@mshowes/brackets-manager 1.8.1

package/dist/delete.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Delete = void 0;
+class Delete {
+    /**
+     * Creates an instance of Delete, which will handle cleanly deleting data in the storage.
+     *
+     * @param storage The implementation of Storage.
+     */
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Deletes a stage, and all its components:
+     *
+     * - Groups
+     * - Rounds
+     * - Matches
+     * - Match games
+     *
+     * This does not delete the related participants.
+     *
+     * @param stageId ID of the stage.
+     */
+    async stage(stageId) {
+        // The order is important here, because the abstract storage can possibly have foreign key checks (e.g. SQL).
+        if (!(await this.storage.delete('match_game', { stage_id: stageId })))
+            throw Error('Could not delete match games.');
+        if (!(await this.storage.delete('match', { stage_id: stageId })))
+            throw Error('Could not delete matches.');
+        if (!(await this.storage.delete('round', { stage_id: stageId })))
+            throw Error('Could not delete rounds.');
+        if (!(await this.storage.delete('group', { stage_id: stageId })))
+            throw Error('Could not delete groups.');
+        if (!(await this.storage.delete('stage', { id: stageId })))
+            throw Error('Could not delete the stage.');
+    }
+    /**
+     * Deletes **the stages** of a tournament (and all their components, see {@link stage | delete.stage()}).
+     *
+     * This does not delete the related participants and you are responsible for deleting the tournament itself.
+     *
+     * @param tournamentId ID of the tournament.
+     */
+    async tournament(tournamentId) {
+        const stages = await this.storage.select('stage', {
+            tournament_id: tournamentId,
+        });
+        if (!stages)
+            throw Error('Error getting the stages.');
+        // Not doing this in a `Promise.all()` since this can be a heavy operation.
+        for (const stage of stages)
+            await this.stage(stage.id);
+    }
+}
+exports.Delete = Delete;
+//# sourceMappingURL=delete.js.map

package/dist/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../src/delete.ts"],"names":[],"mappings":";;;AAGA,MAAa,MAAM;IAGf;;;;OAIG;IACH,YAAY,OAAgB;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED;;;;;;;;;;;OAWG;IACI,KAAK,CAAC,KAAK,CAAC,OAAW;QAC1B,6GAA6G;QAE7G,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YACjE,MAAM,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAEjD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5D,MAAM,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAE7C,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5D,MAAM,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAE5C,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5D,MAAM,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAE5C,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YACtD,MAAM,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,UAAU,CAAC,YAAgB;QACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE;YAC9C,aAAa,EAAE,YAAY;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,MAAM;YAAE,MAAM,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAEtD,2EAA2E;QAC3E,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;CACJ;AA3DD,wBA2DC"}

package/dist/find.d.ts

@@ -0,0 +1,60 @@
+import { Group, Id, Match, MatchGame } from 'brackets-model';
+import { BaseGetter } from './base/getter';
+export declare class Find extends BaseGetter {
+    /**
+     * Gets the upper bracket (the only bracket if single elimination or the winner bracket in double elimination).
+     *
+     * @param stageId ID of the stage.
+     */
+    upperBracket(stageId: Id): Promise<Group>;
+    /**
+     * Gets the loser bracket.
+     *
+     * @param stageId ID of the stage.
+     */
+    loserBracket(stageId: Id): Promise<Group>;
+    /**
+     * Returns the matches leading to the given match.
+     *
+     * If a `participantId` is given, the previous match _from their point of view_ is returned.
+     *
+     * @param matchId ID of the target match.
+     * @param participantId Optional ID of the participant.
+     */
+    previousMatches(matchId: Id, participantId?: number): Promise<Match[]>;
+    /**
+     * Returns the matches following the given match.
+     *
+     * If a `participantId` is given:
+     * - If the participant won, the next match _from their point of view_ is returned.
+     * - If the participant is eliminated, no match is returned.
+     *
+     * @param matchId ID of the target match.
+     * @param participantId Optional ID of the participant.
+     */
+    nextMatches(matchId: Id, participantId?: number): Promise<Match[]>;
+    /**
+     * Finds a match in a given group. The match must have the given number in a round of which the number in group is given.
+     *
+     * **Example:** In group of id 1, give me the 4th match in the 3rd round.
+     *
+     * @param groupId ID of the group.
+     * @param roundNumber Number of the round in its parent group.
+     * @param matchNumber Number of the match in its parent round.
+     */
+    match(groupId: Id, roundNumber: number, matchNumber: number): Promise<Match>;
+    /**
+     * Finds a match game based on its `id` or based on the combination of its `parent_id` and `number`.
+     *
+     * @param game Values to change in a match game.
+     */
+    matchGame(game: Partial<MatchGame>): Promise<MatchGame>;
+    /**
+     * Returns an object with 1 match per group type. Only supports double elimination.
+     *
+     * @param matches A list of matches.
+     * @param fetchedGroups A map of groups which were already fetched.
+     */
+    private getMatchesByGroupDoubleElimination;
+}
+//# sourceMappingURL=find.d.ts.map

package/dist/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../src/find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,qBAAa,IAAK,SAAQ,UAAU;IAChC;;;;OAIG;IACU,YAAY,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAetD;;;;OAIG;IACU,YAAY,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAoBtD;;;;;;;OAOG;IACU,eAAe,CACxB,OAAO,EAAE,EAAE,EACX,aAAa,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,KAAK,EAAE,CAAC;IAiCnB;;;;;;;;;OASG;IACU,WAAW,CACpB,OAAO,EAAE,EAAE,EACX,aAAa,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,KAAK,EAAE,CAAC;IAwFnB;;;;;;;;OAQG;IACU,KAAK,CACd,OAAO,EAAE,EAAE,EACX,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,KAAK,CAAC;IAIjB;;;;OAIG;IACU,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAIpE;;;;;OAKG;YACW,kCAAkC;CAgDnD"}

package/dist/find.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Find = void 0;
+const getter_1 = require("./base/getter");
+const helpers = require("./helpers");
+class Find extends getter_1.BaseGetter {
+    /**
+     * Gets the upper bracket (the only bracket if single elimination or the winner bracket in double elimination).
+     *
+     * @param stageId ID of the stage.
+     */
+    async upperBracket(stageId) {
+        const stage = await this.storage.select('stage', stageId);
+        if (!stage)
+            throw Error('Stage not found.');
+        switch (stage.type) {
+            case 'round_robin':
+                throw Error('Round-robin stages do not have an upper bracket.');
+            case 'single_elimination':
+            case 'double_elimination':
+                return this.getUpperBracket(stageId);
+            default:
+                throw Error('Unknown stage type.');
+        }
+    }
+    /**
+     * Gets the loser bracket.
+     *
+     * @param stageId ID of the stage.
+     */
+    async loserBracket(stageId) {
+        const stage = await this.storage.select('stage', stageId);
+        if (!stage)
+            throw Error('Stage not found.');
+        switch (stage.type) {
+            case 'round_robin':
+                throw Error('Round-robin stages do not have a loser bracket.');
+            case 'single_elimination':
+                throw Error('Single elimination stages do not have a loser bracket.');
+            case 'double_elimination':
+                const group = await this.getLoserBracket(stageId);
+                if (!group)
+                    throw Error('Loser bracket not found.');
+                return group;
+            default:
+                throw Error('Unknown stage type.');
+        }
+    }
+    /**
+     * Returns the matches leading to the given match.
+     *
+     * If a `participantId` is given, the previous match _from their point of view_ is returned.
+     *
+     * @param matchId ID of the target match.
+     * @param participantId Optional ID of the participant.
+     */
+    async previousMatches(matchId, participantId) {
+        const match = await this.storage.select('match', matchId);
+        if (!match)
+            throw Error('Match not found.');
+        const stage = await this.storage.select('stage', match.stage_id);
+        if (!stage)
+            throw Error('Stage not found.');
+        const group = await this.storage.select('group', match.group_id);
+        if (!group)
+            throw Error('Group not found.');
+        const round = await this.storage.select('round', match.round_id);
+        if (!round)
+            throw Error('Round not found.');
+        const matchLocation = helpers.getMatchLocation(stage.type, group.number);
+        const previousMatches = await this.getPreviousMatches(match, matchLocation, stage, round.number);
+        if (participantId !== undefined) {
+            return previousMatches.filter((m) => helpers.isParticipantInMatch(m, participantId));
+        }
+        return previousMatches;
+    }
+    /**
+     * Returns the matches following the given match.
+     *
+     * If a `participantId` is given:
+     * - If the participant won, the next match _from their point of view_ is returned.
+     * - If the participant is eliminated, no match is returned.
+     *
+     * @param matchId ID of the target match.
+     * @param participantId Optional ID of the participant.
+     */
+    async nextMatches(matchId, participantId) {
+        const match = await this.storage.select('match', matchId);
+        if (!match)
+            throw Error('Match not found.');
+        const stage = await this.storage.select('stage', match.stage_id);
+        if (!stage)
+            throw Error('Stage not found.');
+        const group = await this.storage.select('group', match.group_id);
+        if (!group)
+            throw Error('Group not found.');
+        const { roundNumber, roundCount } = await this.getRoundPositionalInfo(match.round_id);
+        const matchLocation = helpers.getMatchLocation(stage.type, group.number);
+        const nextMatches = helpers.getNonNull(await this.getNextMatches(match, matchLocation, stage, roundNumber, roundCount));
+        if (participantId !== undefined) {
+            if (!helpers.isParticipantInMatch(match, participantId))
+                throw Error('The participant does not belong to this match.');
+            if (!helpers.isMatchStale(match)) {
+                throw Error('The match is not stale yet, so it is not possible to conclude the next matches for this participant.');
+            }
+            const loser = helpers.getLoser(match);
+            if (stage.type === 'single_elimination' &&
+                (loser === null || loser === void 0 ? void 0 : loser.id) === participantId)
+                return []; // Eliminated.
+            if (stage.type === 'double_elimination') {
+                // TODO: refactor `getNextMatches()` to return 1 next match per group. Then we can get rid of `getMatchesByGroupDoubleElimination()`.
+                const { winnerBracketMatch, loserBracketMatch, finalGroupMatch, } = await this.getMatchesByGroupDoubleElimination(nextMatches, new Map([[group.id, group]]));
+                const winner = helpers.getWinner(match);
+                if (matchLocation === 'loser_bracket') {
+                    if (participantId === (loser === null || loser === void 0 ? void 0 : loser.id))
+                        return []; // Eliminated from lower bracket.
+                    if (participantId === (winner === null || winner === void 0 ? void 0 : winner.id))
+                        return loserBracketMatch ? [loserBracketMatch] : [];
+                }
+                else if (matchLocation === 'winner_bracket') {
+                    if (!loserBracketMatch) {
+                        throw Error('All matches of winner bracket should lead to loser bracket.');
+                    }
+                    if (participantId === (loser === null || loser === void 0 ? void 0 : loser.id))
+                        return [loserBracketMatch]; // Eliminated from upper bracket, going to lower bracket.
+                    if (participantId === (winner === null || winner === void 0 ? void 0 : winner.id))
+                        return winnerBracketMatch ? [winnerBracketMatch] : [];
+                }
+                else if (matchLocation === 'final_group') {
+                    if (!finalGroupMatch) {
+                        throw Error('All matches of a final group should also lead to the final group.');
+                    }
+                    return [finalGroupMatch];
+                }
+            }
+        }
+        return nextMatches;
+    }
+    /**
+     * Finds a match in a given group. The match must have the given number in a round of which the number in group is given.
+     *
+     * **Example:** In group of id 1, give me the 4th match in the 3rd round.
+     *
+     * @param groupId ID of the group.
+     * @param roundNumber Number of the round in its parent group.
+     * @param matchNumber Number of the match in its parent round.
+     */
+    async match(groupId, roundNumber, matchNumber) {
+        return this.findMatch(groupId, roundNumber, matchNumber);
+    }
+    /**
+     * Finds a match game based on its `id` or based on the combination of its `parent_id` and `number`.
+     *
+     * @param game Values to change in a match game.
+     */
+    async matchGame(game) {
+        return this.findMatchGame(game);
+    }
+    /**
+     * Returns an object with 1 match per group type. Only supports double elimination.
+     *
+     * @param matches A list of matches.
+     * @param fetchedGroups A map of groups which were already fetched.
+     */
+    async getMatchesByGroupDoubleElimination(matches, fetchedGroups) {
+        var _a, _b, _c;
+        const getGroup = async (groupId) => {
+            const existing = fetchedGroups.get(groupId);
+            if (existing)
+                return existing;
+            const group = await this.storage.select('group', groupId);
+            if (!group)
+                throw Error('Group not found.');
+            fetchedGroups.set(groupId, group);
+            return group;
+        };
+        let matchByGroupType = {};
+        for (const match of matches) {
+            const group = await getGroup(match.group_id);
+            matchByGroupType = {
+                winnerBracketMatch: (_a = matchByGroupType['winnerBracketMatch']) !== null && _a !== void 0 ? _a : (helpers.isWinnerBracket('double_elimination', group.number)
+                    ? match
+                    : undefined),
+                loserBracketMatch: (_b = matchByGroupType['loserBracketMatch']) !== null && _b !== void 0 ? _b : (helpers.isLoserBracket('double_elimination', group.number)
+                    ? match
+                    : undefined),
+                finalGroupMatch: (_c = matchByGroupType['finalGroupMatch']) !== null && _c !== void 0 ? _c : (helpers.isFinalGroup('double_elimination', group.number)
+                    ? match
+                    : undefined),
+            };
+        }
+        return matchByGroupType;
+    }
+}
+exports.Find = Find;
+//# sourceMappingURL=find.js.map

package/dist/find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../src/find.ts"],"names":[],"mappings":"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"}

package/dist/get.d.ts

@@ -0,0 +1,121 @@
+import { Stage, Round, Match, MatchGame, Id, RankingItem } from 'brackets-model';
+import { FinalStandingsItem, ParticipantSlot, StageData, type RoundRobinFinalStandingsOptions } from './types';
+import { BaseGetter } from './base/getter';
+export declare class Get extends BaseGetter {
+    /**
+     * Returns the data needed to display a stage.
+     *
+     * @param stageId ID of the stage.
+     */
+    stageData(stageId: Id): Promise<StageData>;
+    /**
+     * Returns the data needed to display a whole tournament with all its stages.
+     *
+     * @param tournamentId ID of the tournament.
+     */
+    tournamentData(tournamentId: Id): Promise<StageData>;
+    /**
+     * Returns the match games associated to a list of matches.
+     *
+     * @param matches A list of matches.
+     */
+    matchGames(matches: Match[]): Promise<MatchGame[]>;
+    /**
+     * Returns the stage that is not completed yet, because of uncompleted matches.
+     * If all matches are completed in this tournament, there is no "current stage", so `null` is returned.
+     *
+     * @param tournamentId ID of the tournament.
+     */
+    currentStage(tournamentId: Id): Promise<Stage | null>;
+    /**
+     * Returns the round that is not completed yet, because of uncompleted matches.
+     * If all matches are completed in this stage of a tournament, there is no "current round", so `null` is returned.
+     *
+     * Note: The consolation final of single elimination and the grand final of double elimination will be in a different `Group`.
+     *
+     * @param stageId ID of the stage.
+     * @example
+     * If you don't know the stage id, you can first get the current stage.
+     * ```js
+     * const tournamentId = 3;
+     * const currentStage = await manager.get.currentStage(tournamentId);
+     * const currentRound = await manager.get.currentRound(currentStage.id);
+     * ```
+     */
+    currentRound(stageId: Id): Promise<Round | null>;
+    /**
+     * Returns the matches that can currently be played in parallel.
+     * If the stage doesn't contain any, an empty array is returned.
+     *
+     * Note:
+     * - Returned matches are ongoing (i.e. ready or running).
+     * - Returned matches can be from different rounds.
+     *
+     * @param stageId ID of the stage.
+     * @example
+     * If you don't know the stage id, you can first get the current stage.
+     * ```js
+     * const tournamentId = 3;
+     * const currentStage = await manager.get.currentStage(tournamentId);
+     * const currentMatches = await manager.get.currentMatches(currentStage.id);
+     * ```
+     */
+    currentMatches(stageId: Id): Promise<Match[]>;
+    /**
+     * Returns the seeding of a stage.
+     *
+     * @param stageId ID of the stage.
+     */
+    seeding(stageId: Id): Promise<ParticipantSlot[]>;
+    /**
+     * Returns the final standings of an elimination stage.
+     *
+     * @param stageId ID of the stage.
+     */
+    finalStandings(stageId: Id): Promise<FinalStandingsItem[]>;
+    /**
+     * Returns the final standings of a round-robin stage with a ranking formula.
+     *
+     * @param stageId ID of the stage.
+     * @param rankingFormula The formula to compute the points for the ranking.
+     */
+    finalStandings(stageId: Id, roundRobinOptions: RoundRobinFinalStandingsOptions): Promise<RankingItem[]>;
+    /**
+     * Returns the seeding of a round-robin stage.
+     *
+     * @param stage The stage.
+     */
+    private roundRobinSeeding;
+    /**
+     * Returns the seeding of an elimination stage.
+     *
+     * @param stage The stage.
+     */
+    private eliminationSeeding;
+    /**
+     * Returns the final standings of a round-robin stage.
+     *
+     * @param stage The stage.
+     * @param roundRobinOptions The options for the round-robin standings.
+     */
+    private roundRobinStandings;
+    /**
+     * Returns the final standings of a single elimination stage.
+     *
+     * @param stage The stage.
+     */
+    private singleEliminationStandings;
+    /**
+     * Returns the final standings of a double elimination stage.
+     *
+     * @param stage The stage.
+     */
+    private doubleEliminationStandings;
+    /**
+     * Returns only the data specific to the given stage (without the participants).
+     *
+     * @param stageId ID of the stage.
+     */
+    private getStageSpecificData;
+}
+//# sourceMappingURL=get.d.ts.map

package/dist/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../src/get.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,EAEL,KAAK,EACL,KAAK,EACL,SAAS,EAGT,EAAE,EACF,WAAW,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACH,kBAAkB,EAClB,eAAe,EACf,SAAS,EAET,KAAK,+BAA+B,EACvC,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,qBAAa,GAAI,SAAQ,UAAU;IAC/B;;;;OAIG;IACU,SAAS,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAqBvD;;;;OAIG;IACU,cAAc,CAAC,YAAY,EAAE,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAqCjE;;;;OAIG;IACU,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAc/D;;;;;OAKG;IACU,YAAY,CAAC,YAAY,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAqBlE;;;;;;;;;;;;;;OAcG;IACU,YAAY,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAuB7D;;;;;;;;;;;;;;;;OAgBG;IACU,cAAc,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA2D1D;;;;OAIG;IACU,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAgB7D;;;;OAIG;IACU,cAAc,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IACvE;;;;;OAKG;IACU,cAAc,CACvB,OAAO,EAAE,EAAE,EACX,iBAAiB,EAAE,+BAA+B,GACnD,OAAO,CAAC,WAAW,EAAE,CAAC;IA0CzB;;;;OAIG;YACW,iBAAiB;IAuB/B;;;;OAIG;YACW,kBAAkB;IAgBhC;;;;;OAKG;YACW,mBAAmB;IAkCjC;;;;OAIG;YACW,0BAA0B;IAgExC;;;;OAIG;YACW,0BAA0B;IA+ExC;;;;OAIG;YACW,oBAAoB;CA8BrC"}