@2bad/bitrix 2.3.1 → 2.5.0

package/README.md

@@ -1,24 +1,25 @@
----
-description: that doesn't suck
----
+![@2bad/bitrix](https://user-images.githubusercontent.com/4460311/64487745-c4a1ea00-d246-11e9-9d6e-a0b0227c801c.png)
 
-# Bitrix24 REST API client
+# Bitrix24 REST API client that doesn't suck
 
-![](https://user-images.githubusercontent.com/4460311/64487745-c4a1ea00-d246-11e9-9d6e-a0b0227c801c.png)
+[![NPM version](https://img.shields.io/npm/v/@2bad/bitrix)](https://www.npmjs.com/package/@2bad/bitrix)
+[![License](https://img.shields.io/npm/l/@2bad/bitrix)](https://www.npmjs.com/package/@2bad/bitrix)
+[![Code coverage](https://img.shields.io/codecov/c/github/2BAD/bitrix)](https://codecov.io/gh/2BAD/bitrix)
+[![Travis Build Status](https://img.shields.io/travis/2BAD/bitrix?logo=Travis)](https://travis-ci.org/github/2BAD/bitrix)
+[![GitHub Build Status](https://img.shields.io/github/workflow/status/2BAD/bitrix/Integration%20testing?logo=GitHub)](https://github.com/2BAD/bitrix/actions?query=workflow%3A%22Integration+testing%22)
+[![Written in TypeScript](https://img.shields.io/github/languages/top/2BAD/bitrix)](https://github.com/2BAD/bitrix/search?l=typescript)
 
- [![NPM version](https://img.shields.io/npm/v/@2bad/bitrix.svg)](https://www.npmjs.com/package/@2bad/bitrix) [![License](https://img.shields.io/npm/l/@2bad/bitrix.svg)](https://www.npmjs.com/package/@2bad/bitrix) [![Code coverage](https://img.shields.io/codecov/c/github/2BAD/bitrix.svg)](https://codecov.io/gh/2BAD/bitrix) [![CircleCI Build Status](https://img.shields.io/circleci/build/gh/2BAD/bitrix/master.svg?label=circle)](https://circleci.com/gh/2BAD/bitrix) [![Dependency Status](https://img.shields.io/david/2BAD/bitrix.svg)](https://david-dm.org/2BAD/bitrix) [![Written in TypeScript](https://img.shields.io/github/languages/top/2BAD/bitrix.svg)](https://github.com/2BAD/bitrix/search?l=typescript)
-
-* 🔥 No bullshit
-* ✨ Expressive API
-* 💪 Strongly typed methods and requests results with TypeScript
-* 🚀 Handles records batching and rate limiting for you
-* ❤️ Promise-based
+- 🔥 No bullshit
+- ✨ Expressive API
+- 💪 Strongly typed methods and requests results with TypeScript
+- 🚀 Handles records batching and rate limiting for you
+- ❤️ Promise-based
 
 ![@2bad/bitrix usage example](https://user-images.githubusercontent.com/4460311/64130824-7798c080-cdcd-11e9-99f0-7ded87541a85.png)
 
 ### Install
 
-```text
+```shell
 npm install @2bad/bitrix
 ```
 
@@ -79,18 +80,18 @@ There are two ways to do that:
 
 ### API
 
-* Generic
-  * [`call()`](docs/methods.md#call)
-  * [`list()`](docs/methods.md#list)
-  * [`batch()`](docs/methods.md#batch)
-* CRM
-  * [Company](docs/services/companies.md)
-  * [Contact](docs/services/contacts.md)
-  * [Currency](docs/services/currencies.md)
-  * [Deal](docs/services/deals.md)
-  * [Lead](docs/services/leads.md)
-  * [Status](docs/services/statuses.md)
-* [User](docs/services/users.md)
+- Generic
+  - [`call()`](docs/methods.md#call)
+  - [`list()`](docs/methods.md#list)
+  - [`batch()`](docs/methods.md#batch)
+- CRM
+  - [Company](docs/services/companies.md)
+  - [Contact](docs/services/contacts.md)
+  - [Currency](docs/services/currencies.md)
+  - [Deal](docs/services/deals.md)
+  - [Lead](docs/services/leads.md)
+  - [Status](docs/services/statuses.md)
+- [User](docs/services/users.md)
 
 ### How it works
 
@@ -98,16 +99,16 @@ The client tries hard to provide a consistent, strongly typed and at the same ti
 
 It takes care of the any necessary batching to run "large" commands, like retrieving all deals or leads with least possible network request. That allows achieving a reading of the 250 000 and updating of 5000 entries per minute with a single line of code.
 
-All client methods are automatically rate-limited and queued if needed to cope with Bitrix REST API limitation of 2 requests per second, so you should never see Bitrix erroring about exceeding rate limits.
+All client methods are automatically rate-limited and queued if needed to cope with Bitrix REST API limitation of 2 requests per second, so you should never see Bitrix errors about exceeding rate limits.
 
-Methods required params and returned payload types are automatically resolved based on [Methods](https://github.com/2BAD/bitrix/tree/b0db508dcebe77f486f7db833183f28de7de14db/source/types.ts) interface, which effectively describes all currently supported methods.
+Methods required params and returned payload types are automatically resolved based on [Methods](source/types.ts) interface, which effectively describes all currently supported methods.
 
 To facilitate better architecture, the client divided into layers:
 
 1. **Methods** — a mostly generic [methods](docs/methods.md) like `call` to work with Bitrix API methods. They take care of the routine and provide a foundation for more complex operations.
-2. **Client** — a generic [client](https://github.com/2BAD/bitrix/tree/b0db508dcebe77f486f7db833183f28de7de14db/source/client/README.md), which takes care of some additional routine tasks like setting access token on every request, setting up a queue for the rate limiting, and providing generic methods.
-3. **Services** — each [service](https://github.com/2BAD/bitrix/tree/b0db508dcebe77f486f7db833183f28de7de14db/docs/services/README.md) provides an expressive interface to work with a specific group of Bitrix REST API operations. In essence, they do orchestrate generic client methods and parameters to get proper results.
-4. **Bitrix client** — a top-level [provider](https://github.com/2BAD/bitrix/tree/b0db508dcebe77f486f7db833183f28de7de14db/source/bitrix.ts) of generic method and services. An effortless way to deal with Bitrix REST API by using an intuitive API, which takes care of all underlying complexity.
+2. **Client** — a generic [client](source/client/README.md), which takes care of some additional routine tasks like setting access token on every request, setting up a queue for the rate limiting, and providing generic methods.
+3. **Services** — each [service](docs/services/README.md) provides an expressive interface to work with a specific group of Bitrix REST API operations. In essence, they do orchestrate generic client methods and parameters to get proper results.
+4. **Bitrix client** — a top-level [provider](source/bitrix.ts) of generic method and services. An effortless way to deal with Bitrix REST API by using an intuitive API, which takes care of all underlying complexity.
 
 ### FAQ
 
@@ -117,7 +118,7 @@ The core is ready and stable. It can be used to arbitrary invoke any Bitrix REST
 
 However, not all Bitrix REST API methods are exposed as convenient client services yet \(the ones like `bitrix.deals.list()`\).
 
-If you need specific service, add one by making a Pull Request, following the structure of already existing [services](https://github.com/2BAD/bitrix/tree/b0db508dcebe77f486f7db833183f28de7de14db/source/services/README.md) and ["Adding new methods"](./#adding-new-methods) instructions.
+If you need specific service, add one by making a Pull Request, following the structure of already existing [services](source/services/README.md) and ["Adding new methods"](./#adding-new-methods) instructions.
 
 > I'm not a Typed Language Master Race user. Can I use it with a regular JavaScript?
 
@@ -170,6 +171,14 @@ bitrix.list('some.new.list' as any, { select: ["TITLE"] })
 
 Use the `batch` method. It will handle all routine:
 
+> I'm using a self-signed SSL certificate and I'm getting a `[RequestError]: self signed certificate`. What should I do?
+
+Override [`got options`](https://github.com/sindresorhus/got/blob/main/documentation/2-options.md) in constructor:
+
+```typescript
+const bitrix = Bitrix('https://PORTAL_NAME.bitrix24.ru/rest', 'ACCESS_TOKEN', {https: { rejectUnauthorized: false }})
+```
+
 ```typescript
 bitrix.batch({
   lead: { method: Method.GET_LEAD, params: { ID: '77' } },
@@ -179,26 +188,25 @@ bitrix.batch({
 
 ### Development
 
-* `npm test` — run all tests and collect full coverage report
-* `npm run test:unit` — run unit tests and collect coverage report
-* `npm run test:integration` — run integration tests and collect coverage report
-* `npm run test:watch` — watch for changes and run all tests
-* `npm run test:unit:watch` — watch for changes and run unit tests
-* `npm run test:integration:watch` — watch for changes and run integration tests
-* `npm run build` — build the library for the release
+- `npm test` — run all tests and collect full coverage report
+- `npm run test:unit` — run unit tests and collect coverage report
+- `npm run test:integration` — run integration tests and collect coverage report
+- `npm run test:watch` — watch for changes and run all tests
+- `npm run test:unit:watch` — watch for changes and run unit tests
+- `npm run test:integration:watch` — watch for changes and run integration tests
+- `npm run build` — build the library for the release
 
 #### Adding new methods
 
 Proper method parameters and payload types handling requires some routine when adding any new method. Hopefully, we can do it better in future, but for now follow those steps:
 
-1. Add new method into the [`Method`](https://github.com/2BAD/bitrix/tree/b0db508dcebe77f486f7db833183f28de7de14db/source/methods.ts) enum.
-2. Add it into the [`LISTABLE_METHODS`](https://github.com/2BAD/bitrix/tree/b0db508dcebe77f486f7db833183f28de7de14db/source/methods.ts) array if it is listable \(paginated\). Not everything that lists is listable, so check it.
-3. Add or update related [service](https://github.com/2BAD/bitrix/tree/b0db508dcebe77f486f7db833183f28de7de14db/source/services/README.md):
+1. Add new method into the [`Method`](source/methods.ts) enum.
+2. Add it into the [`LISTABLE_METHODS`](source/methods.ts) array if it is listable \(paginated\). Not everything that lists is listable, so check it.
+3. Add or update related [service](source/services/README.md):
    1. Put exposed by the service public methods into the `index.ts` file. Ensure that you're properly mapping service method arguments to `call` or `list` params.
    2. Add related entities into the `entities.ts`.
    3. Add interface describing service methods into the `methods.ts`. Test and check method payload type to be sure you've described it correctly!
-   4. Extend [`Methods`](https://github.com/2BAD/bitrix/tree/b0db508dcebe77f486f7db833183f28de7de14db/source/methods.ts) interface with the added service-specific interface. That way the client will know how to resolve parameters and payload types for the added method.
+   4. Extend [`Methods`](source/methods.ts) interface with the added service-specific interface. That way the client will know how to resolve parameters and payload types for the added method.
    5. Add tests into the `index.unit.test.ts`.
-4. Re-export service public types like Entities in the [bitrix.ts](https://github.com/2BAD/bitrix/tree/b0db508dcebe77f486f7db833183f28de7de14db/source/bitrix.ts) to make them available to the end-users.
-5. Document addition in the [docs](https://github.com/2BAD/bitrix/tree/b0db508dcebe77f486f7db833183f28de7de14db/docs/README.md).
-
+4. Re-export service public types like Entities in the [bitrix.ts](source/bitrix.ts) to make them available to the end-users.
+5. Document addition in the [docs](docs/README.md).

package/build/main/bitrix.d.ts

@@ -1,4 +1,13 @@
-declare const _default: (restURI: string, accessToken?: string | undefined) => {
+import { ExtendOptions } from 'got';
+/**
+ * Construct a Bitrix client with generic methods
+ * @param restURI REST endpoint, like a `https://hello.bitrix24.ua/rest` or an inbound webhook endpoint,
+ *                like a `https://hello.bitrix24.ua/rest/1/WEBHOOK_TOKEN`.
+ * @param accessToken Bitrix application Access Token. Do not specify in case inbound webhook endpoint used.
+ * @param clientOptions an object that will overwrite underlying configuration for HTTP client,
+ *                see `https://github.com/sindresorhus/got/blob/main/documentation/2-options.md`.
+ */
+declare const _default: (restURI: string, accessToken?: string, clientOptions?: ExtendOptions) => {
     call: import("./client/methods/call").Call;
     batch: import("./client/methods/batch").Batch;
     list: import("./client/methods/list").List;
@@ -7,16 +16,16 @@ declare const _default: (restURI: string, accessToken?: string | undefined) => {
         create: <D extends {
             readonly fields: Partial<import("./services/companies/entities").Company>;
             readonly params?: {
-                readonly REGISTER_SONET_EVENT: import("./services/common").BoolString;
+                readonly REGISTER_SONET_EVENT: "Y" | "N";
             } | undefined;
         }>(fields: D["fields"], params?: D["params"] | undefined) => Promise<import("./payloads").GetPayload<number>>;
         get: (id: string) => Promise<import("./payloads").GetPayload<import("./services/companies/entities").Company>>;
         list: (params?: import("./methods").ListParams) => Promise<import("./payloads").ListPayload<import("./services/companies/entities").Company>>;
         update: <D_1 extends {
             readonly id: string;
-            readonly fields: Record<string, any>;
+            readonly fields: Record<string, unknown>;
             readonly params?: {
-                readonly REGISTER_SONET_EVENT: import("./services/common").BoolString;
+                readonly REGISTER_SONET_EVENT: "Y" | "N";
             } | undefined;
         }>(id: string, fields: D_1["fields"], params?: D_1["params"] | undefined) => Promise<import("./payloads").GetPayload<boolean>>;
     };
@@ -25,16 +34,16 @@ declare const _default: (restURI: string, accessToken?: string | undefined) => {
         create: <D_2 extends {
             readonly fields: Partial<import("./services/contacts/entities").Contact>;
             readonly params?: {
-                readonly REGISTER_SONET_EVENT: import("./services/common").BoolString;
+                readonly REGISTER_SONET_EVENT: "Y" | "N";
             } | undefined;
         }>(fields: D_2["fields"], params?: D_2["params"] | undefined) => Promise<import("./payloads").GetPayload<number>>;
         get: (id: string) => Promise<import("./payloads").GetPayload<import("./services/contacts/entities").Contact>>;
         list: (params?: import("./methods").ListParams) => Promise<import("./payloads").ListPayload<import("./services/contacts/entities").Contact>>;
         update: <D_3 extends {
             readonly id: string;
-            readonly fields: Record<string, any>;
+            readonly fields: Record<string, unknown>;
             readonly params?: {
-                readonly REGISTER_SONET_EVENT: import("./services/common").BoolString;
+                readonly REGISTER_SONET_EVENT: "Y" | "N";
             } | undefined;
         }>(id: string, fields: D_3["fields"], params?: D_3["params"] | undefined) => Promise<import("./payloads").GetPayload<boolean>>;
     };
@@ -43,16 +52,16 @@ declare const _default: (restURI: string, accessToken?: string | undefined) => {
         create: <D_4 extends {
             readonly fields: Partial<import("./services/deals/entities").Deal>;
             readonly params?: {
-                readonly REGISTER_SONET_EVENT: import("./services/common").BoolString;
+                readonly REGISTER_SONET_EVENT: "Y" | "N";
             } | undefined;
         }>(fields: D_4["fields"], params?: D_4["params"] | undefined) => Promise<import("./payloads").GetPayload<number>>;
         get: (id: string) => Promise<import("./payloads").GetPayload<import("./services/deals/entities").Deal>>;
         list: (params?: import("./methods").ListParams) => Promise<import("./payloads").ListPayload<import("./services/deals/entities").Deal>>;
         update: <D_5 extends {
             readonly id: string;
-            readonly fields: Record<string, any>;
+            readonly fields: Record<string, unknown>;
             readonly params?: {
-                readonly REGISTER_SONET_EVENT: import("./services/common").BoolString;
+                readonly REGISTER_SONET_EVENT: "Y" | "N";
             } | undefined;
         }>(id: string, fields: D_5["fields"], params?: D_5["params"] | undefined) => Promise<import("./payloads").GetPayload<boolean>>;
     };
@@ -61,16 +70,16 @@ declare const _default: (restURI: string, accessToken?: string | undefined) => {
         create: <D_6 extends {
             readonly fields: Partial<import("./services/leads/entities").Lead>;
             readonly params?: {
-                readonly REGISTER_SONET_EVENT: import("./services/common").BoolString;
+                readonly REGISTER_SONET_EVENT: "Y" | "N";
             } | undefined;
         }>(fields: D_6["fields"], params?: D_6["params"] | undefined) => Promise<import("./payloads").GetPayload<number>>;
         get: (id: string) => Promise<import("./payloads").GetPayload<import("./services/leads/entities").Lead>>;
         list: (params?: import("./methods").ListParams) => Promise<import("./payloads").ListPayload<import("./services/leads/entities").Lead>>;
         update: <D_7 extends {
             readonly id: string;
-            readonly fields: Record<string, any>;
+            readonly fields: Record<string, unknown>;
             readonly params?: {
-                readonly REGISTER_SONET_EVENT: import("./services/common").BoolString;
+                readonly REGISTER_SONET_EVENT: "Y" | "N";
             } | undefined;
         }>(id: string, fields: D_7["fields"], params?: D_7["params"] | undefined) => Promise<import("./payloads").GetPayload<boolean>>;
     };
@@ -82,10 +91,10 @@ declare const _default: (restURI: string, accessToken?: string | undefined) => {
         } | undefined) => Promise<import("./payloads").GetPayload<boolean>>;
         get: (id: string | number) => Promise<import("./payloads").GetPayload<import("./services/statuses/entities").Status>>;
         list: (params?: {
-            readonly order?: Record<string, any> | undefined;
-            readonly filter?: Record<string, any> | undefined;
+            readonly order?: Record<string, unknown> | undefined;
+            readonly filter?: Record<string, unknown> | undefined;
         }) => Promise<import("./payloads").ListPayload<import("./services/statuses/entities").Status>>;
-        update: (id: string | number, fields: Record<string, any>) => Promise<import("./payloads").GetPayload<boolean>>;
+        update: (id: string | number, fields: Record<string, unknown>) => Promise<import("./payloads").GetPayload<boolean>>;
     };
     users: {
         fields: () => Promise<import("./payloads").GetPayload<import("./services/users/entities").User>>;

package/build/main/bitrix.integration.test.js

@@ -29,4 +29,3 @@ describe('Bitrix API', () => {
         });
     });
 });
-//# sourceMappingURL=bitrix.integration.test.js.map

package/build/main/bitrix.js

@@ -1,7 +1,18 @@
 "use strict";
-function __export(m) {
-    for (var p in m) if (!exports.hasOwnProperty(p)) exports[p] = m[p];
-}
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -13,19 +24,35 @@ const deals_1 = __importDefault(require("./services/deals"));
 const leads_1 = __importDefault(require("./services/leads"));
 const statuses_1 = __importDefault(require("./services/statuses"));
 const users_1 = __importDefault(require("./services/users"));
-exports.default = (restURI, accessToken) => {
-    const { call, batch, list } = client_1.default(restURI, accessToken);
+/**
+ * Construct a Bitrix client with generic methods
+ * @param restURI REST endpoint, like a `https://hello.bitrix24.ua/rest` or an inbound webhook endpoint,
+ *                like a `https://hello.bitrix24.ua/rest/1/WEBHOOK_TOKEN`.
+ * @param accessToken Bitrix application Access Token. Do not specify in case inbound webhook endpoint used.
+ * @param clientOptions an object that will overwrite underlying configuration for HTTP client,
+ *                see `https://github.com/sindresorhus/got/blob/main/documentation/2-options.md`.
+ */
+exports.default = (restURI, accessToken, clientOptions) => {
+    const { call, batch, list } = (0, client_1.default)(restURI, accessToken, clientOptions);
     return {
         call,
         batch,
         list,
-        companies: companies_1.default({ call, list }),
-        contacts: contacts_1.default({ call, list }),
-        deals: deals_1.default({ call, list }),
-        leads: leads_1.default({ call, list }),
-        statuses: statuses_1.default({ call }),
-        users: users_1.default({ call })
+        companies: (0, companies_1.default)({ call, list }),
+        contacts: (0, contacts_1.default)({ call, list }),
+        deals: (0, deals_1.default)({ call, list }),
+        leads: (0, leads_1.default)({ call, list }),
+        statuses: (0, statuses_1.default)({ call }),
+        users: (0, users_1.default)({ call })
     };
 };
-__export(require("./methods"));
-//# sourceMappingURL=bitrix.js.map
+__exportStar(require("./methods"), exports);
+__exportStar(require("./commands"), exports);
+__exportStar(require("./services/common"), exports);
+__exportStar(require("./services/companies/entities"), exports);
+__exportStar(require("./services/contacts/entities"), exports);
+__exportStar(require("./services/currencies/entities"), exports);
+__exportStar(require("./services/deals/entities"), exports);
+__exportStar(require("./services/leads/entities"), exports);
+__exportStar(require("./services/statuses/entities"), exports);
+__exportStar(require("./services/users/entities"), exports);

package/build/main/bitrix.unit.test.js

@@ -1,29 +1,44 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
 var __importStar = (this && this.__importStar) || function (mod) {
     if (mod && mod.__esModule) return mod;
     var result = {};
-    if (mod != null) for (var k in mod) if (Object.hasOwnProperty.call(mod, k)) result[k] = mod[k];
-    result["default"] = mod;
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
     return result;
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const bitrix_1 = __importDefault(require("./bitrix"));
 const client = __importStar(require("./client"));
 describe('Bitrix', () => {
     it('should init', () => {
-        expect(() => bitrix_1.default('https://test.com', 'test_token')).not.toThrow();
+        expect(() => (0, bitrix_1.default)('https://test.com', 'test_token')).not.toThrow();
     });
     it('should pass endpoint and access token to the client', () => {
         const SpiedClient = jest.spyOn(client, 'default');
-        bitrix_1.default('https://test.com', 'test_token');
+        (0, bitrix_1.default)('https://test.com', 'test_token');
         expect(SpiedClient.mock.calls).toMatchSnapshot();
     });
     it('should expose API methods', () => {
-        const bitrix = bitrix_1.default('https://test.com', 'test_token');
+        const bitrix = (0, bitrix_1.default)('https://test.com', 'test_token');
         expect(bitrix).toMatchSnapshot();
     });
 });
-//# sourceMappingURL=bitrix.unit.test.js.map

package/build/main/client/client.unit.test.js

@@ -12,30 +12,30 @@ const TEST_URI = 'https://test.com/rest';
 const TEST_ACCESS_TOKEN = 'test_access_token';
 const RESPONSE_200 = 200;
 const spiedQueueAdd = jest.spyOn(p_queue_1.default.prototype, 'add');
-const client = index_1.default(TEST_URI, TEST_ACCESS_TOKEN);
+const client = (0, index_1.default)(TEST_URI, TEST_ACCESS_TOKEN);
 describe('Client', () => {
     beforeEach(() => {
         spiedQueueAdd.mockClear();
     });
     it('should init', () => {
-        expect(() => index_1.default(TEST_URI, TEST_ACCESS_TOKEN)).not.toThrow();
+        expect(() => (0, index_1.default)(TEST_URI, TEST_ACCESS_TOKEN)).not.toThrow();
     });
     it('should extend `Got` instance with a specified parameters', () => {
         const spiedGotExtend = jest.spyOn(got_1.default, 'extend');
-        index_1.default('https://test.com', 'test_token');
+        (0, index_1.default)('https://test.com', 'test_token', { https: { rejectUnauthorized: false } });
         expect(spiedGotExtend.mock.calls).toMatchSnapshot();
     });
     it('should expose API methods', () => {
         expect(client).toMatchSnapshot();
     });
     describe('`call`', () => {
-        it('should add to queue', async () => {
+        // @todo restore test when issue is resolved (https://github.com/nock/nock/issues/1832)
+        it.skip('should add to queue', async () => {
             const payload = {};
             const method = methods_1.Method.CRM_DEAL_LIST;
-            nock_1.default(TEST_URI)
-                .get(`/${method}?access_token=${TEST_ACCESS_TOKEN}`)
-                .reply(RESPONSE_200, payload)
+            (0, nock_1.default)(TEST_URI)
                 .get(`/${method}?access_token=${TEST_ACCESS_TOKEN}`)
+                .twice()
                 .reply(RESPONSE_200, payload);
             await client.call(method, {});
             await client.call(method, {});
@@ -43,7 +43,8 @@ describe('Client', () => {
         });
     });
     describe('`batch`', () => {
-        it('should add to queue', async () => {
+        // @todo restore test when issue is resolved (https://github.com/nock/nock/issues/1832)
+        it.skip('should add to queue', async () => {
             const payload = {
                 result: {
                     result: ['done'],
@@ -54,7 +55,10 @@ describe('Client', () => {
                 { method: methods_1.Method.CRM_DEAL_GET },
                 { method: methods_1.Method.CRM_DEAL_LIST }
             ];
-            nock_1.default(TEST_URI)
+            (0, nock_1.default)(TEST_URI)
+                // @todo We'd want to use `query` object here as it is much more readable, but nock for some reason
+                //       fails to match request when it contains `cmd[someName]`. The issue definitely connected
+                //       to the `[]`, since it does not appear when only one bracket present
                 .get(`/${methods_1.Method.BATCH}?cmd%5B0%5D=${commands[0].method}&access_token=${TEST_ACCESS_TOKEN}`)
                 .reply(RESPONSE_200, payload)
                 .get(`/${methods_1.Method.BATCH}?cmd%5B0%5D=${commands[1].method}&access_token=${TEST_ACCESS_TOKEN}`)
@@ -64,4 +68,3 @@ describe('Client', () => {
         });
     });
 });
-//# sourceMappingURL=client.unit.test.js.map

package/build/main/client/hooks/addAccessToken.d.ts

@@ -1,3 +1,6 @@
-import got from 'got';
-declare const _default: (accessToken?: string | undefined) => (options: got.GotJSONOptions) => void;
+import { BeforeRequestHook } from 'got';
+/**
+ * Got can't merge `query` option with other queries if they are string. But that hook can.
+ */
+declare const _default: (accessToken?: string) => BeforeRequestHook;
 export default _default;

package/build/main/client/hooks/addAccessToken.js

@@ -1,5 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Got can't merge `query` option with other queries if they are string. But that hook can.
+ */
 exports.default = (accessToken) => (options) => {
     if (!accessToken)
         return;
@@ -8,4 +11,3 @@ exports.default = (accessToken) => (options) => {
     const hasQuery = options.path.includes('?');
     options.path = `${options.path}${hasQuery ? '&' : '?'}access_token=${accessToken}`;
 };
-//# sourceMappingURL=addAccessToken.js.map

package/build/main/client/hooks/addAccessToken.unit.test.js

@@ -3,28 +3,29 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const got_1 = __importDefault(require("got"));
 const addAccessToken_1 = __importDefault(require("./addAccessToken"));
 const token = 'mock_token';
+const merge = got_1.default.mergeOptions;
 describe('Client `addAccessToken` hook', () => {
     it('should add access token to URL without a query', () => {
-        const options = { json: true, path: '/test' };
-        addAccessToken_1.default(token)(options);
-        expect(options.path).toBe(`/test?access_token=${token}`);
+        const options = merge({ path: 'test', responseType: 'json' });
+        (0, addAccessToken_1.default)(token)(options);
+        expect(options.path).toBe(`test?access_token=${token}`);
     });
     it('should add access token to URL with a query', () => {
-        const options = { json: true, path: '/test?value=1' };
-        addAccessToken_1.default(token)(options);
-        expect(options.path).toBe(`/test?value=1&access_token=${token}`);
+        const options = merge({ path: 'test?value=1', responseType: 'json' });
+        (0, addAccessToken_1.default)(token)(options);
+        expect(options.path).toBe(`test?value=1&access_token=${token}`);
     });
     it('should not add access token when it is undefined', () => {
-        const options = { json: true, path: '/test' };
-        addAccessToken_1.default()(options);
-        expect(options.path).toBe('/test');
+        const options = merge({ path: 'test', responseType: 'json' });
+        (0, addAccessToken_1.default)()(options);
+        expect(options.path).toBe('test');
     });
     it('should not add access token when URL is undefined', () => {
-        const options = { json: true, path: undefined };
-        addAccessToken_1.default(token)(options);
+        const options = merge({ path: undefined, responseType: 'json' });
+        (0, addAccessToken_1.default)(token)(options);
         expect(options.path).toBe(undefined);
     });
 });
-//# sourceMappingURL=addAccessToken.unit.test.js.map

package/build/main/client/index.d.ts

@@ -1,4 +1,13 @@
-declare const _default: (restURI: string, accessToken?: string | undefined) => {
+import { ExtendOptions } from 'got';
+/**
+ * Construct a Bitrix client with generic methods
+ * @param restURI REST endpoint, like a `https://hello.bitrix24.ru/rest` or an inbound webhook endpoint,
+ *                like a `https://hello.bitrix24.ru/rest/1/WEBHOOK_TOKEN`.
+ * @param accessToken Bitrix application Access Token. Do not specify in case inbound webhook endpoint used.
+ * @param options an object that will overwrite underlying configuration for HTTP client,
+ *                see `https://github.com/sindresorhus/got/blob/main/documentation/2-options.md`.
+ */
+declare const _default: (restURI: string, accessToken?: string, options?: ExtendOptions) => {
     call: import("./methods/call").Call;
     batch: import("./methods/batch").Batch;
     list: import("./methods/list").List;

package/build/main/client/index.js

@@ -10,32 +10,44 @@ const batch_1 = __importDefault(require("./methods/batch"));
 const call_1 = __importDefault(require("./methods/call"));
 const list_1 = __importDefault(require("./methods/list"));
 const BITRIX_API_RATE_LIMIT = 2;
-const BITRIX_API_RATE_INTERVAL = 1000;
-exports.default = (restURI, accessToken) => {
+const BITRIX_API_RATE_INTERVAL = 1000; // 1 second
+/**
+ * Construct a Bitrix client with generic methods
+ * @param restURI REST endpoint, like a `https://hello.bitrix24.ru/rest` or an inbound webhook endpoint,
+ *                like a `https://hello.bitrix24.ru/rest/1/WEBHOOK_TOKEN`.
+ * @param accessToken Bitrix application Access Token. Do not specify in case inbound webhook endpoint used.
+ * @param options an object that will overwrite underlying configuration for HTTP client,
+ *                see `https://github.com/sindresorhus/got/blob/main/documentation/2-options.md`.
+ */
+exports.default = (restURI, accessToken, options) => {
     const client = got_1.default.extend({
-        baseUrl: restURI,
+        prefixUrl: restURI,
         headers: {
-            'user-agent': `@2bad/bitrix`
+            'user-agent': '@2bad/bitrix'
         },
-        json: true,
+        responseType: 'json',
         hooks: {
             beforeRequest: [
-                addAccessToken_1.default(accessToken)
+                (0, addAccessToken_1.default)(accessToken)
             ]
-        }
+        },
+        ...options !== null && options !== void 0 ? options : {}
     });
     const queue = new p_queue_1.default({
         intervalCap: BITRIX_API_RATE_LIMIT,
         interval: BITRIX_API_RATE_INTERVAL
     });
     const queuedGet = (...args) => queue.add(() => client.get(...args));
-    const call = call_1.default({ get: queuedGet });
-    const batch = batch_1.default({ get: queuedGet });
-    const list = list_1.default({ call, batch });
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-expect-error @todo remove after issue is resolved (https://github.com/sindresorhus/got/issues/954)
+    const call = (0, call_1.default)({ get: queuedGet });
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-expect-error @todo remove after issue is resolved (https://github.com/sindresorhus/got/issues/954)
+    const batch = (0, batch_1.default)({ get: queuedGet });
+    const list = (0, list_1.default)({ call, batch });
     return {
         call,
         batch,
         list
     };
 };
-//# sourceMappingURL=index.js.map