@v3finance/monitoring-sdk 0.1.0 → 0.2.0

package/src/resources/clients.ts

@@ -1,135 +0,0 @@
-import { seg, type HttpClient, type RequestOptions } from '../core/http.js'
-import { paginate, type Page } from '../core/pagination.js'
-import type { ApiKey, Client, IssueKeyRequest, IssuedKey, Member, TestWebhookRequest, TestWebhookResult } from '../generated/types.js'
-
-export interface ListClientsParams {
-  /** Размер страницы, до 1000; по умолчанию 100 */
-  limit?: number
-  /** Курсор: `next` прошлой страницы */
-  after?: string
-}
-
-/** Что изменить у клиента; не переданное не меняется */
-export interface UpdateClientParams {
-  /** Название; `null` — убрать */
-  name?: string | null
-  /** URL вебхука: только https, без логина и пароля */
-  webhookUrl?: string
-}
-
-export interface RotateSecretParams {
-  /** Свой секрет (от 16 символов); без него — сгенерируется */
-  secretKey?: string
-}
-
-export interface RotateSecretResult {
-  /** Новый секрет подписи вебхуков — показывается один раз, сохраните его */
-  secretKey: string
-}
-
-/** Ключи клиента: доступ к адресам, истории и транзакциям этого клиента. Управляют owner и admin клиента */
-export class ClientKeysResource {
-  readonly #http: HttpClient
-  constructor(http: HttpClient) {
-    this.#http = http
-  }
-
-  /** Ключи клиента (без самих ключей — только начало) */
-  async list(clientId: string, options?: RequestOptions): Promise<ApiKey[]> {
-    const r = await this.#http.request<{ items: ApiKey[] }>({ method: 'GET', path: `/v1/clients/${seg(clientId)}/keys`, idempotent: true, options })
-    return r.items
-  }
-
-  /**
-   * Выпускает ключ клиента. Полный ключ — в `key`, показывается один раз.
-   *
-   * @example
-   * ```ts
-   * const { key } = await monitoring.clients.keys.create(clientId, { name: 'backend', expiresInDays: 365 })
-   * ```
-   */
-  create(clientId: string, params: IssueKeyRequest = {}, options?: RequestOptions): Promise<IssuedKey> {
-    return this.#http.request({ method: 'POST', path: `/v1/clients/${seg(clientId)}/keys`, body: params, idempotent: false, options })
-  }
-
-  /** Отзывает ключ — он перестаёт работать сразу */
-  async revoke(clientId: string, keyId: string, options?: RequestOptions): Promise<void> {
-    await this.#http.request({ method: 'DELETE', path: `/v1/clients/${seg(clientId)}/keys/${seg(keyId)}`, idempotent: true, options })
-  }
-}
-
-/**
- * Ваш клиент: URL вебхука, секрет подписи, ключи, участники, тестовый вебхук.
- *
- * Права: смотреть — любой участник и ключ клиента; менять — owner и admin клиента по сессии или личному ключу.
- */
-export class ClientsResource {
-  readonly #http: HttpClient
-  /** Ключи клиента */
-  readonly keys: ClientKeysResource
-
-  constructor(http: HttpClient) {
-    this.#http = http
-    this.keys = new ClientKeysResource(http)
-  }
-
-  /** Страница ваших клиентов: где вы участник; для ключа клиента — он сам */
-  list(params: ListClientsParams = {}, options?: RequestOptions): Promise<Page<Client, string>> {
-    return this.#http.request({ method: 'GET', path: '/v1/clients', query: { ...params }, idempotent: true, options })
-  }
-
-  /** Все ваши клиенты — страница за страницей */
-  iterate(params: Omit<ListClientsParams, 'after'> = {}, options?: RequestOptions): AsyncGenerator<Client, void, undefined> {
-    return paginate<Client, string>((after) => this.list({ ...params, after }, options))
-  }
-
-  get(clientId: string, options?: RequestOptions): Promise<Client> {
-    return this.#http.request({ method: 'GET', path: `/v1/clients/${seg(clientId)}`, idempotent: true, options })
-  }
-
-  /**
-   * Меняет название или URL вебхука.
-   *
-   * @example
-   * ```ts
-   * await monitoring.clients.update(clientId, { webhookUrl: 'https://example.com/webhooks/monitoring' })
-   * ```
-   */
-  update(clientId: string, params: UpdateClientParams, options?: RequestOptions): Promise<Client> {
-    return this.#http.request({ method: 'PATCH', path: `/v1/clients/${seg(clientId)}`, body: params, idempotent: true, options })
-  }
-
-  /** Новый секрет подписи вебхуков. Старый перестаёт действовать сразу — обновите его у себя до следующего вебхука */
-  rotateSecret(clientId: string, params: RotateSecretParams = {}, options?: RequestOptions): Promise<RotateSecretResult> {
-    return this.#http.request({ method: 'POST', path: `/v1/clients/${seg(clientId)}/secret`, body: params, idempotent: false, options })
-  }
-
-  /**
-   * Отправляет тестовый вебхук на URL клиента и возвращает результат: доставлен ли, ваш ответ, подпись и точное
-   * тело. Тестовый вебхук помечен `"test": true` и заголовком `x-webhook-test: 1` — не зачисляйте его.
-   * Не больше 10 в минуту.
-   *
-   * @example
-   * ```ts
-   * const r = await monitoring.clients.sendTestWebhook(clientId, { asset: 'USDT' })
-   * if (!r.delivery.ok) console.log('ваш сервер ответил', r.delivery.status ?? r.delivery.error)
-   * ```
-   */
-  sendTestWebhook(clientId: string, params: TestWebhookRequest = {}, options?: RequestOptions): Promise<TestWebhookResult> {
-    return this.#http.request({
-      method: 'POST',
-      path: `/v1/clients/${seg(clientId)}/webhooks/test`,
-      body: params,
-      idempotent: false,
-      // 502 — «не доставлен»: это результат проверки, а не ошибка запроса
-      acceptStatuses: [502],
-      options,
-    })
-  }
-
-  /** Участники клиента и их роли */
-  async members(clientId: string, options?: RequestOptions): Promise<Member[]> {
-    const r = await this.#http.request<{ items: Member[] }>({ method: 'GET', path: `/v1/clients/${seg(clientId)}/members`, idempotent: true, options })
-    return r.items
-  }
-}