@mshowes/brackets-manager 1.8.4 → 1.8.6

package/dist/core/create.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Create = void 0;
+const creator_1 = require("./base/stage/creator");
+const uuid_1 = require("uuid");
+/**
+ * Generates a URL-friendly slug from a string.
+ *
+ * @param text The text to convert to a slug.
+ * @returns A lowercase, hyphenated slug.
+ */
+function generateSlug(text) {
+    return text
+        .toLowerCase()
+        .trim()
+        .replace(/[^\w\s-]/g, '') // Remove special characters except spaces and hyphens
+        .replace(/\s+/g, '-') // Replace spaces with hyphens
+        .replace(/-+/g, '-') // Replace multiple hyphens with single hyphen
+        .replace(/^-+|-+$/g, ''); // Remove leading/trailing hyphens
+}
+class Create {
+    /**
+     * Creates an instance of Create.
+     *
+     * @param storage The implementation of Storage.
+     */
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Creates a tournament with an auto-created stage and group.
+     *
+     * @param data The tournament to create.
+     * @returns The created tournament, stage, and group.
+     */
+    async tournament(data) {
+        var _a;
+        const id = (0, uuid_1.v4)();
+        const slug = data.slug || generateSlug(data.name);
+        /* eslint-disable @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-argument */
+        const tournamentData = {
+            name: data.name,
+            slug,
+            description: (_a = data.description) !== null && _a !== void 0 ? _a : null,
+            start_date: data.start_date ? new Date(data.start_date) : null,
+            end_date: data.end_date ? new Date(data.end_date) : null,
+            extra: data.extra,
+        };
+        /* eslint-enable @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-argument */
+        // The storage layer handles ID generation for tournaments (using text IDs)
+        // We pass the id along with the data for storage implementations that require it
+        const insertData = { id, ...tournamentData };
+        // Storage insert returns number | boolean | string depending on implementation
+        const insertedId = (await this.storage.insert('tournament', insertData));
+        if (insertedId === -1 || insertedId === false || insertedId === '')
+            throw Error('Could not insert the tournament in the database.');
+        // For string IDs, the insertedId might be the generated id or a number
+        const finalId = typeof insertedId === 'string' ? insertedId : id;
+        const tournament = { id: finalId, ...tournamentData };
+        // Auto-create a stage for this tournament
+        const stage = await this.createDefaultStage(tournament.id);
+        // Auto-create a group within the stage
+        const group = await this.createDefaultGroup(stage.id);
+        return { tournament, stage, group };
+    }
+    /**
+     * Creates a default stage for a tournament.
+     *
+     * @param tournamentId The tournament ID.
+     * @returns The created stage.
+     */
+    async createDefaultStage(tournamentId) {
+        const id = (0, uuid_1.v4)();
+        const stageData = {
+            tournament_id: tournamentId,
+            name: 'Bracket',
+            type: 'double_elimination',
+            number: 1,
+            settings: {
+                size: 2,
+                grandFinal: 'none',
+            },
+        };
+        const insertData = { id, ...stageData };
+        const insertedId = (await this.storage.insert('stage', insertData));
+        if (insertedId === -1 || insertedId === false || insertedId === '')
+            throw Error('Could not insert the default stage in the database.');
+        const finalId = typeof insertedId === 'string' ? insertedId : id;
+        return { id: finalId, ...stageData };
+    }
+    /**
+     * Creates a default group for a stage.
+     *
+     * @param stageId The stage ID.
+     * @returns The created group.
+     */
+    async createDefaultGroup(stageId) {
+        const id = (0, uuid_1.v4)();
+        const groupData = {
+            stage_id: stageId,
+            number: 1,
+        };
+        const insertData = { id, ...groupData };
+        const insertedId = (await this.storage.insert('group', insertData));
+        if (insertedId === -1 || insertedId === false || insertedId === '')
+            throw Error('Could not insert the default group in the database.');
+        const finalId = typeof insertedId === 'string' ? insertedId : id;
+        return { id: finalId, ...groupData };
+    }
+    /**
+     * Creates a stage for an existing tournament. The tournament won't be created.
+     *
+     * @param data The stage to create.
+     */
+    async stage(data) {
+        const creator = new creator_1.StageCreator(this.storage, data);
+        return creator.run();
+    }
+}
+exports.Create = Create;
+//# sourceMappingURL=create.js.map

package/dist/core/create.js.map

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

package/dist/core/delete.d.ts

@@ -0,0 +1,43 @@
+import { Id } from '@/model';
+import { Storage } from './types';
+export declare class Delete {
+    private readonly storage;
+    /**
+     * Creates an instance of Delete, which will handle cleanly deleting data in the storage.
+     *
+     * @param storage The implementation of Storage.
+     */
+    constructor(storage: Storage);
+    /**
+     * Deletes a tournament and all its components:
+     *
+     * - Stages (and their groups, rounds, matches, match games)
+     * - Participants
+     * - The tournament itself
+     *
+     * @param tournamentId ID of the tournament.
+     */
+    tournament(tournamentId: Id): Promise<void>;
+    /**
+     * Deletes **only the stages** of a tournament (and all their components, see {@link stage | delete.stage()}).
+     *
+     * This does not delete the related participants or the tournament itself.
+     *
+     * @param tournamentId ID of the tournament.
+     */
+    tournamentStages(tournamentId: Id): Promise<void>;
+    /**
+     * 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.
+     */
+    stage(stageId: Id): Promise<void>;
+}
+//# sourceMappingURL=delete.d.ts.map

package/dist/core/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/core/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,qBAAa,MAAM;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC;;;;OAIG;gBACS,OAAO,EAAE,OAAO;IAI5B;;;;;;;;OAQG;IACU,UAAU,CAAC,YAAY,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxD;;;;;;OAMG;IACU,gBAAgB,CAAC,YAAY,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9D;;;;;;;;;;;OAWG;IACU,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBjD"}

package/dist/core/delete.js

@@ -0,0 +1,78 @@
+"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 tournament and all its components:
+     *
+     * - Stages (and their groups, rounds, matches, match games)
+     * - Participants
+     * - The tournament itself
+     *
+     * @param tournamentId ID of the tournament.
+     */
+    async tournament(tournamentId) {
+        // First, delete all stages and their components
+        await this.tournamentStages(tournamentId);
+        // Delete participants
+        if (!(await this.storage.delete('participant', {
+            tournament_id: tournamentId,
+        })))
+            throw Error('Could not delete participants.');
+        // Finally, delete the tournament itself
+        if (!(await this.storage.delete('tournament', { id: tournamentId })))
+            throw Error('Could not delete the tournament.');
+    }
+    /**
+     * Deletes **only the stages** of a tournament (and all their components, see {@link stage | delete.stage()}).
+     *
+     * This does not delete the related participants or the tournament itself.
+     *
+     * @param tournamentId ID of the tournament.
+     */
+    async tournamentStages(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);
+    }
+    /**
+     * 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.');
+    }
+}
+exports.Delete = Delete;
+//# sourceMappingURL=delete.js.map

package/dist/core/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/core/delete.ts"],"names":[],"mappings":";;;AAGA,MAAa,MAAM;IAGf;;;;OAIG;IACH,YAAY,OAAgB;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED;;;;;;;;OAQG;IACI,KAAK,CAAC,UAAU,CAAC,YAAgB;QACpC,gDAAgD;QAChD,MAAM,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAE1C,sBAAsB;QACtB,IACI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE;YACvC,aAAa,EAAE,YAAY;SAC9B,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAElD,wCAAwC;QACxC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;YAChE,MAAM,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,gBAAgB,CAAC,YAAgB;QAC1C,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;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;CACJ;AArFD,wBAqFC"}

package/dist/core/find.d.ts

@@ -0,0 +1,60 @@
+import { Group, Id, Match, MatchGame } from '@/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/core/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/core/find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACtD,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/core/find.js

@@ -0,0 +1,219 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Find = void 0;
+const getter_1 = require("./base/getter");
+const helpers = __importStar(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/core/find.js.map

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