ballrush-core 0.4.3 → 0.5.0

package/dist/mongo/index.d.ts

@@ -3,3 +3,7 @@ export * from "./schemas/event-template.schema";
 export * from "./schemas/event.schema";
 export * from "./schemas/group.schema";
 export * from "./schemas/stat-group.schema";
+export * from "./schemas/stat-group-profile.schema";
+export * from "./schemas/stat-group-season.schema";
+export * from "./schemas/stat-group-last-100-games.schema";
+export * from "./schemas/stat-group-activity-chart.schema";

package/dist/mongo/index.js

@@ -19,3 +19,7 @@ __exportStar(require("./schemas/event-template.schema"), exports);
 __exportStar(require("./schemas/event.schema"), exports);
 __exportStar(require("./schemas/group.schema"), exports);
 __exportStar(require("./schemas/stat-group.schema"), exports);
+__exportStar(require("./schemas/stat-group-profile.schema"), exports);
+__exportStar(require("./schemas/stat-group-season.schema"), exports);
+__exportStar(require("./schemas/stat-group-last-100-games.schema"), exports);
+__exportStar(require("./schemas/stat-group-activity-chart.schema"), exports);

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

@@ -0,0 +1,27 @@
+import { Schema } from "mongoose";
+/**
+ * Mongoose document interface for StatGroupActivityChart data point
+ */
+export interface StatGroupActivityDataPointDoc {
+    monthYear: string;
+    displayName: string;
+    matches: number;
+}
+/**
+ * Mongoose document interface for StatGroupActivityChart
+ */
+export interface StatGroupActivityChartDoc {
+    groupId: number;
+    timespan: 6 | 12;
+    data: StatGroupActivityDataPointDoc[];
+    updatedAt: Date;
+}
+/**
+ * Factory function to create StatGroupActivityChart schema
+ * Collection: stat_group_activity_charts
+ */
+export declare function createStatGroupActivityChartSchema(): Schema<StatGroupActivityChartDoc, import("mongoose").Model<StatGroupActivityChartDoc, any, any, any, import("mongoose").Document<unknown, any, StatGroupActivityChartDoc> & StatGroupActivityChartDoc & {
+    _id: import("mongoose").Types.ObjectId;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, StatGroupActivityChartDoc, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<StatGroupActivityChartDoc>> & import("mongoose").FlatRecord<StatGroupActivityChartDoc> & {
+    _id: import("mongoose").Types.ObjectId;
+}>;

package/dist/mongo/schemas/stat-group-activity-chart.schema.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStatGroupActivityChartSchema = createStatGroupActivityChartSchema;
+const mongoose_1 = require("mongoose");
+/**
+ * Factory function to create StatGroupActivityChart schema
+ * Collection: stat_group_activity_charts
+ */
+function createStatGroupActivityChartSchema() {
+    const DataPointSchema = new mongoose_1.Schema({
+        monthYear: { type: String, required: true }, // Format: "2024-10"
+        displayName: { type: String, required: true }, // Format: "Oct 2024"
+        matches: { type: Number, required: true, min: 0, default: 0 },
+    }, { _id: false });
+    const StatGroupActivityChartSchema = new mongoose_1.Schema({
+        groupId: { type: Number, required: true, index: true },
+        timespan: { type: Number, enum: [6, 12], required: true },
+        data: { type: [DataPointSchema], default: [] },
+        updatedAt: { type: Date, default: Date.now },
+    }, {
+        collection: 'stat_group_activity_charts',
+        versionKey: false,
+    });
+    // Composite unique index for groupId + timespan
+    StatGroupActivityChartSchema.index({ groupId: 1, timespan: 1 }, { unique: true });
+    return StatGroupActivityChartSchema;
+}

package/dist/mongo/schemas/stat-group-last-100-games.schema.d.ts

@@ -0,0 +1,33 @@
+import { Schema } from "mongoose";
+/**
+ * Mongoose document interface for StatGroupLast100Games player
+ */
+export interface StatGroupLast100GamesPlayerDoc {
+    userId: number;
+    playerName: string;
+    skillRating: number;
+    games: number;
+    wins: number;
+    draws: number;
+    losses: number;
+    winPercentage: number;
+    achievementsCount: number;
+    score: number;
+}
+/**
+ * Mongoose document interface for StatGroupLast100Games
+ */
+export interface StatGroupLast100GamesDoc {
+    groupId: number;
+    players: StatGroupLast100GamesPlayerDoc[];
+    updatedAt: Date;
+}
+/**
+ * Factory function to create StatGroupLast100Games schema
+ * Collection: stat_group_last_100_games
+ */
+export declare function createStatGroupLast100GamesSchema(): Schema<StatGroupLast100GamesDoc, import("mongoose").Model<StatGroupLast100GamesDoc, any, any, any, import("mongoose").Document<unknown, any, StatGroupLast100GamesDoc> & StatGroupLast100GamesDoc & {
+    _id: import("mongoose").Types.ObjectId;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, StatGroupLast100GamesDoc, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<StatGroupLast100GamesDoc>> & import("mongoose").FlatRecord<StatGroupLast100GamesDoc> & {
+    _id: import("mongoose").Types.ObjectId;
+}>;

package/dist/mongo/schemas/stat-group-last-100-games.schema.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStatGroupLast100GamesSchema = createStatGroupLast100GamesSchema;
+const mongoose_1 = require("mongoose");
+/**
+ * Factory function to create StatGroupLast100Games schema
+ * Collection: stat_group_last_100_games
+ */
+function createStatGroupLast100GamesSchema() {
+    const PlayerSchema = new mongoose_1.Schema({
+        userId: { type: Number, required: true },
+        playerName: { type: String, required: true },
+        skillRating: { type: Number, required: true, min: 0, default: 0 },
+        games: { type: Number, required: true, min: 0, max: 100, 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 },
+        winPercentage: { type: Number, required: true, min: 0, max: 100, default: 0 },
+        achievementsCount: { type: Number, required: true, min: 0, default: 0 },
+        score: { type: Number, required: true, min: 0, default: 0 },
+    }, { _id: false });
+    const StatGroupLast100GamesSchema = new mongoose_1.Schema({
+        groupId: { type: Number, required: true, unique: true, index: true },
+        players: { type: [PlayerSchema], default: [] },
+        updatedAt: { type: Date, default: Date.now },
+    }, {
+        collection: 'stat_group_last_100_games',
+        versionKey: false,
+    });
+    return StatGroupLast100GamesSchema;
+}

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

@@ -0,0 +1,27 @@
+import { Schema } from "mongoose";
+/**
+ * Mongoose document interface for StatGroupProfile
+ */
+export interface StatGroupProfileDoc {
+    groupId: number;
+    groupName: string;
+    establishedDate: Date;
+    totalMembers: number;
+    activePlayers: number;
+    totalGames: number;
+    averageSkillRating: number;
+    currentSeason: {
+        seasonName: string;
+        status: 'in_progress' | 'completed';
+    } | null;
+    updatedAt: Date;
+}
+/**
+ * Factory function to create StatGroupProfile schema
+ * Collection: stat_group_profiles
+ */
+export declare function createStatGroupProfileSchema(): Schema<StatGroupProfileDoc, import("mongoose").Model<StatGroupProfileDoc, any, any, any, import("mongoose").Document<unknown, any, StatGroupProfileDoc> & StatGroupProfileDoc & {
+    _id: import("mongoose").Types.ObjectId;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, StatGroupProfileDoc, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<StatGroupProfileDoc>> & import("mongoose").FlatRecord<StatGroupProfileDoc> & {
+    _id: import("mongoose").Types.ObjectId;
+}>;

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

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStatGroupProfileSchema = createStatGroupProfileSchema;
+const mongoose_1 = require("mongoose");
+/**
+ * Factory function to create StatGroupProfile schema
+ * Collection: stat_group_profiles
+ */
+function createStatGroupProfileSchema() {
+    const CurrentSeasonSchema = new mongoose_1.Schema({
+        seasonName: { type: String, required: true },
+        status: { type: String, enum: ['in_progress', 'completed'], required: true },
+    }, { _id: false });
+    const StatGroupProfileSchema = new mongoose_1.Schema({
+        groupId: { type: Number, required: true, unique: true, index: true },
+        groupName: { type: String, required: true },
+        establishedDate: { type: Date, required: true },
+        totalMembers: { type: Number, required: true, min: 0, default: 0 },
+        activePlayers: { type: Number, required: true, min: 0, default: 0 },
+        totalGames: { type: Number, required: true, min: 0, default: 0 },
+        averageSkillRating: { type: Number, required: true, min: 0, default: 0 },
+        currentSeason: { type: CurrentSeasonSchema, default: null },
+        updatedAt: { type: Date, default: Date.now },
+    }, {
+        collection: 'stat_group_profiles',
+        versionKey: false,
+    });
+    return StatGroupProfileSchema;
+}

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

@@ -0,0 +1,37 @@
+import { Schema } from "mongoose";
+/**
+ * Mongoose document interface for StatGroupSeason participant
+ */
+export interface StatGroupSeasonParticipantDoc {
+    userId: number;
+    playerName: string;
+    achievementsCount: number;
+    games: number;
+    wins: number;
+    losses: number;
+    draws: number;
+    winPercentage: number;
+    skillRating: number;
+    score: number;
+}
+/**
+ * Mongoose document interface for StatGroupSeason
+ */
+export interface StatGroupSeasonDoc {
+    groupId: number;
+    seasonName: string;
+    participants: StatGroupSeasonParticipantDoc[];
+    startDate: Date;
+    endDate: Date | null;
+    status: 'in_progress' | 'completed';
+    updatedAt: Date;
+}
+/**
+ * Factory function to create StatGroupSeason schema
+ * Collection: stat_group_seasons
+ */
+export declare function createStatGroupSeasonSchema(): Schema<StatGroupSeasonDoc, import("mongoose").Model<StatGroupSeasonDoc, any, any, any, import("mongoose").Document<unknown, any, StatGroupSeasonDoc> & StatGroupSeasonDoc & {
+    _id: import("mongoose").Types.ObjectId;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, StatGroupSeasonDoc, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<StatGroupSeasonDoc>> & import("mongoose").FlatRecord<StatGroupSeasonDoc> & {
+    _id: import("mongoose").Types.ObjectId;
+}>;

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

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStatGroupSeasonSchema = createStatGroupSeasonSchema;
+const mongoose_1 = require("mongoose");
+/**
+ * Factory function to create StatGroupSeason schema
+ * Collection: stat_group_seasons
+ */
+function createStatGroupSeasonSchema() {
+    const ParticipantSchema = new mongoose_1.Schema({
+        userId: { type: Number, required: true },
+        playerName: { type: String, required: true },
+        achievementsCount: { type: Number, required: true, min: 0, default: 0 },
+        games: { type: Number, required: true, min: 0, default: 0 },
+        wins: { type: Number, required: true, min: 0, default: 0 },
+        losses: { type: Number, required: true, min: 0, default: 0 },
+        draws: { type: Number, required: true, min: 0, default: 0 },
+        winPercentage: { type: Number, required: true, min: 0, max: 100, default: 0 },
+        skillRating: { type: Number, required: true, min: 0, default: 0 },
+        score: { type: Number, required: true, min: 0, default: 0 },
+    }, { _id: false });
+    const StatGroupSeasonSchema = new mongoose_1.Schema({
+        groupId: { type: Number, required: true, index: true },
+        seasonName: { type: String, required: true },
+        participants: { type: [ParticipantSchema], default: [] },
+        startDate: { type: Date, required: true },
+        endDate: { type: Date, default: null },
+        status: { type: String, enum: ['in_progress', 'completed'], required: true },
+        updatedAt: { type: Date, default: Date.now },
+    }, {
+        collection: 'stat_group_seasons',
+        versionKey: false,
+    });
+    // Composite unique index for groupId + seasonName
+    StatGroupSeasonSchema.index({ groupId: 1, seasonName: 1 }, { unique: true });
+    // Index for listing seasons by group (newest first will be done in query)
+    StatGroupSeasonSchema.index({ groupId: 1, updatedAt: -1 });
+    return StatGroupSeasonSchema;
+}

package/dist/ports/index.d.ts

@@ -3,3 +3,7 @@ export * from "./groups.repository";
 export * from "./events.repository";
 export * from "./event-templates.repository";
 export * from "./stat-group.repository";
+export * from "./stat-group-profile.repository";
+export * from "./stat-group-season.repository";
+export * from "./stat-group-last-100-games.repository";
+export * from "./stat-group-activity-chart.repository";

package/dist/ports/index.js

@@ -19,3 +19,7 @@ __exportStar(require("./groups.repository"), exports);
 __exportStar(require("./events.repository"), exports);
 __exportStar(require("./event-templates.repository"), exports);
 __exportStar(require("./stat-group.repository"), exports);
+__exportStar(require("./stat-group-profile.repository"), exports);
+__exportStar(require("./stat-group-season.repository"), exports);
+__exportStar(require("./stat-group-last-100-games.repository"), exports);
+__exportStar(require("./stat-group-activity-chart.repository"), exports);

package/dist/ports/stat-group-activity-chart.repository.d.ts

@@ -0,0 +1,14 @@
+import { StatGroupActivityChart } from "../types/stat-group-activity-chart.types";
+/**
+ * Repository interface for StatGroupActivityChart
+ * Provides pre-aggregated time-series data for the group activity chart
+ */
+export interface StatGroupActivityChartRepository {
+    /**
+     * Finds activity chart data for a group within a timespan
+     * @param groupId - The group ID
+     * @param months - Number of months to look back (6 or 12)
+     * @returns Array of monthly activity data points
+     */
+    findByGroupId(groupId: number, months: 6 | 12): Promise<StatGroupActivityChart | null>;
+}

package/dist/ports/stat-group-activity-chart.repository.js

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

package/dist/ports/stat-group-last-100-games.repository.d.ts

@@ -0,0 +1,13 @@
+import { StatGroupLast100Games } from "../types/stat-group-last-100-games.types";
+/**
+ * Repository interface for StatGroupLast100Games
+ * Provides enriched statistics for players' last 100 games in a group
+ */
+export interface StatGroupLast100GamesRepository {
+    /**
+     * Finds enriched last 100 games statistics for all players in a group
+     * @param groupId - The group ID
+     * @returns Array of enriched statistics pre-sorted by score (descending)
+     */
+    findByGroupId(groupId: number): Promise<StatGroupLast100Games | null>;
+}

package/dist/ports/stat-group-last-100-games.repository.js

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

package/dist/ports/stat-group-profile.repository.d.ts

@@ -0,0 +1,14 @@
+import { StatGroupProfile } from "../types/stat-group-profile.types";
+/**
+ * Repository interface for StatGroupProfile
+ * Provides pre-aggregated group profile data including header info,
+ * current season, and aggregate statistics
+ */
+export interface StatGroupProfileRepository {
+    /**
+     * Finds pre-aggregated group profile data by group ID
+     * @param groupId - The group ID
+     * @returns Group profile data or null if not found
+     */
+    findByGroupId(groupId: number): Promise<StatGroupProfile | null>;
+}

package/dist/ports/stat-group-profile.repository.js

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

package/dist/ports/stat-group-season.repository.d.ts

@@ -0,0 +1,14 @@
+import { StatGroupSeason } from "../types/stat-group-season.types";
+/**
+ * Repository interface for StatGroupSeason
+ * Provides pre-aggregated season statistics including participant rankings
+ * and performance data
+ */
+export interface StatGroupSeasonRepository {
+    /**
+     * Finds all season statistics for a group
+     * @param groupId - The group ID
+     * @returns Array of season statistics ordered by season (newest first)
+     */
+    findByGroupId(groupId: number): Promise<StatGroupSeason[]>;
+}

package/dist/ports/stat-group-season.repository.js

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

package/dist/repositories/index.d.ts

@@ -3,3 +3,7 @@ export * from "./mongo/group.repository";
 export * from "./mongo/event.repository";
 export * from "./mongo/event-template.repository";
 export * from "./mongo/stat-group.repository";
+export * from "./mongo/stat-group-profile.repository";
+export * from "./mongo/stat-group-season.repository";
+export * from "./mongo/stat-group-last-100-games.repository";
+export * from "./mongo/stat-group-activity-chart.repository";

package/dist/repositories/index.js

@@ -19,3 +19,7 @@ __exportStar(require("./mongo/group.repository"), exports);
 __exportStar(require("./mongo/event.repository"), exports);
 __exportStar(require("./mongo/event-template.repository"), exports);
 __exportStar(require("./mongo/stat-group.repository"), exports);
+__exportStar(require("./mongo/stat-group-profile.repository"), exports);
+__exportStar(require("./mongo/stat-group-season.repository"), exports);
+__exportStar(require("./mongo/stat-group-last-100-games.repository"), exports);
+__exportStar(require("./mongo/stat-group-activity-chart.repository"), exports);

package/dist/repositories/mongo/stat-group-activity-chart.repository.d.ts

@@ -0,0 +1,13 @@
+import type { Model } from "mongoose";
+import type { StatGroupActivityChartRepository } from "../../ports/stat-group-activity-chart.repository";
+import type { StatGroupActivityChartDoc } from "../../mongo/schemas/stat-group-activity-chart.schema";
+import type { StatGroupActivityChart } from "../../types/stat-group-activity-chart.types";
+/**
+ * MongoDB implementation of StatGroupActivityChartRepository
+ * Provides read-only access to pre-aggregated activity chart data
+ */
+export declare class MongoStatGroupActivityChartRepository implements StatGroupActivityChartRepository {
+    private readonly model;
+    constructor(model: Model<StatGroupActivityChartDoc>);
+    findByGroupId(groupId: number, months: 6 | 12): Promise<StatGroupActivityChart | null>;
+}

package/dist/repositories/mongo/stat-group-activity-chart.repository.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoStatGroupActivityChartRepository = void 0;
+const errors_1 = require("../../errors");
+/**
+ * MongoDB implementation of StatGroupActivityChartRepository
+ * Provides read-only access to pre-aggregated activity chart data
+ */
+class MongoStatGroupActivityChartRepository {
+    constructor(model) {
+        this.model = model;
+    }
+    async findByGroupId(groupId, months) {
+        try {
+            // Validate input
+            if (!groupId || groupId === 0) {
+                throw new errors_1.ValidationError('StatGroupActivityChart', 'groupId', groupId, 'must be a non-zero number');
+            }
+            if (months !== 6 && months !== 12) {
+                throw new errors_1.ValidationError('StatGroupActivityChart', 'months', months, 'must be 6 or 12');
+            }
+            const doc = await this.model.findOne({ groupId, timespan: months }).lean();
+            if (!doc) {
+                return null;
+            }
+            // Map document to domain type
+            return {
+                groupId: doc.groupId,
+                timespan: doc.timespan,
+                data: doc.data.map(d => ({
+                    monthYear: d.monthYear,
+                    displayName: d.displayName,
+                    matches: d.matches,
+                })),
+                updatedAt: doc.updatedAt,
+            };
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError) {
+                throw error;
+            }
+            throw new errors_1.QueryError('findByGroupId', 'StatGroupActivityChart', `${groupId}:${months}`, error);
+        }
+    }
+}
+exports.MongoStatGroupActivityChartRepository = MongoStatGroupActivityChartRepository;

package/dist/repositories/mongo/stat-group-last-100-games.repository.d.ts

@@ -0,0 +1,13 @@
+import type { Model } from "mongoose";
+import type { StatGroupLast100GamesRepository } from "../../ports/stat-group-last-100-games.repository";
+import type { StatGroupLast100GamesDoc } from "../../mongo/schemas/stat-group-last-100-games.schema";
+import type { StatGroupLast100Games } from "../../types/stat-group-last-100-games.types";
+/**
+ * MongoDB implementation of StatGroupLast100GamesRepository
+ * Provides read-only access to enriched last 100 games statistics
+ */
+export declare class MongoStatGroupLast100GamesRepository implements StatGroupLast100GamesRepository {
+    private readonly model;
+    constructor(model: Model<StatGroupLast100GamesDoc>);
+    findByGroupId(groupId: number): Promise<StatGroupLast100Games | null>;
+}

package/dist/repositories/mongo/stat-group-last-100-games.repository.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoStatGroupLast100GamesRepository = void 0;
+const errors_1 = require("../../errors");
+/**
+ * MongoDB implementation of StatGroupLast100GamesRepository
+ * Provides read-only access to enriched last 100 games statistics
+ */
+class MongoStatGroupLast100GamesRepository {
+    constructor(model) {
+        this.model = model;
+    }
+    async findByGroupId(groupId) {
+        try {
+            // Validate input
+            if (!groupId || groupId === 0) {
+                throw new errors_1.ValidationError('StatGroupLast100Games', 'groupId', groupId, 'must be a non-zero number');
+            }
+            const doc = await this.model.findOne({ groupId }).lean();
+            if (!doc) {
+                return null;
+            }
+            // Map document to domain type
+            return {
+                groupId: doc.groupId,
+                players: doc.players.map(p => ({
+                    userId: p.userId,
+                    playerName: p.playerName,
+                    skillRating: p.skillRating,
+                    games: p.games,
+                    wins: p.wins,
+                    draws: p.draws,
+                    losses: p.losses,
+                    winPercentage: p.winPercentage,
+                    achievementsCount: p.achievementsCount,
+                    score: p.score,
+                })),
+                updatedAt: doc.updatedAt,
+            };
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError) {
+                throw error;
+            }
+            throw new errors_1.QueryError('findByGroupId', 'StatGroupLast100Games', groupId, error);
+        }
+    }
+}
+exports.MongoStatGroupLast100GamesRepository = MongoStatGroupLast100GamesRepository;

package/dist/repositories/mongo/stat-group-profile.repository.d.ts

@@ -0,0 +1,13 @@
+import type { Model } from "mongoose";
+import type { StatGroupProfileRepository } from "../../ports/stat-group-profile.repository";
+import type { StatGroupProfileDoc } from "../../mongo/schemas/stat-group-profile.schema";
+import type { StatGroupProfile } from "../../types/stat-group-profile.types";
+/**
+ * MongoDB implementation of StatGroupProfileRepository
+ * Provides read-only access to pre-aggregated group profile data
+ */
+export declare class MongoStatGroupProfileRepository implements StatGroupProfileRepository {
+    private readonly model;
+    constructor(model: Model<StatGroupProfileDoc>);
+    findByGroupId(groupId: number): Promise<StatGroupProfile | null>;
+}

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

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoStatGroupProfileRepository = void 0;
+const errors_1 = require("../../errors");
+/**
+ * MongoDB implementation of StatGroupProfileRepository
+ * Provides read-only access to pre-aggregated group profile data
+ */
+class MongoStatGroupProfileRepository {
+    constructor(model) {
+        this.model = model;
+    }
+    async findByGroupId(groupId) {
+        try {
+            // Validate input
+            if (!groupId || groupId === 0) {
+                throw new errors_1.ValidationError('StatGroupProfile', 'groupId', groupId, 'must be a non-zero number');
+            }
+            const doc = await this.model.findOne({ groupId }).lean();
+            if (!doc) {
+                return null;
+            }
+            // Map document to domain type
+            return {
+                groupId: doc.groupId,
+                groupName: doc.groupName,
+                establishedDate: doc.establishedDate,
+                totalMembers: doc.totalMembers,
+                activePlayers: doc.activePlayers,
+                totalGames: doc.totalGames,
+                averageSkillRating: doc.averageSkillRating,
+                currentSeason: doc.currentSeason ? {
+                    seasonName: doc.currentSeason.seasonName,
+                    status: doc.currentSeason.status,
+                } : null,
+                updatedAt: doc.updatedAt,
+            };
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError) {
+                throw error;
+            }
+            throw new errors_1.QueryError('findByGroupId', 'StatGroupProfile', groupId, error);
+        }
+    }
+}
+exports.MongoStatGroupProfileRepository = MongoStatGroupProfileRepository;

package/dist/repositories/mongo/stat-group-season.repository.d.ts

@@ -0,0 +1,13 @@
+import type { Model } from "mongoose";
+import type { StatGroupSeasonRepository } from "../../ports/stat-group-season.repository";
+import type { StatGroupSeasonDoc } from "../../mongo/schemas/stat-group-season.schema";
+import type { StatGroupSeason } from "../../types/stat-group-season.types";
+/**
+ * MongoDB implementation of StatGroupSeasonRepository
+ * Provides read-only access to pre-aggregated season statistics
+ */
+export declare class MongoStatGroupSeasonRepository implements StatGroupSeasonRepository {
+    private readonly model;
+    constructor(model: Model<StatGroupSeasonDoc>);
+    findByGroupId(groupId: number): Promise<StatGroupSeason[]>;
+}

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

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoStatGroupSeasonRepository = void 0;
+const errors_1 = require("../../errors");
+/**
+ * MongoDB implementation of StatGroupSeasonRepository
+ * Provides read-only access to pre-aggregated season statistics
+ */
+class MongoStatGroupSeasonRepository {
+    constructor(model) {
+        this.model = model;
+    }
+    async findByGroupId(groupId) {
+        try {
+            // Validate input
+            if (!groupId || groupId === 0) {
+                throw new errors_1.ValidationError('StatGroupSeason', 'groupId', groupId, 'must be a non-zero number');
+            }
+            // Find all seasons for the group, sorted by start date (newest first)
+            const docs = await this.model
+                .find({ groupId })
+                .sort({ startDate: -1 })
+                .lean();
+            // Map documents to domain types
+            return docs.map(doc => ({
+                groupId: doc.groupId,
+                seasonName: doc.seasonName,
+                participants: doc.participants.map(p => ({
+                    userId: p.userId,
+                    playerName: p.playerName,
+                    achievementsCount: p.achievementsCount,
+                    games: p.games,
+                    wins: p.wins,
+                    losses: p.losses,
+                    draws: p.draws,
+                    winPercentage: p.winPercentage,
+                    skillRating: p.skillRating,
+                    score: p.score,
+                })),
+                startDate: doc.startDate,
+                endDate: doc.endDate,
+                status: doc.status,
+                updatedAt: doc.updatedAt,
+            }));
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError) {
+                throw error;
+            }
+            throw new errors_1.QueryError('findByGroupId', 'StatGroupSeason', groupId, error);
+        }
+    }
+}
+exports.MongoStatGroupSeasonRepository = MongoStatGroupSeasonRepository;

package/dist/types/index.d.ts

@@ -1 +1,5 @@
 export * from "./shared";
+export * from "./stat-group-profile.types";
+export * from "./stat-group-season.types";
+export * from "./stat-group-last-100-games.types";
+export * from "./stat-group-activity-chart.types";

package/dist/types/index.js

@@ -15,3 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./shared"), exports);
+__exportStar(require("./stat-group-profile.types"), exports);
+__exportStar(require("./stat-group-season.types"), exports);
+__exportStar(require("./stat-group-last-100-games.types"), exports);
+__exportStar(require("./stat-group-activity-chart.types"), exports);

package/dist/types/stat-group-activity-chart.types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Statistics: Group Activity Chart Types
+ * Pre-aggregated time-series data for group activity visualization
+ */
+export interface StatGroupActivityDataPoint {
+    monthYear: string;
+    displayName: string;
+    matches: number;
+}
+export interface StatGroupActivityChart {
+    groupId: number;
+    timespan: 6 | 12;
+    data: StatGroupActivityDataPoint[];
+    updatedAt: Date;
+}

package/dist/types/stat-group-activity-chart.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Statistics: Group Activity Chart Types
+ * Pre-aggregated time-series data for group activity visualization
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/stat-group-last-100-games.types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Statistics: Group Last 100 Games Types
+ * Enriched statistics for players' last 100 games in a group
+ */
+export interface StatGroupLast100GamesPlayer {
+    userId: number;
+    playerName: string;
+    skillRating: number;
+    games: number;
+    wins: number;
+    draws: number;
+    losses: number;
+    winPercentage: number;
+    achievementsCount: number;
+    score: number;
+}
+export interface StatGroupLast100Games {
+    groupId: number;
+    players: StatGroupLast100GamesPlayer[];
+    updatedAt: Date;
+}

package/dist/types/stat-group-last-100-games.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Statistics: Group Last 100 Games Types
+ * Enriched statistics for players' last 100 games in a group
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,19 @@
+/**
+ * Statistics: Group Profile Types
+ * Pre-aggregated group profile data for ballrush-api
+ */
+export interface StatGroupProfileCurrentSeason {
+    seasonName: string;
+    status: 'in_progress' | 'completed';
+}
+export interface StatGroupProfile {
+    groupId: number;
+    groupName: string;
+    establishedDate: Date;
+    totalMembers: number;
+    activePlayers: number;
+    totalGames: number;
+    averageSkillRating: number;
+    currentSeason: StatGroupProfileCurrentSeason | null;
+    updatedAt: Date;
+}

package/dist/types/stat-group-profile.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Statistics: Group Profile Types
+ * Pre-aggregated group profile data for ballrush-api
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,25 @@
+/**
+ * Statistics: Group Season Types
+ * Pre-aggregated season statistics with participant rankings
+ */
+export interface StatGroupSeasonParticipant {
+    userId: number;
+    playerName: string;
+    achievementsCount: number;
+    games: number;
+    wins: number;
+    losses: number;
+    draws: number;
+    winPercentage: number;
+    skillRating: number;
+    score: number;
+}
+export interface StatGroupSeason {
+    groupId: number;
+    seasonName: string;
+    participants: StatGroupSeasonParticipant[];
+    startDate: Date;
+    endDate: Date | null;
+    status: 'in_progress' | 'completed';
+    updatedAt: Date;
+}

package/dist/types/stat-group-season.types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Statistics: Group Season Types
+ * Pre-aggregated season statistics with participant rankings
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

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