bb-api-platforma 0.1.244 → 0.1.246

package/dist/BetBoosterOfficeApi.d.ts

@@ -1131,17 +1131,45 @@ export declare class BetBoosterOfficeApi {
         statusText: string;
     }>;
     /**
-     * Copies (clones) an existing betslip with the given list of odds items
-     * and returns updated betslip data from the server, including actual odds,
-     * limitations, and betslip type.
+     * Клонирует существующий купон (betslip) по переданному списку позиций ставок
+     * и возвращает обновлённые данные купона с сервера: актуальные коэффициенты,
+     * лимиты и тип купона.
      *
-     * @param oddsList - Array of betslip odds items to clone.
+     * @param oddsList - Массив позиций ставок (`TBetslipOddsList[]`), полученных
+     * из ранее сформированного купона (например, из ответа `getBetslipOddsList`).
+     * Каждый элемент содержит обязательные поля состояния (`ErrorMessage`, `Min`, `Max`,
+     * `MinCurrencyUnit`, `IsRound`, `IsReinvested`, `MinAdd`, `MaxAdd`, `Odds`, `IsLive`)
+     * и опциональные идентификаторы ставки (`LinesID`, `BetVarID`, `HandSize`, `Add1`, `Add2`).
+     * Метод оборачивает массив в payload `{ Bets: oddsList, Culture: locale }` автоматически.
      *
      * @remarks
      * Endpoint: `POST /betting/CopyBetslip` (API v2)
      *
      * @example
-     * **Request payload:**
+     * **Вызов метода:**
+     * ```ts
+     * const result = await api.cloneStoredBetslip([
+     *   {
+     *     ErrorMessage: 0,
+     *     Min: 0,
+     *     Max: 0,
+     *     MinCurrencyUnit: 0.01,
+     *     IsRound: false,
+     *     IsReinvested: false,
+     *     MinAdd: 0,
+     *     MaxAdd: 0,
+     *     Odds: 3.07,
+     *     IsLive: false,
+     *     LinesID: 2970079,
+     *     BetVarID: 1,
+     *     HandSize: null,
+     *     Add1: null,
+     *     Add2: null
+     *   }
+     * ]);
+     * ```
+     *
+     * **Формируемый payload (POST /betting/CopyBetslip):**
      * ```json
      * {
      *   "Bets": [
@@ -1160,17 +1188,7 @@ export declare class BetBoosterOfficeApi {
      *       "BetVarID": 1,
      *       "HandSize": null,
      *       "Add1": null,
-     *       "Add2": null,
-     *       "Score": "",
-     *       "NameSport": "Football",
-     *       "NameCountry": "Europe",
-     *       "NameTurnir": "UEFA Champions League",
-     *       "NameTeam1": "Real Madrid",
-     *       "NameTeam2": "Bayern Munich",
-     *       "DateEvent": "2026-04-07T22:00:00+03:00",
-     *       "NameBetShort": "1",
-     *       "NameBetLong": "Team 1 wins",
-     *       "SportId": 5
+     *       "Add2": null
      *     }
      *   ],
      *   "Culture": "en-US"
@@ -1208,4 +1226,106 @@ export declare class BetBoosterOfficeApi {
         status: number;
         statusText: string;
     }>;
+    /**
+     * Получает сохранённый купон по его идентификатору.
+     *
+     * @param savedCouponId - Уникальный числовой идентификатор сохранённого купона.
+     * @returns Данные сохранённого купона.
+     *
+     * @remarks
+     * Endpoint: `GET /portfolio/getcoupon/:savedCouponId` (NV20)
+     *
+     * @example
+     * ```ts
+     * // Запрос
+     * const coupon = await api.getSavedCoupon(12345);
+     *
+     * // Ответ (строка с данными купона)
+     * // "{ ... serialized coupon data ... }"
+     * ```
+     */
+    getSavedCoupon(savedCouponId: number): Promise<{
+        data: any;
+        error: string | null;
+        status: number;
+        statusText: string;
+    }>;
+    /**
+     * Создаёт новый сохранённый купон на основе переданных данных и списка кодов.
+     *
+     * @param couponData - Объект {@link I.ICouponRequest} с данными купона (коэффициенты, домен, партнёр и т.д.).
+     * @param savedCodesList - Массив строковых кодов, привязываемых к купону.
+     * @returns Результат создания купона.
+     *
+     * @remarks
+     * Endpoint: `POST /portfolio/createcoupon` (NV20)
+     *
+     * @example
+     * ```ts
+     * // Payload запроса
+     * const payload = {
+     *   data: {
+     *     odds: [
+     *       {
+     *         ErrorMessage: 0,
+     *         Min: 10,
+     *         Max: 1000,
+     *         MinCurrencyUnit: 1,
+     *         IsRound: false,
+     *         IsReinvested: false,
+     *         MinAdd: 0,
+     *         MaxAdd: 0,
+     *         Odds: 1.85,
+     *         IsLive: false,
+     *         LinesID: 456789,
+     *         BetVarID: 1,
+     *         NameSport: "Football",
+     *         NameTeam1: "Team A",
+     *         NameTeam2: "Team B",
+     *         NameBetShort: "1"
+     *       }
+     *     ],
+     *     domain: "example.com",
+     *     partner: "partner1"
+     *   },
+     *   codes: ["ABC123", "DEF456"]
+     * };
+     *
+     * const result = await api.createSavedCoupon(payload.data, payload.codes);
+     * ```
+     */
+    createSavedCoupon(couponData: I.ICouponRequest, savedCodesList: string[]): Promise<{
+        data: any;
+        error: string | null;
+        status: number;
+        statusText: string;
+    }>;
+    /**
+     * Получает список сохранённых купонов по массиву кодов.
+     *
+     * @param savedCodesList - Массив строковых кодов для поиска соответствующих купонов.
+     * @returns Массив найденных купонов.
+     *
+     * @remarks
+     * Endpoint: `POST /portfolio/getcoupons` (NV20)
+     *
+     * @example
+     * ```ts
+     * // Payload запроса
+     * const payload = {
+     *   codes: ["ABC123", "DEF456"]
+     * };
+     *
+     * const coupons = await api.getCoupons(["ABC123", "DEF456"]);
+     *
+     * // Ответ — массив объектов купонов
+     * // [{ id: 1, odds: [...], domain: "example.com", ... }, ...]
+     * ```
+     */
+    getCoupons(savedCodesList: string[]): Promise<{
+        data: any;
+        error: string | null;
+        status: number;
+        statusText: string;
+    }>;
 }

package/dist/BetBoosterOfficeApi.js

@@ -2153,17 +2153,45 @@ export class BetBoosterOfficeApi {
         return this.responseHandlerDataData(data, status, statusText);
     }
     /**
-     * Copies (clones) an existing betslip with the given list of odds items
-     * and returns updated betslip data from the server, including actual odds,
-     * limitations, and betslip type.
+     * Клонирует существующий купон (betslip) по переданному списку позиций ставок
+     * и возвращает обновлённые данные купона с сервера: актуальные коэффициенты,
+     * лимиты и тип купона.
      *
-     * @param oddsList - Array of betslip odds items to clone.
+     * @param oddsList - Массив позиций ставок (`TBetslipOddsList[]`), полученных
+     * из ранее сформированного купона (например, из ответа `getBetslipOddsList`).
+     * Каждый элемент содержит обязательные поля состояния (`ErrorMessage`, `Min`, `Max`,
+     * `MinCurrencyUnit`, `IsRound`, `IsReinvested`, `MinAdd`, `MaxAdd`, `Odds`, `IsLive`)
+     * и опциональные идентификаторы ставки (`LinesID`, `BetVarID`, `HandSize`, `Add1`, `Add2`).
+     * Метод оборачивает массив в payload `{ Bets: oddsList, Culture: locale }` автоматически.
      *
      * @remarks
      * Endpoint: `POST /betting/CopyBetslip` (API v2)
      *
      * @example
-     * **Request payload:**
+     * **Вызов метода:**
+     * ```ts
+     * const result = await api.cloneStoredBetslip([
+     *   {
+     *     ErrorMessage: 0,
+     *     Min: 0,
+     *     Max: 0,
+     *     MinCurrencyUnit: 0.01,
+     *     IsRound: false,
+     *     IsReinvested: false,
+     *     MinAdd: 0,
+     *     MaxAdd: 0,
+     *     Odds: 3.07,
+     *     IsLive: false,
+     *     LinesID: 2970079,
+     *     BetVarID: 1,
+     *     HandSize: null,
+     *     Add1: null,
+     *     Add2: null
+     *   }
+     * ]);
+     * ```
+     *
+     * **Формируемый payload (POST /betting/CopyBetslip):**
      * ```json
      * {
      *   "Bets": [
@@ -2182,17 +2210,7 @@ export class BetBoosterOfficeApi {
      *       "BetVarID": 1,
      *       "HandSize": null,
      *       "Add1": null,
-     *       "Add2": null,
-     *       "Score": "",
-     *       "NameSport": "Football",
-     *       "NameCountry": "Europe",
-     *       "NameTurnir": "UEFA Champions League",
-     *       "NameTeam1": "Real Madrid",
-     *       "NameTeam2": "Bayern Munich",
-     *       "DateEvent": "2026-04-07T22:00:00+03:00",
-     *       "NameBetShort": "1",
-     *       "NameBetLong": "Team 1 wins",
-     *       "SportId": 5
+     *       "Add2": null
      *     }
      *   ],
      *   "Culture": "en-US"
@@ -2233,5 +2251,111 @@ export class BetBoosterOfficeApi {
         const { data, status, statusText } = await this.request(url).POST(payload).exec();
         return this.responseHandlerDataData(data, status, statusText);
     }
+    /**
+     * Получает сохранённый купон по его идентификатору.
+     *
+     * @param savedCouponId - Уникальный числовой идентификатор сохранённого купона.
+     * @returns Данные сохранённого купона.
+     *
+     * @remarks
+     * Endpoint: `GET /portfolio/getcoupon/:savedCouponId` (NV20)
+     *
+     * @example
+     * ```ts
+     * // Запрос
+     * const coupon = await api.getSavedCoupon(12345);
+     *
+     * // Ответ (строка с данными купона)
+     * // "{ ... serialized coupon data ... }"
+     * ```
+     */
+    async getSavedCoupon(savedCouponId) {
+        const url = this.url(`/portfolio/getcoupon/${savedCouponId}`, api.NV20);
+        const { data, status, statusText } = await this.request(url).exec();
+        return this.responseHandlerDataData(data, status, statusText);
+    }
+    /**
+     * Создаёт новый сохранённый купон на основе переданных данных и списка кодов.
+     *
+     * @param couponData - Объект {@link I.ICouponRequest} с данными купона (коэффициенты, домен, партнёр и т.д.).
+     * @param savedCodesList - Массив строковых кодов, привязываемых к купону.
+     * @returns Результат создания купона.
+     *
+     * @remarks
+     * Endpoint: `POST /portfolio/createcoupon` (NV20)
+     *
+     * @example
+     * ```ts
+     * // Payload запроса
+     * const payload = {
+     *   data: {
+     *     odds: [
+     *       {
+     *         ErrorMessage: 0,
+     *         Min: 10,
+     *         Max: 1000,
+     *         MinCurrencyUnit: 1,
+     *         IsRound: false,
+     *         IsReinvested: false,
+     *         MinAdd: 0,
+     *         MaxAdd: 0,
+     *         Odds: 1.85,
+     *         IsLive: false,
+     *         LinesID: 456789,
+     *         BetVarID: 1,
+     *         NameSport: "Football",
+     *         NameTeam1: "Team A",
+     *         NameTeam2: "Team B",
+     *         NameBetShort: "1"
+     *       }
+     *     ],
+     *     domain: "example.com",
+     *     partner: "partner1"
+     *   },
+     *   codes: ["ABC123", "DEF456"]
+     * };
+     *
+     * const result = await api.createSavedCoupon(payload.data, payload.codes);
+     * ```
+     */
+    async createSavedCoupon(couponData, savedCodesList) {
+        const url = this.url(`/portfolio/createcoupon`, api.NV20);
+        const payload = {
+            data: couponData,
+            codes: savedCodesList,
+        };
+        const { data, status, statusText } = await this.request(url).POST(payload).exec();
+        return this.responseHandlerDataData(data, status, statusText);
+    }
+    /**
+     * Получает список сохранённых купонов по массиву кодов.
+     *
+     * @param savedCodesList - Массив строковых кодов для поиска соответствующих купонов.
+     * @returns Массив найденных купонов.
+     *
+     * @remarks
+     * Endpoint: `POST /portfolio/getcoupons` (NV20)
+     *
+     * @example
+     * ```ts
+     * // Payload запроса
+     * const payload = {
+     *   codes: ["ABC123", "DEF456"]
+     * };
+     *
+     * const coupons = await api.getCoupons(["ABC123", "DEF456"]);
+     *
+     * // Ответ — массив объектов купонов
+     * // [{ id: 1, odds: [...], domain: "example.com", ... }, ...]
+     * ```
+     */
+    async getCoupons(savedCodesList) {
+        const url = this.url(`/portfolio/getcoupons`, api.NV20);
+        const payload = {
+            codes: savedCodesList,
+        };
+        const { data, status, statusText } = await this.request(url).POST(payload).exec();
+        return this.responseHandlerDataData(data, status, statusText);
+    }
 }
 // @workspace /doc в комментарии приведи полный пример payload из I.IConfirmWithdrawalOrderPayload

package/dist/Types.d.ts

@@ -1866,6 +1866,55 @@ export type TBetslipResponse = {
     };
     BetslipType: EBetslipType;
 };
+/** Одна позиция ставки в купоне */
+export interface ICouponOdd {
+    ErrorMessage: number;
+    Min: number;
+    Max: number;
+    MinCurrencyUnit: number;
+    IsRound: boolean;
+    IsReinvested: boolean;
+    MinAdd: number;
+    MaxAdd: number;
+    Odds: number;
+    IsLive: boolean;
+    Amount?: number;
+    LinesID?: number;
+    HandSize?: number | null;
+    BetVarID?: number;
+    Add1?: number | null;
+    Add2?: number | null;
+    Score?: string;
+    OddsOld?: number;
+    HandSizeOld?: number;
+    NameSport?: string;
+    NameCountry?: string;
+    NameTurnir?: string;
+    NameTeam1?: string;
+    NameTeam2?: string;
+    PriceNum?: number;
+    /** Дата события в формате ISO 8601 с часовым поясом, например "2026-04-07T22:00:00+03:00" */
+    DateEvent?: string;
+    NameBetShort?: string;
+    NameBetLong?: string;
+    Comment?: string;
+    SportId?: number;
+    DateEventLive?: string | null;
+    BonusType?: number;
+    BetIdentifier?: string | null;
+}
+/** Входящий запрос на сохранение купона */
+export interface ICouponRequest {
+    odds: ICouponOdd[];
+    domain: string;
+    partner: string;
+    id?: number;
+    code?: string;
+}
+export type ICreateCouponRequest = {
+    data: ICouponRequest;
+    codes?: string[] | null | undefined;
+};
 export {};
 /**
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bb-api-platforma",
-  "version": "0.1.244",
+  "version": "0.1.246",
   "description": "API module for BetBooster Platform",
   "productName": "BetBooster Platform API",
   "author": "Tomy Bet <tomybet.com@gmail.com>",
@@ -9,7 +9,7 @@
   "types": "dist/BetBoosterApi.min.d.ts",
   "type": "module",
   "scripts": {
-    "release": "pwsh ./release.ps1",
+    "release": "pwsh -File .\\release.ps1",
     "build": "rimraf ./dist && tsc --project tsconfig.build.json",
     "build:compress": "npm run build && terser --compress --mangle --source-map \"url='BetBoosterApi.min.js.map'\" --output dist/BetBoosterApi.min.js dist/BetBoosterApi.js",
     "build:types": "dts-bundle-generator -o dist/BetBoosterApi.min.d.ts src/BetBoosterApi.ts",