@v3finance/monitoring-sdk 0.1.0 → 0.2.0

package/dist/cjs/client.js

@@ -1,88 +1,79 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MonitoringClient = void 0;
+const errors_js_1 = require("./core/errors.js");
 const http_js_1 = require("./core/http.js");
 const account_js_1 = require("./resources/account.js");
 const addresses_js_1 = require("./resources/addresses.js");
 const catalog_js_1 = require("./resources/catalog.js");
-const clients_js_1 = require("./resources/clients.js");
 const deliveries_js_1 = require("./resources/deliveries.js");
 const transactions_js_1 = require("./resources/transactions.js");
+const webhooks_js_1 = require("./resources/webhooks.js");
 const version_js_1 = require("./version.js");
 /**
- * Клиент API мониторинга адресов V3 Finance: адреса и подписки, история вебхуков, транзакции, ваш клиент и ключи.
- * Только для сервера: ключ в браузере увидит любой.
+ * Client for the V3 Finance Monitoring API.
  *
- * @example С ключом клиента — для бэкенда
+ * Use it on the server only: an API key in a browser is visible to anyone.
+ *
+ * @example
  * ```ts
  * import { MonitoringClient } from '@v3finance/monitoring-sdk'
  *
- * const monitoring = new MonitoringClient({ apiKey: process.env.MONITORING_API_KEY })
- * await monitoring.addresses.add(clientId, [{ network: 'tron', address: 'T…' }], { assets: ['USDT'], direction: 'in' })
- * ```
+ * const monitoring = new MonitoringClient({ apiKey: process.env.MONITORING_API_KEY! })
  *
- * @example По паролю — для скриптов, которым нужны права пользователя
- * ```ts
- * const { client } = await MonitoringClient.signIn({ email, password })
- * const { key } = await client.account.keys.create({ name: 'ci' })
+ * await monitoring.addresses.add([{ network: 'tron', address: 'TA8Hg…' }], { assets: ['USDT'], direction: 'in' })
  * ```
  */
 class MonitoringClient {
-    /** Кто вы и ваши личные ключи */
+    /** Your client: the account your API key belongs to. */
     account;
-    /** Выход и смена пароля (для клиента, вошедшего по паролю) */
-    auth;
-    /** Сети */
-    networks;
-    /** Нативные монеты и токены */
-    assets;
-    /** Ваш клиент: URL вебхука, секрет, ключи, участники, тестовый вебхук */
-    clients;
-    /** Адреса на мониторинге и подписка */
+    /** Addresses you monitor and their subscriptions. */
     addresses;
-    /** История вебхуков */
+    /** Test your webhook endpoint. */
+    webhooks;
+    /** History of webhooks sent to you. */
     deliveries;
-    /** Транзакция по хешу: статус, подтверждения, финальность */
+    /** Any transaction by hash, with confirmations and finality. */
     transactions;
+    /** Supported networks. */
+    networks;
+    /** Supported native coins and tokens. */
+    assets;
     #http;
+    #clientId;
     /**
-     * @param options - ключ (`apiKey`) или токен сессии (`sessionToken`), адрес API, таймаут, повторы
-     * @throws {@link MonitoringError} переданы и ключ, и токен; нет `fetch`
+     * @param options - API key and optional settings.
+     * @throws {@link MonitoringError} when `apiKey` is missing or `fetch` is not available.
      */
-    constructor(options = {}) {
+    constructor(options) {
         this.#http = new http_js_1.HttpClient(options, version_js_1.DEFAULT_BASE_URL);
-        this.account = new account_js_1.AccountResource(this.#http);
-        this.auth = new account_js_1.AuthResource(this.#http);
-        this.networks = new catalog_js_1.NetworksResource(this.#http);
-        this.assets = new catalog_js_1.AssetsResource(this.#http);
-        this.clients = new clients_js_1.ClientsResource(this.#http);
-        this.addresses = new addresses_js_1.AddressesResource(this.#http);
-        this.deliveries = new deliveries_js_1.DeliveriesResource(this.#http);
-        this.transactions = new transactions_js_1.TransactionsResource(this.#http);
+        if (options.clientId)
+            this.#clientId = Promise.resolve(options.clientId);
+        const scope = { http: this.#http, clientPath: async () => `/v1/clients/${(0, http_js_1.seg)(await this.#resolveClientId())}` };
+        this.account = new account_js_1.AccountResource(scope, () => this.#resolveClientId());
+        this.addresses = new addresses_js_1.AddressesResource(scope);
+        this.webhooks = new webhooks_js_1.WebhooksResource(scope);
+        this.deliveries = new deliveries_js_1.DeliveriesResource(scope);
+        this.transactions = new transactions_js_1.TransactionsResource(scope);
+        this.networks = new catalog_js_1.NetworksResource(scope);
+        this.assets = new catalog_js_1.AssetsResource(scope);
     }
-    /** Адрес API, с которым работает клиент */
+    /** API base URL this client sends requests to. */
     get baseUrl() {
         return this.#http.baseUrl;
     }
-    /**
-     * Вход по email и паролю: возвращает клиента с токеном сессии. Регистрации нет — пользователей заводит
-     * администратор сервиса. Не больше 3 попыток за 10 секунд с одного IP.
-     *
-     * @param options - настройки клиента, кроме учётных данных
-     * @throws {@link MonitoringApiError} 401 — неверный email или пароль
-     */
-    static async signIn(credentials, options = {}, requestOptions) {
-        const http = new http_js_1.HttpClient(options, version_js_1.DEFAULT_BASE_URL);
-        const r = await http.request({
-            method: 'POST',
-            path: '/api/auth/sign-in/email',
-            body: credentials,
-            idempotent: false,
-            auth: false,
-            // повтор при отказе 429 только сожжёт попытки входа
-            options: { maxRetries: 0, ...requestOptions },
+    /** Client ID of the API key: from the options, or resolved once from the API and cached. */
+    #resolveClientId() {
+        this.#clientId ??= this.#http.request({ method: 'GET', path: '/v1/me', idempotent: true }).then((identity) => {
+            if (!identity.actor.clientId)
+                throw new errors_js_1.MonitoringError('this API key is not bound to a client: pass clientId in the options');
+            return identity.actor.clientId;
+        }, (error) => {
+            // a failed lookup is not cached: the next call tries again
+            this.#clientId = undefined;
+            throw error;
         });
-        return { token: r.token, user: r.user, client: new MonitoringClient({ ...options, sessionToken: r.token }) };
+        return this.#clientId;
     }
 }
 exports.MonitoringClient = MonitoringClient;

package/dist/cjs/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";;;AAAA,4CAAoF;AAEpF,uDAAyF;AACzF,2DAA4D;AAC5D,uDAAyE;AACzE,uDAAwD;AACxD,6DAA8D;AAC9D,iEAAkE;AAClE,6CAA+C;AAE/C;;;;;;;;;;;;;;;;;GAiBG;AACH;IACE,iCAAiC;IACxB,OAAO,CAAiB;IACjC,8DAA8D;IACrD,IAAI,CAAc;IAC3B,WAAW;IACF,QAAQ,CAAkB;IACnC,+BAA+B;IACtB,MAAM,CAAgB;IAC/B,yEAAyE;IAChE,OAAO,CAAiB;IACjC,uCAAuC;IAC9B,SAAS,CAAmB;IACrC,uBAAuB;IACd,UAAU,CAAoB;IACvC,6DAA6D;IACpD,YAAY,CAAsB;IAElC,KAAK,CAAY;IAE1B;;;OAGG;IACH,YAAY,OAAO,GAAkB,EAAE;QACrC,IAAI,CAAC,KAAK,GAAG,IAAI,oBAAU,CAAC,OAAO,EAAE,6BAAgB,CAAC,CAAA;QACtD,IAAI,CAAC,OAAO,GAAG,IAAI,4BAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,yBAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,6BAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAChD,IAAI,CAAC,MAAM,GAAG,IAAI,2BAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC5C,IAAI,CAAC,OAAO,GAAG,IAAI,4BAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC9C,IAAI,CAAC,SAAS,GAAG,IAAI,gCAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAClD,IAAI,CAAC,UAAU,GAAG,IAAI,kCAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACpD,IAAI,CAAC,YAAY,GAAG,IAAI,sCAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC1D,CAAC;IAED,2CAA2C;IAC3C,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAA;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,WAAgD,EAChD,OAAO,GAAmD,EAAE,EAC5D,cAA+B;QAE/B,MAAM,IAAI,GAAG,IAAI,oBAAU,CAAC,OAAO,EAAE,6BAAgB,CAAC,CAAA;QACtD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAgC;YAC1D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE,WAAW;YACjB,UAAU,EAAE,KAAK;YACjB,IAAI,EAAE,KAAK;YACX,oDAAoD;YACpD,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,cAAc,EAAE;SAC9C,CAAC,CAAA;QACF,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,gBAAgB,CAAC,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAA;IAC9G,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";;;AAAA,gDAAkD;AAClD,4CAAoE;AAGpE,uDAAwD;AACxD,2DAA4D;AAC5D,uDAAyE;AACzE,6DAA8D;AAC9D,iEAAkE;AAClE,yDAA0D;AAC1D,6CAA+C;AAE/C;;;;;;;;;;;;;GAaG;AACH;IACE,wDAAwD;IAC/C,OAAO,CAAiB;IACjC,qDAAqD;IAC5C,SAAS,CAAmB;IACrC,kCAAkC;IACzB,QAAQ,CAAkB;IACnC,uCAAuC;IAC9B,UAAU,CAAoB;IACvC,gEAAgE;IACvD,YAAY,CAAsB;IAC3C,0BAA0B;IACjB,QAAQ,CAAkB;IACnC,yCAAyC;IAChC,MAAM,CAAgB;IAEtB,KAAK,CAAY;IAC1B,SAAS,CAA6B;IAEtC;;;OAGG;IACH,YAAY,OAAsB;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,oBAAU,CAAC,OAAO,EAAE,6BAAgB,CAAC,CAAA;QACtD,IAAI,OAAO,CAAC,QAAQ;YAAE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACxE,MAAM,KAAK,GAAU,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,eAAe,IAAA,aAAG,EAAC,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAA;QACtH,IAAI,CAAC,OAAO,GAAG,IAAI,4BAAe,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAA;QACxE,IAAI,CAAC,SAAS,GAAG,IAAI,gCAAiB,CAAC,KAAK,CAAC,CAAA;QAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,8BAAgB,CAAC,KAAK,CAAC,CAAA;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,kCAAkB,CAAC,KAAK,CAAC,CAAA;QAC/C,IAAI,CAAC,YAAY,GAAG,IAAI,sCAAoB,CAAC,KAAK,CAAC,CAAA;QACnD,IAAI,CAAC,QAAQ,GAAG,IAAI,6BAAgB,CAAC,KAAK,CAAC,CAAA;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,2BAAc,CAAC,KAAK,CAAC,CAAA;IACzC,CAAC;IAED,kDAAkD;IAClD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAA;IAC3B,CAAC;IAED,4FAA4F;IAC5F,gBAAgB;QACd,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAW,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CACvG,CAAC,QAAQ,EAAE,EAAE;YACX,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ;gBAAE,MAAM,IAAI,2BAAe,CAAC,qEAAqE,CAAC,CAAA;YAC9H,OAAO,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAA;QAChC,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,2DAA2D;YAC3D,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;YAC1B,MAAM,KAAK,CAAA;QACb,CAAC,CACF,CAAA;QACD,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;CACF"}

package/dist/cjs/core/errors.d.ts

@@ -1,16 +1,16 @@
 import type { ApiErrorBody } from '../generated/types.js';
-/** Ошибка по элементу запроса: номер элемента в переданном массиве и причина */
+/** A per-item problem of a batch request: the item's index in your request and the reason. */
 export type ErrorDetail = NonNullable<ApiErrorBody['error']['details']>[number];
 /**
- * Базовый класс всех ошибок SDK. Ловите его, чтобы перехватить любую ошибку SDK.
+ * Base class of every error thrown by the SDK.
  *
  * @example
  * ```ts
  * try {
- *   await monitoring.addresses.add(clientId, items)
- * } catch (e) {
- *   if (e instanceof MonitoringApiError && e.status === 400) console.log(e.details)
- *   else throw e
+ *   await monitoring.addresses.add(items)
+ * } catch (error) {
+ *   if (error instanceof MonitoringApiError && error.status === 400) console.log(error.details)
+ *   else throw error
  * }
  * ```
  */
@@ -19,20 +19,20 @@ export declare class MonitoringError extends Error {
         cause?: unknown;
     });
 }
-/** API ответил ошибкой: HTTP 4xx или 5xx */
+/** The API responded with an error status (4xx or 5xx). */
 export declare class MonitoringApiError extends MonitoringError {
-    /** HTTP-статус ответа */
+    /** HTTP status code. */
     readonly status: number;
     /**
-     * Машинный код ошибки: `invalid_request`, `unauthorized`, `forbidden`, `not_found`, `conflict`,
-     * `rate_limited`, `upstream_error`, `upstream_rate_limited`, `unavailable`…
+     * Machine-readable error code, e.g. `invalid_request`, `unauthorized`, `forbidden`, `not_found`,
+     * `rate_limited`, `upstream_error`, `upstream_rate_limited`.
      */
     readonly code: string;
-    /** Ошибки по элементам запроса (например, какой адрес из переданных не подошёл); пустой массив, если их нет */
+    /** Per-item problems of a batch request, such as invalid addresses. Empty when there are none. */
     readonly details: ErrorDetail[];
-    /** Идентификатор запроса (`cf-ray`) — укажите его, если обращаетесь в поддержку */
+    /** Request ID. Include it when contacting support. */
     readonly requestId: string | undefined;
-    /** Тело ответа как есть */
+    /** Raw response body. */
     readonly body: unknown;
     constructor(init: {
         status: number;
@@ -42,23 +42,23 @@ export declare class MonitoringApiError extends MonitoringError {
         requestId?: string;
         body?: unknown;
     });
-    /** Временная ошибка — лимит частоты или недоступный провайдер: запрос можно повторить позже */
+    /** `true` for transient errors — rate limits and unavailable upstream providers — that can be retried later. */
     get retryable(): boolean;
 }
-/** Ответа нет: сбой сети или соединения */
+/** The request did not get a response because of a network or connection failure. */
 export declare class MonitoringConnectionError extends MonitoringError {
     constructor(message: string, options?: {
         cause?: unknown;
     });
 }
-/** Запрос не уложился в таймаут (`timeoutMs`) */
+/** The request did not complete within `timeoutMs`. */
 export declare class MonitoringTimeoutError extends MonitoringConnectionError {
     constructor(timeoutMs: number);
 }
-/** Подпись вебхука не прошла проверку: тело подделано, изменено по дороге или проверяется не тем секретом */
+/** The webhook signature does not match: the body was altered or is verified with the wrong secret. */
 export declare class WebhookSignatureError extends MonitoringError {
     constructor(message?: string);
 }
-/** Тело ошибки в любом из форматов API: `/v1`, старые пути (`{ok: false}`), вход (`{code, message}`) */
+/** Builds an error from any error body the API returns. */
 export declare function apiErrorFrom(status: number, body: unknown, requestId: string | undefined): MonitoringApiError;
 //# sourceMappingURL=errors.d.ts.map

package/dist/cjs/core/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEzD,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/E;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAGzD;CACF;AAED,4CAA4C;AAC5C,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,+GAA+G;IAC/G,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,CAAA;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IAEtB,YAAY,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,EAQ/H;IAED,+FAA+F;IAC/F,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF;AAED,2CAA2C;AAC3C,qBAAa,yBAA0B,SAAQ,eAAe;IAC5D,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAGzD;CACF;AAED,iDAAiD;AACjD,qBAAa,sBAAuB,SAAQ,yBAAyB;IACnE,YAAY,SAAS,EAAE,MAAM,EAG5B;CACF;AAED,6GAA6G;AAC7G,qBAAa,qBAAsB,SAAQ,eAAe;IACxD,YAAY,OAAO,SAA+B,EAGjD;CACF;AAED,wGAAwG;AACxG,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,kBAAkB,CAW7G"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEzD,8FAA8F;AAC9F,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/E;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAGzD;CACF;AAED,2DAA2D;AAC3D,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kGAAkG;IAClG,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,CAAA;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IAEtB,YAAY,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,EAQ/H;IAED,gHAAgH;IAChH,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF;AAED,qFAAqF;AACrF,qBAAa,yBAA0B,SAAQ,eAAe;IAC5D,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAGzD;CACF;AAED,uDAAuD;AACvD,qBAAa,sBAAuB,SAAQ,yBAAyB;IACnE,YAAY,SAAS,EAAE,MAAM,EAG5B;CACF;AAED,uGAAuG;AACvG,qBAAa,qBAAsB,SAAQ,eAAe;IACxD,YAAY,OAAO,SAA+B,EAGjD;CACF;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,kBAAkB,CAW7G"}

package/dist/cjs/core/errors.js

@@ -3,15 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebhookSignatureError = exports.MonitoringTimeoutError = exports.MonitoringConnectionError = exports.MonitoringApiError = exports.MonitoringError = void 0;
 exports.apiErrorFrom = apiErrorFrom;
 /**
- * Базовый класс всех ошибок SDK. Ловите его, чтобы перехватить любую ошибку SDK.
+ * Base class of every error thrown by the SDK.
  *
  * @example
  * ```ts
  * try {
- *   await monitoring.addresses.add(clientId, items)
- * } catch (e) {
- *   if (e instanceof MonitoringApiError && e.status === 400) console.log(e.details)
- *   else throw e
+ *   await monitoring.addresses.add(items)
+ * } catch (error) {
+ *   if (error instanceof MonitoringApiError && error.status === 400) console.log(error.details)
+ *   else throw error
  * }
  * ```
  */
@@ -22,20 +22,20 @@ class MonitoringError extends Error {
     }
 }
 exports.MonitoringError = MonitoringError;
-/** API ответил ошибкой: HTTP 4xx или 5xx */
+/** The API responded with an error status (4xx or 5xx). */
 class MonitoringApiError extends MonitoringError {
-    /** HTTP-статус ответа */
+    /** HTTP status code. */
     status;
     /**
-     * Машинный код ошибки: `invalid_request`, `unauthorized`, `forbidden`, `not_found`, `conflict`,
-     * `rate_limited`, `upstream_error`, `upstream_rate_limited`, `unavailable`…
+     * Machine-readable error code, e.g. `invalid_request`, `unauthorized`, `forbidden`, `not_found`,
+     * `rate_limited`, `upstream_error`, `upstream_rate_limited`.
      */
     code;
-    /** Ошибки по элементам запроса (например, какой адрес из переданных не подошёл); пустой массив, если их нет */
+    /** Per-item problems of a batch request, such as invalid addresses. Empty when there are none. */
     details;
-    /** Идентификатор запроса (`cf-ray`) — укажите его, если обращаетесь в поддержку */
+    /** Request ID. Include it when contacting support. */
     requestId;
-    /** Тело ответа как есть */
+    /** Raw response body. */
     body;
     constructor(init) {
         super(`${init.message} (HTTP ${init.status}, ${init.code})`);
@@ -46,13 +46,13 @@ class MonitoringApiError extends MonitoringError {
         this.requestId = init.requestId;
         this.body = init.body;
     }
-    /** Временная ошибка — лимит частоты или недоступный провайдер: запрос можно повторить позже */
+    /** `true` for transient errors — rate limits and unavailable upstream providers — that can be retried later. */
     get retryable() {
         return this.status === 429 || this.status === 503;
     }
 }
 exports.MonitoringApiError = MonitoringApiError;
-/** Ответа нет: сбой сети или соединения */
+/** The request did not get a response because of a network or connection failure. */
 class MonitoringConnectionError extends MonitoringError {
     constructor(message, options) {
         super(message, options);
@@ -60,7 +60,7 @@ class MonitoringConnectionError extends MonitoringError {
     }
 }
 exports.MonitoringConnectionError = MonitoringConnectionError;
-/** Запрос не уложился в таймаут (`timeoutMs`) */
+/** The request did not complete within `timeoutMs`. */
 class MonitoringTimeoutError extends MonitoringConnectionError {
     constructor(timeoutMs) {
         super(`request timed out after ${timeoutMs} ms`);
@@ -68,7 +68,7 @@ class MonitoringTimeoutError extends MonitoringConnectionError {
     }
 }
 exports.MonitoringTimeoutError = MonitoringTimeoutError;
-/** Подпись вебхука не прошла проверку: тело подделано, изменено по дороге или проверяется не тем секретом */
+/** The webhook signature does not match: the body was altered or is verified with the wrong secret. */
 class WebhookSignatureError extends MonitoringError {
     constructor(message = 'webhook signature mismatch') {
         super(message);
@@ -76,7 +76,7 @@ class WebhookSignatureError extends MonitoringError {
     }
 }
 exports.WebhookSignatureError = WebhookSignatureError;
-/** Тело ошибки в любом из форматов API: `/v1`, старые пути (`{ok: false}`), вход (`{code, message}`) */
+/** Builds an error from any error body the API returns. */
 function apiErrorFrom(status, body, requestId) {
     const b = (body ?? {});
     const v1 = typeof b.error === 'object' && b.error !== null ? b.error : undefined;

package/dist/cjs/core/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":";;;;AAKA;;;;;;;;;;;;GAYG;AACH,qBAA6B,SAAQ,KAAK;IACxC,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;;AAED,2DAA2D;AAC3D,wBAAgC,SAAQ,eAAe;IACrD,wBAAwB;IACf,MAAM,CAAQ;IACvB;;;OAGG;IACM,IAAI,CAAQ;IACrB,kGAAkG;IACzF,OAAO,CAAe;IAC/B,sDAAsD;IAC7C,SAAS,CAAoB;IACtC,yBAAyB;IAChB,IAAI,CAAS;IAEtB,YAAY,IAAoH;QAC9H,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,UAAU,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;QAC5D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;QAChC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;QACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAA;QACjC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAA;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;IACvB,CAAC;IAED,gHAAgH;IAChH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,CAAA;IACnD,CAAC;CACF;;AAED,qFAAqF;AACrF,+BAAuC,SAAQ,eAAe;IAC5D,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;IACzC,CAAC;CACF;;AAED,uDAAuD;AACvD,4BAAoC,SAAQ,yBAAyB;IACnE,YAAY,SAAiB;QAC3B,KAAK,CAAC,2BAA2B,SAAS,KAAK,CAAC,CAAA;QAChD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;IACtC,CAAC;CACF;;AAED,uGAAuG;AACvG,2BAAmC,SAAQ,eAAe;IACxD,YAAY,OAAO,GAAG,4BAA4B;QAChD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;IACrC,CAAC;CACF;;AAED,2DAA2D;AAC3D,sBAA6B,MAAc,EAAE,IAAa,EAAE,SAA6B;IACvF,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAA;IACjD,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,KAAiC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC7G,MAAM,OAAO,GACX,CAAC,OAAO,EAAE,EAAE,OAAO,KAAK,QAAQ,IAAI,EAAE,CAAC,OAAO,CAAC;QAC/C,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC;QACxC,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC;QAC5C,QAAQ,MAAM,EAAE,CAAA;IAClB,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,CAAA;IACrI,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAkB,CAAA;IACtH,OAAO,IAAI,kBAAkB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AACpF,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,MAAM,KAAK,GAA2B,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,EAAE,CAAA;IAC/J,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,CAAA;AACzE,CAAC"}

package/dist/cjs/core/http.d.ts

@@ -1,62 +1,58 @@
-/** Настройки одного запроса — последний необязательный аргумент любого метода */
+/** Per-request options, accepted as the last argument of every method. */
 export interface RequestOptions {
-    /** Отмена запроса; повторы тоже прекращаются */
+    /** Cancels the request, including pending retries. */
     signal?: AbortSignal;
-    /** Таймаут этого запроса, мс — вместо {@link ClientOptions.timeoutMs} */
+    /** Timeout for this request in milliseconds. Overrides {@link ClientOptions.timeoutMs}. */
     timeoutMs?: number;
-    /** Сколько раз повторить этот запрос — вместо {@link ClientOptions.maxRetries} */
+    /** Maximum number of retries for this request. Overrides {@link ClientOptions.maxRetries}. */
     maxRetries?: number;
 }
-/** Настройки клиента */
+/** Options of {@link MonitoringClient}. */
 export interface ClientOptions {
+    /** Your API key. Sent in the `x-api-key` header. */
+    apiKey: string;
     /**
-     * API-ключ: ключ клиента `ce_…` (адреса, история и транзакции своего клиента) или личный ключ `ce_user_…`
-     * (всё, что вы можете в панели, с вашими правами). Уходит в заголовке `x-api-key`.
+     * Your client ID. Optional: when omitted, it is resolved from the API key on first use and cached.
      */
-    apiKey?: string;
-    /** Токен сессии из {@link MonitoringClient.signIn} — вместо `apiKey`. Уходит в `Authorization: Bearer` */
-    sessionToken?: string;
-    /** Адрес API. По умолчанию `https://monitoring.v3.finance` */
+    clientId?: string;
+    /** API base URL. Defaults to `https://monitoring.v3.finance`. */
     baseUrl?: string;
-    /** Таймаут запроса, мс. По умолчанию 30 000 */
+    /** Request timeout in milliseconds. Defaults to `30000`. */
     timeoutMs?: number;
     /**
-     * Сколько раз повторять запрос после временной ошибки. По умолчанию 2.
+     * Maximum number of retries for transient errors. Defaults to `2`.
      *
-     * Повторяются ответы 429 и 503 (запрос не был выполнен), а сбои сети и таймауты — только у запросов,
-     * которые безопасно выполнить дважды (чтение, снятие и добавление адресов, отзыв ключа). Пауза — из
-     * `Retry-After`, иначе экспоненциальная с разбросом.
+     * `429` and `503` responses are retried for every request, honoring `Retry-After`. Network errors and timeouts are
+     * retried only for requests that are safe to repeat. Backoff is exponential with jitter.
      */
     maxRetries?: number;
-    /** Своя реализация `fetch` — для тестов, прокси, логирования. По умолчанию глобальный `fetch` */
+    /** Custom `fetch` implementation, e.g. for proxies or instrumentation. Defaults to the global `fetch`. */
     fetch?: typeof fetch;
-    /** Дополнительные заголовки каждого запроса */
+    /** Additional headers sent with every request. */
     headers?: Record<string, string>;
 }
 type Query = Record<string, string | number | boolean | null | undefined>;
-/** Описание одного запроса к API */
+/** @internal A request to the API. */
 export interface Call {
     method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
     path: string;
     query?: Query;
     body?: unknown;
-    /** Можно ли повторить после сбоя сети: повтор не изменит результат */
+    /** The request can be repeated after a network failure without changing the outcome. */
     idempotent: boolean;
-    /** Статусы, которые возвращаются как данные, а не ошибка (тестовый вебхук: 502 — «не доставлен») */
+    /** Statuses returned as data rather than thrown. */
     acceptStatuses?: number[];
-    /** false — запрос без учётных данных (вход) */
-    auth?: boolean;
     options?: RequestOptions | undefined;
 }
-/** Транспорт SDK: адрес, авторизация, таймауты, повторы, разбор ошибок. Ресурсы ходят в API только через него */
+/** @internal Transport: base URL, authentication, timeouts, retries and error mapping. */
 export declare class HttpClient {
     #private;
     readonly baseUrl: string;
     constructor(options: ClientOptions, defaultBaseUrl: string);
-    /** Выполняет запрос и возвращает разобранный JSON ответа */
+    /** Sends a request and returns the parsed JSON response. */
     request<T>(call: Call): Promise<T>;
 }
-/** Сегмент пути: id клиента, хеш и т. п. */
+/** @internal Encodes a path segment. */
 export declare const seg: (value: string | number) => string;
 export {};
 //# sourceMappingURL=http.d.ts.map

package/dist/cjs/core/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/core/http.ts"],"names":[],"mappings":"AAGA,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAwB;AACxB,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0GAA0G;IAC1G,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iGAAiG;IACjG,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAEzE,oCAAoC;AACpC,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAA;IACnB,oGAAoG;IACpG,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;CACrC;AAKD,iHAAiH;AACjH,qBAAa,UAAU;;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAQxB,YAAY,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAWzD;IAED,4DAA4D;IACtD,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CA4BvC;CAwCF;AAuCD,4CAA4C;AAC5C,eAAO,MAAM,GAAG,UAAW,MAAM,GAAG,MAAM,WAAsC,CAAA"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/core/http.ts"],"names":[],"mappings":"AAGA,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0GAA0G;IAC1G,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAEzE,sCAAsC;AACtC,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,wFAAwF;IACxF,UAAU,EAAE,OAAO,CAAA;IACnB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;CACrC;AAKD,0FAA0F;AAC1F,qBAAa,UAAU;;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAOxB,YAAY,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAUzD;IAED,4DAA4D;IACtD,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAmCvC;CA6BF;AAuCD,wCAAwC;AACxC,eAAO,MAAM,GAAG,UAAW,MAAM,GAAG,MAAM,WAAsC,CAAA"}

package/dist/cjs/core/http.js

@@ -5,56 +5,62 @@ const version_js_1 = require("../version.js");
 const errors_js_1 = require("./errors.js");
 const DEFAULTS = { timeoutMs: 30_000, maxRetries: 2 };
 const MAX_RETRY_DELAY_MS = 60_000;
-/** Транспорт SDK: адрес, авторизация, таймауты, повторы, разбор ошибок. Ресурсы ходят в API только через него */
+/** @internal Transport: base URL, authentication, timeouts, retries and error mapping. */
 class HttpClient {
     baseUrl;
     #apiKey;
-    #sessionToken;
     #timeoutMs;
     #maxRetries;
     #fetch;
     #headers;
     constructor(options, defaultBaseUrl) {
-        if (options.apiKey && options.sessionToken)
-            throw new errors_js_1.MonitoringError('pass either apiKey or sessionToken, not both');
+        if (!options?.apiKey)
+            throw new errors_js_1.MonitoringError('apiKey is required');
         this.baseUrl = (options.baseUrl ?? defaultBaseUrl).replace(/\/+$/, '');
         this.#apiKey = options.apiKey;
-        this.#sessionToken = options.sessionToken;
         this.#timeoutMs = options.timeoutMs ?? DEFAULTS.timeoutMs;
         this.#maxRetries = options.maxRetries ?? DEFAULTS.maxRetries;
         const f = options.fetch ?? globalThis.fetch;
         if (typeof f !== 'function')
-            throw new errors_js_1.MonitoringError('fetch is not available: use Node.js 20+ or pass options.fetch');
+            throw new errors_js_1.MonitoringError('fetch is not available: use Node.js 20 or later, or pass options.fetch');
         this.#fetch = f;
         this.#headers = { ...options.headers };
     }
-    /** Выполняет запрос и возвращает разобранный JSON ответа */
+    /** Sends a request and returns the parsed JSON response. */
     async request(call) {
         const url = this.#url(call.path, call.query);
-        const headers = this.#headersFor(call);
+        const headers = {
+            accept: 'application/json',
+            'user-agent': `@v3finance/monitoring-sdk/${version_js_1.SDK_VERSION}`,
+            ...this.#headers,
+            'x-api-key': this.#apiKey,
+        };
+        if (call.body !== undefined)
+            headers['content-type'] = 'application/json';
         const body = call.body === undefined ? undefined : JSON.stringify(call.body);
         const maxRetries = call.options?.maxRetries ?? this.#maxRetries;
         const timeoutMs = call.options?.timeoutMs ?? this.#timeoutMs;
+        const signal = call.options?.signal;
         for (let attempt = 0;; attempt++) {
             let res;
             try {
-                res = await this.#send(url, { method: call.method, headers, body }, timeoutMs, call.options?.signal);
+                res = await this.#send(url, { method: call.method, headers, body }, timeoutMs, signal);
             }
-            catch (e) {
-                if (call.options?.signal?.aborted)
-                    throw call.options.signal.reason;
+            catch (error) {
+                if (signal?.aborted)
+                    throw signal.reason;
                 if (call.idempotent && attempt < maxRetries) {
-                    await sleep(backoff(attempt), call.options?.signal);
+                    await sleep(backoff(attempt), signal);
                     continue;
                 }
-                throw e;
+                throw error;
             }
             if ((res.status >= 200 && res.status < 300) || call.acceptStatuses?.includes(res.status))
                 return res.data;
             const error = (0, errors_js_1.apiErrorFrom)(res.status, res.data, res.headers.get('cf-ray') ?? undefined);
-            // 429 и 503: запрос не выполнен — повтор безопасен для любого метода
+            // 429 and 503 mean the request was not processed, so retrying is safe for any method
             if (error.retryable && attempt < maxRetries) {
-                await sleep(retryAfter(res.headers) ?? backoff(attempt), call.options?.signal);
+                await sleep(retryAfter(res.headers) ?? backoff(attempt), signal);
                 continue;
             }
             throw error;
@@ -67,21 +73,7 @@ class HttpClient {
                 url.searchParams.set(k, String(v));
         return url.toString();
     }
-    #headersFor(call) {
-        const headers = { accept: 'application/json', 'user-agent': `@v3finance/monitoring-sdk/${version_js_1.SDK_VERSION}`, ...this.#headers };
-        if (call.body !== undefined)
-            headers['content-type'] = 'application/json';
-        if (call.auth !== false) {
-            if (this.#apiKey)
-                headers['x-api-key'] = this.#apiKey;
-            else if (this.#sessionToken)
-                headers.authorization = `Bearer ${this.#sessionToken}`;
-            else
-                throw new errors_js_1.MonitoringError('credentials required: pass apiKey or sessionToken to MonitoringClient');
-        }
-        return headers;
-    }
-    /** Один запрос с таймаутом на всё — и соединение, и чтение тела */
+    /** One attempt, with a single timeout covering both the connection and the response body. */
     async #send(url, init, timeoutMs, signal) {
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(new errors_js_1.MonitoringTimeoutError(timeoutMs)), timeoutMs);
@@ -94,13 +86,13 @@ class HttpClient {
             const text = await res.text();
             return { status: res.status, headers: res.headers, data: text ? parseJson(text) : undefined };
         }
-        catch (e) {
+        catch (error) {
             const reason = controller.signal.reason;
             if (reason instanceof errors_js_1.MonitoringTimeoutError)
                 throw reason;
             if (signal?.aborted)
                 throw signal.reason;
-            throw new errors_js_1.MonitoringConnectionError(`request to ${new URL(url).origin} failed: ${e.message}`, { cause: e });
+            throw new errors_js_1.MonitoringConnectionError(`request to ${new URL(url).origin} failed: ${error.message}`, { cause: error });
         }
         finally {
             clearTimeout(timer);
@@ -117,11 +109,11 @@ function parseJson(text) {
         return text;
     }
 }
-/** Экспоненциальная пауза с разбросом: ~0,5 с, 1 с, 2 с… не больше 8 с */
+/** Exponential backoff with jitter: ~0.5 s, 1 s, 2 s… capped at 8 s. */
 function backoff(attempt) {
     return Math.min(8_000, 500 * 2 ** attempt) * (0.5 + Math.random() / 2);
 }
-/** Пауза из заголовка Retry-After: секунды или дата */
+/** Delay from a `Retry-After` header: seconds or an HTTP date. */
 function retryAfter(headers) {
     const raw = headers.get('retry-after');
     if (!raw)
@@ -145,7 +137,7 @@ function sleep(ms, signal) {
         signal?.addEventListener('abort', onAbort, { once: true });
     });
 }
-/** Сегмент пути: id клиента, хеш и т. п. */
+/** @internal Encodes a path segment. */
 const seg = (value) => encodeURIComponent(String(value));
 exports.seg = seg;
 //# sourceMappingURL=http.js.map