ballrush-core 0.4.3 → 0.5.1

package/dist/mongo/index.d.ts

@@ -3,3 +3,9 @@ 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";
+export * from "./schemas/stat-user-profile.schema";
+export * from "./schemas/stat-user-match-history.schema";

package/dist/mongo/index.js

@@ -19,3 +19,9 @@ __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);
+__exportStar(require("./schemas/stat-user-profile.schema"), exports);
+__exportStar(require("./schemas/stat-user-match-history.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/mongo/schemas/stat-user-match-history.schema.d.ts

@@ -0,0 +1,24 @@
+import { Schema } from "mongoose";
+/**
+ * Mongoose document interface for StatUserMatchHistory
+ */
+export interface StatUserMatchHistoryDoc {
+    userId: number;
+    groupId: number;
+    eventId: number;
+    result: 'Win' | 'Loss' | 'Draw';
+    matchup: string;
+    score: string;
+    date: Date;
+    seasonName: string;
+    createdAt: Date;
+}
+/**
+ * Factory function to create StatUserMatchHistory schema
+ * Collection: stat_user_match_history
+ */
+export declare function createStatUserMatchHistorySchema(): Schema<StatUserMatchHistoryDoc, import("mongoose").Model<StatUserMatchHistoryDoc, any, any, any, import("mongoose").Document<unknown, any, StatUserMatchHistoryDoc> & StatUserMatchHistoryDoc & {
+    _id: import("mongoose").Types.ObjectId;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, StatUserMatchHistoryDoc, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<StatUserMatchHistoryDoc>> & import("mongoose").FlatRecord<StatUserMatchHistoryDoc> & {
+    _id: import("mongoose").Types.ObjectId;
+}>;

package/dist/mongo/schemas/stat-user-match-history.schema.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStatUserMatchHistorySchema = createStatUserMatchHistorySchema;
+const mongoose_1 = require("mongoose");
+/**
+ * Factory function to create StatUserMatchHistory schema
+ * Collection: stat_user_match_history
+ */
+function createStatUserMatchHistorySchema() {
+    const StatUserMatchHistorySchema = new mongoose_1.Schema({
+        userId: { type: Number, required: true, index: true },
+        groupId: { type: Number, required: true, index: true },
+        eventId: { type: Number, required: true },
+        result: { type: String, enum: ['Win', 'Loss', 'Draw'], required: true },
+        matchup: { type: String, required: true },
+        score: { type: String, required: true },
+        date: { type: Date, required: true },
+        seasonName: { type: String, required: true },
+        createdAt: { type: Date, default: Date.now },
+    }, {
+        collection: 'stat_user_match_history',
+        versionKey: false,
+    });
+    // Compound index for efficient queries (userId + groupId + date DESC)
+    StatUserMatchHistorySchema.index({ userId: 1, groupId: 1, date: -1 });
+    // Compound index for season filtering (userId + groupId + seasonName + date DESC)
+    StatUserMatchHistorySchema.index({ userId: 1, groupId: 1, seasonName: 1, date: -1 });
+    return StatUserMatchHistorySchema;
+}

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

@@ -0,0 +1,51 @@
+import { Schema } from "mongoose";
+/**
+ * Mongoose sub-schema for SkillHistoryPoint
+ */
+export interface SkillHistoryPointDoc {
+    date: Date;
+    earnedRating: number | null;
+    manualAdjustment: number | null;
+}
+/**
+ * Mongoose sub-schema for ProfileAchievement
+ */
+export interface ProfileAchievementDoc {
+    icon: string;
+    name: string;
+    description: string;
+    count: number;
+}
+/**
+ * Mongoose document interface for StatUserProfile
+ */
+export interface StatUserProfileDoc {
+    userId: number;
+    groupId: number;
+    username: string;
+    fullName: string;
+    avatarUrl: string;
+    position: string;
+    currentSkillRating: number;
+    groupName: string;
+    gamesCount: number;
+    wins: number;
+    losses: number;
+    draws: number;
+    winPercentage: number;
+    goalsFor: number;
+    goalsAgainst: number;
+    eventsCount: number;
+    skillHistory: SkillHistoryPointDoc[];
+    achievements: ProfileAchievementDoc[];
+    lastUpdated: Date;
+}
+/**
+ * Factory function to create StatUserProfile schema
+ * Collection: stat_user_profile
+ */
+export declare function createStatUserProfileSchema(): Schema<StatUserProfileDoc, import("mongoose").Model<StatUserProfileDoc, any, any, any, import("mongoose").Document<unknown, any, StatUserProfileDoc> & StatUserProfileDoc & {
+    _id: import("mongoose").Types.ObjectId;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, StatUserProfileDoc, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<StatUserProfileDoc>> & import("mongoose").FlatRecord<StatUserProfileDoc> & {
+    _id: import("mongoose").Types.ObjectId;
+}>;

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

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStatUserProfileSchema = createStatUserProfileSchema;
+const mongoose_1 = require("mongoose");
+/**
+ * Factory function to create StatUserProfile schema
+ * Collection: stat_user_profile
+ */
+function createStatUserProfileSchema() {
+    const SkillHistoryPointSchema = new mongoose_1.Schema({
+        date: { type: Date, required: true },
+        earnedRating: { type: Number, default: null },
+        manualAdjustment: { type: Number, default: null },
+    }, { _id: false });
+    const ProfileAchievementSchema = new mongoose_1.Schema({
+        icon: { type: String, required: true },
+        name: { type: String, required: true },
+        description: { type: String, required: true },
+        count: { type: Number, required: true, min: 0, default: 0 },
+    }, { _id: false });
+    const StatUserProfileSchema = new mongoose_1.Schema({
+        userId: { type: Number, required: true, index: true },
+        groupId: { type: Number, required: true, index: true },
+        username: { type: String, required: true },
+        fullName: { type: String, required: true },
+        avatarUrl: { type: String, default: '' },
+        position: { type: String, default: '' },
+        currentSkillRating: { type: Number, required: true, default: 0 },
+        groupName: { type: String, required: true },
+        gamesCount: { 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 },
+        goalsFor: { type: Number, required: true, min: 0, default: 0 },
+        goalsAgainst: { type: Number, required: true, min: 0, default: 0 },
+        eventsCount: { type: Number, required: true, min: 0, default: 0 },
+        skillHistory: { type: [SkillHistoryPointSchema], default: [] },
+        achievements: { type: [ProfileAchievementSchema], default: [] },
+        lastUpdated: { type: Date, default: Date.now },
+    }, {
+        collection: 'stat_user_profile',
+        versionKey: false,
+    });
+    // Create compound unique index for userId + groupId
+    StatUserProfileSchema.index({ userId: 1, groupId: 1 }, { unique: true });
+    return StatUserProfileSchema;
+}

package/dist/ports/index.d.ts

@@ -3,3 +3,9 @@ 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";
+export * from "./stat-user-profile.repository";
+export * from "./stat-user-match-history.repository";

package/dist/ports/index.js

@@ -19,3 +19,9 @@ __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);
+__exportStar(require("./stat-user-profile.repository"), exports);
+__exportStar(require("./stat-user-match-history.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/ports/stat-user-match-history.repository.d.ts

@@ -0,0 +1,19 @@
+import { StatUserMatchHistory, MatchHistoryFilter, MatchHistoryOptions, MatchHistoryResult } from "../types/stat-user-match-history.types";
+/**
+ * Repository interface for StatUserMatchHistory
+ * Provides paginated and filterable match history data
+ */
+export interface StatUserMatchHistoryRepository {
+    /**
+     * Find paginated match history for a user in a group
+     * @param filter - User ID, group ID, and optional season filter
+     * @param options - Pagination options
+     * @returns Paginated match history with metadata
+     */
+    find(filter: MatchHistoryFilter, options: MatchHistoryOptions): Promise<MatchHistoryResult>;
+    /**
+     * Create a new match history item
+     * @param item - Match history item to save
+     */
+    create(item: StatUserMatchHistory): Promise<void>;
+}

package/dist/ports/stat-user-match-history.repository.js

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

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

@@ -0,0 +1,20 @@
+import { StatUserProfile } from "../types/stat-user-profile.types";
+/**
+ * Repository interface for StatUserProfile
+ * Provides pre-aggregated user profile data including basic info,
+ * statistics, skill history, and achievements
+ */
+export interface StatUserProfileRepository {
+    /**
+     * Find user profile data for a specific user in a specific group
+     * @param userId - User ID
+     * @param groupId - Group ID
+     * @returns User profile data or null if not found
+     */
+    findByUserAndGroup(userId: number, groupId: number): Promise<StatUserProfile | null>;
+    /**
+     * Create or update user profile data
+     * @param profile - User profile data to save
+     */
+    save(profile: StatUserProfile): Promise<void>;
+}

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

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

package/dist/repositories/index.d.ts

@@ -3,3 +3,9 @@ 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";
+export * from "./mongo/stat-user-profile.repository";
+export * from "./mongo/stat-user-match-history.repository";

package/dist/repositories/index.js

@@ -19,3 +19,9 @@ __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);
+__exportStar(require("./mongo/stat-user-profile.repository"), exports);
+__exportStar(require("./mongo/stat-user-match-history.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>;
+}