itd-api 0.7.2 → 0.8.0

package/README.md

@@ -16,7 +16,7 @@
 [![license](https://img.shields.io/npm/l/itd-api.svg)](./LICENSE)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/KiowDev/itd-api)
 
-Независимый TypeScript-клиент REST и realtime API социальной сети **итд.com**.
+Полнофункциональный TypeScript SDK для социальной сети **итд.com**.
 Проект не является официальным SDK и не аффилирован с итд.com.
 
 [Документация](https://kiowdev.github.io/itd-api/) ·
@@ -55,10 +55,10 @@ for (const post of page.items) {
 |---|---|
 | REST API | пользователи, посты, комментарии, файлы, уведомления, поиск, жалобы, верификация и подписка |
 | Авторизация | access/refresh token, автоматическое обновление, OTP, хранение сессии и несколько аккаунтов |
-| Realtime | SSE и резервный опрос, промежуточные обработчики, типизированные фильтры и маршрутизация |
+| События | SSE и резервный опрос, промежуточные обработчики, типизированные фильтры и маршрутизация |
 | Пагинация | разные серверные схемы через единый `for await` |
 | Публикация | билдеры постов, комментариев, опросов, разметки текста и загрузки файлов |
-| Надёжность | таймауты, отмена, очередь, rate limiting, безопасные повторы, хуки и типизированные ошибки |
+| Надёжность | таймауты, отмена, очередь, ограничения частоты, безопасные повторы, хуки и типизированные ошибки |
 | Расширение | плагины, собственный `fetch`, сервисы и произвольные запросы |
 | Платформа | версии приложений, changelog, анонсы, портал и состояние сервисов |
 
@@ -71,9 +71,9 @@ for (const post of page.items) {
 
 | Пакет | Назначение | Среда | npm | Документация |
 |---|---|---|---|---|
-| `itd-api` | REST/realtime-клиент | Node.js 18+, браузер, Bun, Deno, React Native | [npm](https://www.npmjs.com/package/itd-api) | [быстрый старт](https://kiowdev.github.io/itd-api/quickstart/) |
+| `itd-api` | полный SDK для итд.com | Node.js 18+, браузер, Bun, Deno, React Native | [npm](https://www.npmjs.com/package/itd-api) | [быстрый старт](https://kiowdev.github.io/itd-api/quickstart/) |
 | `@itd-api/turnstile` | получение Turnstile-токена в локальном браузере | Node.js 18+, Bun, Deno + драйвер браузера | [npm](https://www.npmjs.com/package/@itd-api/turnstile) | [документация](https://kiowdev.github.io/itd-api/packages/turnstile) |
-| `@itd-api/proxy` | HTTP/HTTPS- и SOCKS5-транспорт | Node.js 18+, Bun, Deno | [npm](https://www.npmjs.com/package/@itd-api/proxy) | [документация](https://kiowdev.github.io/itd-api/packages/proxy) |
+| `@itd-api/proxy` | прокси-транспорт для HTTP и WebSocket | Node.js 18+, Bun, Deno | [npm](https://www.npmjs.com/package/@itd-api/proxy) | [документация](https://kiowdev.github.io/itd-api/packages/proxy) |
 | `@itd-api/cache` | TTL/LRU-кэш и дедупликация запросов | среды основного клиента | [npm](https://www.npmjs.com/package/@itd-api/cache) | [документация](https://kiowdev.github.io/itd-api/packages/cache) |
 | `@itd-api/hydrate` | методы действий на моделях API | среды основного клиента | [npm](https://www.npmjs.com/package/@itd-api/hydrate) | [документация](https://kiowdev.github.io/itd-api/packages/hydrate) |
 | `@itd-api/crypto` | скрытые сообщения в постах, комментариях и профилях | среды основного клиента | [npm](https://www.npmjs.com/package/@itd-api/crypto) | [документация](https://kiowdev.github.io/itd-api/packages/crypto) |
@@ -88,7 +88,7 @@ for (const post of page.items) {
 | [Конфигурация](https://kiowdev.github.io/itd-api/configuration/) | таймауты, повторы, очереди, сервисы, хуки и жизненный цикл |
 | [Несколько аккаунтов](https://kiowdev.github.io/itd-api/multi-accounts/) | `ItdAccounts`, общее хранилище и отдельные сессии |
 | [Разметка текста](https://kiowdev.github.io/itd-api/text-markup/) | spans, автоматическая разметка и отображение |
-| [Realtime](https://kiowdev.github.io/itd-api/realtime/) | обновления, обработчики, фильтры, маршрутизация и переподключение |
+| [События](https://kiowdev.github.io/itd-api/events/) | обновления, обработчики, фильтры, маршрутизация и переподключение |
 | [Интеграции](https://kiowdev.github.io/itd-api/integrations/) | browser proxy и Turnstile |
 | [Плагины](https://kiowdev.github.io/itd-api/plugins/) | cache, crypto и создание плагина |
 | [Справочник API](https://kiowdev.github.io/itd-api/reference/) | ресурсы, методы, типы, ошибки и билдеры |
@@ -111,7 +111,7 @@ TypeScript 5.0+. Пакет проверяется в Node.js 18, 20, 22, 24 и
 
 | Хост | Назначение | Автоматическая передача Bearer-токена |
 |---|---|---|
-| `https://xn--d1ah4a.com` (`итд.com`) | REST API, авторизация и realtime | да, для защищённых REST-методов и realtime |
+| `https://xn--d1ah4a.com` (`итд.com`) | REST API, авторизация и события | да, для защищённых REST-методов и событий |
 | `https://xn--80a7abcbg.xn--d1ah4a.com` (`статус.итд.com`) | публичное состояние сервисов | нет |
 
 Опциональный `@itd-api/turnstile` дополнительно загружает виджет с
@@ -123,8 +123,8 @@ TypeScript 5.0+. Пакет проверяется в Node.js 18, 20, 22, 24 и
 
 | Настройка | Последствие |
 |---|---|
-| `baseUrl` | становится основным API-хостом; на него идут авторизация, сессия, защищённые запросы и realtime |
-| `fetch` | получает URL, заголовки и body всех запросов клиента; передавайте только доверенную реализацию |
+| `baseUrl` | становится основным API-хостом; на него идут авторизация, сессия, защищённые запросы и события |
+| `fetch` | получает URL, заголовки и тело всех запросов клиента; передавайте только доверенную реализацию |
 | `proxyFetch(...)` | направляет запросы через указанный вами proxy, которому будут доступны соединения с API |
 | `defineService({ auth: true })` | явно разрешает отправлять Bearer-токен на хост этого сервиса |
 | `request({ baseUrl })` | внешний хост не получает Bearer автоматически; `skipAuth: false` явно разрешает его передачу |
@@ -139,10 +139,10 @@ TypeScript 5.0+. Пакет проверяется в Node.js 18, 20, 22, 24 и
 | CORS основного API | браузерному приложению нужен собственный серверный proxy; [подробнее](https://kiowdev.github.io/itd-api/integrations/#браузер-и-cors)                           |
 | Подписчики, подписки и блокировки | сервер возвращает только первые 20 записей; [подробнее](https://kiowdev.github.io/itd-api/reference/users)                                                      |
 | Посты пользователя | `posts.byUser()` возвращает стену, включая чужие публикации на ней; [подробнее](https://kiowdev.github.io/itd-api/reference/posts)                              |
-| Rate limiting | маршруты разбиты на бакеты, у каждого свой лимит запросов в минуту, считается по IP; [таблица бакетов](https://kiowdev.github.io/itd-api/reference/rate-limits) |
+| Ограничения частоты | маршруты разбиты на бакеты, у каждого свой лимит запросов в минуту, считается по IP; [таблица бакетов](https://kiowdev.github.io/itd-api/reference/rate-limits) |
 
-Матрица известных маршрутов, wire-контрактов и статуса поддержки находится в
-[справочнике endpoint](https://kiowdev.github.io/itd-api/reference/endpoints).
+Матрица известных маршрутов, протоколов и статуса поддержки находится в
+[справочнике методов API](https://kiowdev.github.io/itd-api/reference/endpoints).
 
 ## Проект
 

package/dist/events/index.cjs

@@ -0,0 +1,53 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_url = require("../shared/url-CFN1sT9S.cjs");
+const require_errors = require("../shared/errors-BmP3TKoW.cjs");
+const require_redact = require("../shared/redact-DB9EMGJx.cjs");
+const require_events = require("../shared/events-iTteVsd_.cjs");
+exports.DEFAULT_BASE_URL = require_url.DEFAULT_BASE_URL;
+exports.EventChannel = require_events.EventChannel;
+exports.EventChannelStatus = require_url.EventChannelStatus;
+exports.EventComposer = require_events.EventComposer;
+exports.EventRouter = require_events.EventRouter;
+exports.ItdAbortError = require_errors.ItdAbortError;
+exports.ItdApiError = require_errors.ItdApiError;
+exports.ItdApiErrorKind = require_errors.ItdApiErrorKind;
+exports.ItdAuthError = require_errors.ItdAuthError;
+exports.ItdConfigError = require_errors.ItdConfigError;
+exports.ItdError = require_errors.ItdError;
+exports.ItdErrorKind = require_errors.ItdErrorKind;
+exports.ItdForbiddenError = require_errors.ItdForbiddenError;
+exports.ItdNetworkError = require_errors.ItdNetworkError;
+exports.ItdNotFoundError = require_errors.ItdNotFoundError;
+exports.ItdRateLimitError = require_errors.ItdRateLimitError;
+exports.ItdServerError = require_errors.ItdServerError;
+exports.ItdStateError = require_errors.ItdStateError;
+exports.ItdTimeoutError = require_errors.ItdTimeoutError;
+exports.ItdValidationError = require_errors.ItdValidationError;
+exports.LIBRARY_VERSION = require_url.LIBRARY_VERSION;
+exports.NotificationEvents = require_events.NotificationEvents;
+exports.NotificationEventsClient = require_events.NotificationEventsClient;
+exports.NotificationEventsTransport = require_events.NotificationEventsTransport;
+exports.NotificationType = require_url.NotificationType;
+exports.NotificationUpdateOrigin = require_events.NotificationUpdateOrigin;
+exports.NotificationUpdateType = require_events.NotificationUpdateType;
+exports.RuntimeMode = require_redact.RuntimeMode;
+exports.UnauthorizedStreamError = require_events.UnauthorizedStreamError;
+exports.WebSocketTransport = require_events.WebSocketTransport;
+exports.anonymousAuth = require_url.anonymousAuth;
+exports.bearerToken = require_url.bearerToken;
+exports.canonicalNotificationType = require_url.canonicalNotificationType;
+exports.createNotificationEventsClient = require_events.createNotificationEventsClient;
+exports.formatNotificationText = require_url.formatNotificationText;
+exports.isItdApiError = require_errors.isItdApiError;
+exports.isItdAuthError = require_errors.isItdAuthError;
+exports.isItdError = require_errors.isItdError;
+exports.isItdRateLimitError = require_errors.isItdRateLimitError;
+exports.isItdStateError = require_errors.isItdStateError;
+exports.isItdValidationError = require_errors.isItdValidationError;
+exports.isKnownNotificationType = require_url.isKnownNotificationType;
+exports.normalizeNotification = require_url.normalizeNotification;
+exports.resolveEventChannelOptions = require_events.resolveEventChannelOptions;
+exports.resolveNotificationUrl = require_url.resolveNotificationUrl;
+exports.runEventMiddleware = require_events.runEventMiddleware;
+exports.systemClock = require_url.systemClock;
+exports.tokenProvider = require_url.tokenProvider;

package/dist/events/index.d.cts

@@ -0,0 +1,3 @@
+import { $ as isItdValidationError, B as ItdTimeoutError, Bt as ItdClock, E as ItdConfigError, F as ItdNotFoundError, G as isItdError, H as isItdApiError, L as ItdRateLimitError, N as ItdForbiddenError, O as ItdError, P as ItdNetworkError, Pt as RuntimeOptions, Q as isItdStateError, R as ItdServerError, S as ItdApiError, T as ItdAuthError, U as isItdAuthError, V as ItdValidationError, Vt as systemClock, X as isItdRateLimitError, a as NotificationEvent, at as tokenProvider, bt as Logger, c as NotificationSettings, ct as Unsubscribe, dt as LIBRARY_VERSION, et as ClientConnection, i as formatNotificationText, it as bearerToken, k as ItdErrorKind, lt as DEFAULT_BASE_URL, mn as NotificationType, n as canonicalNotificationType, nt as AuthProvider, o as normalizeNotification, pn as Loose, r as isKnownNotificationType, rt as anonymousAuth, s as Notification, sn as EventChannelStatus, st as Listener, t as resolveNotificationUrl, tt as AuthIdentity, vt as ClientHooks, w as ItdApiErrorKind, x as ItdAbortError, z as ItdStateError, zt as RuntimeMode } from "../shared/url-Be9jlWRv.cjs";
+import { $ as EventTransport, A as ReconnectOptions, B as NotificationContext, C as EventChannelDeps, D as EventSession, E as EventEnqueueOptions, F as EventPredicate, G as NotificationEventsUpdate, H as NotificationEventFilter, I as EventSequentializer, J as NotificationUpdateOfType, K as NotificationOfType, L as EventTypeGuard, M as EventMiddleware, N as EventMiddlewareObject, O as EventSyncReason, P as EventNext, Q as UnreadCountUpdate, R as runEventMiddleware, S as EventChannel, T as EventChannelOptions, U as NotificationEventOfType, V as NotificationEventContext, W as NotificationEventSelector, X as NotificationUpdateType, Y as NotificationUpdateOrigin, Z as UnknownNotificationUpdate, _ as createNotificationEventsClient, a as WebSocketTransportOptions, b as NotificationEventsOptions, c as EventErrorContext, d as EventMiddlewareLike, et as EventTransportContext, f as EventRouteTable, g as NotificationEventsClientOptions, h as NotificationEventsClient, i as WebSocketTransport, j as EventHandler, k as resolveEventChannelOptions, l as EventFilter, m as EventRouter, n as WebSocketLike, nt as UnauthorizedStreamError, o as EventComposer, p as EventRouteSelector, q as NotificationUpdate, r as WebSocketOpenFailureClassifier, s as EventErrorBoundary, t as WebSocketImplementationOptions, tt as EventTransportFrame, u as EventMiddlewareGroup, v as NotificationEvents, w as EventChannelEvents, x as NotificationEventsTransport, y as NotificationEventsMap, z as EventContext } from "../shared/events-Br2r7coi.cjs";
+export { type AuthIdentity, type AuthProvider, type ClientConnection, type ClientHooks, DEFAULT_BASE_URL, EventChannel, type EventChannelDeps, type EventChannelEvents, type EventChannelOptions, EventChannelStatus, EventComposer, type EventContext, type EventEnqueueOptions, type EventErrorBoundary, type EventErrorContext, type EventFilter, type EventHandler, type EventMiddleware, type EventMiddlewareGroup, type EventMiddlewareLike, type EventMiddlewareObject, type EventNext, type EventPredicate, type EventRouteSelector, type EventRouteTable, EventRouter, type EventSequentializer, type EventSession, type EventSyncReason, type EventTransport, type EventTransportContext, type EventTransportFrame, type EventTypeGuard, ItdAbortError, ItdApiError, ItdApiErrorKind, ItdAuthError, type ItdClock, ItdConfigError, ItdError, ItdErrorKind, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdRateLimitError, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, type Listener, type Logger, type Loose, type Notification, type NotificationContext, type NotificationEvent, type NotificationEventContext, type NotificationEventFilter, type NotificationEventOfType, type NotificationEventSelector, NotificationEvents, NotificationEventsClient, type NotificationEventsClientOptions, type NotificationEventsMap, type NotificationEventsOptions, NotificationEventsTransport, type NotificationEventsUpdate, type NotificationOfType, type NotificationSettings, NotificationType, type NotificationUpdate, type NotificationUpdateOfType, NotificationUpdateOrigin, NotificationUpdateType, type ReconnectOptions, RuntimeMode, type RuntimeOptions, UnauthorizedStreamError, type UnknownNotificationUpdate, type UnreadCountUpdate, type Unsubscribe, type WebSocketImplementationOptions, type WebSocketLike, type WebSocketOpenFailureClassifier, WebSocketTransport, type WebSocketTransportOptions, anonymousAuth, bearerToken, canonicalNotificationType, createNotificationEventsClient, formatNotificationText, isItdApiError, isItdAuthError, isItdError, isItdRateLimitError, isItdStateError, isItdValidationError, isKnownNotificationType, normalizeNotification, resolveEventChannelOptions, resolveNotificationUrl, runEventMiddleware, systemClock, tokenProvider };

package/dist/events/index.d.ts

@@ -0,0 +1,3 @@
+import { $ as isItdValidationError, B as ItdTimeoutError, Bt as ItdClock, E as ItdConfigError, F as ItdNotFoundError, G as isItdError, H as isItdApiError, L as ItdRateLimitError, N as ItdForbiddenError, O as ItdError, P as ItdNetworkError, Pt as RuntimeOptions, Q as isItdStateError, R as ItdServerError, S as ItdApiError, T as ItdAuthError, U as isItdAuthError, V as ItdValidationError, Vt as systemClock, X as isItdRateLimitError, a as NotificationEvent, at as tokenProvider, bt as Logger, c as NotificationSettings, ct as Unsubscribe, dt as LIBRARY_VERSION, et as ClientConnection, i as formatNotificationText, it as bearerToken, k as ItdErrorKind, lt as DEFAULT_BASE_URL, mn as NotificationType, n as canonicalNotificationType, nt as AuthProvider, o as normalizeNotification, pn as Loose, r as isKnownNotificationType, rt as anonymousAuth, s as Notification, sn as EventChannelStatus, st as Listener, t as resolveNotificationUrl, tt as AuthIdentity, vt as ClientHooks, w as ItdApiErrorKind, x as ItdAbortError, z as ItdStateError, zt as RuntimeMode } from "../shared/url-Be9jlWRv.js";
+import { $ as EventTransport, A as ReconnectOptions, B as NotificationContext, C as EventChannelDeps, D as EventSession, E as EventEnqueueOptions, F as EventPredicate, G as NotificationEventsUpdate, H as NotificationEventFilter, I as EventSequentializer, J as NotificationUpdateOfType, K as NotificationOfType, L as EventTypeGuard, M as EventMiddleware, N as EventMiddlewareObject, O as EventSyncReason, P as EventNext, Q as UnreadCountUpdate, R as runEventMiddleware, S as EventChannel, T as EventChannelOptions, U as NotificationEventOfType, V as NotificationEventContext, W as NotificationEventSelector, X as NotificationUpdateType, Y as NotificationUpdateOrigin, Z as UnknownNotificationUpdate, _ as createNotificationEventsClient, a as WebSocketTransportOptions, b as NotificationEventsOptions, c as EventErrorContext, d as EventMiddlewareLike, et as EventTransportContext, f as EventRouteTable, g as NotificationEventsClientOptions, h as NotificationEventsClient, i as WebSocketTransport, j as EventHandler, k as resolveEventChannelOptions, l as EventFilter, m as EventRouter, n as WebSocketLike, nt as UnauthorizedStreamError, o as EventComposer, p as EventRouteSelector, q as NotificationUpdate, r as WebSocketOpenFailureClassifier, s as EventErrorBoundary, t as WebSocketImplementationOptions, tt as EventTransportFrame, u as EventMiddlewareGroup, v as NotificationEvents, w as EventChannelEvents, x as NotificationEventsTransport, y as NotificationEventsMap, z as EventContext } from "../shared/events-QyhQZrnC.js";
+export { type AuthIdentity, type AuthProvider, type ClientConnection, type ClientHooks, DEFAULT_BASE_URL, EventChannel, type EventChannelDeps, type EventChannelEvents, type EventChannelOptions, EventChannelStatus, EventComposer, type EventContext, type EventEnqueueOptions, type EventErrorBoundary, type EventErrorContext, type EventFilter, type EventHandler, type EventMiddleware, type EventMiddlewareGroup, type EventMiddlewareLike, type EventMiddlewareObject, type EventNext, type EventPredicate, type EventRouteSelector, type EventRouteTable, EventRouter, type EventSequentializer, type EventSession, type EventSyncReason, type EventTransport, type EventTransportContext, type EventTransportFrame, type EventTypeGuard, ItdAbortError, ItdApiError, ItdApiErrorKind, ItdAuthError, type ItdClock, ItdConfigError, ItdError, ItdErrorKind, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdRateLimitError, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, type Listener, type Logger, type Loose, type Notification, type NotificationContext, type NotificationEvent, type NotificationEventContext, type NotificationEventFilter, type NotificationEventOfType, type NotificationEventSelector, NotificationEvents, NotificationEventsClient, type NotificationEventsClientOptions, type NotificationEventsMap, type NotificationEventsOptions, NotificationEventsTransport, type NotificationEventsUpdate, type NotificationOfType, type NotificationSettings, NotificationType, type NotificationUpdate, type NotificationUpdateOfType, NotificationUpdateOrigin, NotificationUpdateType, type ReconnectOptions, RuntimeMode, type RuntimeOptions, UnauthorizedStreamError, type UnknownNotificationUpdate, type UnreadCountUpdate, type Unsubscribe, type WebSocketImplementationOptions, type WebSocketLike, type WebSocketOpenFailureClassifier, WebSocketTransport, type WebSocketTransportOptions, anonymousAuth, bearerToken, canonicalNotificationType, createNotificationEventsClient, formatNotificationText, isItdApiError, isItdAuthError, isItdError, isItdRateLimitError, isItdStateError, isItdValidationError, isKnownNotificationType, normalizeNotification, resolveEventChannelOptions, resolveNotificationUrl, runEventMiddleware, systemClock, tokenProvider };

package/dist/events/index.js

@@ -0,0 +1,5 @@
+import { $ as DEFAULT_BASE_URL, S as NotificationType, a as tokenProvider, c as normalizeNotification, ct as systemClock, d as canonicalNotificationType, f as isKnownNotificationType, g as EventChannelStatus, i as bearerToken, n as formatNotificationText, r as anonymousAuth, rt as LIBRARY_VERSION, t as resolveNotificationUrl } from "../shared/url-B3ocFlHj.js";
+import { A as isItdStateError, C as isItdError, O as isItdRateLimitError, _ as ItdStateError, a as ItdConfigError, b as isItdApiError, c as ItdErrorKind, d as ItdForbiddenError, f as ItdNetworkError, g as ItdServerError, h as ItdRateLimitError, i as ItdAuthError, j as isItdValidationError, n as ItdApiError, p as ItdNotFoundError, r as ItdApiErrorKind, s as ItdError, t as ItdAbortError, v as ItdTimeoutError, x as isItdAuthError, y as ItdValidationError } from "../shared/errors-GI10kZxk.js";
+import { _ as RuntimeMode } from "../shared/redact-FNK29Fv-.js";
+import { a as WebSocketTransport, c as NotificationEventsTransport, d as NotificationUpdateOrigin, f as NotificationUpdateType, g as runEventMiddleware, h as UnauthorizedStreamError, i as createNotificationEventsClient, m as resolveEventChannelOptions, n as EventRouter, p as EventChannel, r as NotificationEventsClient, s as NotificationEvents, t as EventComposer } from "../shared/events-TfhKh26b.js";
+export { DEFAULT_BASE_URL, EventChannel, EventChannelStatus, EventComposer, EventRouter, ItdAbortError, ItdApiError, ItdApiErrorKind, ItdAuthError, ItdConfigError, ItdError, ItdErrorKind, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdRateLimitError, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, NotificationEvents, NotificationEventsClient, NotificationEventsTransport, NotificationType, NotificationUpdateOrigin, NotificationUpdateType, RuntimeMode, UnauthorizedStreamError, WebSocketTransport, anonymousAuth, bearerToken, canonicalNotificationType, createNotificationEventsClient, formatNotificationText, isItdApiError, isItdAuthError, isItdError, isItdRateLimitError, isItdStateError, isItdValidationError, isKnownNotificationType, normalizeNotification, resolveEventChannelOptions, resolveNotificationUrl, runEventMiddleware, systemClock, tokenProvider };