@v3finance/monitoring-sdk 0.0.0-stage → 0.1.0

package/dist/esm/core/http.js

@@ -0,0 +1,146 @@
+import { SDK_VERSION } from '../version.js';
+import { apiErrorFrom, MonitoringConnectionError, MonitoringError, MonitoringTimeoutError } from './errors.js';
+const DEFAULTS = { timeoutMs: 30_000, maxRetries: 2 };
+const MAX_RETRY_DELAY_MS = 60_000;
+/** Транспорт SDK: адрес, авторизация, таймауты, повторы, разбор ошибок. Ресурсы ходят в API только через него */
+export class HttpClient {
+    baseUrl;
+    #apiKey;
+    #sessionToken;
+    #timeoutMs;
+    #maxRetries;
+    #fetch;
+    #headers;
+    constructor(options, defaultBaseUrl) {
+        if (options.apiKey && options.sessionToken)
+            throw new MonitoringError('pass either apiKey or sessionToken, not both');
+        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 MonitoringError('fetch is not available: use Node.js 20+ or pass options.fetch');
+        this.#fetch = f;
+        this.#headers = { ...options.headers };
+    }
+    /** Выполняет запрос и возвращает разобранный JSON ответа */
+    async request(call) {
+        const url = this.#url(call.path, call.query);
+        const headers = this.#headersFor(call);
+        const body = call.body === undefined ? undefined : JSON.stringify(call.body);
+        const maxRetries = call.options?.maxRetries ?? this.#maxRetries;
+        const timeoutMs = call.options?.timeoutMs ?? this.#timeoutMs;
+        for (let attempt = 0;; attempt++) {
+            let res;
+            try {
+                res = await this.#send(url, { method: call.method, headers, body }, timeoutMs, call.options?.signal);
+            }
+            catch (e) {
+                if (call.options?.signal?.aborted)
+                    throw call.options.signal.reason;
+                if (call.idempotent && attempt < maxRetries) {
+                    await sleep(backoff(attempt), call.options?.signal);
+                    continue;
+                }
+                throw e;
+            }
+            if ((res.status >= 200 && res.status < 300) || call.acceptStatuses?.includes(res.status))
+                return res.data;
+            const error = apiErrorFrom(res.status, res.data, res.headers.get('cf-ray') ?? undefined);
+            // 429 и 503: запрос не выполнен — повтор безопасен для любого метода
+            if (error.retryable && attempt < maxRetries) {
+                await sleep(retryAfter(res.headers) ?? backoff(attempt), call.options?.signal);
+                continue;
+            }
+            throw error;
+        }
+    }
+    #url(path, query) {
+        const url = new URL(this.baseUrl + path);
+        for (const [k, v] of Object.entries(query ?? {}))
+            if (v !== undefined && v !== null && v !== '')
+                url.searchParams.set(k, String(v));
+        return url.toString();
+    }
+    #headersFor(call) {
+        const headers = { accept: 'application/json', 'user-agent': `@v3finance/monitoring-sdk/${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 MonitoringError('credentials required: pass apiKey or sessionToken to MonitoringClient');
+        }
+        return headers;
+    }
+    /** Один запрос с таймаутом на всё — и соединение, и чтение тела */
+    async #send(url, init, timeoutMs, signal) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(new MonitoringTimeoutError(timeoutMs)), timeoutMs);
+        const onAbort = () => controller.abort(signal.reason);
+        if (signal?.aborted)
+            onAbort();
+        signal?.addEventListener('abort', onAbort, { once: true });
+        try {
+            const res = await this.#fetch(url, { ...init, signal: controller.signal });
+            const text = await res.text();
+            return { status: res.status, headers: res.headers, data: text ? parseJson(text) : undefined };
+        }
+        catch (e) {
+            const reason = controller.signal.reason;
+            if (reason instanceof MonitoringTimeoutError)
+                throw reason;
+            if (signal?.aborted)
+                throw signal.reason;
+            throw new MonitoringConnectionError(`request to ${new URL(url).origin} failed: ${e.message}`, { cause: e });
+        }
+        finally {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', onAbort);
+        }
+    }
+}
+function parseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+/** Экспоненциальная пауза с разбросом: ~0,5 с, 1 с, 2 с… не больше 8 с */
+function backoff(attempt) {
+    return Math.min(8_000, 500 * 2 ** attempt) * (0.5 + Math.random() / 2);
+}
+/** Пауза из заголовка Retry-After: секунды или дата */
+function retryAfter(headers) {
+    const raw = headers.get('retry-after');
+    if (!raw)
+        return undefined;
+    const seconds = Number(raw);
+    const ms = Number.isFinite(seconds) ? seconds * 1000 : Date.parse(raw) - Date.now();
+    return Number.isFinite(ms) ? Math.min(Math.max(ms, 0), MAX_RETRY_DELAY_MS) : undefined;
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted)
+            return reject(signal.reason);
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal.reason);
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/** Сегмент пути: id клиента, хеш и т. п. */
+export const seg = (value) => encodeURIComponent(String(value));
+//# sourceMappingURL=http.js.map

package/dist/esm/core/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/core/http.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/pagination.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Страница списка. `next` — курсор следующей страницы; `null` — страниц больше нет.
+ *
+ * @typeParam T - элемент списка
+ * @typeParam Cursor - тип курсора: строка (клиенты) или число (адреса, история)
+ */
+export interface Page<T, Cursor = string | number> {
+    items: T[];
+    next: Cursor | null;
+}
+/** Обходит все страницы по порядку, запрашивая следующую, только когда закончилась текущая */
+export declare function paginate<T, Cursor>(fetchPage: (cursor: Cursor | undefined) => Promise<Page<T, Cursor>>): AsyncGenerator<T, void, undefined>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/esm/core/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/core/pagination.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAC/C,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAED,8FAA8F;AAC9F,wBAAuB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAQlJ"}

package/dist/esm/core/pagination.js

@@ -0,0 +1,12 @@
+/** Обходит все страницы по порядку, запрашивая следующую, только когда закончилась текущая */
+export async function* paginate(fetchPage) {
+    let cursor;
+    for (;;) {
+        const page = await fetchPage(cursor);
+        yield* page.items;
+        if (page.next === null || page.next === undefined)
+            return;
+        cursor = page.next;
+    }
+}
+//# sourceMappingURL=pagination.js.map

package/dist/esm/core/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/core/pagination.ts"],"names":[],"mappings":"AAWA,8FAA8F;AAC9F,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,QAAQ,CAAY,SAAmE;IAC5G,IAAI,MAA0B,CAAA;IAC9B,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAA;QACpC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAA;QACjB,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAM;QACzD,MAAM,GAAG,IAAI,CAAC,IAAI,CAAA;IACpB,CAAC;AACH,CAAC"}

package/dist/esm/generated/types.d.ts

@@ -0,0 +1,324 @@
+export interface ApiErrorBody {
+    error: {
+        /** @example "invalid_request" */
+        code: string;
+        message: string;
+        details?: Array<{
+            index: number;
+            message: string;
+        }>;
+    };
+}
+export interface User {
+    id: string;
+    email: string;
+    name: string;
+    role?: "admin" | "user";
+    banned?: boolean;
+    createdAt?: string;
+}
+export interface Identity {
+    actor: {
+        /** user — пользователь, client-key — ключ клиента */
+        kind: "user" | "client-key" | "admin";
+        via?: "session" | "api-key" | "token";
+        userId?: string | null;
+        clientId?: string;
+        keyId?: string;
+    };
+    user: User | null;
+    memberships: Array<{
+        clientId: string;
+        role: "owner" | "admin" | "member";
+    }>;
+}
+export interface ApiKey {
+    id: string;
+    name: string | null;
+    /** начало ключа — чтобы узнать его */
+    start: string;
+    enabled: boolean;
+    expiresAt: string | null;
+    lastUsedAt: string | null;
+    createdAt: string;
+}
+export interface IssueKeyRequest {
+    /** length: 0..100 */
+    name?: string;
+    /**
+     * срок; без него — бессрочный
+     *
+     * range: 1..3650
+     */
+    expiresInDays?: number;
+}
+export interface IssuedKey {
+    id: string;
+    /** полный ключ — показывается один раз */
+    key: string;
+    start: string;
+    name: string | null;
+    expiresAt: string | null;
+}
+export interface Network {
+    id: number;
+    /** @example "tron" */
+    slug: string;
+    /** @example "tron:0x2b6653dc" */
+    caip2: string;
+    chainId: number;
+    name: string;
+    shortName: string | null;
+    /** 1 — L1, 2 — L2 */
+    layer: 1 | 2;
+    parent: string | null;
+    l2Type: string | null;
+    l2Stack: string | null;
+    isTestnet: boolean;
+    explorerUrl: string | null;
+    /** сервис читает сеть: если false, вебхуков по ней нет */
+    enabled: boolean;
+}
+export interface Asset {
+    id: number;
+    network: string;
+    caip19: string;
+    standard: "native" | "erc20" | "trc20";
+    contract: string | null;
+    symbol: string;
+    name: string;
+    decimals: number;
+    /** порог включительно, в минимальных единицах: меньшие переводы не сообщаются */
+    minAmount: string;
+    /** включён: о его переводах приходят вебхуки */
+    enabled: boolean;
+}
+export interface Client {
+    id: string;
+    name: string | null;
+    webhookUrl: string;
+    /** disabled — вебхуки не отправляются */
+    status: "active" | "disabled";
+    createdAt: string;
+}
+export interface Member {
+    userId: string;
+    email: string;
+    name: string;
+    role: "owner" | "admin" | "member";
+    createdAt: string;
+}
+/** in — адрес получатель, out — отправитель, both — любой */
+export type Direction = "in" | "out" | "both";
+/** символы (`USDT`) или адреса контрактов; null — все активы сети, включая добавленные позже */
+export type AssetSelection = string[] | null;
+export interface AddressInput {
+    /** slug или CAIP-2 */
+    network: string;
+    address: string;
+    /**
+     * ваша метка: id пользователя, номер счёта
+     *
+     * length: 0..200
+     */
+    label?: string;
+    assets?: AssetSelection;
+    direction?: Direction;
+}
+export interface AddAddressesRequest {
+    /** items: 1..1000 */
+    addresses: AddressInput[];
+    assets?: AssetSelection;
+    direction?: Direction;
+}
+export interface UpdateAddressesRequest {
+    /** items: 1..1000 */
+    addresses: Array<{
+        network: string;
+        address: string;
+        assets?: AssetSelection;
+        direction?: Direction;
+    }>;
+    assets?: AssetSelection;
+    direction?: Direction;
+}
+export interface Address {
+    id: number;
+    network: string;
+    caip10: string;
+    address: string;
+    label: string | null;
+    /** символы активов подписки; null — все */
+    assets: string[] | null;
+    direction: Direction;
+    createdAt: string;
+}
+/** delivered — вы ответили 2xx; retrying — последняя попытка не удалась, будет повтор; failed — повторы исчерпаны */
+export type DeliveryStatus = "delivered" | "retrying" | "failed";
+export interface Delivery {
+    id: number;
+    clientId: string;
+    network: string;
+    asset: string;
+    contract: string;
+    txId: string;
+    logIndex: number | null;
+    block: number;
+    /** время блока, мс */
+    blockTime: number;
+    from: string;
+    to: string;
+    value: string;
+    status: DeliveryStatus;
+    attempts: number;
+    lastHttpStatus: number | null;
+    lastError: string | null;
+    lastDurationMs: number | null;
+    firstAttemptAt: string;
+    lastAttemptAt: string;
+    deliveredAt: string | null;
+}
+export type DeliveryDetail = Delivery & {
+    /** куда ушла последняя попытка */
+    url: string;
+    /** точное тело запроса */
+    body: string;
+};
+export interface TxTransfer {
+    /** native — монета самой транзакцией; token — событие Transfer; internal — TRX изнутри контракта (TRON); trc10 — токен TRC-10 */
+    kind: "native" | "token" | "internal" | "trc10";
+    asset: string | null;
+    /** адрес контракта, native или id токена TRC-10 */
+    contract: string;
+    from: string;
+    to: string;
+    value: string;
+    logIndex?: number;
+    /** актив отслеживается: о таких переводах приходят вебхуки (если сумма не меньше порога) */
+    tracked: boolean;
+}
+export interface Transaction {
+    network: string;
+    caip2: string;
+    txId: string;
+    /** pending — ещё не в блоке */
+    status: "success" | "failed" | "pending";
+    failure: string | null;
+    block: number | null;
+    blockTime: number | null;
+    /** от текущей головы сети; 0 — не в блоке */
+    confirmations: number;
+    /** транзакцию уже не отменить */
+    final: boolean;
+    /** кто подписал */
+    from: string;
+    to: string | null;
+    /** TRON — тип контракта (TransferContract, TriggerSmartContract…); EVM — transfer, contract_call, contract_creation */
+    type: string;
+    /** нативная монета самой транзакции */
+    value: string;
+    fee: {
+        asset: string;
+        value: string;
+    } | null;
+    transfers: TxTransfer[];
+    /** ваши адреса на мониторинге в этой транзакции */
+    watched: Array<{
+        clientId: string;
+        address: string;
+        direction: Direction;
+    }>;
+    /** наши вебхуки вам по этой транзакции */
+    webhooks: Array<{
+        id: number;
+        clientId: string;
+        asset: string;
+        value: string;
+        status: DeliveryStatus;
+        attempts: number;
+        deliveredAt: string | null;
+    }>;
+}
+export interface WebhookTx {
+    /**
+     * сеть в верхнем регистре
+     * @example "TRON"
+     * @example "ETHEREUM"
+     */
+    network: string;
+    /** @example "USDT" */
+    asset: string;
+    /** адрес контракта или native */
+    contract: string;
+    /** всегда TOPUP — и для входящего, и для исходящего: направление — по from и to */
+    type: "TOPUP";
+    /** хеш транзакции */
+    id: string;
+    block: number;
+    /** время блока, мс */
+    timestamp: number;
+    from: string;
+    to: string;
+    /** в минимальных единицах */
+    value: string;
+    /** у переводов токенов EVM: в одной транзакции их бывает несколько */
+    logIndex?: number;
+}
+export interface WebhookPayload {
+    tx: WebhookTx;
+    /** только у тестового вебхука — не зачислять */
+    test?: true;
+}
+export interface TestWebhookRequest {
+    /** @defaultValue "USDT" */
+    asset?: "USDT" | "A7A5" | "TRX";
+    /** адрес TRON */
+    from?: string;
+    /** адрес TRON */
+    to?: string;
+    /** в минимальных единицах */
+    value?: string;
+}
+export interface TestDelivery {
+    ok: boolean;
+    /** HTTP-код вашего ответа */
+    status?: number;
+    error?: string;
+    durationMs: number;
+}
+export interface TestWebhookResult {
+    delivery: TestDelivery;
+    /** x-signature — сверьте со своим HMAC */
+    signature: string;
+    /** точное тело запроса */
+    body: string;
+}
+export interface LegacyAddresses {
+    /** items: 0..1000 */
+    addresses: string[];
+}
+export interface LegacyClientResult {
+    ok: true;
+    client: {
+        id: string;
+        webhookUrl: string;
+        addresses: string[];
+    };
+}
+export interface LegacyError {
+    ok: false;
+    error: string;
+    details?: Array<{
+        index: number;
+        message: string;
+    }>;
+}
+export interface LegacyTestResult {
+    ok: boolean;
+    clientId: string;
+    webhookUrl: string;
+    delivery: TestDelivery;
+    signature: string;
+    body: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/generated/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/generated/types.ts"],"names":[],"mappings":"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"}

package/dist/esm/generated/types.js

@@ -0,0 +1,4 @@
+// Generated from openapi/openapi.json by scripts/generate.ts — do not edit by hand.
+// chain-events API 1.0.0. Regenerate: npm run spec:update && npm run generate
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/generated/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/generated/types.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,8EAA8E"}

package/dist/esm/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Официальный SDK API мониторинга адресов V3 Finance (https://monitoring.v3.finance): TRON и EVM-сети,
+ * подписанные вебхуки о переводах, история доставок, транзакции с подтверждениями и финальностью.
+ *
+ * Справочник API — https://monitoring.v3.finance/docs
+ *
+ * @packageDocumentation
+ */
+export { MonitoringClient } from './client.js';
+export type { ClientOptions, RequestOptions } from './core/http.js';
+export type { Page } from './core/pagination.js';
+export { MonitoringApiError, MonitoringConnectionError, MonitoringError, MonitoringTimeoutError, WebhookSignatureError, type ErrorDetail, } from './core/errors.js';
+export { AccountResource, AuthResource, PersonalKeysResource, type SignInResult } from './resources/account.js';
+export { ADDRESS_BATCH_SIZE, AddressesResource, type AddAddressesResult, type AddressDefaults, type AddressRef, type AddressSubscriptionUpdate, type ListAddressesParams, type RemoveAddressesResult, type UpdateAddressesResult, } from './resources/addresses.js';
+export { AssetsResource, NetworksResource } from './resources/catalog.js';
+export { ClientKeysResource, ClientsResource, type ListClientsParams, type RotateSecretParams, type RotateSecretResult, type UpdateClientParams, } from './resources/clients.js';
+export { DeliveriesResource, type DeliveryFilter, type ListDeliveriesParams } from './resources/deliveries.js';
+export { TransactionsResource } from './resources/transactions.js';
+export { isTestWebhook, parseWebhook, signWebhookBody, verifyWebhookSignature, WEBHOOK_HEADERS, webhookIdempotencyKey, type SignatureSource, type WebhookBody, } from './webhooks.js';
+export { formatUnits, parseUnits } from './units.js';
+export { DEFAULT_BASE_URL, SDK_VERSION } from './version.js';
+export type * from './generated/types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACnE,YAAY,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAC/G,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAC9G,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAElE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG5D,mBAAmB,sBAAsB,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,20 @@
+/**
+ * Официальный SDK API мониторинга адресов V3 Finance (https://monitoring.v3.finance): TRON и EVM-сети,
+ * подписанные вебхуки о переводах, история доставок, транзакции с подтверждениями и финальностью.
+ *
+ * Справочник API — https://monitoring.v3.finance/docs
+ *
+ * @packageDocumentation
+ */
+export { MonitoringClient } from './client.js';
+export { MonitoringApiError, MonitoringConnectionError, MonitoringError, MonitoringTimeoutError, WebhookSignatureError, } from './core/errors.js';
+export { AccountResource, AuthResource, PersonalKeysResource } from './resources/account.js';
+export { ADDRESS_BATCH_SIZE, AddressesResource, } from './resources/addresses.js';
+export { AssetsResource, NetworksResource } from './resources/catalog.js';
+export { ClientKeysResource, ClientsResource, } from './resources/clients.js';
+export { DeliveriesResource } from './resources/deliveries.js';
+export { TransactionsResource } from './resources/transactions.js';
+export { isTestWebhook, parseWebhook, signWebhookBody, verifyWebhookSignature, WEBHOOK_HEADERS, webhookIdempotencyKey, } from './webhooks.js';
+export { formatUnits, parseUnits } from './units.js';
+export { DEFAULT_BASE_URL, SDK_VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9C,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GAEtB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAqB,MAAM,wBAAwB,CAAA;AAC/G,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAQlB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,EACL,kBAAkB,EAClB,eAAe,GAKhB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,kBAAkB,EAAkD,MAAM,2BAA2B,CAAA;AAC9G,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAElE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,qBAAqB,GAGtB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA"}

package/dist/esm/resources/account.d.ts

@@ -0,0 +1,61 @@
+import { type HttpClient, type RequestOptions } from '../core/http.js';
+import type { ApiKey, Identity, IssueKeyRequest, IssuedKey, User } from '../generated/types.js';
+/** Личные ключи: действуют от вашего имени с вашими правами — всё, что вы можете в панели */
+export declare class PersonalKeysResource {
+    #private;
+    constructor(http: HttpClient);
+    list(options?: RequestOptions): Promise<ApiKey[]>;
+    /**
+     * Выпускает личный ключ. Работает только с клиентом, вошедшим по паролю ({@link MonitoringClient.signIn}):
+     * ключ не может выпустить себе замену. Полный ключ — в `key`, показывается один раз.
+     */
+    create(params?: IssueKeyRequest, options?: RequestOptions): Promise<IssuedKey>;
+    revoke(keyId: string, options?: RequestOptions): Promise<void>;
+}
+/** Кто вы и ваши ключи */
+export declare class AccountResource {
+    #private;
+    /** Личные ключи */
+    readonly keys: PersonalKeysResource;
+    constructor(http: HttpClient);
+    /**
+     * Кто сделал запрос: способ входа, пользователь и участие в клиентах с ролями. Для ключа клиента —
+     * `actor.kind === 'client-key'` и `actor.clientId`.
+     *
+     * @example
+     * ```ts
+     * const { actor } = await monitoring.account.me()
+     * const clientId = actor.clientId // для ключа клиента
+     * ```
+     */
+    me(options?: RequestOptions): Promise<Identity>;
+}
+/** Результат входа по паролю */
+export interface SignInResult {
+    /** Токен сессии: передайте его в `sessionToken` или используйте готовый клиент из {@link MonitoringClient.signIn} */
+    token: string;
+    user: User;
+}
+/** Сессия: выход и смена пароля. Нужен клиент, вошедший по паролю */
+export declare class AuthResource {
+    #private;
+    constructor(http: HttpClient);
+    /** Текущая сессия и пользователь; `null` — сессии нет или она истекла */
+    session(options?: RequestOptions): Promise<{
+        session: Record<string, unknown>;
+        user: User;
+    } | null>;
+    /** Завершает сессию; токен перестаёт работать */
+    signOut(options?: RequestOptions): Promise<void>;
+    /**
+     * Меняет пароль. Ключом пароль не сменить — только в сессии.
+     *
+     * @param params.revokeOtherSessions - завершить остальные сессии
+     */
+    changePassword(params: {
+        currentPassword: string;
+        newPassword: string;
+        revokeOtherSessions?: boolean;
+    }, options?: RequestOptions): Promise<void>;
+}
+//# sourceMappingURL=account.d.ts.map