volleyballsimtypes 0.0.356 → 0.0.358

package/dist/cjs/src/service/utils/rng-utils.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shuffle = shuffle;
+exports.calculateProbability = calculateProbability;
+exports.createUniqueRandomPicker = createUniqueRandomPicker;
+const number_utils_1 = require("./number-utils");
+/**
+ * Fisher-Yates shuffle algorithm
+ * Shuffles array IN-PLACE
+ * @param {any[]} array
+ */
+function shuffle(array) {
+    let m = array.length;
+    let t;
+    let i;
+    // While there remain elements to shuffle…
+    while (m > 0) {
+        // Pick a remaining element…
+        i = Math.floor(Math.random() * m--);
+        // And swap it with the current element.
+        t = array[m];
+        array[m] = array[i];
+        array[i] = t;
+    }
+    return array;
+}
+function calculateProbability(score, scale, minP, maxP) {
+    const x = score / scale;
+    const sigmoid = 1 / (1 + Math.exp(-x));
+    const p = minP + (maxP - minP) * sigmoid;
+    return (0, number_utils_1.clamp)(0, 1, p);
+}
+function createUniqueRandomPicker(min, max, rng = Math.random) {
+    if (!Number.isInteger(min) || !Number.isInteger(max) || min > max) {
+        throw new Error('Invalid range');
+    }
+    let pool = [];
+    function refill() {
+        pool = [];
+        for (let i = min; i <= max; i++)
+            pool.push(i);
+        // Fisher–Yates shuffle
+        for (let i = pool.length - 1; i > 0; i--) {
+            const j = Math.floor(rng() * (i + 1));
+            [pool[i], pool[j]] = [pool[j], pool[i]];
+        }
+    }
+    refill();
+    return {
+        next() {
+            const aux = pool.pop();
+            if (aux == null)
+                return NaN;
+            return aux;
+        },
+        reset() {
+            refill();
+        }
+    };
+}

package/dist/cjs/src/service/utils/rng-utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/src/service/utils/rng-utils.test.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const rng_utils_1 = require("./rng-utils");
+// ─── shuffle ─────────────────────────────────────────────────────────────────
+(0, globals_1.describe)('shuffle()', () => {
+    (0, globals_1.it)('returns the same array reference (in-place)', () => {
+        const arr = [1, 2, 3, 4, 5];
+        (0, globals_1.expect)((0, rng_utils_1.shuffle)(arr)).toBe(arr);
+    });
+    (0, globals_1.it)('preserves all elements', () => {
+        const original = [1, 2, 3, 4, 5];
+        const result = (0, rng_utils_1.shuffle)([...original]);
+        (0, globals_1.expect)(result.sort((a, b) => a - b)).toEqual(original);
+    });
+    (0, globals_1.it)('handles an empty array', () => {
+        (0, globals_1.expect)((0, rng_utils_1.shuffle)([])).toEqual([]);
+    });
+    (0, globals_1.it)('handles a single-element array', () => {
+        (0, globals_1.expect)((0, rng_utils_1.shuffle)([42])).toEqual([42]);
+    });
+    (0, globals_1.it)('works with string elements', () => {
+        const original = ['a', 'b', 'c', 'd'];
+        const result = (0, rng_utils_1.shuffle)([...original]);
+        (0, globals_1.expect)(result.sort()).toEqual(original.sort());
+    });
+});
+// ─── calculateProbability ────────────────────────────────────────────────────
+(0, globals_1.describe)('calculateProbability()', () => {
+    (0, globals_1.it)('returns 0.5 when score is 0 over full [0, 1] range', () => {
+        (0, globals_1.expect)((0, rng_utils_1.calculateProbability)(0, 100, 0, 1)).toBeCloseTo(0.5, 5);
+    });
+    (0, globals_1.it)('always returns a value within [0, 1]', () => {
+        for (const score of [-1000, -100, -10, 0, 10, 100, 1000]) {
+            const p = (0, rng_utils_1.calculateProbability)(score, 50, 0, 1);
+            (0, globals_1.expect)(p).toBeGreaterThanOrEqual(0);
+            (0, globals_1.expect)(p).toBeLessThanOrEqual(1);
+        }
+    });
+    (0, globals_1.it)('clamps to maxP for very high scores', () => {
+        (0, globals_1.expect)((0, rng_utils_1.calculateProbability)(1e9, 1, 0.1, 0.9)).toBeCloseTo(0.9, 5);
+    });
+    (0, globals_1.it)('clamps to minP for very negative scores', () => {
+        (0, globals_1.expect)((0, rng_utils_1.calculateProbability)(-1e9, 1, 0.1, 0.9)).toBeCloseTo(0.1, 5);
+    });
+    (0, globals_1.it)('returns a higher probability for a higher score (monotone)', () => {
+        const p1 = (0, rng_utils_1.calculateProbability)(10, 100, 0, 1);
+        const p2 = (0, rng_utils_1.calculateProbability)(50, 100, 0, 1);
+        (0, globals_1.expect)(p2).toBeGreaterThan(p1);
+    });
+});
+// ─── createUniqueRandomPicker ────────────────────────────────────────────────
+(0, globals_1.describe)('createUniqueRandomPicker()', () => {
+    (0, globals_1.it)('throws when min > max', () => {
+        (0, globals_1.expect)(() => (0, rng_utils_1.createUniqueRandomPicker)(5, 3)).toThrow('Invalid range');
+    });
+    (0, globals_1.it)('throws for non-integer min', () => {
+        (0, globals_1.expect)(() => (0, rng_utils_1.createUniqueRandomPicker)(0.5, 3)).toThrow('Invalid range');
+    });
+    (0, globals_1.it)('throws for non-integer max', () => {
+        (0, globals_1.expect)(() => (0, rng_utils_1.createUniqueRandomPicker)(0, 2.5)).toThrow('Invalid range');
+    });
+    (0, globals_1.it)('yields each number in [min, max] exactly once per cycle', () => {
+        const picker = (0, rng_utils_1.createUniqueRandomPicker)(1, 5);
+        const results = [];
+        for (let i = 0; i < 5; i++)
+            results.push(picker.next());
+        (0, globals_1.expect)(results.sort((a, b) => a - b)).toEqual([1, 2, 3, 4, 5]);
+    });
+    (0, globals_1.it)('returns NaN after exhausting the pool before reset', () => {
+        const picker = (0, rng_utils_1.createUniqueRandomPicker)(1, 2);
+        picker.next();
+        picker.next();
+        (0, globals_1.expect)(picker.next()).toBeNaN();
+    });
+    (0, globals_1.it)('replenishes the full pool after reset()', () => {
+        const picker = (0, rng_utils_1.createUniqueRandomPicker)(1, 3);
+        for (let i = 0; i < 3; i++)
+            picker.next();
+        picker.reset();
+        const results = [];
+        for (let i = 0; i < 3; i++)
+            results.push(picker.next());
+        (0, globals_1.expect)(results.sort((a, b) => a - b)).toEqual([1, 2, 3]);
+    });
+    (0, globals_1.it)('works for a single-value range', () => {
+        const picker = (0, rng_utils_1.createUniqueRandomPicker)(7, 7);
+        (0, globals_1.expect)(picker.next()).toBe(7);
+        (0, globals_1.expect)(picker.next()).toBeNaN();
+    });
+    (0, globals_1.it)('accepts min === 0', () => {
+        const picker = (0, rng_utils_1.createUniqueRandomPicker)(0, 2);
+        const results = [picker.next(), picker.next(), picker.next()];
+        (0, globals_1.expect)(results.sort((a, b) => a - b)).toEqual([0, 1, 2]);
+    });
+    (0, globals_1.it)('uses a custom rng deterministically', () => {
+        // rng always returns 0 → j=0 in every Fisher-Yates step → pool reversed
+        const picker = (0, rng_utils_1.createUniqueRandomPicker)(0, 2, () => 0);
+        const results = [picker.next(), picker.next(), picker.next()];
+        (0, globals_1.expect)(results.sort((a, b) => a - b)).toEqual([0, 1, 2]);
+    });
+});

package/dist/cjs/src/stat-config/index.d.ts

@@ -0,0 +1,4 @@
+import rolesJSON from './roles.json';
+import traitsJSON from './traits.json';
+import statCapsJSON from './stat-caps.json';
+export { rolesJSON, traitsJSON, statCapsJSON };

package/dist/cjs/src/stat-config/index.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statCapsJSON = exports.traitsJSON = exports.rolesJSON = void 0;
+const roles_json_1 = __importDefault(require("./roles.json"));
+exports.rolesJSON = roles_json_1.default;
+const traits_json_1 = __importDefault(require("./traits.json"));
+exports.traitsJSON = traits_json_1.default;
+const stat_caps_json_1 = __importDefault(require("./stat-caps.json"));
+exports.statCapsJSON = stat_caps_json_1.default;

package/dist/cjs/src/stat-config/roles.json

@@ -0,0 +1,117 @@
+[
+    {
+        "role": "SETTER",
+        "weight": {
+            "serve": 0.2,
+            "stamina": 0.05,
+            "setting": 0.7,
+            "block": 0.05,
+            "spike": 0,
+            "quick": 0,
+            "power": 0,
+            "backAttack": 0,
+            "awareness": 0,
+            "attack": 0,
+            "reception": 0,
+            "overhand": 0,
+            "bump": 0,
+            "read": 0,
+            "commit": 0,
+            "focus": 0,
+            "defense": 0,
+            "reflex": 0
+        }
+    },
+    {
+        "role": "LIBERO",
+        "weight": {
+            "spike": 0,
+            "quick": 0,
+            "power": 0,
+            "backAttack": 0,
+            "awareness": 0,
+            "attack": 0,
+            "serve": 0,
+            "stamina": 0.15,
+            "setting": 0.15,
+            "reception": 0.7,
+            "overhand": 0,
+            "bump": 0,
+            "block": 0,
+            "read": 0,
+            "commit": 0,
+            "focus": 0,
+            "defense": 0,
+            "reflex": 0
+        }
+    },
+    {
+        "role": "OUTSIDE_HITTER",
+        "weight": {
+            "spike": 0.3,
+            "quick": 0,
+            "power": 0,
+            "backAttack": 0.1,
+            "awareness": 0,
+            "attack": 0,
+            "serve": 0.1,
+            "stamina": 0.1,
+            "setting": 0,
+            "reception": 0.2,
+            "overhand": 0,
+            "bump": 0,
+            "block": 0.2,
+            "read": 0,
+            "commit": 0,
+            "focus": 0,
+            "defense": 0,
+            "reflex": 0
+        }
+    },
+    {
+        "role": "OPPOSITE_HITTER",
+        "weight": {
+            "spike": 0.6,
+            "quick": 0,
+            "power": 0,
+            "backAttack": 0.2,
+            "awareness": 0,
+            "attack": 0,
+            "serve": 0.15,
+            "stamina": 0.05,
+            "setting": 0,
+            "reception": 0,
+            "overhand": 0,
+            "bump": 0,
+            "block": 0,
+            "read": 0,
+            "commit": 0,
+            "focus": 0,
+            "defense": 0,
+            "reflex": 0
+        }
+    },
+    {
+        "role": "MIDDLE_BLOCKER",
+        "weight": {
+            "spike": 0.2,
+            "quick": 0,
+            "power": 0,
+            "backAttack": 0,
+            "awareness": 0,
+            "attack": 0,
+            "serve": 0,
+            "stamina": 0.1,
+            "setting": 0,
+            "reception": 0,
+            "overhand": 0,
+            "bump": 0,
+            "block": 0.7,
+            "read": 0,
+            "commit": 0,
+            "focus": 0,
+            "defense": 0,
+            "reflex": 0
+        }
+    }
+]

package/dist/cjs/src/stat-config/stat-caps.json

@@ -0,0 +1,7 @@
+[
+    { "rarity": "COMMON", "cap": 59, "rarityMultiplier": 1.0 },
+    { "rarity": "RARE", "cap": 69, "rarityMultiplier": 1.15 },
+    { "rarity": "LEGENDARY", "cap": 79, "rarityMultiplier": 1.3 },
+    { "rarity": "MYTHIC", "cap": 89, "rarityMultiplier": 1.5 },
+    { "rarity": "SPECIAL", "cap": 99, "rarityMultiplier": 1.75 }
+]

package/dist/cjs/src/stat-config/traits.json

@@ -0,0 +1,94 @@
+[
+    {
+        "name": "MASTER_MIND",
+        "modifier": 1.1,
+        "chance": 0.2,
+        "roles": [
+            "SETTER",
+            "LIBERO"
+        ]
+    },
+    {
+        "name": "SURPRISE_ATTACK",
+        "modifier": 1.2,
+        "chance": 0.07,
+        "roles": [
+            "SETTER",
+            "OPPOSITE_HITTER"
+        ]
+    },
+    {
+        "name": "MOVING_WALL",
+        "modifier": 1.1,
+        "chance": 0.5,
+        "roles": [
+            "MIDDLE_BLOCKER",
+            "OPPOSITE_HITTER",
+            "SETTER"
+        ]
+    },
+    {
+        "name": "MARKSMAN",
+        "modifier": 1.05,
+        "chance": 0.5,
+        "roles": [
+            "SETTER",
+            "OPPOSITE_HITTER",
+            "OUTSIDE_HITTER",
+            "MIDDLE_BLOCKER"
+        ]
+    },
+    {
+        "name": "METEOR_SERVE",
+        "modifier": 1.2,
+        "chance": 0.5,
+        "roles": [
+            "SETTER",
+            "OPPOSITE_HITTER",
+            "OUTSIDE_HITTER",
+            "MIDDLE_BLOCKER"
+        ]
+    },
+    {
+        "name": "FLOAT_SERVE",
+        "modifier": 1.2,
+        "chance": 0.5,
+        "roles": [
+            "SETTER",
+            "OPPOSITE_HITTER",
+            "LIBERO",
+            "OUTSIDE_HITTER",
+            "MIDDLE_BLOCKER"
+        ]
+    },
+    {
+        "name": "VIGOROUS",
+        "modifier": 1,
+        "chance": 0.5,
+        "roles": [
+            "SETTER",
+            "OPPOSITE_HITTER",
+            "LIBERO",
+            "OUTSIDE_HITTER",
+            "MIDDLE_BLOCKER"
+        ]
+    },
+    {
+        "name": "GUARDIAN",
+        "chance": 0.2,
+        "modifier": 1.05,
+        "roles": [
+            "LIBERO",
+            "OUTSIDE_HITTER"
+        ]
+    },
+    {
+        "name": "DEFENSIVE_SPECIALIST",
+        "chance": 0.2,
+        "modifier": 1.2,
+        "roles": [
+            "LIBERO",
+            "OUTSIDE_HITTER"
+        ]
+    }
+]

package/dist/esm/src/api/index.d.ts

@@ -0,0 +1,127 @@
+import { BoxScore, DataProps, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, Country as _Country, CourtPosition } from '../service';
+export type Rally = DataProps<_Rally> & {
+    homePlayerPosition: PlayerPosition[];
+    awayPlayerPosition: PlayerPosition[];
+    events: RallyEvent[];
+};
+export type MatchSet = Omit<DataProps<_MatchSet>, 'rallies' | '_homeScore' | '_awayScore' | 'homeScore' | 'awayScore'> & {
+    homeLibero?: Player;
+    awayLibero?: Player;
+    rallies: Rally[];
+    homeScore: number;
+    awayScore: number;
+};
+export interface Results {
+    home: number[];
+    away: number[];
+}
+export type Match = Omit<DataProps<_Match>, 'sets' | 'homeTeam' | 'awayTeam' | 'VPERs'> & {
+    sets: MatchSet[];
+    boxScores: BoxScore[];
+    VPERs: VPER[];
+    homeTeam: Team;
+    awayTeam: Team;
+    season?: Season;
+    tournament?: Tournament;
+    qualifier?: Qualifier;
+    results?: Results;
+};
+export type RallyEvent = DataProps<_RallyEvent> & {
+    team?: Team;
+};
+export type Player = DataProps<_Player> & {
+    teamId: string;
+    jerseyNumber: number;
+    locked: boolean;
+};
+export interface StartingLineup {
+    [CourtPosition.LEFT_FRONT]: string;
+    [CourtPosition.MIDDLE_FRONT]: string;
+    [CourtPosition.RIGHT_FRONT]: string;
+    [CourtPosition.LEFT_BACK]: string;
+    [CourtPosition.MIDDLE_BACK]: string;
+    [CourtPosition.RIGHT_BACK]: string;
+    [CourtPosition.LIBERO_ZONE]?: string;
+    bench: string[];
+}
+export interface Tactics {
+    lineup: StartingLineup;
+    substitutionTolerance: number;
+    liberoReplacements: string[];
+    pinchServerSubs: Record<string, string>;
+}
+export type Team = Omit<DataProps<_Team>, 'roster' | '_rating' | 'rating' | 'tactics'> & {
+    roster: Player[];
+    rating: {
+        value: number;
+        lastChange?: number;
+    };
+    tactics?: Tactics;
+    leagueData?: {
+        division: {
+            tier: number;
+            subdivision: number;
+            name: string;
+        };
+        league: {
+            leagueId: string;
+            name: string;
+        };
+    };
+};
+export type Standing = DataProps<_Standing> & {
+    position: number;
+    iteration: number;
+};
+export type Season = Omit<DataProps<_Season>, 'teams' | 'matches' | 'champion' | 'standings'> & {
+    teams: Team[];
+    matches: Match[];
+    champion?: Team;
+    league?: _League;
+    standings: Standing[];
+};
+export type Division = Omit<DataProps<_Division>, 'seasons' | 'teams'> & {
+    teams: Team[];
+    seasons: Season[];
+};
+export type League = Omit<DataProps<_League>, 'divisions'> & {
+    divisions: Division[];
+};
+export type TournamentMatch = Omit<DataProps<_TournamentMatch>, 'match'> & {
+    match: Match;
+};
+export type Tournament = Omit<DataProps<_Tournament>, 'matches'> & {
+    matches: TournamentMatch[];
+};
+export type QualifierMatch = Omit<DataProps<_QualifierMatch>, 'match'> & {
+    match: Match;
+};
+export type Qualifier = Omit<DataProps<_Qualifier>, 'matches'> & {
+    matches: QualifierMatch[];
+};
+export interface VPER {
+    playerId: string;
+    value: number;
+}
+export type Country = Omit<DataProps<_Country>, 'league'> & {
+    league?: League;
+};
+export interface MVP {
+    totalVPER: number;
+    pointsPlayed: number;
+    avgVPER: number;
+    teamId: string;
+    player: Player;
+}
+export type TotalBoxScore = Omit<DataProps<BoxScore>, 'misc' | 'playerId' | 'matchSetId'> & {
+    player: Player;
+    misc: {
+        pointsPlayed: number;
+        pointsWonOnCourt: number;
+        serveTurns: number;
+        sideoutOpportunities: number;
+        successfulSideouts: number;
+        setsPlayed: number;
+        matchesPlayed: number;
+    };
+};

package/dist/esm/src/api/index.js

@@ -0,0 +1 @@
+import { CourtPosition } from '../service';

package/dist/esm/src/data/common/auth-admin.d.ts

@@ -0,0 +1,7 @@
+import { Sequelize, Transaction } from 'sequelize';
+export interface EnsureAdminUserResult {
+    userId: string;
+    createdUser: boolean;
+    createdIdentity: boolean;
+}
+export declare function ensureDefaultAdminUser(sequelize: Sequelize, transaction?: Transaction): Promise<EnsureAdminUserResult>;