@v3finance/monitoring-sdk 0.1.0 → 0.2.0

package/dist/esm/client.d.ts

@@ -1,65 +1,46 @@
-import { type ClientOptions, type RequestOptions } from './core/http.js';
-import { AccountResource, AuthResource, type SignInResult } from './resources/account.js';
+import { type ClientOptions } from './core/http.js';
+import { AccountResource } from './resources/account.js';
 import { AddressesResource } from './resources/addresses.js';
 import { AssetsResource, NetworksResource } from './resources/catalog.js';
-import { ClientsResource } from './resources/clients.js';
 import { DeliveriesResource } from './resources/deliveries.js';
 import { TransactionsResource } from './resources/transactions.js';
+import { WebhooksResource } from './resources/webhooks.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' })
  * ```
  */
 export declare class MonitoringClient {
     #private;
-    /** Кто вы и ваши личные ключи */
+    /** Your client: the account your API key belongs to. */
     readonly account: AccountResource;
-    /** Выход и смена пароля (для клиента, вошедшего по паролю) */
-    readonly auth: AuthResource;
-    /** Сети */
-    readonly networks: NetworksResource;
-    /** Нативные монеты и токены */
-    readonly assets: AssetsResource;
-    /** Ваш клиент: URL вебхука, секрет, ключи, участники, тестовый вебхук */
-    readonly clients: ClientsResource;
-    /** Адреса на мониторинге и подписка */
+    /** Addresses you monitor and their subscriptions. */
     readonly addresses: AddressesResource;
-    /** История вебхуков */
+    /** Test your webhook endpoint. */
+    readonly webhooks: WebhooksResource;
+    /** History of webhooks sent to you. */
     readonly deliveries: DeliveriesResource;
-    /** Транзакция по хешу: статус, подтверждения, финальность */
+    /** Any transaction by hash, with confirmations and finality. */
     readonly transactions: TransactionsResource;
+    /** Supported networks. */
+    readonly networks: NetworksResource;
+    /** Supported native coins and tokens. */
+    readonly assets: AssetsResource;
     /**
-     * @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?: ClientOptions);
-    /** Адрес API, с которым работает клиент */
+    constructor(options: ClientOptions);
+    /** API base URL this client sends requests to. */
     get baseUrl(): string;
-    /**
-     * Вход по email и паролю: возвращает клиента с токеном сессии. Регистрации нет — пользователей заводит
-     * администратор сервиса. Не больше 3 попыток за 10 секунд с одного IP.
-     *
-     * @param options - настройки клиента, кроме учётных данных
-     * @throws {@link MonitoringApiError} 401 — неверный email или пароль
-     */
-    static signIn(credentials: {
-        email: string;
-        password: string;
-    }, options?: Omit<ClientOptions, 'apiKey' | 'sessionToken'>, requestOptions?: RequestOptions): Promise<SignInResult & {
-        client: MonitoringClient;
-    }>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/esm/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpF,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAGlE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,gBAAgB;;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,WAAW;IACX,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAA;IACrC,uBAAuB;IACvB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;IACvC,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAA;IAI3C;;;OAGG;IACH,YAAY,OAAO,GAAE,aAAkB,EAUtC;IAED,2CAA2C;IAC3C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;;;OAMG;IACH,OAAa,MAAM,CACjB,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAChD,OAAO,GAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,cAAc,CAAM,EAC5D,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,YAAY,GAAG;QAAE,MAAM,EAAE,gBAAgB,CAAA;KAAE,CAAC,CAYtD;CACF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAG1D;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAgB;;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAA;IACrC,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;IACvC,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAA;IAC3C,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAK/B;;;OAGG;IACH,YAAY,OAAO,EAAE,aAAa,EAWjC;IAED,kDAAkD;IAClD,IAAI,OAAO,IAAI,MAAM,CAEpB;CAiBF"}

package/dist/esm/client.js

@@ -1,85 +1,76 @@
-import { HttpClient } from './core/http.js';
-import { AccountResource, AuthResource } from './resources/account.js';
+import { MonitoringError } from './core/errors.js';
+import { HttpClient, seg } from './core/http.js';
+import { AccountResource } from './resources/account.js';
 import { AddressesResource } from './resources/addresses.js';
 import { AssetsResource, NetworksResource } from './resources/catalog.js';
-import { ClientsResource } from './resources/clients.js';
 import { DeliveriesResource } from './resources/deliveries.js';
 import { TransactionsResource } from './resources/transactions.js';
+import { WebhooksResource } from './resources/webhooks.js';
 import { DEFAULT_BASE_URL } from './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' })
  * ```
  */
 export 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 HttpClient(options, DEFAULT_BASE_URL);
-        this.account = new AccountResource(this.#http);
-        this.auth = new AuthResource(this.#http);
-        this.networks = new NetworksResource(this.#http);
-        this.assets = new AssetsResource(this.#http);
-        this.clients = new ClientsResource(this.#http);
-        this.addresses = new AddressesResource(this.#http);
-        this.deliveries = new DeliveriesResource(this.#http);
-        this.transactions = new TransactionsResource(this.#http);
+        if (options.clientId)
+            this.#clientId = Promise.resolve(options.clientId);
+        const scope = { http: this.#http, clientPath: async () => `/v1/clients/${seg(await this.#resolveClientId())}` };
+        this.account = new AccountResource(scope, () => this.#resolveClientId());
+        this.addresses = new AddressesResource(scope);
+        this.webhooks = new WebhooksResource(scope);
+        this.deliveries = new DeliveriesResource(scope);
+        this.transactions = new TransactionsResource(scope);
+        this.networks = new NetworksResource(scope);
+        this.assets = new 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 HttpClient(options, 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 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;
     }
 }
 //# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2C,MAAM,gBAAgB,CAAA;AAEpF,OAAO,EAAE,eAAe,EAAE,YAAY,EAAqB,MAAM,wBAAwB,CAAA;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,gBAAgB;IAC3B,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,UAAU,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAA;QACtD,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAChD,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC5C,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC9C,IAAI,CAAC,SAAS,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAClD,IAAI,CAAC,UAAU,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACpD,IAAI,CAAC,YAAY,GAAG,IAAI,oBAAoB,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,UAAU,CAAC,OAAO,EAAE,gBAAgB,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":"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"}

package/dist/esm/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/esm/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/esm/core/errors.js

@@ -1,13 +1,13 @@
 /**
- * Базовый класс всех ошибок 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
  * }
  * ```
  */
@@ -17,20 +17,20 @@ export class MonitoringError extends Error {
         this.name = 'MonitoringError';
     }
 }
-/** API ответил ошибкой: HTTP 4xx или 5xx */
+/** The API responded with an error status (4xx or 5xx). */
 export 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})`);
@@ -41,33 +41,33 @@ export 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;
     }
 }
-/** Ответа нет: сбой сети или соединения */
+/** The request did not get a response because of a network or connection failure. */
 export class MonitoringConnectionError extends MonitoringError {
     constructor(message, options) {
         super(message, options);
         this.name = 'MonitoringConnectionError';
     }
 }
-/** Запрос не уложился в таймаут (`timeoutMs`) */
+/** The request did not complete within `timeoutMs`. */
 export class MonitoringTimeoutError extends MonitoringConnectionError {
     constructor(timeoutMs) {
         super(`request timed out after ${timeoutMs} ms`);
         this.name = 'MonitoringTimeoutError';
     }
 }
-/** Подпись вебхука не прошла проверку: тело подделано, изменено по дороге или проверяется не тем секретом */
+/** The webhook signature does not match: the body was altered or is verified with the wrong secret. */
 export class WebhookSignatureError extends MonitoringError {
     constructor(message = 'webhook signature mismatch') {
         super(message);
         this.name = 'WebhookSignatureError';
     }
 }
-/** Тело ошибки в любом из форматов API: `/v1`, старые пути (`{ok: false}`), вход (`{code, message}`) */
+/** Builds an error from any error body the API returns. */
 export function apiErrorFrom(status, body, requestId) {
     const b = (body ?? {});
     const v1 = typeof b.error === 'object' && b.error !== null ? b.error : undefined;

package/dist/esm/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,MAAM,OAAO,eAAgB,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,MAAM,OAAO,kBAAmB,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,MAAM,OAAO,yBAA0B,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,MAAM,OAAO,sBAAuB,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,MAAM,OAAO,qBAAsB,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,MAAM,UAAU,YAAY,CAAC,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/esm/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/esm/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"}