bx-rest 1.2.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bx-rest",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Bitrix24 REST API client and TypeScript SDK for Angular, Vue and browser apps",
   "keywords": [
     "bitrix",

package/rest/base.d.ts

@@ -29,5 +29,5 @@ export declare class BXRest {
     readonly socialNetWork: BXRestSocialNetWork;
     readonly pull: BXRestPull;
     profile(): import("rxjs").Observable<import("../typification/rest/base").iBXRestAnswer<iBXRestProfileHttp> | undefined>;
-    batch<T>(param: iBXRestParamBatch): import("rxjs").Observable<import("../typification/rest/base").iBXRestAnswer<iBXRestBatch<T>> | undefined>;
+    batch<T>(param: iBXRestParamBatch, headers?: Record<string, string>): import("rxjs").Observable<import("../typification/rest/base").iBXRestAnswer<iBXRestBatch<T>> | undefined>;
 }

package/services/http/HttpBX.d.ts

@@ -2,6 +2,7 @@ import { Observable } from 'rxjs';
 import { HttpServices } from './http';
 import { iBatchRequestAnswer, iBatchRequestParam, iBatchRequestParamArr, iBatchRequestParamHttp, keyBatch } from '../../typification/rest/batch/batchRequestParam';
 import { iBXRestAnswer } from '../../typification/rest/base/answer';
+import { iHttpParamSettings } from '../../typification/rest/settings';
 export declare class HttpBXServices extends HttpServices {
     /**
      * Не считайте этот метод образцом/финальным API.
@@ -17,17 +18,27 @@ export declare class HttpBXServices extends HttpServices {
      *
      * @param name
      * @param params
+     * @param restApi
+     * @param headers заголовки только для этого запроса, поверх `BXRestSettings.headers`
      */
-    post<T>(name: string[], params?: any, restApi?: boolean): Observable<iBXRestAnswer<T> | undefined>;
+    post<T>(name: string[], params?: any, restApi?: boolean, headers?: Record<string, string>): Observable<iBXRestAnswer<T> | undefined>;
     /**
      * Второстепенный метод для запросов. По возможности лучше не использовать
      *
      * @param name
      * @param params
+     * @param headers заголовки только для этого запроса, поверх `BXRestSettings.headers`
      */
-    get<T>(name: string[], params?: any): Observable<iBXRestAnswer<T> | undefined>;
-    httpPost<T>(url: string, params?: any): Observable<T | undefined>;
-    httpGet<T>(url: string, params?: any): Observable<T | undefined>;
+    get<T>(name: string[], params?: any, headers?: Record<string, string>): Observable<iBXRestAnswer<T> | undefined>;
+    httpPost<T>(url: string, params?: any, settings?: iHttpParamSettings, headers?: Record<string, string>): Observable<T | undefined>;
+    httpGet<T>(url: string, params?: any, settings?: iHttpParamSettings, headers?: Record<string, string>): Observable<T | undefined>;
+    /**
+     * Заголовки запроса: `BXRestSettings.headers`, поверх них — заголовки
+     * конкретного запроса, поверх всего — `required`. В `required` идёт
+     * `Content-Type`: от него зависит, как сервер разберёт тело, поэтому
+     * пользовательские заголовки его не перебивают.
+     */
+    private buildHeaders;
     serializeBitrixParams(params: unknown): string;
     getNameMethod(arr: string[]): string;
 }

package/services/http/sessionKey.d.ts

@@ -21,6 +21,11 @@ export declare class SessionKeyServices {
      * сохраняется историческое поведение: включаем только для `auth.key === 'OAuth2'`.
      */
     getWithCredentials(): boolean;
+    /**
+     * Статичные заголовки из `BXRestSettings.headers` — копия, чтобы правка
+     * результата не меняла сами настройки.
+     */
+    getHeaders(): Record<string, string>;
     getSessid(): string;
     getAuthParams(): string | undefined;
     getCheckAuthParamsIsOn(): boolean;

package/services/navvy/extends/navvy-pag-base.d.ts

@@ -22,8 +22,19 @@ export declare abstract class NavvyPagBase<T, R, P> {
     protected map: ((param: T | undefined) => R | undefined) | undefined;
     protected restApi: boolean;
     protected readonly http: HttpBXServices;
+    protected requestHeaders?: Record<string, string>;
     pageSize: number;
     constructor(url: string[], param: P, map?: ((param: T | undefined) => R | undefined) | undefined, restApi?: boolean);
+    /**
+     * HTTP-заголовки только для этого запроса — поверх `BXRestSettings.headers`
+     * (при совпадении имени побеждает значение отсюда). Повторные вызовы
+     * дополняют уже заданные заголовки. Действует на `.res()`, `.resVanilla()`,
+     * `.mapForVanilla()` и на все batch-запросы `.resAll()`.
+     *
+     * @example
+     * bx.crm.deal.list({ ... }).withHeaders({ 'X-Request-Source': 'report' }).resAll()
+     */
+    withHeaders(headers: Record<string, string>): this;
     resVanilla(): Observable<iBXRestAnswer<T> | undefined>;
     mapForVanilla(): Observable<iBXRestAnswer<ReturnTypeNavvy<T, R>> | undefined>;
     res(options?: BXRestResOptions): Observable<ReturnTypeNavvy<T, R> | undefined>;

package/typification/settings.d.ts

@@ -17,4 +17,11 @@ export interface iBXRestSettings {
      * а браузер должен приложить cookie сессии этого прокси (не Bitrix24).
      */
     withCredentials?: boolean;
+    /**
+     * Статичные HTTP-заголовки, которые прикладываются к каждому запросу,
+     * например `{ 'X-Bitrix-App': 'smart-process-pro' }`. Для одного запроса
+     * их можно дополнить или перебить через `.withHeaders()`. `Content-Type`
+     * библиотека всегда выставляет сама — от него зависит формат тела запроса.
+     */
+    headers?: Record<string, string>;
 }