bb-api-platforma 0.1.191 → 0.1.205

package/dist/BetBoosterApi.js

@@ -61,6 +61,7 @@ const languageIdsRemote = {
 //   cr: 6,
 //   ru: 0,
 // }
+const MAX_TIME_EXECUTION_MS = 25000;
 const stringify = (obj) => {
     return JSON.stringify(obj, null, 2);
 };
@@ -109,11 +110,25 @@ export class BetBoosterApi {
         this.LANG_DEFAULT = 'en';
         this.LOCALE_DEFAULT = 'en-EN';
         this.LANG_ID_DEFAULT = 1;
-        this.maxTimeExecutionMs = 15000;
+        this.maxTimeExecutionMs = MAX_TIME_EXECUTION_MS;
         this.liveTimestamp = 0;
         this._liveTimestampReset = false;
         this.liveRecivedIsFullPackage = false;
         this.isNotActive = false;
+        /** Приоритетные виды спорта для сортировки и отображения на странице [VidSportaRating]*/
+        this.primarySports = [5, 1, 3, 4, 8, 6, 263, 265, 2, 16, 17, 18];
+        /** Приоритетные страны по видам спорта для сортировки и отображения */
+        this.priorityCountries = {
+            "1": [14, 8, 54],
+            "5": [8, 14, 1, 2, 5, 4, 3, 43, 44, 42, 11, 54],
+            "6": [14, 8, 54],
+            "8": [8, 14, 54],
+            "27": [45, 187],
+        };
+        /** Приоритетные турниры по видам спорта*/
+        this.priorityTournaments = {
+            "5": [201, 361, 199, 410, 200, 423, 1141, 1142, 47, 2408, 1688, 2511, 129, 193, 919, 1693, 1134, 2157, 147, 212, 1, 185, 2, 2379, 286, 1216, 99, 1266, 4, 290, 735, 1059, 1100, 1268, 5, 292, 1210, 1366, 700, 1217, 3, 186, 2209, 2431, 288, 1410, 6, 540, 1062, 1223, 1061, 1237, 40, 1235, 2230, 2370, 209, 1278, 470, 1373, 35, 1386, 2229, 2373, 737, 1383, 1412, 1857, 1505, 1858, 11, 1853, 2231, 742, 1382, 49, 1236, 1060, 2364, 624, 15, 1896, 1409, 1493, 1918, 1925, 2283, 1612, 86, 149, 2337, 8, 1213, 19, 1387],
+        };
         // const uri = new URL(baseUrl)
         IS_DEV_MODE = isDev;
         // this._ENDPOINT_DOMAIN = uri.origin;
@@ -465,6 +480,89 @@ export class BetBoosterApi {
             // return `${this._baseUrl}${this._APIv1}${apiPath}`
         }
     }
+    /**
+     * Сортирует данные по приоритету, указанному в массиве priorityIDs.
+     *
+     * @template T - Тип объектов в массиве данных
+     * @param {Array<T>} data - Массив объектов данных для сортировки.
+     * @param {Array<number|string>} priorityIDs - Массив приоритетных ID для сортировки.
+     * @param {keyof T} sortField - Поле объекта, по которому будет производиться сортировка.
+     * @returns {Array<T>} - Новый массив отсортированных данных.
+     *
+     * @example
+     * ```typescript
+     * interface Tournament {
+     *   Id: number;
+     *   Name: string;
+     *   SportID: number;
+     * }
+     *
+     * const tournaments: Tournament[] = [
+     *   { Id: 1, Name: 'Premier League', SportID: 5 },
+     *   { Id: 2, Name: 'La Liga', SportID: 5 },
+     *   { Id: 3, Name: 'Serie A', SportID: 5 }
+     * ];
+     *
+     * const sortedTournaments = api.sortDataByPriority(
+     *   tournaments,
+     *   [3, 1, 2],
+     *   'Id'
+     * );
+     * // Result: [Serie A, Premier League, La Liga]
+     * ```
+     */
+    sortDataByPriority(data, priorityIDs, sortField) {
+        const priorityIndex = new Map();
+        // Создаем объект для быстрого доступа к индексам приоритетных ID
+        priorityIDs.forEach((id, index) => {
+            priorityIndex.set(id, index);
+        });
+        // Сортируем данные, используя объект индексов приоритетов
+        return data.slice().sort((a, b) => {
+            const aPriority = priorityIndex.has(a[sortField])
+                ? priorityIndex.get(a[sortField])
+                : Infinity;
+            const bPriority = priorityIndex.has(b[sortField])
+                ? priorityIndex.get(b[sortField])
+                : Infinity;
+            return aPriority - bPriority;
+        });
+    }
+    /**
+     * Сортирует массив значений по приоритету, указанному в массиве priorityIDs.
+     *
+     * @template T - Тип элементов массива (number | string)
+     * @param {Array<T>} array - Массив значений для сортировки.
+     * @param {Array<T>} priorityIDs - Массив приоритетных ID для сортировки.
+     * @returns {Array<T>} - Новый массив отсортированных значений.
+     *
+     * @example
+     * ```typescript
+     * const sportIds = [1, 5, 3, 8, 2];
+     * const prioritySports = [5, 1, 3];
+     *
+     * const sortedSports = api.sortArrayByPriority(sportIds, prioritySports);
+     * // Result: [5, 1, 3, 8, 2]
+     * // Elements 5, 1, 3 are sorted by priority, others remain in original order
+     * ```
+     */
+    sortArrayByPriority(array, priorityIDs) {
+        const priorityIndex = new Map();
+        // Создаем объект для быстрого доступа к индексам приоритетных ID
+        priorityIDs.forEach((id, index) => {
+            priorityIndex.set(id, index);
+        });
+        // Сортируем массив, используя объект индексов приоритетов
+        return array.slice().sort((a, b) => {
+            const aPriority = priorityIndex.has(a)
+                ? priorityIndex.get(a)
+                : Infinity;
+            const bPriority = priorityIndex.has(b)
+                ? priorityIndex.get(b)
+                : Infinity;
+            return aPriority - bPriority;
+        });
+    }
     // #endregion Handlers --------------------------------------------------------------------
     // #region AXIOS --------------------------------------------------------------------------
     /**
@@ -528,19 +626,48 @@ export class BetBoosterApi {
             ;
         };
         const now = Date.now() + Math.random();
-        let abortController = new AbortController();
-        let signal = setTimeout(() => {
-            abortController.abort();
-        }, this.maxTimeExecutionMs);
+        /**
+         * Создает локальный AbortController с автоматическим таймаутом.
+         *
+         * @param customTimeout - Пользовательский таймаут в миллисекундах. Если не указан, используется значение по умолчанию.
+         * @returns Объект с сигналом AbortSignal для отмены запроса.
+         *
+         * @example
+         * ```typescript
+         * const { signal } = setupLocalAbortController(5000);
+         * const response = await fetch(url, { signal });
+         * ```
+         */
+        const setupLocalAbortController = (customTimeout) => {
+            var _a;
+            const timeout = (_a = customTimeout !== null && customTimeout !== void 0 ? customTimeout : this.maxTimeExecutionMs) !== null && _a !== void 0 ? _a : MAX_TIME_EXECUTION_MS;
+            // const abortControllerTimeout = (timeout * this.maxRetryGotRequests) + 1000;
+            const localAbortController = new AbortController();
+            const signalTimeout = setTimeout(() => {
+                if (!localAbortController.signal.aborted) {
+                    localAbortController.abort();
+                }
+            }, timeout);
+            const originalClearSignal = () => clearTimeout(signalTimeout);
+            localAbortController.signal.addEventListener('abort', () => {
+                clearTimeout(signalTimeout);
+            }, { once: true });
+            return {
+                signal: localAbortController.signal,
+                clearSignal: originalClearSignal,
+                get isAborted() { return localAbortController.signal.aborted; },
+            };
+        };
+        let { signal, clearSignal } = setupLocalAbortController(this.maxTimeExecutionMs);
         const requestConfig = {
             url,
             method: 'GET',
             params: { _: now },
             headers: Object.assign({}, (this.token ? { 'X-Token': this.token } : {})),
             responseType: 'json',
-            timeout: this.maxTimeExecutionMs,
+            // timeout: this.maxTimeExecutionMs, // убираем, потому, что есть signal
             timeoutErrorMessage: `Request timed out after ${this.maxTimeExecutionMs} ms`,
-            signal: abortController.signal,
+            signal: signal,
         };
         return {
             /**
@@ -566,15 +693,12 @@ export class BetBoosterApi {
                 delete requestConfig.headers;
                 return this;
             },
-            setTimeout(timeout = 15000) {
-                clearTimeout(signal);
-                abortController = new AbortController();
-                signal = setTimeout(() => {
-                    abortController.abort();
-                }, timeout);
-                requestConfig.timeout = timeout;
+            setTimeout(timeout = MAX_TIME_EXECUTION_MS) {
+                clearSignal(); // Очищаем signal потому, что переназначаем его.
+                ({ signal, clearSignal } = setupLocalAbortController(timeout));
+                // requestConfig.timeout = timeout; // убираем, потому, что есть signal
                 requestConfig.timeoutErrorMessage = `Request timed out after ${timeout} ms`;
-                requestConfig.signal = abortController.signal;
+                requestConfig.signal = signal;
                 requestConfig.withXSRFToken = true;
                 return this;
             },
@@ -634,7 +758,7 @@ export class BetBoosterApi {
                     return response;
                 })
                     .catch(axiosErrorHandler)
-                    .finally(() => clearTimeout(signal));
+                    .finally(() => clearSignal());
                 const { data, status, statusText } = await response;
                 statusHandler(status, statusText);
                 return { data, status, statusText };
@@ -753,6 +877,7 @@ export class BetBoosterApi {
      *
      * @param minutes The number of minutes to consider for the data retrieval. Defaults to 0.
      * @returns {Promise<Array<any>>} A promise that resolves to an array of line sports data.
+     * @deprecated - use this.getLineSportsMain();
      */
     async getLineSports(minutes = 0) {
         var _a;
@@ -781,6 +906,7 @@ export class BetBoosterApi {
      * @param sportId - Идентификатор спорта.
      * @param minutes - Опциональный параметр, количество минут.
      * @returns Промис, который разрешается в массив объектов типа ICountry.
+     * @deprecated - use this.getCountriesListMain();
      */
     async getCountriesList(sportId, minutes = 0) {
         var _a;
@@ -794,6 +920,7 @@ export class BetBoosterApi {
      * @param countryId - The ID of the country.
      * @param minutes - The number of minutes ago for which data is to be retrieved.
      * @returns A promise that resolves to an array of prematch tournaments.
+     * @deprecated - use this.getPrematchTournamentsMain();
      */
     async getPrematchTournaments(sportId, countryId, minutes = 0) {
         var _a;
@@ -2420,6 +2547,201 @@ export class BetBoosterApi {
         rawData.size = payload.LIMIT.size;
         return this.responseHandlerData(rawData, status, statusText);
     }
+    /**
+     * Retrieves aggregated dictionary data from Redis using FT.AGGREGATE command.
+     * Groups and counts items by specified dictionary type (sport, country, or tournament).
+     *
+     * @param payload - The search parameters for dictionary aggregation
+     * @param payload.locale - Language locale code for filtering results
+     * @param payload.sportId - Sport ID(s) to include in search
+     * @param payload.countryId - Country ID(s) to include in search
+     * @param payload.tournamentId - Tournament ID(s) to include in search
+     * @param payload.dictionary - Dictionary type to group by ('sport' | 'country' | 'tournament')
+     * @param payload.notsport - Sport ID(s) to exclude from search
+     * @param payload.notcountry - Country ID(s) to exclude from search
+     * @param payload.nottournament - Tournament ID(s) to exclude from search
+     * @param payload.LIMIT - Maximum number of results to return
+     * @param payload.minTime - Minimum time filter for events
+     * @param payload.maxTime - Maximum time filter for events
+     *
+     * @returns Promise resolving to aggregated results with total count and grouped items,
+     *          or error object with total: 0 and empty results array on failure
+     *
+     * @example
+     * ```typescript
+     * // Get sport dictionary with counts
+     * const sportDict = await redisDb.getDictionary({
+     *   locale: 'en',
+     *   dictionary: 'sport',
+     *   LIMIT: { from: 0, size: 10 },
+     *   minTime: 1640995200,
+     *   maxTime: 1641081600
+     * });
+     *
+     * // Get country dictionary excluding specific sports
+     * const countryDict = await redisDb.getDictionary({
+     *   locale: 'ru',
+     *   dictionary: 'country',
+     *   notsport: [1, 2, 3],
+     *   LIMIT: { from: 0, size: 50 }
+     * });
+     *
+     * // Get tournament dictionary for specific sport and country
+     * const tournamentDict = await redisDb.getDictionary({
+     *   locale: 'en',
+     *   dictionary: 'tournament',
+     *   sportId: [1],
+     *   countryId: [225],
+     *   LIMIT: { from: 0, size: 100 }
+     * });
+     * ```
+     */
+    async getDictionaryNv20(payload) {
+        var _a, _b, _c, _d, _e;
+        const url = this.url(`/stats/pm/dictionary`, api.NV20);
+        (_a = payload.locale) !== null && _a !== void 0 ? _a : (payload.locale = this.locale);
+        const { data: rawData, status, statusText } = await this.request(url).POST(payload).exec();
+        rawData.from = (_c = (_b = payload === null || payload === void 0 ? void 0 : payload.LIMIT) === null || _b === void 0 ? void 0 : _b.from) !== null && _c !== void 0 ? _c : null;
+        rawData.size = (_e = (_d = payload === null || payload === void 0 ? void 0 : payload.LIMIT) === null || _d === void 0 ? void 0 : _d.size) !== null && _e !== void 0 ? _e : null;
+        return this.responseHandlerData(rawData, status, statusText);
+    }
+    /**
+     * Retrieves a list of sports from the NV20 API endpoint with optional time filtering.
+     *
+     * @param {number} [minutes=0] - Optional time window in minutes to filter sports data.
+     *                                If greater than 0, filters results to include only data
+     *                                from the current time to the specified minutes in the future.
+     * @param {number} [timeout=MAX_TIME_EXECUTION_MS] - Optional request timeout in milliseconds.
+     * @returns {Promise<I.ISport[]>} A promise that resolves to an array of sports objects sorted by priority.
+     *                                 Each sport contains an ID, Name, and count (cnt) property.
+     *
+     * @example
+     * // Get all available sports
+     * const sports = await betBoosterApi.getLineSportsNv20();
+     *
+     * @example
+     * // Get sports updated in the last 30 minutes with a custom timeout
+     * const sports = await betBoosterApi.getLineSportsNv20(30, 5000);
+     */
+    async getLineSportsNv20(minutes = 0, timeout = MAX_TIME_EXECUTION_MS) {
+        var _a;
+        const url = this.url(`/stats/pm/dictionary`, api.NV20);
+        const payload = Object.assign({ locale: this.locale, dictionary: 'sport' }, (minutes > 0 ? { minTime: Date.now(), maxTime: Date.now() + minutes * 60 * 1000 } : {}));
+        const { data: rawData, status, statusText } = await this.request(url).POST(payload).setTimeout(timeout).exec();
+        const handledData = this.responseHandlerData(rawData, status, statusText);
+        const preparedSports = (((_a = handledData === null || handledData === void 0 ? void 0 : handledData.data) === null || _a === void 0 ? void 0 : _a.results) || []).filter((v) => v.sport && v.sName).map((v) => ({ ID: +v.sport, Name: v.sName, cnt: +v.cnt }));
+        return this.sortDataByPriority(preparedSports, this.primarySports, 'ID');
+    }
+    /**
+     * Retrieves the main line sports data with fallback mechanism.
+     *
+     * Attempts to fetch line sports data from the NV20 endpoint first with a 2000ms timeout.
+     * If no sports data is returned, falls back to the standard getLineSports endpoint.
+     *
+     * @param minutes - Optional. The number of minutes to look back for sports data. Defaults to 0.
+     * @param timeout - Optional. The timeout duration in milliseconds for the NV20 API request. Defaults to 1500.
+     * @returns A promise that resolves to an array of sports objects containing line sports data.
+     * @example
+     * // Get current line sports
+     * const sports = await getLineSportsMain();
+     *
+     * @example
+     * // Get line sports from the last 30 minutes
+     * const sports = await getLineSportsMain(30);
+     */
+    async getLineSportsMain(minutes = 0, timeout = 1500) {
+        let sports = await this.getLineSportsNv20(minutes, timeout);
+        if (sports.length === 0) {
+            sports = await this.getLineSports(minutes);
+        }
+        return sports;
+    }
+    /**
+     * Retrieves countries for a given sport using the NV20 API.
+     * @param sportId - The sport ID to filter countries by.
+     * @param minutes - Optional time window in minutes for the query. Defaults to 0 (no time filter).
+     * @returns A promise that resolves to the response data containing countries or null if the request fails.
+     */
+    async getCountriesBySportNv20(sportId, minutes = 0, timeout = MAX_TIME_EXECUTION_MS) {
+        var _a;
+        const url = this.url(`/stats/pm/dictionary`, api.NV20);
+        const payload = Object.assign({ locale: this.locale, sportId, dictionary: 'country' }, (minutes > 0 ? { minTime: Date.now(), maxTime: Date.now() + minutes * 60 * 1000 } : {}));
+        const { data: rawData, status, statusText } = await this.request(url).POST(payload).setTimeout(timeout).exec();
+        const handledData = this.responseHandlerData(rawData, status, statusText);
+        const preparedCounties = (((_a = handledData === null || handledData === void 0 ? void 0 : handledData.data) === null || _a === void 0 ? void 0 : _a.results) || []).sort((a, b) => a.cName.localeCompare(b.cName)).map((v) => ({ ID: +v.country, Name: v.cName, cnt: +v.cnt }));
+        const priorityCountries = this.priorityCountries[sportId];
+        if (priorityCountries) {
+            return this.sortDataByPriority(preparedCounties, priorityCountries, 'ID');
+        }
+        return preparedCounties;
+    }
+    /**
+     * Retrieves a list of countries for a given sport, with fallback behavior.
+     *
+     * Attempts to fetch countries using the NV20 API with a 5-second timeout.
+     * If no results are returned, falls back to the standard countries list endpoint.
+     *
+     * @param sportId - The unique identifier of the sport
+     * @param minutes - Optional. The number of minutes to use as a filter criteria. Defaults to 0.
+     * @param timeout - Optional. The timeout duration in milliseconds for the NV20 API request. Defaults to 3000.
+     * @returns A promise that resolves to an array of countries for the specified sport
+     *
+     * @example
+     * ```typescript
+     * const countries = await this.getCountriesListMain(1, 30);
+     * ```
+     */
+    async getCountriesListMain(sportId, minutes = 0, timeout = 3000) {
+        let sports = await this.getCountriesBySportNv20(sportId, minutes, timeout);
+        if (sports.length === 0) {
+            sports = await this.getCountriesList(sportId, minutes);
+        }
+        return sports;
+    }
+    /**
+     * Retrieves tournaments from the NV20 API for a specific sport and optional country.
+     * @param sportId - The sport ID to filter tournaments by
+     * @param countryId - Optional country ID to filter tournaments by
+     * @param minutes - Optional time window in minutes for tournament data (default: 0, no time filter)
+     * @returns A promise that resolves to the response data containing tournaments or null
+     */
+    async getPrematchTournamentsNv20(sportId, countryId, minutes = 0, timeout = MAX_TIME_EXECUTION_MS) {
+        var _a, _b;
+        const url = this.url(`/stats/pm/dictionary`, api.NV20);
+        const payload = Object.assign({ locale: this.locale, sportId,
+            countryId, dictionary: 'tournament' }, (minutes > 0 ? { minTime: Date.now(), maxTime: Date.now() + minutes * 60 * 1000 } : {}));
+        const { data: rawData, status, statusText } = await this.request(url).POST(payload).setTimeout(timeout).exec();
+        const handledData = this.responseHandlerData(rawData, status, statusText);
+        const preparedTournaments = (((_a = handledData === null || handledData === void 0 ? void 0 : handledData.data) === null || _a === void 0 ? void 0 : _a.results) || []).sort((a, b) => a.tName.localeCompare(b.tName)).map((v) => ({ Id: +v.tournament, Name: v.tName, cnt: +v.cnt, sId: +v.sport, sName: v.sName, cId: +v.country, cName: v.cName }));
+        const priorityTournaments = (_b = this.priorityTournaments[sportId]) !== null && _b !== void 0 ? _b : null;
+        if (priorityTournaments) {
+            return this.sortDataByPriority(preparedTournaments, priorityTournaments, 'Id');
+        }
+        return preparedTournaments;
+    }
+    /**
+     * Retrieves prematch tournaments for a given sport and country.
+     *
+     * Attempts to fetch tournaments using the NV2.0 API first. If no tournaments are returned,
+     * falls back to the standard API as a failover mechanism.
+     *
+     * @param sportId - The sport identifier (number or string)
+     * @param countryId - The country identifier (number or string)
+     * @param minutes - The time window in minutes for prematch tournaments (default: 0)
+     * @param timeout - The request timeout in milliseconds (default: 3000)
+     * @returns A promise that resolves to an array of tournament objects
+     * @throws May throw an error if both API calls fail
+     *
+     * @example
+     * const tournaments = await betBoosterApi.getPrematchTournamentsMain(1, 'US', 30, 5000);
+     */
+    async getPrematchTournamentsMain(sportId, countryId, minutes = 0, timeout = 3000) {
+        let tournaments = await this.getPrematchTournamentsNv20(sportId, countryId, minutes, timeout);
+        if (tournaments.length === 0) {
+            tournaments = await this.getPrematchTournaments(sportId, countryId, minutes);
+        }
+        return tournaments;
+    }
     async searchPrematchTournametsEventsNv20(searchString, options = {}) {
         var _a, _b, _c;
         const { data, status, statusText } = await this.searchPrematchEventsNv20(searchString, options);
@@ -2576,6 +2898,9 @@ export class BetBoosterApi {
     async test3() {
         return 'test3 Ok';
     }
+    /**
+     * @deprecated sellBet - Not implemented
+     */
     async sellBet(data) {
         // !TODO sellBet - Not implemented
         // ! Нет реализации в BC