@v3finance/monitoring-sdk 0.0.0-stage → 0.1.0

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

@@ -0,0 +1,50 @@
+import { type HttpClient, type RequestOptions } from '../core/http.js';
+import { type Page } from '../core/pagination.js';
+import type { Delivery, DeliveryDetail, DeliveryStatus } from '../generated/types.js';
+/** Фильтры истории; все необязательны и сочетаются */
+export interface DeliveryFilter {
+    /** `delivered` — вы ответили 2xx, `retrying` — будет повтор, `failed` — повторы исчерпаны */
+    status?: DeliveryStatus;
+    /** Сеть: slug или CAIP-2 */
+    network?: string;
+    /** Символ актива */
+    asset?: string;
+    /** Хеш транзакции */
+    tx?: string;
+    /** Отправитель или получатель */
+    address?: string;
+    /** Первая попытка не раньше (дата или время) */
+    since?: Date | string;
+    /** Первая попытка раньше (не включая) */
+    until?: Date | string;
+}
+export interface ListDeliveriesParams extends DeliveryFilter {
+    /** Размер страницы, до 500; по умолчанию 100 */
+    limit?: number;
+    /** Курсор: `next` прошлой страницы */
+    before?: number;
+}
+/**
+ * История вебхуков клиента: что, когда и куда отправлено, сколько было попыток и что вы ответили.
+ * Повторы одного вебхука — одна запись. Хранится 90 дней.
+ */
+export declare class DeliveriesResource {
+    #private;
+    constructor(http: HttpClient);
+    /**
+     * Страница истории, новые сверху.
+     *
+     * @example
+     * ```ts
+     * const { items } = await monitoring.deliveries.list(clientId, { status: 'failed', since: new Date(Date.now() - 86_400_000) })
+     * ```
+     */
+    list(clientId: string, params?: ListDeliveriesParams, options?: RequestOptions): Promise<Page<Delivery, number>>;
+    /** Вся история по фильтру — от новых к старым, страница за страницей */
+    iterate(clientId: string, filter?: DeliveryFilter & {
+        limit?: number;
+    }, options?: RequestOptions): AsyncGenerator<Delivery, void, undefined>;
+    /** Одна запись с URL последней попытки и точным телом запроса */
+    get(clientId: string, deliveryId: number, options?: RequestOptions): Promise<DeliveryDetail>;
+}
+//# sourceMappingURL=deliveries.d.ts.map

package/dist/esm/resources/deliveries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliveries.d.ts","sourceRoot":"","sources":["../../../src/resources/deliveries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,EAAY,KAAK,IAAI,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAErF,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qBAAqB;IACrB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gDAAgD;IAChD,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IACrB,yCAAyC;IACzC,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID;;;GAGG;AACH,qBAAa,kBAAkB;;IAE7B,YAAY,IAAI,EAAE,UAAU,EAE3B;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,oBAAyB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAQnH;IAED,wEAAwE;IACxE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAE/I;IAED,iEAAiE;IACjE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAE3F;CACF"}

package/dist/esm/resources/deliveries.js

@@ -0,0 +1,39 @@
+import { seg } from '../core/http.js';
+import { paginate } from '../core/pagination.js';
+const iso = (v) => (v instanceof Date ? v.toISOString() : v);
+/**
+ * История вебхуков клиента: что, когда и куда отправлено, сколько было попыток и что вы ответили.
+ * Повторы одного вебхука — одна запись. Хранится 90 дней.
+ */
+export class DeliveriesResource {
+    #http;
+    constructor(http) {
+        this.#http = http;
+    }
+    /**
+     * Страница истории, новые сверху.
+     *
+     * @example
+     * ```ts
+     * const { items } = await monitoring.deliveries.list(clientId, { status: 'failed', since: new Date(Date.now() - 86_400_000) })
+     * ```
+     */
+    list(clientId, params = {}, options) {
+        return this.#http.request({
+            method: 'GET',
+            path: `/v1/clients/${seg(clientId)}/deliveries`,
+            query: { ...params, since: iso(params.since), until: iso(params.until) },
+            idempotent: true,
+            options,
+        });
+    }
+    /** Вся история по фильтру — от новых к старым, страница за страницей */
+    iterate(clientId, filter = {}, options) {
+        return paginate((before) => this.list(clientId, { ...filter, before }, options));
+    }
+    /** Одна запись с URL последней попытки и точным телом запроса */
+    get(clientId, deliveryId, options) {
+        return this.#http.request({ method: 'GET', path: `/v1/clients/${seg(clientId)}/deliveries/${seg(deliveryId)}`, idempotent: true, options });
+    }
+}
+//# sourceMappingURL=deliveries.js.map

package/dist/esm/resources/deliveries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliveries.js","sourceRoot":"","sources":["../../../src/resources/deliveries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAwC,MAAM,iBAAiB,CAAA;AAC3E,OAAO,EAAE,QAAQ,EAAa,MAAM,uBAAuB,CAAA;AA4B3D,MAAM,GAAG,GAAG,CAAC,CAA4B,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEvF;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACpB,KAAK,CAAY;IAC1B,YAAY,IAAgB;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;IACnB,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,QAAgB,EAAE,MAAM,GAAyB,EAAE,EAAE,OAAwB;QAChF,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YACxB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,GAAG,CAAC,QAAQ,CAAC,aAAa;YAC/C,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YACxE,UAAU,EAAE,IAAI;YAChB,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED,wEAAwE;IACxE,OAAO,CAAC,QAAgB,EAAE,MAAM,GAAwC,EAAE,EAAE,OAAwB;QAClG,OAAO,QAAQ,CAAmB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;IACpG,CAAC;IAED,iEAAiE;IACjE,GAAG,CAAC,QAAgB,EAAE,UAAkB,EAAE,OAAwB;QAChE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,GAAG,CAAC,QAAQ,CAAC,eAAe,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IAC7I,CAAC;CACF"}

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

@@ -0,0 +1,28 @@
+import { type HttpClient, type RequestOptions } from '../core/http.js';
+import type { Transaction } from '../generated/types.js';
+/** Любая транзакция сети по хешу — не только те, о которых пришёл вебхук */
+export declare class TransactionsResource {
+    #private;
+    constructor(http: HttpClient);
+    /**
+     * Статус, блок, подтверждения, финальность, комиссия и все переводы внутри транзакции; для ваших адресов —
+     * направление и вебхуки, которые мы по ней отправили.
+     *
+     * `final: true` — транзакцию уже не отменить: в TRON блок солидифицирован (около минуты), в EVM —
+     * финализирован (Ethereum — около 13 минут). Крупные суммы зачисляйте после `final`.
+     *
+     * Не больше 60 запросов в минуту на ключ; при превышении SDK подождёт и повторит.
+     *
+     * @param network - slug (`tron`, `ethereum`) или CAIP-2
+     * @param hash - EVM — `0x` + 64 hex; TRON — 64 hex (можно с `0x`)
+     * @throws {@link MonitoringApiError} 404 — такой транзакции в сети нет
+     *
+     * @example
+     * ```ts
+     * const tx = await monitoring.transactions.get('tron', webhook.tx.id)
+     * if (tx.status === 'success' && tx.final) credit(webhook)
+     * ```
+     */
+    get(network: string, hash: string, options?: RequestOptions): Promise<Transaction>;
+}
+//# sourceMappingURL=transactions.d.ts.map

package/dist/esm/resources/transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../../src/resources/transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,4EAA4E;AAC5E,qBAAa,oBAAoB;;IAE/B,YAAY,IAAI,EAAE,UAAU,EAE3B;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAEjF;CACF"}

package/dist/esm/resources/transactions.js

@@ -0,0 +1,31 @@
+import { seg } from '../core/http.js';
+/** Любая транзакция сети по хешу — не только те, о которых пришёл вебхук */
+export class TransactionsResource {
+    #http;
+    constructor(http) {
+        this.#http = http;
+    }
+    /**
+     * Статус, блок, подтверждения, финальность, комиссия и все переводы внутри транзакции; для ваших адресов —
+     * направление и вебхуки, которые мы по ней отправили.
+     *
+     * `final: true` — транзакцию уже не отменить: в TRON блок солидифицирован (около минуты), в EVM —
+     * финализирован (Ethereum — около 13 минут). Крупные суммы зачисляйте после `final`.
+     *
+     * Не больше 60 запросов в минуту на ключ; при превышении SDK подождёт и повторит.
+     *
+     * @param network - slug (`tron`, `ethereum`) или CAIP-2
+     * @param hash - EVM — `0x` + 64 hex; TRON — 64 hex (можно с `0x`)
+     * @throws {@link MonitoringApiError} 404 — такой транзакции в сети нет
+     *
+     * @example
+     * ```ts
+     * const tx = await monitoring.transactions.get('tron', webhook.tx.id)
+     * if (tx.status === 'success' && tx.final) credit(webhook)
+     * ```
+     */
+    get(network, hash, options) {
+        return this.#http.request({ method: 'GET', path: `/v1/networks/${seg(network)}/transactions/${seg(hash)}`, idempotent: true, options });
+    }
+}
+//# sourceMappingURL=transactions.js.map

package/dist/esm/resources/transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../../../src/resources/transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAwC,MAAM,iBAAiB,CAAA;AAG3E,4EAA4E;AAC5E,MAAM,OAAO,oBAAoB;IACtB,KAAK,CAAY;IAC1B,YAAY,IAAgB;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;IACnB,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,GAAG,CAAC,OAAe,EAAE,IAAY,EAAE,OAAwB;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,GAAG,CAAC,OAAO,CAAC,iBAAiB,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IACzI,CAAC;CACF"}

package/dist/esm/units.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Суммы в API и вебхуках — строки в минимальных единицах (sun, wei; у USDT 6 знаков после запятой): uint256 не
+ * помещается в `number`. Эти функции переводят их в привычный вид и обратно без потери точности.
+ * Знаки после запятой актива — `decimals` из `monitoring.assets.list()`.
+ */
+/**
+ * Минимальные единицы → строка в монетах.
+ *
+ * @example
+ * ```ts
+ * formatUnits('100000000', 6)            // '100'     — 100 USDT
+ * formatUnits('1500000', 6)              // '1.5'
+ * formatUnits('10090000000000000', 18)   // '0.01009' — ETH
+ * ```
+ */
+export declare function formatUnits(value: string | bigint, decimals: number): string;
+/**
+ * Строка в монетах → минимальные единицы.
+ *
+ * @throws RangeError — больше знаков после запятой, чем у актива, или не число
+ *
+ * @example
+ * ```ts
+ * parseUnits('1.5', 6)   // '1500000'
+ * parseUnits('100', 6)   // '100000000'
+ * ```
+ */
+export declare function parseUnits(amount: string, decimals: number): string;
+//# sourceMappingURL=units.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../src/units.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOnE"}

package/dist/esm/units.js

@@ -0,0 +1,58 @@
+/**
+ * Суммы в API и вебхуках — строки в минимальных единицах (sun, wei; у USDT 6 знаков после запятой): uint256 не
+ * помещается в `number`. Эти функции переводят их в привычный вид и обратно без потери точности.
+ * Знаки после запятой актива — `decimals` из `monitoring.assets.list()`.
+ */
+const INTEGER = /^-?\d+$/;
+const DECIMAL = /^(\d+)(?:\.(\d+))?$/;
+/**
+ * Минимальные единицы → строка в монетах.
+ *
+ * @example
+ * ```ts
+ * formatUnits('100000000', 6)            // '100'     — 100 USDT
+ * formatUnits('1500000', 6)              // '1.5'
+ * formatUnits('10090000000000000', 18)   // '0.01009' — ETH
+ * ```
+ */
+export function formatUnits(value, decimals) {
+    assertDecimals(decimals);
+    const raw = typeof value === 'bigint' ? value.toString() : value.trim();
+    if (!INTEGER.test(raw))
+        throw new RangeError(`formatUnits: integer in minimal units expected, got ${JSON.stringify(value)}`);
+    const negative = raw.startsWith('-');
+    const digits = (negative ? raw.slice(1) : raw).replace(/^0+(?=\d)/, '');
+    if (decimals === 0)
+        return (negative && digits !== '0' ? '-' : '') + digits;
+    const padded = digits.padStart(decimals + 1, '0');
+    const whole = padded.slice(0, -decimals);
+    const fraction = padded.slice(-decimals).replace(/0+$/, '');
+    const sign = negative && (whole !== '0' || fraction) ? '-' : '';
+    return `${sign}${whole}${fraction ? `.${fraction}` : ''}`;
+}
+/**
+ * Строка в монетах → минимальные единицы.
+ *
+ * @throws RangeError — больше знаков после запятой, чем у актива, или не число
+ *
+ * @example
+ * ```ts
+ * parseUnits('1.5', 6)   // '1500000'
+ * parseUnits('100', 6)   // '100000000'
+ * ```
+ */
+export function parseUnits(amount, decimals) {
+    assertDecimals(decimals);
+    const m = DECIMAL.exec(amount.trim());
+    if (!m)
+        throw new RangeError(`parseUnits: non-negative decimal expected, got ${JSON.stringify(amount)}`);
+    const fraction = m[2] ?? '';
+    if (fraction.length > decimals)
+        throw new RangeError(`parseUnits: ${amount} has more than ${decimals} decimal places`);
+    return BigInt(m[1] + fraction.padEnd(decimals, '0')).toString();
+}
+function assertDecimals(decimals) {
+    if (!Number.isInteger(decimals) || decimals < 0 || decimals > 255)
+        throw new RangeError(`decimals: integer 0..255 expected, got ${decimals}`);
+}
+//# sourceMappingURL=units.js.map

package/dist/esm/units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.js","sourceRoot":"","sources":["../../src/units.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,GAAG,SAAS,CAAA;AACzB,MAAM,OAAO,GAAG,qBAAqB,CAAA;AAErC;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,KAAsB,EAAE,QAAgB;IAClE,cAAc,CAAC,QAAQ,CAAC,CAAA;IACxB,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;IACvE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,uDAAuD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC5H,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IACpC,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;IACvE,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,CAAC,QAAQ,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAA;IAC3E,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAA;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAA;IACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAC3D,MAAM,IAAI,GAAG,QAAQ,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/D,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;AAC3D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,QAAgB;IACzD,cAAc,CAAC,QAAQ,CAAC,CAAA;IACxB,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IACrC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,kDAAkD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACxG,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,QAAQ,CAAC,MAAM,GAAG,QAAQ;QAAE,MAAM,IAAI,UAAU,CAAC,eAAe,MAAM,kBAAkB,QAAQ,iBAAiB,CAAC,CAAA;IACtH,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;AAClE,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,GAAG;QAAE,MAAM,IAAI,UAAU,CAAC,0CAA0C,QAAQ,EAAE,CAAC,CAAA;AAC/I,CAAC"}

package/dist/esm/version.d.ts

@@ -0,0 +1,5 @@
+/** Версия SDK: уходит в заголовке `user-agent`. Тест сверяет её с package.json */
+export declare const SDK_VERSION = "0.1.0";
+/** Адрес API по умолчанию */
+export declare const DEFAULT_BASE_URL = "https://monitoring.v3.finance";
+//# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,eAAO,MAAM,WAAW,UAAU,CAAA;AAElC,6BAA6B;AAC7B,eAAO,MAAM,gBAAgB,kCAAkC,CAAA"}

package/dist/esm/version.js

@@ -0,0 +1,5 @@
+/** Версия SDK: уходит в заголовке `user-agent`. Тест сверяет её с package.json */
+export const SDK_VERSION = '0.1.0';
+/** Адрес API по умолчанию */
+export const DEFAULT_BASE_URL = 'https://monitoring.v3.finance';
+//# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAA;AAElC,6BAA6B;AAC7B,MAAM,CAAC,MAAM,gBAAgB,GAAG,+BAA+B,CAAA"}

package/dist/esm/webhooks.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Приём вебхуков: проверка подписи и разбор тела. Работает без клиента API и без сети — нужен только секрет
+ * подписи клиента. Использует WebCrypto: Node.js 20+, Bun, Deno, Cloudflare Workers.
+ */
+import type { WebhookPayload } from './generated/types.js';
+/** Заголовки вебхука */
+export declare const WEBHOOK_HEADERS: {
+    /** HMAC-SHA256 сырого тела секретом клиента, hex в нижнем регистре */
+    readonly signature: 'x-signature';
+    /** id клиента */
+    readonly clientId: 'x-client-id';
+    /** `1` у тестового вебхука — такой не зачислять */
+    readonly test: 'x-webhook-test';
+};
+/**
+ * Тело вебхука ровно как пришло — сырые байты или строка. Не `JSON.parse` + `JSON.stringify`: подпись считается
+ * по исходным байтам, и любое переформатирование её ломает.
+ */
+export type WebhookBody = string | Uint8Array | ArrayBuffer;
+/**
+ * Откуда взять подпись: значение заголовка `x-signature` или все заголовки запроса — Fetch `Headers`
+ * (Hono, Next.js, Workers) или объект Node.js (`req.headers` в Express, Fastify).
+ */
+export type SignatureSource = string | null | undefined | Headers | Record<string, string | string[] | undefined>;
+/**
+ * Подпись тела секретом клиента — как её считает сервис. Нужна в тестах вашего обработчика вебхуков.
+ *
+ * @example
+ * ```ts
+ * const body = JSON.stringify({ tx: { …, id: 'test' } })
+ * await fetch('http://localhost:3000/webhooks', { method: 'POST', body, headers: { 'x-signature': await signWebhookBody(body, secret) } })
+ * ```
+ */
+export declare function signWebhookBody(body: WebhookBody, secret: string): Promise<string>;
+/**
+ * Проверяет подпись вебхука: `true` — тело пришло от сервиса и не изменено.
+ *
+ * @param body - сырое тело запроса
+ * @param signature - заголовок `x-signature` или все заголовки запроса
+ * @param secret - секрет подписи клиента
+ */
+export declare function verifyWebhookSignature(body: WebhookBody, signature: SignatureSource, secret: string): Promise<boolean>;
+/**
+ * Проверяет подпись и возвращает разобранный вебхук.
+ *
+ * Дальше — по правилам приёма: тестовый вебхук ({@link isTestWebhook}) не зачислять; один и тот же вебхук может
+ * прийти повторно — обрабатывайте идемпотентно по {@link webhookIdempotencyKey}; ответьте 2xx в течение 15 секунд.
+ * Вебхук уходит, как только перевод попал в блок, — для крупных сумм дождитесь финальности
+ * (`monitoring.transactions.get(...).final`).
+ *
+ * @throws {@link WebhookSignatureError} подпись не совпала — ответьте 401 и ничего не зачисляйте
+ *
+ * @example Express — нужен сырой body
+ * ```ts
+ * app.post('/webhooks/monitoring', express.raw({ type: 'application/json' }), async (req, res) => {
+ *   const event = await parseWebhook(req.body, req.headers, process.env.MONITORING_WEBHOOK_SECRET!)
+ *   if (!isTestWebhook(event)) await creditOnce(webhookIdempotencyKey(event), event.tx)
+ *   res.sendStatus(200)
+ * })
+ * ```
+ *
+ * @example Hono, Next.js route handler, Cloudflare Workers
+ * ```ts
+ * const event = await parseWebhook(await request.text(), request.headers, env.MONITORING_WEBHOOK_SECRET)
+ * ```
+ */
+export declare function parseWebhook(body: WebhookBody, signature: SignatureSource, secret: string): Promise<WebhookPayload>;
+/** Тестовый вебхук (из панели или `clients.sendTestWebhook`) — такой не зачислять */
+export declare function isTestWebhook(event: WebhookPayload): boolean;
+/**
+ * Ключ идемпотентности вебхука: сеть, транзакция и номер лога. Один перевод — один ключ, даже если вебхук пришёл
+ * несколько раз. В одной транзакции EVM может быть несколько переводов токенов — у них разный `logIndex`.
+ *
+ * @example `"TRON:1249cb…a5fc45:"`, `"ETHEREUM:0x3fbc…1d57:7"`
+ */
+export declare function webhookIdempotencyKey(event: WebhookPayload): string;
+//# sourceMappingURL=webhooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/webhooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,wBAAwB;AACxB,eAAO,MAAM,eAAe;IAC1B,sEAAsE;aACtE,SAAS,EAAE,aAAa;IACxB,iBAAiB;aACjB,QAAQ,EAAE,aAAa;IACvB,mDAAmD;aACnD,IAAI,EAAE,gBAAgB;CACd,CAAA;AAEV;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAA;AAE3D;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;AA0BjH;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIxF;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI5H;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAWzH;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAEnE"}

package/dist/esm/webhooks.js

@@ -0,0 +1,120 @@
+/**
+ * Приём вебхуков: проверка подписи и разбор тела. Работает без клиента API и без сети — нужен только секрет
+ * подписи клиента. Использует WebCrypto: Node.js 20+, Bun, Deno, Cloudflare Workers.
+ */
+import { MonitoringError, WebhookSignatureError } from './core/errors.js';
+/** Заголовки вебхука */
+export const WEBHOOK_HEADERS = {
+    /** HMAC-SHA256 сырого тела секретом клиента, hex в нижнем регистре */
+    signature: 'x-signature',
+    /** id клиента */
+    clientId: 'x-client-id',
+    /** `1` у тестового вебхука — такой не зачислять */
+    test: 'x-webhook-test',
+};
+const encoder = new TextEncoder();
+function bytesOf(body) {
+    if (typeof body === 'string')
+        return encoder.encode(body);
+    // копия: WebCrypto не принимает view над SharedArrayBuffer (Buffer в Node.js — тоже Uint8Array)
+    return body instanceof Uint8Array ? new Uint8Array(body) : new Uint8Array(body);
+}
+function signatureOf(source) {
+    if (source === null || source === undefined)
+        return undefined;
+    if (typeof source === 'string')
+        return source;
+    if (typeof source.get === 'function')
+        return source.get(WEBHOOK_HEADERS.signature) ?? undefined;
+    const value = source[WEBHOOK_HEADERS.signature];
+    return Array.isArray(value) ? value[0] : value;
+}
+/** Сравнение без утечки по времени: время не зависит от того, где строки расходятся */
+function safeEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < a.length; i++)
+        diff |= a.charCodeAt(i) ^ b.charCodeAt(i);
+    return diff === 0;
+}
+/**
+ * Подпись тела секретом клиента — как её считает сервис. Нужна в тестах вашего обработчика вебхуков.
+ *
+ * @example
+ * ```ts
+ * const body = JSON.stringify({ tx: { …, id: 'test' } })
+ * await fetch('http://localhost:3000/webhooks', { method: 'POST', body, headers: { 'x-signature': await signWebhookBody(body, secret) } })
+ * ```
+ */
+export async function signWebhookBody(body, secret) {
+    const key = await crypto.subtle.importKey('raw', encoder.encode(secret), { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
+    const mac = new Uint8Array(await crypto.subtle.sign('HMAC', key, bytesOf(body)));
+    return Array.from(mac, (b) => b.toString(16).padStart(2, '0')).join('');
+}
+/**
+ * Проверяет подпись вебхука: `true` — тело пришло от сервиса и не изменено.
+ *
+ * @param body - сырое тело запроса
+ * @param signature - заголовок `x-signature` или все заголовки запроса
+ * @param secret - секрет подписи клиента
+ */
+export async function verifyWebhookSignature(body, signature, secret) {
+    const given = signatureOf(signature)?.trim().toLowerCase();
+    if (!given)
+        return false;
+    return safeEqual(await signWebhookBody(body, secret), given);
+}
+/**
+ * Проверяет подпись и возвращает разобранный вебхук.
+ *
+ * Дальше — по правилам приёма: тестовый вебхук ({@link isTestWebhook}) не зачислять; один и тот же вебхук может
+ * прийти повторно — обрабатывайте идемпотентно по {@link webhookIdempotencyKey}; ответьте 2xx в течение 15 секунд.
+ * Вебхук уходит, как только перевод попал в блок, — для крупных сумм дождитесь финальности
+ * (`monitoring.transactions.get(...).final`).
+ *
+ * @throws {@link WebhookSignatureError} подпись не совпала — ответьте 401 и ничего не зачисляйте
+ *
+ * @example Express — нужен сырой body
+ * ```ts
+ * app.post('/webhooks/monitoring', express.raw({ type: 'application/json' }), async (req, res) => {
+ *   const event = await parseWebhook(req.body, req.headers, process.env.MONITORING_WEBHOOK_SECRET!)
+ *   if (!isTestWebhook(event)) await creditOnce(webhookIdempotencyKey(event), event.tx)
+ *   res.sendStatus(200)
+ * })
+ * ```
+ *
+ * @example Hono, Next.js route handler, Cloudflare Workers
+ * ```ts
+ * const event = await parseWebhook(await request.text(), request.headers, env.MONITORING_WEBHOOK_SECRET)
+ * ```
+ */
+export async function parseWebhook(body, signature, secret) {
+    if (!(await verifyWebhookSignature(body, signature, secret)))
+        throw new WebhookSignatureError();
+    let payload;
+    try {
+        payload = JSON.parse(typeof body === 'string' ? body : new TextDecoder().decode(bytesOf(body)));
+    }
+    catch (e) {
+        throw new MonitoringError('webhook body is not valid JSON', { cause: e });
+    }
+    const tx = payload?.tx;
+    if (typeof tx !== 'object' || tx === null || typeof tx.id !== 'string')
+        throw new MonitoringError('webhook body has no tx');
+    return payload;
+}
+/** Тестовый вебхук (из панели или `clients.sendTestWebhook`) — такой не зачислять */
+export function isTestWebhook(event) {
+    return event.test === true;
+}
+/**
+ * Ключ идемпотентности вебхука: сеть, транзакция и номер лога. Один перевод — один ключ, даже если вебхук пришёл
+ * несколько раз. В одной транзакции EVM может быть несколько переводов токенов — у них разный `logIndex`.
+ *
+ * @example `"TRON:1249cb…a5fc45:"`, `"ETHEREUM:0x3fbc…1d57:7"`
+ */
+export function webhookIdempotencyKey(event) {
+    return `${event.tx.network}:${event.tx.id}:${event.tx.logIndex ?? ''}`;
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/esm/webhooks.js.map

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

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "@v3finance/monitoring-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for the V3 Finance address monitoring API: TRON and EVM addresses, signed webhooks, delivery history, transaction finality",
+  "keywords": [
+    "tron",
+    "ethereum",
+    "evm",
+    "usdt",
+    "trc20",
+    "erc20",
+    "webhooks",
+    "blockchain",
+    "monitoring",
+    "payments",
+    "sdk",
+    "v3finance"
+  ],
+  "homepage": "https://monitoring.v3.finance/docs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/v3-finance/monitoring-sdk.git"
+  },
+  "license": "MIT",
+  "author": "V3 Finance",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "spec:update": "node scripts/fetch-spec.ts",
+    "generate": "node scripts/generate.ts",
+    "typecheck": "tsc -p tsconfig.json && tsc -p tsconfig.build.json --noEmit",
+    "test": "vitest run",
+    "build": "node scripts/build.ts",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "22.20.5",
+    "typescript": "7.0.2",
+    "vitest": "4.1.11"
+  }
+}