bb-api-platforma 0.1.266 → 0.1.268

package/dist/BetBoosterOfficeApi.d.ts

@@ -1495,10 +1495,227 @@ export declare class BetBoosterOfficeApi {
         status: number;
         statusText: string;
     }>;
+    /**
+     * Возвращает постраничный отчёт по транзакциям кассиров за указанный период.
+     *
+     * Ответ содержит три набора данных:
+     * - `Rows` — транзакции текущей страницы;
+     * - `Totals` — агрегированные итоги по видам транзакций за весь период;
+     * - метаданные пагинации (`TotalRows`, `TotalPages`, `CurrentPage`, `PageSize`).
+     *
+     * Максимальный диапазон дат — 65 дней.
+     *
+     * @param payload - Параметры запроса.
+     * @param payload.DateStart - Начало периода в формате ISO 8601 UTC.
+     * @param payload.DateEnd - Конец периода в формате ISO 8601 UTC.
+     * @param payload.PointIds - Массив идентификаторов касс (опционально).
+     * @param payload.UserIds - Массив идентификаторов кассиров (опционально).
+     * @param payload.PageNumber - Номер страницы (начиная с 1).
+     * @param payload.PageSize - Размер страницы.
+     * @param payload.SortDesc - Сортировка по убыванию даты транзакции.
+     * @returns Промис с объектом {@link I.ICashiersTransactionsResponse} или `null` в случае ошибки.
+     *
+     * @remarks
+     * Endpoint: `POST /api/v2/report/CashierTransactionsReport`
+     *
+     * @example
+     * ```typescript
+     * const payload: I.ICashiersTransactionsPayload = {
+     *   DateStart: "2026-06-01T00:00:00.000Z",
+     *   DateEnd: "2026-06-25T23:59:59.999Z",
+     *   PointIds: [427, 465],
+     *   UserIds: [1012, 1015],
+     *   PageNumber: 1,
+     *   PageSize: 50,
+     *   SortDesc: true
+     * };
+     *
+     * const result = await officeApi.getCashiersTransactions(payload);
+     *
+     * // Response (data содержит I.ICashiersTransactionsResponse)
+     * // {
+     * //   "Ok": true,
+     * //   "Error": "",
+     * //   "Data": {
+     * //     "Rows": [
+     * //       {
+     * //         "TransactionId": 9000123,
+     * //         "TransactionDate": "2026-06-24T14:35:00",
+     * //         "PointId": 427,
+     * //         "PointName": "Point 427",
+     * //         "PointCurrency": "USD",
+     * //         "CashierUserId": 1012,
+     * //         "CashierLogin": "cashier_01",
+     * //         "IsExternal": 0,
+     * //         "TransactionTypeId": 1,
+     * //         "Amount": 500.00,
+     * //         "IsAddition": true
+     * //       }
+     * //     ],
+     * //     "Totals": [
+     * //       {
+     * //         "IsExternal": 0,
+     * //         "TransactionTypeId": 1,
+     * //         "IsAddition": true,
+     * //         "TotalAmount": 15000.00,
+     * //         "RowsCount": 30
+     * //       }
+     * //     ],
+     * //     "TotalRows": 30,
+     * //     "TotalPages": 1,
+     * //     "CurrentPage": 1,
+     * //     "PageSize": 50
+     * //   }
+     * // }
+     * ```
+     */
+    getCashiersTransactions(payload: I.ICashiersTransactionsPayload): Promise<{
+        data: I.ICashiersTransactionsResponse | null;
+        error: string | null;
+        status: number;
+        statusText: string;
+    }>;
     /**
       * Retrieves the content of a bet by betId.
       * @param betId - The bet identifier.
       * @returns The content of the bet.
       */
     getBetContentV2(betId: number): Promise<{}>;
+    /**
+     * Генерирует баннер для социальных сетей и загружает его в Backblaze B2.
+     *
+     * @remarks
+     * POST /api/v2/social/banner
+     *
+     * @param payload - Параметры для создания баннера.
+     * @returns Объект с информацией о загруженном баннере (key, url, cdnUrl).
+     *
+     * @example
+     * ```typescript
+     * const result = await api.postSocialBanner({
+     *   site: 'betsite.com',
+     *   type: 'win',
+     *   betId: '12345',
+     *   countEvent: '5',
+     *   odds: '3.50'
+     * });
+     * // Ответ:
+     * // {
+     * //   "Ok": true,
+     * //   "Data": {
+     * //     "key": "betsite.com/12345.avif",
+     * //     "url": "https://s3.us-west-004.backblazeb2.com/bbsocialimages/betsite.com/12345.avif",
+     * //     "cdnUrl": "https://banners.fwdgmblns.top/file/bbsocialimages/betsite.com/12345.avif"
+     * //   }
+     * // }
+     * ```
+     */
+    postSocialBanner(payload: {
+        site: string;
+        type: string;
+        betId: string | number;
+        countEvent?: string;
+        odds?: string;
+    }): Promise<{
+        data: any;
+        error: string | null;
+        status: number;
+        statusText: string;
+    }>;
+    /**
+     * Получает дерево всех доступных файлов социальных баннеров.
+     *
+     * @remarks
+     * GET /api/v2/social/tree
+     *
+     * @returns Объект с деревом структуры всех файлов баннеров.
+     *
+     * @example
+     * ```typescript
+     * const result = await api.getSocialTree();
+     * // Ответ:
+     * // {
+     * //   "Ok": true,
+     * //   "Data": [
+     * //     {
+     * //       "site": "betsite.com",
+     * //       "files": ["123.avif", "456.avif"]
+     * //     }
+     * //   ]
+     * // }
+     * ```
+     */
+    getSocialTree(): Promise<{
+        data: any;
+        error: string | null;
+        status: number;
+        statusText: string;
+    }>;
+    /**
+     * Получает дерево файлов социальных баннеров для конкретного сайта.
+     *
+     * @remarks
+     * GET /api/v2/social/tree/:site
+     *
+     * @param site - Название сайта (например: "betsite.com").
+     * @returns Объект с деревом структуры файлов для указанного сайта.
+     *
+     * @example
+     * ```typescript
+     * const result = await api.getSocialTreeBySite('betsite.com');
+     * // Ответ:
+     * // {
+     * //   "Ok": true,
+     * //   "Data": [
+     * //     { "fileName": "123.avif" },
+     * //     { "fileName": "456.avif" }
+     * //   ]
+     * // }
+     * ```
+     */
+    getSocialTreeBySite(site: string): Promise<{
+        data: any;
+        error: string | null;
+        status: number;
+        statusText: string;
+    }>;
+    /**
+     * Загружает фоновое изображение для социальных баннеров.
+     *
+     * @remarks
+     * PUT /api/v2/social/background
+     *
+     * @param payload - Параметры загрузки изображения.
+     * @returns Объект с результатом загрузки и информацией о файле.
+     *
+     * @example
+     * ```typescript
+     * const result = await api.putSocialBackground({
+     *   imageBase64: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==',
+     *   site: 'betsite.com',
+     *   type: 'win'
+     * });
+     * // Ответ:
+     * // {
+     * //   "Ok": true,
+     * //   "Data": [
+     * //     {
+     * //       "fileName": "win.avif",
+     * //       "size": 1024,
+     * //       "url": "https://banners.fwdgmblns.top/file/bbsocialimages/betsite.com/win.avif"
+     * //     }
+     * //   ]
+     * // }
+     * ```
+     */
+    putSocialBackground(payload: {
+        imageBase64: string;
+        site: string;
+        type: string;
+    }): Promise<{
+        data: any;
+        error: string | null;
+        status: number;
+        statusText: string;
+    }>;
 }

package/dist/BetBoosterOfficeApi.js

@@ -2521,6 +2521,85 @@ export class BetBoosterOfficeApi {
         const { data, status, statusText } = await this.request(url).POST(payload).exec();
         return this.responseHandlerData(data, status, statusText);
     }
+    /**
+     * Возвращает постраничный отчёт по транзакциям кассиров за указанный период.
+     *
+     * Ответ содержит три набора данных:
+     * - `Rows` — транзакции текущей страницы;
+     * - `Totals` — агрегированные итоги по видам транзакций за весь период;
+     * - метаданные пагинации (`TotalRows`, `TotalPages`, `CurrentPage`, `PageSize`).
+     *
+     * Максимальный диапазон дат — 65 дней.
+     *
+     * @param payload - Параметры запроса.
+     * @param payload.DateStart - Начало периода в формате ISO 8601 UTC.
+     * @param payload.DateEnd - Конец периода в формате ISO 8601 UTC.
+     * @param payload.PointIds - Массив идентификаторов касс (опционально).
+     * @param payload.UserIds - Массив идентификаторов кассиров (опционально).
+     * @param payload.PageNumber - Номер страницы (начиная с 1).
+     * @param payload.PageSize - Размер страницы.
+     * @param payload.SortDesc - Сортировка по убыванию даты транзакции.
+     * @returns Промис с объектом {@link I.ICashiersTransactionsResponse} или `null` в случае ошибки.
+     *
+     * @remarks
+     * Endpoint: `POST /api/v2/report/CashierTransactionsReport`
+     *
+     * @example
+     * ```typescript
+     * const payload: I.ICashiersTransactionsPayload = {
+     *   DateStart: "2026-06-01T00:00:00.000Z",
+     *   DateEnd: "2026-06-25T23:59:59.999Z",
+     *   PointIds: [427, 465],
+     *   UserIds: [1012, 1015],
+     *   PageNumber: 1,
+     *   PageSize: 50,
+     *   SortDesc: true
+     * };
+     *
+     * const result = await officeApi.getCashiersTransactions(payload);
+     *
+     * // Response (data содержит I.ICashiersTransactionsResponse)
+     * // {
+     * //   "Ok": true,
+     * //   "Error": "",
+     * //   "Data": {
+     * //     "Rows": [
+     * //       {
+     * //         "TransactionId": 9000123,
+     * //         "TransactionDate": "2026-06-24T14:35:00",
+     * //         "PointId": 427,
+     * //         "PointName": "Point 427",
+     * //         "PointCurrency": "USD",
+     * //         "CashierUserId": 1012,
+     * //         "CashierLogin": "cashier_01",
+     * //         "IsExternal": 0,
+     * //         "TransactionTypeId": 1,
+     * //         "Amount": 500.00,
+     * //         "IsAddition": true
+     * //       }
+     * //     ],
+     * //     "Totals": [
+     * //       {
+     * //         "IsExternal": 0,
+     * //         "TransactionTypeId": 1,
+     * //         "IsAddition": true,
+     * //         "TotalAmount": 15000.00,
+     * //         "RowsCount": 30
+     * //       }
+     * //     ],
+     * //     "TotalRows": 30,
+     * //     "TotalPages": 1,
+     * //     "CurrentPage": 1,
+     * //     "PageSize": 50
+     * //   }
+     * // }
+     * ```
+     */
+    async getCashiersTransactions(payload) {
+        const url = this.url(`/report/CashierTransactionsReport`, api.V2);
+        const { data, status, statusText } = await this.request(url).POST(payload).exec();
+        return this.responseHandlerData(data, status, statusText);
+    }
     /**
       * Retrieves the content of a bet by betId.
       * @param betId - The bet identifier.
@@ -2532,11 +2611,135 @@ export class BetBoosterOfficeApi {
                 id: betId,
                 culture: this.locale
             };
-            const url = this.url(`/account/GetBetContentNew`, api.V2);
+            const url = this.url(`/account/GetBetContentNew`, api.NV30);
             const { data, status, statusText } = await this.request(url).query(payload).exec();
             return this.responseHandlerData(data, status, statusText);
         }
         return {};
     }
+    // #region Social Banner -----------------------------------------------------------------------
+    /**
+     * Генерирует баннер для социальных сетей и загружает его в Backblaze B2.
+     *
+     * @remarks
+     * POST /api/v2/social/banner
+     *
+     * @param payload - Параметры для создания баннера.
+     * @returns Объект с информацией о загруженном баннере (key, url, cdnUrl).
+     *
+     * @example
+     * ```typescript
+     * const result = await api.postSocialBanner({
+     *   site: 'betsite.com',
+     *   type: 'win',
+     *   betId: '12345',
+     *   countEvent: '5',
+     *   odds: '3.50'
+     * });
+     * // Ответ:
+     * // {
+     * //   "Ok": true,
+     * //   "Data": {
+     * //     "key": "betsite.com/12345.avif",
+     * //     "url": "https://s3.us-west-004.backblazeb2.com/bbsocialimages/betsite.com/12345.avif",
+     * //     "cdnUrl": "https://banners.fwdgmblns.top/file/bbsocialimages/betsite.com/12345.avif"
+     * //   }
+     * // }
+     * ```
+     */
+    async postSocialBanner(payload) {
+        const url = this.url('/social/banner', api.NV30);
+        const { data, status, statusText } = await this.request(url).POST(payload).exec();
+        return this.responseHandlerData(data, status, statusText);
+    }
+    /**
+     * Получает дерево всех доступных файлов социальных баннеров.
+     *
+     * @remarks
+     * GET /api/v2/social/tree
+     *
+     * @returns Объект с деревом структуры всех файлов баннеров.
+     *
+     * @example
+     * ```typescript
+     * const result = await api.getSocialTree();
+     * // Ответ:
+     * // {
+     * //   "Ok": true,
+     * //   "Data": [
+     * //     {
+     * //       "site": "betsite.com",
+     * //       "files": ["123.avif", "456.avif"]
+     * //     }
+     * //   ]
+     * // }
+     * ```
+     */
+    async getSocialTree() {
+        const url = this.url('/social/tree', api.NV30);
+        const { data, status, statusText } = await this.request(url).GET().exec();
+        return this.responseHandlerData(data, status, statusText);
+    }
+    /**
+     * Получает дерево файлов социальных баннеров для конкретного сайта.
+     *
+     * @remarks
+     * GET /api/v2/social/tree/:site
+     *
+     * @param site - Название сайта (например: "betsite.com").
+     * @returns Объект с деревом структуры файлов для указанного сайта.
+     *
+     * @example
+     * ```typescript
+     * const result = await api.getSocialTreeBySite('betsite.com');
+     * // Ответ:
+     * // {
+     * //   "Ok": true,
+     * //   "Data": [
+     * //     { "fileName": "123.avif" },
+     * //     { "fileName": "456.avif" }
+     * //   ]
+     * // }
+     * ```
+     */
+    async getSocialTreeBySite(site) {
+        const url = this.url(`/social/tree/${site}`, api.NV30);
+        const { data, status, statusText } = await this.request(url).GET().exec();
+        return this.responseHandlerData(data, status, statusText);
+    }
+    /**
+     * Загружает фоновое изображение для социальных баннеров.
+     *
+     * @remarks
+     * PUT /api/v2/social/background
+     *
+     * @param payload - Параметры загрузки изображения.
+     * @returns Объект с результатом загрузки и информацией о файле.
+     *
+     * @example
+     * ```typescript
+     * const result = await api.putSocialBackground({
+     *   imageBase64: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==',
+     *   site: 'betsite.com',
+     *   type: 'win'
+     * });
+     * // Ответ:
+     * // {
+     * //   "Ok": true,
+     * //   "Data": [
+     * //     {
+     * //       "fileName": "win.avif",
+     * //       "size": 1024,
+     * //       "url": "https://banners.fwdgmblns.top/file/bbsocialimages/betsite.com/win.avif"
+     * //     }
+     * //   ]
+     * // }
+     * ```
+     */
+    async putSocialBackground(payload) {
+        const url = this.url('/social/background', api.NV30);
+        const { data, status, statusText } = await this.request(url).PUT(payload).exec();
+        return this.responseHandlerData(data, status, statusText);
+    }
 }
 // @workspace /doc в комментарии приведи полный пример payload из I.IConfirmWithdrawalOrderPayload

package/dist/Types.d.ts

@@ -1166,6 +1166,76 @@ export interface IGgrReportItem {
     /** Сумма выигрышей в казино */
     CasinoWin: number;
 }
+/** Параметры запроса отчёта по транзакциям кассиров */
+export interface ICashiersTransactionsPayload {
+    /** Начало периода (ISO 8601 UTC) */
+    DateStart: string;
+    /** Конец периода (ISO 8601 UTC) */
+    DateEnd: string;
+    /** Массив идентификаторов касс (опционально) */
+    PointIds?: number[];
+    /** Массив идентификаторов пользователей-кассиров (опционально) */
+    UserIds?: number[];
+    /** Номер страницы (начиная с 1) */
+    PageNumber: number;
+    /** Размер страницы */
+    PageSize: number;
+    /** Сортировка по убыванию */
+    SortDesc: boolean;
+}
+/** Одна транзакция в отчёте кассира */
+export interface ICashierTransactionRow {
+    /** Идентификатор транзакции */
+    TransactionId: number;
+    /** Дата и время транзакции (ISO 8601) */
+    TransactionDate: string;
+    /** Идентификатор кассы */
+    PointId: number;
+    /** Наименование кассы */
+    PointName: string;
+    /** Код валюты кассы */
+    PointCurrency: string;
+    /** Идентификатор пользователя-кассира */
+    CashierUserId: number;
+    /** Логин кассира */
+    CashierLogin: string;
+    /** Признак внешней транзакции (0 — внутренняя, 1 — внешняя) */
+    IsExternal: number;
+    /** Тип транзакции */
+    TransactionTypeId: number;
+    /** Сумма транзакции */
+    Amount: number;
+    /** true — пополнение, false — выплата */
+    IsAddition: boolean;
+}
+/** Агрегированный итог по виду транзакции за период */
+export interface ICashierTransactionTotal {
+    /** Признак внешней транзакции */
+    IsExternal: number;
+    /** Тип транзакции */
+    TransactionTypeId: number;
+    /** true — пополнение, false — выплата */
+    IsAddition: boolean;
+    /** Итоговая сумма */
+    TotalAmount: number;
+    /** Количество строк */
+    RowsCount: number;
+}
+/** Ответ отчёта по транзакциям кассиров */
+export interface ICashiersTransactionsResponse {
+    /** Список транзакций на текущей странице */
+    Rows: ICashierTransactionRow[];
+    /** Итоги по видам транзакций за период */
+    Totals: ICashierTransactionTotal[];
+    /** Общее количество строк */
+    TotalRows: number;
+    /** Общее количество страниц */
+    TotalPages: number;
+    /** Текущая страница */
+    CurrentPage: number;
+    /** Размер страницы */
+    PageSize: number;
+}
 export type TResponseDataFormat = 'StatusResponse' | null;
 export interface ILiveResponce {
     TimeStamp?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bb-api-platforma",
-  "version": "0.1.266",
+  "version": "0.1.268",
   "description": "API module for BetBooster Platform",
   "productName": "BetBooster Platform API",
   "author": "Tomy Bet <tomybet.com@gmail.com>",