bb-api-platforma 0.1.190 → 0.1.197

package/dist/BetBoosterApi.d.ts

@@ -24,6 +24,12 @@ export declare class BetBoosterApi {
     private _liveTimestampReset;
     liveRecivedIsFullPackage?: boolean;
     isNotActive?: boolean;
+    /** Приоритетные виды спорта для сортировки и отображения на странице [VidSportaRating]*/
+    primarySports: number[];
+    /** Приоритетные страны по видам спорта для сортировки и отображения */
+    priorityCountries: Record<string, number[]>;
+    /** Приоритетные турниры по видам спорта*/
+    priorityTournaments: Record<string, number[]>;
     /**
      * Represents the BetBoosterApi class.
      * @constructor
@@ -58,6 +64,22 @@ export declare class BetBoosterApi {
         status: number;
         statusText: string;
     };
+    /**
+     * Processes the response data and returns an object with data, error, status and status text.
+     * Same as `this.responseHandlerData` only corrects the nesting of `Data.Data`
+     *
+     * @template T - Тип данных, возвращаемых в поле `data`.
+     * @param {any} rawData - Сырые данные ответа.
+     * @param {number} status - HTTP статус ответа.
+     * @param {string} statusText - Текст статуса HTTP ответа.
+     * @returns {{ data: T, error: string | null, status: number, statusText: string }} Объект, содержащий данные ответа, ошибку, статус и текст статуса.
+     */
+    responseHandlerDataData<T = any | null>(rawData: any, status: number, statusText: string): {
+        data: T | null;
+        error: string | null;
+        status: number;
+        statusText: string;
+    };
     /**
      * Converts rawData.Data.Data format to rawData.Data.data format
      * Sometimes API returns a format that is difficult to process later.
@@ -130,6 +152,57 @@ export declare class BetBoosterApi {
      * @returns URL for the specified API path and version.
      */
     private url;
+    /**
+     * Сортирует данные по приоритету, указанному в массиве 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<T extends Record<string, any>>(data: T[], priorityIDs: Array<number | string>, sortField: keyof T): T[];
+    /**
+     * Сортирует массив значений по приоритету, указанному в массиве 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<T extends number | string>(array: T[], priorityIDs: T[]): T[];
     /**
      * Executes an HTTP request with the specified parameters.
      * @param url - The URL to execute the request.
@@ -204,6 +277,7 @@ export declare 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();
      */
     getLineSports(minutes?: number): Promise<I.ISport[]>;
     /**
@@ -216,6 +290,7 @@ export declare class BetBoosterApi {
      * @param sportId - Идентификатор спорта.
      * @param minutes - Опциональный параметр, количество минут.
      * @returns Промис, который разрешается в массив объектов типа ICountry.
+     * @deprecated - use this.getCountriesListMain();
      */
     getCountriesList(sportId: number, minutes?: number): Promise<I.ICountry[]>;
     /**
@@ -224,8 +299,9 @@ export declare 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();
      */
-    getPrematchTournaments(sportId: number, countryId: number, minutes?: number): Promise<I.GetPrematchTournament[]>;
+    getPrematchTournaments(sportId: number | string, countryId: number | string, minutes?: number): Promise<I.GetPrematchTournament[]>;
     /**
      * Retrieves prematch tournaments based on the specified sport ID and minutes.
      * @param sportId - The ID of the sport.
@@ -1157,6 +1233,147 @@ export declare class BetBoosterApi {
         status: number;
         statusText: string;
     }>;
+    /**
+     * 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 }
+     * });
+     * ```
+     */
+    getDictionaryNv20(payload: I.RedisDictionaryParams): Promise<{
+        data: any;
+        error: string | null;
+        status: number;
+        statusText: string;
+    }>;
+    /**
+     * 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);
+     */
+    getLineSportsNv20(minutes?: number, timeout?: number): Promise<I.ISport[]>;
+    /**
+     * 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);
+     */
+    getLineSportsMain(minutes?: number, timeout?: number): Promise<I.ISport[]>;
+    /**
+     * 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.
+     */
+    getCountriesBySportNv20(sportId: number, minutes?: number, timeout?: number): Promise<I.ICountry[]>;
+    /**
+     * 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);
+     * ```
+     */
+    getCountriesListMain(sportId: number, minutes?: number, timeout?: number): Promise<I.ICountry[]>;
+    /**
+     * 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
+     */
+    getPrematchTournamentsNv20(sportId: number | string, countryId: number | string, minutes?: number, timeout?: number): Promise<I.ITournamentShort[]>;
+    /**
+     * 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);
+     */
+    getPrematchTournamentsMain(sportId: number | string, countryId: number | string, minutes?: number, timeout?: number): Promise<I.ITournamentShort[]>;
     searchPrematchTournametsEventsNv20(searchString: string, options?: I.RedisPrematchSearchParams): Promise<{
         data: any;
         error: string | null;
@@ -1227,15 +1444,35 @@ export declare class BetBoosterApi {
      * ```
      */
     getCdnSlidesData(cdnUrl: string, sites: string[], hardCodeSlides?: any[]): Promise<Record<string, any[]>>;
+    /**
+     * Deposits money into a bet kiosk account.
+     * @param amount - The amount to deposit.
+     * @returns A promise that resolves to true if the deposit was successful, otherwise false or null.
+     * @deprecated use depositBetKioskV2 instead
+     */
     depositBetKiosk(amount: number): Promise<{
         data: boolean | null;
         error: string | null;
         status: number;
         statusText: string;
     }>;
+    /**
+     * Deposits money into a bet kiosk account.
+     * @param amount - The amount to deposit.
+     * @returns A promise that resolves to true if the deposit was successful, otherwise false or null.
+     */
+    depositBetKioskV2(amount: number): Promise<{
+        data: boolean | null;
+        error: string | null;
+        status: number;
+        statusText: string;
+    }>;
     getFaq(): Promise<any>;
     getFlatpagesList(): Promise<any>;
     test3(): Promise<string>;
+    /**
+     * @deprecated sellBet - Not implemented
+     */
     sellBet(data: any): Promise<void>;
     /** Конвертирует различные представления корзины в единый формат
      * @param betslipItem - элемент корзины