itd-api 0.7.2 → 0.9.0

package/dist/rest/index.d.ts

@@ -1,5 +1,5 @@
-import { $ as UserSummary, $t as RateLimitPacing, A as isItdFileError, B as Notification, Bt as RateLimitOptions, C as ItdStateError, Ct as ReportReason, D as isItdAuthError, Dt as ViewReason, E as isItdApiError, Et as SpanType, F as isItdServerError, Ft as Logger, G as FollowResult, Gt as ResponseContext, H as Actor, Ht as RequestContext, I as isItdStateError, It as OperationRequestOptions, J as PinsResult, Jt as RetryOptions, K as MyProfile, Kt as RetryContext, L as isItdValidationError, Lt as PaginationOptions, M as isItdNotFoundError, Mt as Unsubscribe, N as isItdPhoneVerificationError, Nt as ClientHooks, O as isItdConflictError, Ot as ViewSource, P as isItdRateLimitError, Pt as ErrorContextHook, Q as SubscriptionState, Qt as ServiceDefinition, R as NotificationEvent, Rt as RateLimitBucketContext, S as ItdServerError, T as ItdValidationError, Tt as ServiceState, Ut as RequestExtensions, V as NotificationSettings, Vt as RawRequestOptions, W as Author, Wt as RequestOptions, X as Profile, Xt as QueryParams, Y as PrivacySettings, Yt as RuntimeOptions, Z as PublicProfile, Zt as QueryValue, _ as ItdForbiddenError, _n as RetrySafety, _t as InteractionType, a as ItdAbortError, an as ItdOperationDefinition, at as DEFAULT_BASE_URL, b as ItdPhoneVerificationError, bt as Loose, c as ItdApiErrorKind, cn as isBuiltInOperationId, ct as IsoDate, d as ItdConflictError, dn as operationRetrySafety, dt as UserRef, en as RuntimeMode, f as ItdError, fn as BUCKET_LIMITS, ft as AccessType, g as ItdFileErrorReason, gn as OperationMethod, gt as IncidentKind, h as ItdFileError, hn as FeatureOperationId, ht as FeedTab, i as formatNotificationText, in as CustomOperationId, it as tokenProvider, j as isItdForbiddenError, jt as Listener, k as isItdError, kt as WallAccess, l as ItdAuthError, ln as operationBucket, lt as Span, m as ItdFieldErrors, mn as RateLimitBucket, mt as CommentSort, n as canonicalNotificationType, nn as systemClock, nt as anonymousAuth, o as ItdApiError, on as OPERATIONS, ot as STATUS_SERVICE, p as ItdErrorKind, pn as DEFAULT_RATE_LIMIT_BUCKET, pt as AttachmentType, q as Pin, qt as RetryDecisionContext, r as isKnownNotificationType, rn as BuiltInOperationId, rt as bearerToken, s as ItdApiErrorInit, sn as OperationId, st as LIBRARY_VERSION, t as resolveNotificationUrl, tn as ItdClock, tt as AuthProvider, u as ItdConfigError, un as operationMethod, ut as UserId, v as ItdNetworkError, vt as ItdErrorCode, w as ItdTimeoutError, wt as ReportTargetType, x as ItdRateLimitError, xt as NotificationType, y as ItdNotFoundError, yt as LikesVisibility, z as normalizeNotification, zt as RateLimitBucketOverride } from "../shared/url-DTfZ2toq.js";
-import { $ as poll, $t as CreatePostData, A as TelemetryResource, At as FilesResource, B as ReportInput, Bt as PinPostResult, C as DwellEntry, Cn as FeatureBucketDefinition, Ct as Report, D as TelemetryBatchOptions, Dn as FeatureRequestOptions, Dt as UpdateNotificationSettingsInput, E as TelemetryBatch, En as FeatureOperationDefinition, Et as NotificationsResource, F as SubscriptionResource, Ft as Attachment, G as UserPostsParams, Gt as CommentBuilder, H as CommentsParams, Ht as PollOption, I as SearchResource, It as Comment, J as PostInput, Jt as BuilderInput, K as CreatePostInput, Kt as CommentInput, L as SearchResult, Lt as CommentReplyTo, M as ViewTracker, Mt as UploadedFile, N as ViewTrackerInput, Nt as CommentsResource, O as TelemetryClock, Ot as HashtagPostsParams, P as ViewTrackerOptions, Pt as RepliesParams, Q as PollInput, Qt as CreatePollInput, R as ReportsResource, Rt as Hashtag, S as UsersResource, Sn as ClientFeature, St as Portal, T as PhotoOpenInput, Tn as FeatureInstallation, Tt as NotificationListParams, U as FeedParams, Ut as Post, V as report, Vt as Poll, W as PostsResource, Wt as PostStats, X as post, Xt as isBuilder, Y as PostUpdateInput, Yt as ItdBuilder, Z as PollBuilder, Zt as CreateCommentInput, _ as fromUrl, _n as ClientPlugin, _t as StatusIncidentLine, a as isMyProfile, an as PaginationMode, at as MarkupContent, b as UpdateProfileInput, bn as PluginApi, bt as ChangelogEntry, c as ALLOWED_MIME_TYPES, cn as mapPage, ct as TextMarkup, d as AudioMimeType, dn as Subscription, dt as PlatformClientVersion, en as CreateReportInput, et as ParseMarkupOptions, f as IMAGE_MIME_TYPES, fn as RateLimitBucketState, ft as PlatformResource, g as fromStream, gn as AttemptNext, gt as StatusDay, h as VideoMimeType, hn as AttemptInterceptor, ht as ServiceStatus, i as statusDays, in as PageState, it as MarkupBuilder, j as VideoProgressInput, jt as UploadOptions, k as TelemetryOptions, kt as HashtagsResource, l as AUDIO_MIME_TYPES, ln as PaymentMethod, lt as autoSpans, m as VIDEO_MIME_TYPES, mn as AttemptExtensions, mt as PlatformStatus, n as SpanRenderFormat, nt as parseMarkdown, o as toDate, on as Paginator, ot as MarkupInput, p as ImageMimeType, pn as AttemptContext, pt as PlatformVersions, q as PostBuilder, qt as comment, r as renderSpans, rn as Page, rt as AutoSpansOptions, s as utcStampToIso, sn as PaginatorOptions, st as MarkupSpan, t as RenderSpansOptions, tn as UpdatePostInput, tt as parseHtml, u as AllowedMimeType, un as Session, ut as markup, v as VerificationResource, vn as OperationExtensions, vt as Announcement, w as InteractionEntry, wn as FeatureContext, wt as VerificationStatus, x as UserListParams, xn as PluginTeardown, xt as Clan, y as UpdatePrivacyInput, yn as OperationTransformer, yt as AnnouncementButton, z as ReportBuilder, zt as LikeResult } from "../shared/render-CgwKdOzu.js";
+import { $ as isItdValidationError, $t as RateLimitBucket, A as ItdFieldErrors, At as ResponseContext, B as ItdTimeoutError, Bt as ItdClock, C as ItdApiErrorInit, Ct as RateLimitBucketContext, D as ItdConflictError, Dt as RequestContext, E as ItdConfigError, Et as RawRequestOptions, F as ItdNotFoundError, Ft as QueryParams, G as isItdError, Gt as OPERATIONS, H as isItdApiError, Ht as BuiltInOperationId, I as ItdPhoneVerificationError, It as QueryValue, J as isItdNotFoundError, Jt as operationBucket, K as isItdFileError, Kt as OperationId, L as ItdRateLimitError, Lt as ServiceDefinition, M as ItdFileErrorReason, Mt as RetryDecisionContext, N as ItdForbiddenError, Nt as RetryOptions, O as ItdError, Ot as RequestExtensions, P as ItdNetworkError, Pt as RuntimeOptions, Q as isItdStateError, Qt as DEFAULT_RATE_LIMIT_BUCKET, R as ItdServerError, Rt as RateLimitPacing, S as ItdApiError, St as PaginationOptions, T as ItdAuthError, Tt as RateLimitOptions, U as isItdAuthError, Ut as CustomOperationId, V as ItdValidationError, Vt as systemClock, W as isItdConflictError, Wt as ItdOperationDefinition, X as isItdRateLimitError, Xt as operationRetrySafety, Y as isItdPhoneVerificationError, Yt as operationMethod, Z as isItdServerError, Zt as BUCKET_LIMITS, _ as Profile, _n as ServiceState, _t as RetrySafety, a as NotificationEvent, an as AttachmentType, at as tokenProvider, b as UserSummary, bn as ViewSource, bt as Logger, c as NotificationSettings, cn as FeedTab, ct as Unsubscribe, d as Author, dn as ItdErrorCode, dt as LIBRARY_VERSION, en as IsoDate, et as ClientConnection, f as FollowResult, fn as LikesVisibility, ft as FeatureOperationId, g as PrivacySettings, gn as ReportTargetType, gt as OperationMethod, h as PinsResult, hn as ReportReason, ht as OperationMetadata, i as formatNotificationText, in as AccessType, it as bearerToken, j as ItdFileError, jt as RetryContext, k as ItdErrorKind, kt as RequestOptions, l as Actor, ln as IncidentKind, lt as DEFAULT_BASE_URL, m as Pin, mn as NotificationType, n as canonicalNotificationType, nn as UserId, nt as AuthProvider, o as normalizeNotification, on as CommentSort, p as MyProfile, pn as Loose, pt as OperationAnnotations, q as isItdForbiddenError, qt as isBuiltInOperationId, r as isKnownNotificationType, rn as UserRef, rt as anonymousAuth, s as Notification, st as Listener, t as resolveNotificationUrl, tn as Span, un as InteractionType, ut as STATUS_SERVICE, v as PublicProfile, vn as SpanType, vt as ClientHooks, w as ItdApiErrorKind, wt as RateLimitBucketOverride, x as ItdAbortError, xn as WallAccess, xt as OperationRequestOptions, y as SubscriptionState, yn as ViewReason, yt as ErrorContextHook, z as ItdStateError, zt as RuntimeMode } from "../shared/url-XBsMdAcv.js";
+import { $ as ShopConsent, $n as Paginator, $t as autoSpans, A as UsersResource, An as Post, At as ReportInput, B as ViewTracker, Bn as CreatePostData, Bt as post, C as VideoMimeType, Cn as Comment, Cr as OperationTransformer, Ct as ShopRecipient, D as UpdatePrivacyInput, Dn as PinPostResult, Dt as SearchResult, E as VerificationResource, En as LikeResult, Et as SearchResource, F as TelemetryBatchOptions, Fn as BuilderInput, Ft as UserPostsParams, G as PayShopOrderOptions, Gn as Subscription, Gt as parseHtml, H as ViewTrackerOptions, Hn as UpdatePostInput, Ht as PollInput, I as TelemetryClock, In as ItdBuilder, It as CreatePostInput, J as ShopOrderRequestOptions, Jn as UpdateNotificationSettingsInput, Jt as MarkupBuilder, K as ShopConsentsResource, Kn as NotificationListParams, Kt as parseMarkdown, L as TelemetryOptions, Ln as isBuilder, Lt as PostBuilder, M as InteractionEntry, Mn as CommentBuilder, Mt as CommentsParams, N as PhotoOpenInput, Nn as CommentInput, Nt as FeedParams, O as UpdateProfileInput, On as Poll, Ot as ReportsResource, P as TelemetryBatch, Pn as comment, Pt as PostsResource, Q as CreateShopOrderInput, Qn as PaginationMode, Qt as TextMarkup, R as TelemetryResource, Rn as CreateCommentInput, Rt as PostInput, S as VIDEO_MIME_TYPES, Sn as Attachment, Sr as OperationExtensions, St as ShopProductStatus, T as fromUrl, Tn as Hashtag, Tr as PluginTeardown, Tt as ShopSizeChartRow, U as SubscriptionResource, Un as PaymentMethod, Ut as poll, V as ViewTrackerInput, Vn as CreateReportInput, Vt as PollBuilder, W as CreateShopOrderOptions, Wn as Session, Wt as ParseMarkupOptions, X as ShopProductsResource, Xn as Page, Xt as MarkupInput, Y as ShopOrdersResource, Yt as MarkupContent, Z as ShopResource, Zn as PageState, Zt as MarkupSpan, _ as AUDIO_MIME_TYPES, _n as FilesResource, _r as AttemptContext, _t as ShopPayment, a as ShopFeatureOptions, an as ServiceStatus, ar as FeatureContext, at as ShopDeliveryCountry, b as IMAGE_MIME_TYPES, bn as CommentsResource, br as AttemptNext, bt as ShopProductColor, c as ShopOrderAccessStorage, cn as Announcement, cr as FeatureRequestOptions, ct as ShopOrder, d as createShopOrderAccessStorage, dn as Clan, dr as PreparedBufferSource, dt as ShopOrderDelivery, en as markup, er as PaginatorOptions, et as ShopConsentContext, f as statusDays, fn as Portal, fr as PreparedFileSource, ft as ShopOrderItem, g as ALLOWED_MIME_TYPES, gn as HashtagsResource, gt as ShopOrderSupport, h as utcStampToIso, hn as HashtagPostsParams, hr as ResolveFileOptions, ht as ShopOrderSummary, i as ShopFeatureApi, in as PlatformStatus, ir as FeatureBucketDefinition, it as ShopDeliveryCity, j as DwellEntry, jn as PostStats, jt as report, k as UserListParams, kn as PollOption, kt as ReportBuilder, l as ShopOrderAccessStorageAdapterOptions, ln as AnnouncementButton, lr as ManagedClientResource, lt as ShopOrderAccessSession, m as toDate, mn as VerificationStatus, mr as ResolveFileContext, mt as ShopOrderStatus, n as SpanRenderFormat, nn as PlatformResource, nr as RateLimitBucketState, nt as ShopCreatedOrder, o as createShopFeature, on as StatusDay, or as FeatureInstallation, ot as ShopDeliveryDestination, p as isMyProfile, pn as Report, pr as PreparedStreamSource, pt as ShopOrderItemInput, q as ShopDeliveryResource, qn as NotificationsResource, qt as AutoSpansOptions, r as renderSpans, rn as PlatformVersions, rr as ClientFeature, rt as ShopDeliveryCalculation, s as MemoryShopOrderAccessStorage, sn as StatusIncidentLine, sr as FeatureOperationDefinition, st as ShopDeliveryPoint, t as RenderSpansOptions, tn as PlatformClientVersion, tr as mapPage, tt as ShopConsentKind, u as createMemoryShopOrderAccessStorage, un as ChangelogEntry, ur as FileResolver, ut as ShopOrderAccessVerification, v as AllowedMimeType, vn as UploadOptions, vr as AttemptExtensions, vt as ShopProduct, w as fromStream, wn as CommentReplyTo, wr as PluginApi, wt as ShopSizeChart, x as ImageMimeType, xn as RepliesParams, xr as ClientPlugin, xt as ShopProductSpec, y as AudioMimeType, yn as UploadedFile, yr as AttemptInterceptor, yt as ShopProductCategory, z as VideoProgressInput, zn as CreatePollInput, zt as PostUpdateInput } from "../shared/render-B4qis7Sb.js";
 import { a as FileStreamOptions, c as LazyFile, d as UrlFileOptions, i as FileStreamContent, l as StreamFile, n as FileContext, o as FileTransferMode, r as FileInput, s as FromStreamOptions, t as FileContent, u as UrlFile } from "../shared/contracts-BoT7msmq.js";
 //#region src/rest/client.d.ts
 /** Опции конструктора {@link ItdRestClient}. */
@@ -45,6 +45,8 @@ declare class ItdRestClient {
   get hashtags(): HashtagsResource;
   /** Глобальный поиск по пользователям и хэштегам. */
   get search(): SearchResource;
+  /** Каталог, доставка и заказы магазина ИТД. */
+  get shop(): ShopResource;
   /** Жалобы на контент и пользователей. */
   get reports(): ReportsResource;
   /** Верификация профиля. */
@@ -73,13 +75,13 @@ declare class ItdRestClient {
    * Пустой массив при `rateLimit: false`.
    */
   rateLimitState(): RateLimitBucketState[];
-  /** Устанавливает REST feature поверх общего request pipeline клиента. */
+  /** Устанавливает REST-модуль с общей обработкой запросов клиента. */
   install<TApi>(feature: ClientFeature<TApi>): TApi;
-  /** Устанавливает REST feature и публикует его API как readonly-свойство клиента. */
+  /** Устанавливает REST-модуль и добавляет его API в свойство только для чтения. */
   withFeature<const K extends string, TApi>(key: K, feature: ClientFeature<TApi>): this & { readonly [P in K]: TApi; };
-  /** Имена установленных feature в порядке установки. */
+  /** Имена установленных модулей в порядке установки. */
   featureNames(): string[];
-  /** Установлен ли feature с таким именем. */
+  /** Установлен ли модуль с таким именем. */
   hasFeature(name: string): boolean;
   /**
    * Подключает плагин.
@@ -142,5 +144,5 @@ declare class ItdRestClient {
  */
 declare function createRestClient(options?: RestClientOptions): ItdRestClient;
 //#endregion
-export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AccessType, type Actor, type AllowedMimeType, type Announcement, type AnnouncementButton, type Attachment, AttachmentType, type AttemptContext, type AttemptExtensions, type AttemptInterceptor, type AttemptNext, type AudioMimeType, type AuthProvider, type Author, type AutoSpansOptions, BUCKET_LIMITS, type BuilderInput, type BuiltInOperationId, type ChangelogEntry, type Clan, type ClientFeature, type ClientHooks, type ClientPlugin, type Comment, type CommentBuilder, type CommentInput, type CommentReplyTo, CommentSort, type CommentsParams, type CommentsResource, type CreateCommentInput, type CreatePollInput, type CreatePostData, type CreatePostInput, type CreateReportInput, type CustomOperationId, DEFAULT_BASE_URL, DEFAULT_RATE_LIMIT_BUCKET, type DwellEntry, type ErrorContextHook, type FeatureBucketDefinition, type FeatureContext, type FeatureInstallation, type FeatureOperationDefinition, type FeatureOperationId, type FeatureRequestOptions, type FeedParams, FeedTab, type FileContent, type FileContext, type FileInput, type FileStreamContent, type FileStreamOptions, FileTransferMode, type FilesResource, type FollowResult, type FromStreamOptions, type Hashtag, type HashtagPostsParams, type HashtagsResource, IMAGE_MIME_TYPES, type ImageMimeType, IncidentKind, type InteractionEntry, InteractionType, type IsoDate, ItdAbortError, ItdApiError, type ItdApiErrorInit, ItdApiErrorKind, ItdAuthError, type ItdBuilder, type ItdClock, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, type ItdFieldErrors, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdRestClient, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, type LazyFile, type LikeResult, LikesVisibility, type Listener, type Logger, type Loose, type MarkupBuilder, type MarkupContent, type MarkupInput, type MarkupSpan, type MyProfile, type Notification, type NotificationEvent, type NotificationListParams, type NotificationSettings, NotificationType, type NotificationsResource, OPERATIONS, type ItdOperationDefinition as OperationDefinition, type OperationExtensions, type OperationId, type OperationMethod, type OperationRequestOptions, type OperationTransformer, type Page, type PageState, PaginationMode, type PaginationOptions, Paginator, type PaginatorOptions, type ParseMarkupOptions, type PaymentMethod, type PhotoOpenInput, type Pin, type PinPostResult, type PinsResult, type PlatformClientVersion, type PlatformResource, type PlatformStatus, type PlatformVersions, type PluginApi, type PluginTeardown, type Poll, type PollBuilder, type PollInput, type PollOption, type Portal, type Post, type PostBuilder, type PostInput, type PostStats, type PostUpdateInput, type PostsResource, type PrivacySettings, type Profile, type PublicProfile, type QueryParams, type QueryValue, type RateLimitBucket, type RateLimitBucketContext, type RateLimitBucketOverride, type RateLimitBucketState, type RateLimitOptions, RateLimitPacing, type RawRequestOptions, type RenderSpansOptions, type RepliesParams, type Report, type ReportBuilder, type ReportInput, ReportReason, ReportTargetType, type ReportsResource, type RequestContext, type RequestExtensions, type RequestOptions, type ResponseContext, type RestClientOptions, type RetryContext, type RetryDecisionContext, type RetryOptions, RetrySafety, RuntimeMode, type RuntimeOptions, STATUS_SERVICE, type SearchResource, type SearchResult, type ServiceDefinition, ServiceState, type ServiceStatus, type Session, type Span, SpanRenderFormat, SpanType, type StatusDay, type StatusIncidentLine, type StreamFile, type Subscription, type SubscriptionResource, type SubscriptionState, type TelemetryBatch, type TelemetryBatchOptions, type TelemetryClock, type TelemetryOptions, type TelemetryResource, type TextMarkup, type Unsubscribe, type UpdateNotificationSettingsInput, type UpdatePostInput, type UpdatePrivacyInput, type UpdateProfileInput, type UploadOptions, type UploadedFile, type UrlFile, type UrlFileOptions, type UserId, type UserListParams, type UserPostsParams, type UserRef, type UserSummary, type UsersResource, VIDEO_MIME_TYPES, type VerificationResource, type VerificationStatus, type VideoMimeType, type VideoProgressInput, ViewReason, ViewSource, type ViewTracker, type ViewTrackerInput, type ViewTrackerOptions, WallAccess, anonymousAuth, autoSpans, bearerToken, canonicalNotificationType, comment, createRestClient, formatNotificationText, fromStream, fromUrl, isBuilder, isBuiltInOperationId, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdFileError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdStateError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, operationBucket, operationMethod, operationRetrySafety, parseHtml, parseMarkdown, poll, post, renderSpans, report, resolveNotificationUrl, statusDays, systemClock, toDate, tokenProvider, utcStampToIso };
+export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AccessType, type Actor, type AllowedMimeType, type Announcement, type AnnouncementButton, type Attachment, AttachmentType, type AttemptContext, type AttemptExtensions, type AttemptInterceptor, type AttemptNext, type AudioMimeType, type AuthProvider, type Author, type AutoSpansOptions, BUCKET_LIMITS, type BuilderInput, type BuiltInOperationId, type ChangelogEntry, type Clan, type ClientConnection, type ClientFeature, type ClientHooks, type ClientPlugin, type Comment, type CommentBuilder, type CommentInput, type CommentReplyTo, CommentSort, type CommentsParams, type CommentsResource, type CreateCommentInput, type CreatePollInput, type CreatePostData, type CreatePostInput, type CreateReportInput, type CreateShopOrderInput, type CreateShopOrderOptions, type CustomOperationId, DEFAULT_BASE_URL, DEFAULT_RATE_LIMIT_BUCKET, type DwellEntry, type ErrorContextHook, type FeatureBucketDefinition, type FeatureContext, type FeatureInstallation, type FeatureOperationDefinition, type FeatureOperationId, type FeatureRequestOptions, type FeedParams, FeedTab, type FileContent, type FileContext, type FileInput, type FileResolver, type FileStreamContent, type FileStreamOptions, FileTransferMode, type FilesResource, type FollowResult, type FromStreamOptions, type Hashtag, type HashtagPostsParams, type HashtagsResource, IMAGE_MIME_TYPES, type ImageMimeType, IncidentKind, type InteractionEntry, InteractionType, type IsoDate, ItdAbortError, ItdApiError, type ItdApiErrorInit, ItdApiErrorKind, ItdAuthError, type ItdBuilder, type ItdClock, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, type ItdFieldErrors, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdRestClient, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, type LazyFile, type LikeResult, LikesVisibility, type Listener, type Logger, type Loose, type ManagedClientResource, type MarkupBuilder, type MarkupContent, type MarkupInput, type MarkupSpan, MemoryShopOrderAccessStorage, type MyProfile, type Notification, type NotificationEvent, type NotificationListParams, type NotificationSettings, NotificationType, type NotificationsResource, OPERATIONS, type OperationAnnotations, type ItdOperationDefinition as OperationDefinition, type OperationExtensions, type OperationId, type OperationMetadata, type OperationMethod, type OperationRequestOptions, type OperationTransformer, type Page, type PageState, PaginationMode, type PaginationOptions, Paginator, type PaginatorOptions, type ParseMarkupOptions, type PayShopOrderOptions, type PaymentMethod, type PhotoOpenInput, type Pin, type PinPostResult, type PinsResult, type PlatformClientVersion, type PlatformResource, type PlatformStatus, type PlatformVersions, type PluginApi, type PluginTeardown, type Poll, type PollBuilder, type PollInput, type PollOption, type Portal, type Post, type PostBuilder, type PostInput, type PostStats, type PostUpdateInput, type PostsResource, type PreparedBufferSource, type PreparedFileSource, type PreparedStreamSource, type PrivacySettings, type Profile, type PublicProfile, type QueryParams, type QueryValue, type RateLimitBucket, type RateLimitBucketContext, type RateLimitBucketOverride, type RateLimitBucketState, type RateLimitOptions, RateLimitPacing, type RawRequestOptions, type RenderSpansOptions, type RepliesParams, type Report, type ReportBuilder, type ReportInput, ReportReason, ReportTargetType, type ReportsResource, type RequestContext, type RequestExtensions, type RequestOptions, type ResolveFileContext, type ResolveFileOptions, type ResponseContext, type RestClientOptions, type RetryContext, type RetryDecisionContext, type RetryOptions, RetrySafety, RuntimeMode, type RuntimeOptions, STATUS_SERVICE, type SearchResource, type SearchResult, type ServiceDefinition, ServiceState, type ServiceStatus, type Session, type ShopConsent, type ShopConsentContext, ShopConsentKind, type ShopConsentsResource, type ShopCreatedOrder, type ShopDeliveryCalculation, type ShopDeliveryCity, type ShopDeliveryCountry, type ShopDeliveryDestination, type ShopDeliveryPoint, type ShopDeliveryResource, type ShopFeatureApi, type ShopFeatureOptions, type ShopOrder, type ShopOrderAccessSession, type ShopOrderAccessStorage, type ShopOrderAccessStorageAdapterOptions, type ShopOrderAccessVerification, type ShopOrderDelivery, type ShopOrderItem, type ShopOrderItemInput, type ShopOrderRequestOptions, ShopOrderStatus, type ShopOrderSummary, type ShopOrderSupport, type ShopOrdersResource, type ShopPayment, type ShopProduct, ShopProductCategory, type ShopProductColor, type ShopProductSpec, ShopProductStatus, type ShopProductsResource, type ShopRecipient, type ShopResource, type ShopSizeChart, type ShopSizeChartRow, type Span, SpanRenderFormat, SpanType, type StatusDay, type StatusIncidentLine, type StreamFile, type Subscription, type SubscriptionResource, type SubscriptionState, type TelemetryBatch, type TelemetryBatchOptions, type TelemetryClock, type TelemetryOptions, type TelemetryResource, type TextMarkup, type Unsubscribe, type UpdateNotificationSettingsInput, type UpdatePostInput, type UpdatePrivacyInput, type UpdateProfileInput, type UploadOptions, type UploadedFile, type UrlFile, type UrlFileOptions, type UserId, type UserListParams, type UserPostsParams, type UserRef, type UserSummary, type UsersResource, VIDEO_MIME_TYPES, type VerificationResource, type VerificationStatus, type VideoMimeType, type VideoProgressInput, ViewReason, ViewSource, type ViewTracker, type ViewTrackerInput, type ViewTrackerOptions, WallAccess, anonymousAuth, autoSpans, bearerToken, canonicalNotificationType, comment, createMemoryShopOrderAccessStorage, createRestClient, createShopFeature, createShopOrderAccessStorage, formatNotificationText, fromStream, fromUrl, isBuilder, isBuiltInOperationId, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdFileError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdStateError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, operationBucket, operationMethod, operationRetrySafety, parseHtml, parseMarkdown, poll, post, renderSpans, report, resolveNotificationUrl, statusDays, systemClock, toDate, tokenProvider, utcStampToIso };
 //# sourceMappingURL=index.d.ts.map

package/dist/rest/index.js

@@ -1,8 +1,8 @@
-import { A as operationRetrySafety, C as ViewSource, D as isBuiltInOperationId, E as OPERATIONS, H as RetrySafety, M as DEFAULT_RATE_LIMIT_BUCKET, N as createClientRuntime, O as operationBucket, S as ViewReason, T as ITD_CATALOG, Y as STATUS_SERVICE, Z as LIBRARY_VERSION, b as ServiceState, c as AccessType, ct as installAsyncDisposeFallback, d as FeedTab, et as RateLimitPacing, f as IncidentKind, g as NotificationType, h as LikesVisibility, j as BUCKET_LIMITS, k as operationMethod, l as AttachmentType, m as ItdErrorCode, n as formatNotificationText, o as canonicalNotificationType, p as InteractionType, q as DEFAULT_BASE_URL, r as normalizeNotification, s as isKnownNotificationType, st as systemClock, t as resolveNotificationUrl, tt as RuntimeMode, u as CommentSort, v as ReportReason, w as WallAccess, x as SpanType, y as ReportTargetType } from "../shared/url-IU0xN9wX.js";
-import { A as isItdStateError, C as isItdError, D as isItdPhoneVerificationError, E as isItdNotFoundError, O as isItdRateLimitError, S as isItdConflictError, T as isItdForbiddenError, _ 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, k as isItdServerError, l as ItdFileError, m as ItdPhoneVerificationError, n as ItdApiError, o as ItdConflictError, p as ItdNotFoundError, r as ItdApiErrorKind, s as ItdError, t as ItdAbortError, u as ItdFileErrorReason, v as ItdTimeoutError, w as isItdFileError, x as isItdAuthError, y as ItdValidationError } from "../shared/errors-Bhrd2fJd.js";
-import { C as utcStampToIso, D as mapPage, E as Paginator, O as FeatureRegistry, S as toDate, T as PaginationMode, _ as IMAGE_MIME_TYPES, a as fromStream, b as isBuilder, c as report, d as autoSpans, f as markup, g as AUDIO_MIME_TYPES, h as ALLOWED_MIME_TYPES, i as isMyProfile, k as ExtensibleOperationCatalog, l as post, m as parseMarkdown, n as renderSpans, o as fromUrl, p as parseHtml, r as statusDays, s as createResources, t as SpanRenderFormat, u as poll, v as VIDEO_MIME_TYPES, x as createStatusFeature, y as comment } from "../shared/render-C6HRPs10.js";
-import { c as FileTransferMode } from "../shared/options-DtATYdLr.js";
-import { n as bearerToken, r as tokenProvider, t as anonymousAuth } from "../shared/auth-provider-mYqxsSVa.js";
+import { A as ITD_CATALOG, C as ReportReason, D as ViewReason, E as SpanType, F as operationMethod, I as operationRetrySafety, K as RetrySafety, L as BUCKET_LIMITS, N as isBuiltInOperationId, O as ViewSource, P as operationBucket, R as DEFAULT_RATE_LIMIT_BUCKET, S as NotificationType, T as ServiceState, _ as FeedTab, a as tokenProvider, b as ItdErrorCode, c as normalizeNotification, d as canonicalNotificationType, et as DEFAULT_BASE_URL, f as isKnownNotificationType, h as CommentSort, i as bearerToken, it as LIBRARY_VERSION, j as OPERATIONS, k as WallAccess, lt as systemClock, m as AttachmentType, n as formatNotificationText, nt as STATUS_SERVICE, p as AccessType, r as anonymousAuth, st as RateLimitPacing, t as resolveNotificationUrl, ut as installAsyncDisposeFallback, v as IncidentKind, w as ReportTargetType, x as LikesVisibility, y as InteractionType, z as createClientRuntime } from "../shared/url-DP33mp3s.js";
+import { A as isItdStateError, C as isItdError, D as isItdPhoneVerificationError, E as isItdNotFoundError, O as isItdRateLimitError, S as isItdConflictError, T as isItdForbiddenError, _ 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, k as isItdServerError, l as ItdFileError, m as ItdPhoneVerificationError, n as ItdApiError, o as ItdConflictError, p as ItdNotFoundError, r as ItdApiErrorKind, s as ItdError, t as ItdAbortError, u as ItdFileErrorReason, v as ItdTimeoutError, w as isItdFileError, x as isItdAuthError, y as ItdValidationError } from "../shared/errors-GI10kZxk.js";
+import { _ as RuntimeMode } from "../shared/redact-Ba5iSVYZ.js";
+import { A as toDate, C as ALLOWED_MIME_TYPES, D as comment, E as VIDEO_MIME_TYPES, F as Paginator, I as mapPage, L as createFeatureHost, M as NotificationsResource, O as isBuilder, P as PaginationMode, R as ExtensibleOperationCatalog, S as parseMarkdown, T as IMAGE_MIME_TYPES, _ as post, a as createMemoryShopOrderAccessStorage, b as markup, c as ShopConsentKind, d as ShopProductStatus, f as isMyProfile, g as report, h as createResources, i as MemoryShopOrderAccessStorage, j as utcStampToIso, k as createStatusFeature, l as ShopOrderStatus, m as fromUrl, n as renderSpans, o as createShopOrderAccessStorage, p as fromStream, r as createShopFeature, s as statusDays, t as SpanRenderFormat, u as ShopProductCategory, v as poll, w as AUDIO_MIME_TYPES, x as parseHtml, y as autoSpans } from "../shared/render-hiWFh2s4.js";
+import { c as FileTransferMode } from "../shared/options-DhgGg7Ms.js";
 //#region src/rest/client.ts
 /**
 * Минимальный клиент REST API итд.com.
@@ -55,6 +55,10 @@ var ItdRestClient = class ItdRestClient {
 	get search() {
 		return this.#resources.search;
 	}
+	/** Каталог, доставка и заказы магазина ИТД. */
+	get shop() {
+		return this.#resources.shop;
+	}
 	/** Жалобы на контент и пользователей. */
 	get reports() {
 		return this.#resources.reports;
@@ -83,22 +87,16 @@ var ItdRestClient = class ItdRestClient {
 			assertActive: (action) => this.#assertActive(action),
 			auth: () => resolveAuthProvider(auth)
 		});
-		this.#features = new FeatureRegistry({
-			http: this.#runtime.http,
-			services: this.#runtime.services,
-			serviceOverrides: this.#runtime.config.services,
+		this.#features = createFeatureHost(this.#runtime, {
 			catalog,
-			baseUrl: this.#runtime.config.baseUrl,
-			clock: this.#runtime.config.clock,
-			logger: this.#runtime.config.logger,
-			assertActive: (action) => this.#assertActive(action),
-			registerBucket: (name, definition) => this.#runtime.registerRateLimitBucket(name, definition)
+			assertActive: (action) => this.#assertActive(action)
 		});
 		const status = this.#features.install(createStatusFeature());
 		this.#resources = createResources({
 			http: this.#runtime.http,
-			fetch: this.#runtime.config.fetch,
-			status
+			files: this.#features.files,
+			status,
+			createNotifications: (http) => new NotificationsResource(http)
 		});
 	}
 	#assertActive(action) {
@@ -131,11 +129,11 @@ var ItdRestClient = class ItdRestClient {
 	rateLimitState() {
 		return this.#runtime.rateLimitState();
 	}
-	/** Устанавливает REST feature поверх общего request pipeline клиента. */
+	/** Устанавливает REST-модуль с общей обработкой запросов клиента. */
 	install(feature) {
 		return this.#features.install(feature);
 	}
-	/** Устанавливает REST feature и публикует его API как readonly-свойство клиента. */
+	/** Устанавливает REST-модуль и добавляет его API в свойство только для чтения. */
 	withFeature(key, feature) {
 		this.#assertActive("установить feature");
 		if (typeof key !== "string" || key.trim() === "" || key !== key.trim()) throw new ItdConfigError("Свойство feature должно иметь непустое имя без краевых пробелов");
@@ -150,11 +148,11 @@ var ItdRestClient = class ItdRestClient {
 		});
 		return this;
 	}
-	/** Имена установленных feature в порядке установки. */
+	/** Имена установленных модулей в порядке установки. */
 	featureNames() {
 		return this.#features.names();
 	}
-	/** Установлен ли feature с таким именем. */
+	/** Установлен ли модуль с таким именем. */
 	hasFeature(name) {
 		return this.#features.has(name);
 	}
@@ -297,6 +295,6 @@ function createRestClient(options = {}) {
 	return new ItdRestClient(options);
 }
 //#endregion
-export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AccessType, AttachmentType, BUCKET_LIMITS, CommentSort, DEFAULT_BASE_URL, DEFAULT_RATE_LIMIT_BUCKET, FeedTab, FileTransferMode, IMAGE_MIME_TYPES, IncidentKind, InteractionType, ItdAbortError, ItdApiError, ItdApiErrorKind, ItdAuthError, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdRestClient, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, LikesVisibility, NotificationType, OPERATIONS, PaginationMode, Paginator, RateLimitPacing, ReportReason, ReportTargetType, RetrySafety, RuntimeMode, STATUS_SERVICE, ServiceState, SpanRenderFormat, SpanType, VIDEO_MIME_TYPES, ViewReason, ViewSource, WallAccess, anonymousAuth, autoSpans, bearerToken, canonicalNotificationType, comment, createRestClient, formatNotificationText, fromStream, fromUrl, isBuilder, isBuiltInOperationId, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdFileError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdStateError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, operationBucket, operationMethod, operationRetrySafety, parseHtml, parseMarkdown, poll, post, renderSpans, report, resolveNotificationUrl, statusDays, systemClock, toDate, tokenProvider, utcStampToIso };
+export { ALLOWED_MIME_TYPES, AUDIO_MIME_TYPES, AccessType, AttachmentType, BUCKET_LIMITS, CommentSort, DEFAULT_BASE_URL, DEFAULT_RATE_LIMIT_BUCKET, FeedTab, FileTransferMode, IMAGE_MIME_TYPES, IncidentKind, InteractionType, ItdAbortError, ItdApiError, ItdApiErrorKind, ItdAuthError, ItdConfigError, ItdConflictError, ItdError, ItdErrorCode, ItdErrorKind, ItdFileError, ItdFileErrorReason, ItdForbiddenError, ItdNetworkError, ItdNotFoundError, ItdPhoneVerificationError, ItdRateLimitError, ItdRestClient, ItdServerError, ItdStateError, ItdTimeoutError, ItdValidationError, LIBRARY_VERSION, LikesVisibility, MemoryShopOrderAccessStorage, NotificationType, OPERATIONS, PaginationMode, Paginator, RateLimitPacing, ReportReason, ReportTargetType, RetrySafety, RuntimeMode, STATUS_SERVICE, ServiceState, ShopConsentKind, ShopOrderStatus, ShopProductCategory, ShopProductStatus, SpanRenderFormat, SpanType, VIDEO_MIME_TYPES, ViewReason, ViewSource, WallAccess, anonymousAuth, autoSpans, bearerToken, canonicalNotificationType, comment, createMemoryShopOrderAccessStorage, createRestClient, createShopFeature, createShopOrderAccessStorage, formatNotificationText, fromStream, fromUrl, isBuilder, isBuiltInOperationId, isItdApiError, isItdAuthError, isItdConflictError, isItdError, isItdFileError, isItdForbiddenError, isItdNotFoundError, isItdPhoneVerificationError, isItdRateLimitError, isItdServerError, isItdStateError, isItdValidationError, isKnownNotificationType, isMyProfile, mapPage, markup, normalizeNotification, operationBucket, operationMethod, operationRetrySafety, parseHtml, parseMarkdown, poll, post, renderSpans, report, resolveNotificationUrl, statusDays, systemClock, toDate, tokenProvider, utcStampToIso };
 
 //# sourceMappingURL=index.js.map

package/dist/rest/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["#runtime","#features","#resources","#assertActive","#disposed","#disposePromise","#dispose"],"sources":["../../src/rest/client.ts"],"sourcesContent":["import { installAsyncDisposeFallback } from '../core/async-dispose.js';\nimport { type AuthProvider, anonymousAuth, bearerToken } from '../core/auth-provider.js';\nimport { ItdConfigError, ItdStateError } from '../core/errors.js';\nimport { type ClientRuntime, createClientRuntime } from '../core/execution/client-runtime.js';\nimport { ExtensibleOperationCatalog } from '../core/feature-catalog.js';\nimport { type ClientFeature, FeatureRegistry } from '../core/features.js';\nimport type { RawRequestOptions, RuntimeOptions } from '../core/options.js';\nimport type { ClientPlugin } from '../core/plugins/contracts.js';\nimport type { RateLimitBucketState } from '../core/scheduling/rate-limit.js';\nimport type { ServiceDefinition } from '../core/services.js';\nimport { ITD_CATALOG } from '../domain/catalog.js';\nimport type { CommentsResource } from '../resources/comments.js';\nimport type { FilesResource } from '../resources/files.js';\nimport type { HashtagsResource } from '../resources/hashtags.js';\nimport type { NotificationsResource } from '../resources/notifications.js';\nimport type { PlatformResource } from '../resources/platform.js';\nimport type { PostsResource } from '../resources/posts.js';\nimport type { ReportsResource } from '../resources/reports.js';\nimport type { SearchResource } from '../resources/search.js';\nimport { createStatusFeature } from '../resources/status.js';\nimport type { SubscriptionResource } from '../resources/subscription.js';\nimport type { TelemetryResource } from '../resources/telemetry.js';\nimport type { UsersResource } from '../resources/users.js';\nimport type { VerificationResource } from '../resources/verification.js';\nimport { createResources, type RestResources } from './resources.js';\n\n/** Опции конструктора {@link ItdRestClient}. */\nexport interface RestClientOptions extends RuntimeOptions {\n  /**\n   * Авторизация. Строка — сокращение для {@link bearerToken}.\n   *\n   * Без неё доступны только публичные эндпоинты. Токен здесь считается готовым: продлевать\n   * его клиент не умеет и на `401` отвечает ошибкой. Сессия, которая входит по паролю\n   * и продлевает себя сама, живёт в полном `ItdClient`.\n   */\n  auth?: string | AuthProvider | undefined;\n}\n\n/**\n * Минимальный клиент REST API итд.com.\n *\n * Тот же конвейер запросов, что и у полного клиента, — с повторами, очередью, плагинами\n * и типизированными ошибками, — но без сессии, потока событий и нескольких аккаунтов.\n * Нужен там, где токен уже есть, а размер поставки важен: серверные интеграции, воркеры,\n * браузерные приложения.\n *\n * @example\n * ```ts\n * import { createRestClient } from 'itd-api/rest';\n *\n * const api = createRestClient({ auth: process.env.ITD_TOKEN });\n * const feed = await api.posts.list({ tab: 'popular' });\n * ```\n */\nexport class ItdRestClient {\n  readonly #runtime: ClientRuntime;\n  readonly #features: FeatureRegistry;\n  readonly #resources: RestResources;\n  /** Общий результат терминальной очистки для идемпотентных повторных вызовов. */\n  #disposePromise: Promise<void> | undefined;\n  #disposed = false;\n\n  /** Профили, подписки, блокировки, приватность. */\n  get users(): UsersResource {\n    return this.#resources.users;\n  }\n\n  /** Лента, публикация, реакции, репосты, комментарии к постам. */\n  get posts(): PostsResource {\n    return this.#resources.posts;\n  }\n\n  /** Ответы на комментарии и действия над ними. */\n  get comments(): CommentsResource {\n    return this.#resources.comments;\n  }\n\n  /** Загрузка файлов и медиа. */\n  get files(): FilesResource {\n    return this.#resources.files;\n  }\n\n  /** Уведомления: список, счётчик, отметки о прочтении, настройки. */\n  get notifications(): NotificationsResource {\n    return this.#resources.notifications;\n  }\n\n  /** Хэштеги и посты по ним. */\n  get hashtags(): HashtagsResource {\n    return this.#resources.hashtags;\n  }\n\n  /** Глобальный поиск по пользователям и хэштегам. */\n  get search(): SearchResource {\n    return this.#resources.search;\n  }\n\n  /** Жалобы на контент и пользователей. */\n  get reports(): ReportsResource {\n    return this.#resources.reports;\n  }\n\n  /** Верификация профиля. */\n  get verification(): VerificationResource {\n    return this.#resources.verification;\n  }\n\n  /** Подписка и способы оплаты. */\n  get subscription(): SubscriptionResource {\n    return this.#resources.subscription;\n  }\n\n  /** Сведения о платформе: версии приложений, изменения, анонсы, баннер события. */\n  get platform(): PlatformResource {\n    return this.#resources.platform;\n  }\n\n  /** Телеметрия просмотров. */\n  get telemetry(): TelemetryResource {\n    return this.#resources.telemetry;\n  }\n\n  constructor(options: RestClientOptions = {}) {\n    const { auth, ...runtimeOptions } = options;\n    const catalog = new ExtensibleOperationCatalog(ITD_CATALOG);\n\n    this.#runtime = createClientRuntime(runtimeOptions, {\n      catalog,\n      assertActive: (action) => this.#assertActive(action),\n      auth: () => resolveAuthProvider(auth),\n    });\n    this.#features = new FeatureRegistry({\n      http: this.#runtime.http,\n      services: this.#runtime.services,\n      serviceOverrides: this.#runtime.config.services,\n      catalog,\n      baseUrl: this.#runtime.config.baseUrl,\n      clock: this.#runtime.config.clock,\n      logger: this.#runtime.config.logger,\n      assertActive: (action) => this.#assertActive(action),\n      registerBucket: (name, definition) => this.#runtime.registerRateLimitBucket(name, definition),\n    });\n    const status = this.#features.install(createStatusFeature());\n    this.#resources = createResources({\n      http: this.#runtime.http,\n      fetch: this.#runtime.config.fetch,\n      status,\n    });\n  }\n\n  #assertActive(action: string): void {\n    if (!this.#disposed) return;\n    throw new ItdStateError(\n      `Клиент уже окончательно освобождён через dispose(); нельзя ${action}. Создайте новый клиент`,\n    );\n  }\n\n  /** Базовый URL, к которому обращается клиент. */\n  get baseUrl(): string {\n    return this.#runtime.config.baseUrl;\n  }\n\n  /**\n   * Выполняет произвольный запрос к API.\n   *\n   * Запасной путь для случаев, когда нужного метода ещё нет или ответ сервера разошёлся\n   * с документацией. Проходит через ту же авторизацию, очередь и обработку ошибок.\n   *\n   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}\n   */\n  request<T = unknown>(options: RawRequestOptions): Promise<T> {\n    return this.#runtime.http.request<T>({\n      ...options,\n      operationId: options.operationId ?? 'raw',\n    });\n  }\n\n  /**\n   * Остаток серверных лимитов по бакетам, через которые уже проходили запросы.\n   *\n   * Пустой массив при `rateLimit: false`.\n   */\n  rateLimitState(): RateLimitBucketState[] {\n    return this.#runtime.rateLimitState();\n  }\n\n  /** Устанавливает REST feature поверх общего request pipeline клиента. */\n  install<TApi>(feature: ClientFeature<TApi>): TApi {\n    return this.#features.install(feature);\n  }\n\n  /** Устанавливает REST feature и публикует его API как readonly-свойство клиента. */\n  withFeature<const K extends string, TApi>(\n    key: K,\n    feature: ClientFeature<TApi>,\n  ): this & { readonly [P in K]: TApi } {\n    this.#assertActive('установить feature');\n    if (typeof key !== 'string' || key.trim() === '' || key !== key.trim()) {\n      throw new ItdConfigError('Свойство feature должно иметь непустое имя без краевых пробелов');\n    }\n    if (key === 'then' || key in this) {\n      throw new ItdConfigError(`Свойство клиента «${key}» уже занято или зарезервировано`);\n    }\n    if (!Object.isExtensible(this)) {\n      throw new ItdConfigError('Нельзя опубликовать feature на нерасширяемом клиенте');\n    }\n\n    const api = this.install(feature);\n    Object.defineProperty(this, key, {\n      value: api,\n      enumerable: true,\n      configurable: false,\n      writable: false,\n    });\n    return this as this & { readonly [P in K]: TApi };\n  }\n\n  /** Имена установленных feature в порядке установки. */\n  featureNames(): string[] {\n    return this.#features.names();\n  }\n\n  /** Установлен ли feature с таким именем. */\n  hasFeature(name: string): boolean {\n    return this.#features.has(name);\n  }\n\n  /**\n   * Подключает плагин.\n   *\n   * Сессионная идентичность плагину не передаётся: у клиента с готовым токеном её нет.\n   * Плагинам, которые изолируют состояние по аккаунту, нужен полный `ItdClient`.\n   *\n   * @throws {ItdConfigError} если плагин задан неверно или уже подключён\n   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}\n   */\n  use(plugin: ClientPlugin): this {\n    this.#assertActive('подключить плагин');\n    this.#runtime.plugins.add(plugin, {\n      baseUrl: this.#runtime.config.baseUrl,\n      logger: this.#runtime.config.logger,\n    });\n    return this;\n  }\n\n  /**\n   * Отключает плагин и освобождает заведённые им ресурсы.\n   *\n   * @returns `false`, если такого плагина не было\n   * @throws {ItdConfigError} если от плагина зависит другой подключённый плагин\n   */\n  unuse(name: string): Promise<boolean> {\n    return this.#runtime.plugins.remove(name);\n  }\n\n  /** Имена подключённых плагинов в фактическом порядке выполнения обёрток. */\n  pluginNames(): string[] {\n    return this.#runtime.plugins.names();\n  }\n\n  /** Подключён ли плагин с таким именем. */\n  hasPlugin(name: string): boolean {\n    return this.#runtime.plugins.has(name);\n  }\n\n  /**\n   * Регистрирует сервис платформы — домен, отличный от основного.\n   *\n   * @throws {ItdConfigError} если определение неверно или имя уже занято\n   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}\n   */\n  defineService(definition: ServiceDefinition): this {\n    this.#assertActive('зарегистрировать сервис');\n    this.#runtime.services.define(definition);\n    return this;\n  }\n\n  /**\n   * Отправляет открытые накопители {@link telemetry} и останавливает очередь запросов.\n   *\n   * После вызова клиентом можно пользоваться снова. Терминальное освобождение —\n   * это {@link dispose}.\n   */\n  async close(): Promise<void> {\n    const errors: unknown[] = [];\n    try {\n      try {\n        await this.#features.close();\n      } catch (error) {\n        errors.push(error);\n      }\n      try {\n        await this.#resources.closeTelemetry(false);\n      } catch (error) {\n        errors.push(error);\n      }\n    } finally {\n      this.#runtime.close();\n    }\n    if (errors.length === 1) throw errors[0];\n    if (errors.length > 1) throw new AggregateError(errors, 'Не удалось закрыть клиент');\n  }\n\n  /**\n   * Окончательно освобождает клиент: выполняет {@link close}, отменяет незавершённые\n   * запросы и отключает все плагины.\n   *\n   * Терминальное состояние устанавливается сразу при первом вызове; повторные вызовы\n   * возвращают тот же результат очистки.\n   *\n   * @example\n   * ```ts\n   * await using api = createRestClient({ auth: token });\n   * ```\n   */\n  dispose(): Promise<void> {\n    if (this.#disposePromise) return this.#disposePromise;\n    this.#disposed = true;\n    this.#disposePromise = this.#dispose();\n    return this.#disposePromise;\n  }\n\n  async #dispose(): Promise<void> {\n    const errors: unknown[] = [];\n    // Телеметрия уходит через ещё установленный plugin pipeline и мимо проверки состояния.\n    this.#resources.prepareTelemetryClose();\n    try {\n      await this.#features.close();\n    } catch (error) {\n      errors.push(error);\n    }\n    try {\n      await this.#resources.closeTelemetry(true);\n    } catch (error) {\n      errors.push(error);\n    }\n    try {\n      await this.#features.dispose();\n    } catch (error) {\n      errors.push(error);\n    }\n    try {\n      this.#runtime.close();\n      await this.#runtime.dispose();\n    } catch (error) {\n      errors.push(error);\n    }\n    if (errors.length > 0) throw new AggregateError(errors, 'Не удалось освободить клиент');\n  }\n\n  /** Позволяет использовать клиент с `await using`. */\n  [Symbol.asyncDispose](): Promise<void> {\n    return this.dispose();\n  }\n\n  static {\n    installAsyncDisposeFallback(ItdRestClient);\n  }\n}\n\n/** Приводит опцию `auth` к провайдеру конвейера. */\nfunction resolveAuthProvider(auth: RestClientOptions['auth']): AuthProvider {\n  if (auth === undefined) return anonymousAuth();\n  return typeof auth === 'string' ? bearerToken(auth) : auth;\n}\n\n/**\n * Создаёт минимальный клиент REST API. Равнозначно конструктору {@link ItdRestClient}.\n *\n * @example\n * ```ts\n * const api = createRestClient({ auth: token, rateLimit: { concurrency: 4 } });\n * ```\n */\nexport function createRestClient(options: RestClientOptions = {}): ItdRestClient {\n  return new ItdRestClient(options);\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["#runtime","#features","#resources","#assertActive","#disposed","#disposePromise","#dispose"],"sources":["../../src/rest/client.ts"],"sourcesContent":["import { installAsyncDisposeFallback } from '../core/async-dispose.js';\nimport { type AuthProvider, anonymousAuth, bearerToken } from '../core/auth-provider.js';\nimport { ItdConfigError, ItdStateError } from '../core/errors.js';\nimport { type ClientRuntime, createClientRuntime } from '../core/execution/client-runtime.js';\nimport { ExtensibleOperationCatalog } from '../core/feature-catalog.js';\nimport { type ClientFeatureHost, createFeatureHost } from '../core/feature-host.js';\nimport type { ClientFeature } from '../core/features.js';\nimport type { RawRequestOptions, RuntimeOptions } from '../core/options.js';\nimport type { ClientPlugin } from '../core/plugins/contracts.js';\nimport type { RateLimitBucketState } from '../core/scheduling/rate-limit.js';\nimport type { ServiceDefinition } from '../core/services.js';\nimport { ITD_CATALOG } from '../domain/catalog.js';\nimport type { CommentsResource } from '../resources/comments.js';\nimport type { FilesResource } from '../resources/files.js';\nimport type { HashtagsResource } from '../resources/hashtags.js';\nimport { NotificationsResource } from '../resources/notifications.js';\nimport type { PlatformResource } from '../resources/platform.js';\nimport type { PostsResource } from '../resources/posts.js';\nimport type { ReportsResource } from '../resources/reports.js';\nimport type { SearchResource } from '../resources/search.js';\nimport type { ShopResource } from '../resources/shop.js';\nimport { createStatusFeature } from '../resources/status.js';\nimport type { SubscriptionResource } from '../resources/subscription.js';\nimport type { TelemetryResource } from '../resources/telemetry.js';\nimport type { UsersResource } from '../resources/users.js';\nimport type { VerificationResource } from '../resources/verification.js';\nimport { createResources, type RestResources } from './resources.js';\n\n/** Опции конструктора {@link ItdRestClient}. */\nexport interface RestClientOptions extends RuntimeOptions {\n  /**\n   * Авторизация. Строка — сокращение для {@link bearerToken}.\n   *\n   * Без неё доступны только публичные эндпоинты. Токен здесь считается готовым: продлевать\n   * его клиент не умеет и на `401` отвечает ошибкой. Сессия, которая входит по паролю\n   * и продлевает себя сама, живёт в полном `ItdClient`.\n   */\n  auth?: string | AuthProvider | undefined;\n}\n\n/**\n * Минимальный клиент REST API итд.com.\n *\n * Тот же конвейер запросов, что и у полного клиента, — с повторами, очередью, плагинами\n * и типизированными ошибками, — но без сессии, потока событий и нескольких аккаунтов.\n * Нужен там, где токен уже есть, а размер поставки важен: серверные интеграции, воркеры,\n * браузерные приложения.\n *\n * @example\n * ```ts\n * import { createRestClient } from 'itd-api/rest';\n *\n * const api = createRestClient({ auth: process.env.ITD_TOKEN });\n * const feed = await api.posts.list({ tab: 'popular' });\n * ```\n */\nexport class ItdRestClient {\n  readonly #runtime: ClientRuntime;\n  readonly #features: ClientFeatureHost;\n  readonly #resources: RestResources;\n  /** Общий результат терминальной очистки для идемпотентных повторных вызовов. */\n  #disposePromise: Promise<void> | undefined;\n  #disposed = false;\n\n  /** Профили, подписки, блокировки, приватность. */\n  get users(): UsersResource {\n    return this.#resources.users;\n  }\n\n  /** Лента, публикация, реакции, репосты, комментарии к постам. */\n  get posts(): PostsResource {\n    return this.#resources.posts;\n  }\n\n  /** Ответы на комментарии и действия над ними. */\n  get comments(): CommentsResource {\n    return this.#resources.comments;\n  }\n\n  /** Загрузка файлов и медиа. */\n  get files(): FilesResource {\n    return this.#resources.files;\n  }\n\n  /** Уведомления: список, счётчик, отметки о прочтении, настройки. */\n  get notifications(): NotificationsResource {\n    return this.#resources.notifications;\n  }\n\n  /** Хэштеги и посты по ним. */\n  get hashtags(): HashtagsResource {\n    return this.#resources.hashtags;\n  }\n\n  /** Глобальный поиск по пользователям и хэштегам. */\n  get search(): SearchResource {\n    return this.#resources.search;\n  }\n\n  /** Каталог, доставка и заказы магазина ИТД. */\n  get shop(): ShopResource {\n    return this.#resources.shop;\n  }\n\n  /** Жалобы на контент и пользователей. */\n  get reports(): ReportsResource {\n    return this.#resources.reports;\n  }\n\n  /** Верификация профиля. */\n  get verification(): VerificationResource {\n    return this.#resources.verification;\n  }\n\n  /** Подписка и способы оплаты. */\n  get subscription(): SubscriptionResource {\n    return this.#resources.subscription;\n  }\n\n  /** Сведения о платформе: версии приложений, изменения, анонсы, баннер события. */\n  get platform(): PlatformResource {\n    return this.#resources.platform;\n  }\n\n  /** Телеметрия просмотров. */\n  get telemetry(): TelemetryResource {\n    return this.#resources.telemetry;\n  }\n\n  constructor(options: RestClientOptions = {}) {\n    const { auth, ...runtimeOptions } = options;\n    const catalog = new ExtensibleOperationCatalog(ITD_CATALOG);\n\n    this.#runtime = createClientRuntime(runtimeOptions, {\n      catalog,\n      assertActive: (action) => this.#assertActive(action),\n      auth: () => resolveAuthProvider(auth),\n    });\n    this.#features = createFeatureHost(this.#runtime, {\n      catalog,\n      assertActive: (action) => this.#assertActive(action),\n    });\n    const status = this.#features.install(createStatusFeature());\n    this.#resources = createResources({\n      http: this.#runtime.http,\n      files: this.#features.files,\n      status,\n      createNotifications: (http) => new NotificationsResource(http),\n    });\n  }\n\n  #assertActive(action: string): void {\n    if (!this.#disposed) return;\n    throw new ItdStateError(\n      `Клиент уже окончательно освобождён через dispose(); нельзя ${action}. Создайте новый клиент`,\n    );\n  }\n\n  /** Базовый URL, к которому обращается клиент. */\n  get baseUrl(): string {\n    return this.#runtime.config.baseUrl;\n  }\n\n  /**\n   * Выполняет произвольный запрос к API.\n   *\n   * Запасной путь для случаев, когда нужного метода ещё нет или ответ сервера разошёлся\n   * с документацией. Проходит через ту же авторизацию, очередь и обработку ошибок.\n   *\n   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}\n   */\n  request<T = unknown>(options: RawRequestOptions): Promise<T> {\n    return this.#runtime.http.request<T>({\n      ...options,\n      operationId: options.operationId ?? 'raw',\n    });\n  }\n\n  /**\n   * Остаток серверных лимитов по бакетам, через которые уже проходили запросы.\n   *\n   * Пустой массив при `rateLimit: false`.\n   */\n  rateLimitState(): RateLimitBucketState[] {\n    return this.#runtime.rateLimitState();\n  }\n\n  /** Устанавливает REST-модуль с общей обработкой запросов клиента. */\n  install<TApi>(feature: ClientFeature<TApi>): TApi {\n    return this.#features.install(feature);\n  }\n\n  /** Устанавливает REST-модуль и добавляет его API в свойство только для чтения. */\n  withFeature<const K extends string, TApi>(\n    key: K,\n    feature: ClientFeature<TApi>,\n  ): this & { readonly [P in K]: TApi } {\n    this.#assertActive('установить feature');\n    if (typeof key !== 'string' || key.trim() === '' || key !== key.trim()) {\n      throw new ItdConfigError('Свойство feature должно иметь непустое имя без краевых пробелов');\n    }\n    if (key === 'then' || key in this) {\n      throw new ItdConfigError(`Свойство клиента «${key}» уже занято или зарезервировано`);\n    }\n    if (!Object.isExtensible(this)) {\n      throw new ItdConfigError('Нельзя опубликовать feature на нерасширяемом клиенте');\n    }\n\n    const api = this.install(feature);\n    Object.defineProperty(this, key, {\n      value: api,\n      enumerable: true,\n      configurable: false,\n      writable: false,\n    });\n    return this as this & { readonly [P in K]: TApi };\n  }\n\n  /** Имена установленных модулей в порядке установки. */\n  featureNames(): string[] {\n    return this.#features.names();\n  }\n\n  /** Установлен ли модуль с таким именем. */\n  hasFeature(name: string): boolean {\n    return this.#features.has(name);\n  }\n\n  /**\n   * Подключает плагин.\n   *\n   * Сессионная идентичность плагину не передаётся: у клиента с готовым токеном её нет.\n   * Плагинам, которые изолируют состояние по аккаунту, нужен полный `ItdClient`.\n   *\n   * @throws {ItdConfigError} если плагин задан неверно или уже подключён\n   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}\n   */\n  use(plugin: ClientPlugin): this {\n    this.#assertActive('подключить плагин');\n    this.#runtime.plugins.add(plugin, {\n      baseUrl: this.#runtime.config.baseUrl,\n      logger: this.#runtime.config.logger,\n    });\n    return this;\n  }\n\n  /**\n   * Отключает плагин и освобождает заведённые им ресурсы.\n   *\n   * @returns `false`, если такого плагина не было\n   * @throws {ItdConfigError} если от плагина зависит другой подключённый плагин\n   */\n  unuse(name: string): Promise<boolean> {\n    return this.#runtime.plugins.remove(name);\n  }\n\n  /** Имена подключённых плагинов в фактическом порядке выполнения обёрток. */\n  pluginNames(): string[] {\n    return this.#runtime.plugins.names();\n  }\n\n  /** Подключён ли плагин с таким именем. */\n  hasPlugin(name: string): boolean {\n    return this.#runtime.plugins.has(name);\n  }\n\n  /**\n   * Регистрирует сервис платформы — домен, отличный от основного.\n   *\n   * @throws {ItdConfigError} если определение неверно или имя уже занято\n   * @throws {ItdStateError} если клиент уже освобождён через {@link dispose}\n   */\n  defineService(definition: ServiceDefinition): this {\n    this.#assertActive('зарегистрировать сервис');\n    this.#runtime.services.define(definition);\n    return this;\n  }\n\n  /**\n   * Отправляет открытые накопители {@link telemetry} и останавливает очередь запросов.\n   *\n   * После вызова клиентом можно пользоваться снова. Терминальное освобождение —\n   * это {@link dispose}.\n   */\n  async close(): Promise<void> {\n    const errors: unknown[] = [];\n    try {\n      try {\n        await this.#features.close();\n      } catch (error) {\n        errors.push(error);\n      }\n      try {\n        await this.#resources.closeTelemetry(false);\n      } catch (error) {\n        errors.push(error);\n      }\n    } finally {\n      this.#runtime.close();\n    }\n    if (errors.length === 1) throw errors[0];\n    if (errors.length > 1) throw new AggregateError(errors, 'Не удалось закрыть клиент');\n  }\n\n  /**\n   * Окончательно освобождает клиент: выполняет {@link close}, отменяет незавершённые\n   * запросы и отключает все плагины.\n   *\n   * Терминальное состояние устанавливается сразу при первом вызове; повторные вызовы\n   * возвращают тот же результат очистки.\n   *\n   * @example\n   * ```ts\n   * await using api = createRestClient({ auth: token });\n   * ```\n   */\n  dispose(): Promise<void> {\n    if (this.#disposePromise) return this.#disposePromise;\n    this.#disposed = true;\n    this.#disposePromise = this.#dispose();\n    return this.#disposePromise;\n  }\n\n  async #dispose(): Promise<void> {\n    const errors: unknown[] = [];\n    // Телеметрия уходит через ещё установленные плагины и мимо проверки состояния.\n    this.#resources.prepareTelemetryClose();\n    try {\n      await this.#features.close();\n    } catch (error) {\n      errors.push(error);\n    }\n    try {\n      await this.#resources.closeTelemetry(true);\n    } catch (error) {\n      errors.push(error);\n    }\n    try {\n      await this.#features.dispose();\n    } catch (error) {\n      errors.push(error);\n    }\n    try {\n      this.#runtime.close();\n      await this.#runtime.dispose();\n    } catch (error) {\n      errors.push(error);\n    }\n    if (errors.length > 0) throw new AggregateError(errors, 'Не удалось освободить клиент');\n  }\n\n  /** Позволяет использовать клиент с `await using`. */\n  [Symbol.asyncDispose](): Promise<void> {\n    return this.dispose();\n  }\n\n  static {\n    installAsyncDisposeFallback(ItdRestClient);\n  }\n}\n\n/** Приводит опцию `auth` к провайдеру конвейера. */\nfunction resolveAuthProvider(auth: RestClientOptions['auth']): AuthProvider {\n  if (auth === undefined) return anonymousAuth();\n  return typeof auth === 'string' ? bearerToken(auth) : auth;\n}\n\n/**\n * Создаёт минимальный клиент REST API. Равнозначно конструктору {@link ItdRestClient}.\n *\n * @example\n * ```ts\n * const api = createRestClient({ auth: token, rateLimit: { concurrency: 4 } });\n * ```\n */\nexport function createRestClient(options: RestClientOptions = {}): ItdRestClient {\n  return new ItdRestClient(options);\n}\n"],"mappings":"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"}

package/dist/shared/{errors-DfU8M5eS.cjs → errors-BmP3TKoW.cjs}

@@ -244,7 +244,7 @@ const ItdFileErrorReason = Object.freeze({
 /** Не удалось получить или прочитать содержимое вложения. */
 var ItdFileError = class extends ItdError {
 	reason;
-	/** Адрес источника, если файл получался по сети. */
+	/** Адрес источника без секретных параметров запроса, если файл получался по сети. */
 	url;
 	/** HTTP-статус источника. */
 	status;
@@ -305,7 +305,7 @@ var ItdAbortError = class extends ItdError {
 * Операция невозможна в текущем состоянии объекта.
 *
 * Например, клиент уже окончательно освобождён через `dispose()` и не может выполнять
-* новые запросы или создавать realtime-потоки.
+* новые запросы или создавать событийные соединения.
 */
 var ItdStateError = class extends ItdError {
 	constructor(message, options) {
@@ -571,4 +571,4 @@ Object.defineProperty(exports, "isItdValidationError", {
 	}
 });
 
-//# sourceMappingURL=errors-DfU8M5eS.cjs.map
+//# sourceMappingURL=errors-BmP3TKoW.cjs.map

package/dist/shared/{errors-DfU8M5eS.cjs.map → errors-BmP3TKoW.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"errors-DfU8M5eS.cjs","names":[],"sources":["../../src/core/errors.ts"],"sourcesContent":["import type { ItdErrorCode } from '../types/enums.js';\n\n/** Бренд, по которому ошибки библиотеки распознаются надёжнее, чем через `instanceof`. */\nconst ITD_ERROR = Symbol.for('itd.error');\n\n/**\n * Категория ошибки. Определяет, какие поля у неё есть.\n *\n * Значение, а не только тип: категорию нужно с чем-то сравнивать в рантайме.\n */\nexport const ItdErrorKind = Object.freeze({\n  /** Сервер ответил статусом ≥ 400. */\n  Api: 'api',\n  /** Запрос не дошёл до сервера. */\n  Network: 'network',\n  /** Истёк таймаут запроса. */\n  Timeout: 'timeout',\n  /** Запрос отменён через `AbortSignal`. */\n  Abort: 'abort',\n  /** Операция невозможна в текущем состоянии объекта. */\n  State: 'state',\n  /** Не удалось получить или подготовить содержимое вложения. */\n  File: 'file',\n  /** Некорректная конфигурация или аргументы — обнаружено до обращения к сети. */\n  Config: 'config',\n} as const);\nexport type ItdErrorKind = (typeof ItdErrorKind)[keyof typeof ItdErrorKind];\n\n/**\n * Разновидность ошибки API — то же, что класс ошибки, но в виде данных.\n *\n * Существует потому, что `instanceof` подводит, когда в дереве зависимостей оказались\n * две копии пакета или смешаны сборки ESM и CJS: классы тогда разные, хотя ошибка та же.\n * Проверки {@link isItdValidationError} и соседние опираются на это поле, а не на класс.\n */\nexport const ItdApiErrorKind = Object.freeze({\n  /** Ни одна из специализаций не подошла. */\n  Generic: 'generic',\n  Validation: 'validation',\n  Auth: 'auth',\n  Forbidden: 'forbidden',\n  NotFound: 'not_found',\n  Conflict: 'conflict',\n  RateLimit: 'rate_limit',\n  PhoneVerification: 'phone_verification',\n  Server: 'server',\n} as const);\nexport type ItdApiErrorKind = (typeof ItdApiErrorKind)[keyof typeof ItdApiErrorKind];\n\n/** Ошибки по полям формы: `{ email: ['уже занят'] }`. */\nexport type ItdFieldErrors = Record<string, string[]>;\n\n/**\n * Базовый класс всех ошибок библиотеки.\n *\n * Ловить его имеет смысл, чтобы отделить проблемы обращения к итд.com от прочих исключений.\n * Для разбора конкретной причины используйте {@link isItdApiError} и поле {@link ItdApiError.code}.\n *\n * @example\n * ```ts\n * try {\n *   await itd.posts.like(id);\n * } catch (e) {\n *   if (isItdError(e)) console.error('итд.com:', e.message);\n *   else throw e;\n * }\n * ```\n */\nexport class ItdError extends Error {\n  /** @internal */\n  readonly [ITD_ERROR] = true as const;\n\n  /** Категория ошибки. */\n  readonly kind: ItdErrorKind;\n\n  constructor(kind: ItdErrorKind, message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.kind = kind;\n    this.name = 'ItdError';\n  }\n}\n\n/** Параметры конструктора {@link ItdApiError}. */\nexport interface ItdApiErrorInit {\n  /** HTTP-статус ответа. */\n  status: number;\n  /** Строковый код ошибки из тела ответа. */\n  code: ItdErrorCode;\n  /** Человекочитаемое сообщение. */\n  message: string;\n  /** Расширенное описание, если сервер его прислал. */\n  detail?: string | undefined;\n  /** Заголовок ошибки, если сервер его прислал. */\n  title?: string | undefined;\n  /** Ошибки по конкретным полям (сведены из `errors` и `violations`). */\n  fieldErrors?: ItdFieldErrors | undefined;\n  /** Идентификатор запроса из заголовков ответа, если есть. */\n  requestId?: string | undefined;\n  /** HTTP-метод запроса. */\n  method: string;\n  /** Путь запроса без базового URL. */\n  path: string;\n  /** Тело ответа как оно пришло — на случай, если документация разошлась с реальностью. */\n  raw: unknown;\n  /** Сам объект ответа. Тело уже прочитано. */\n  response?: Response | undefined;\n  /** Значение `Retry-After` в миллисекундах, если заголовок был. */\n  retryAfter?: number | undefined;\n  /** Сколько запросов разрешено в окне (`x-ratelimit-limit`). */\n  rateLimit?: number | undefined;\n  /** Сколько запросов осталось в окне (`x-ratelimit-remaining`). */\n  rateLimitRemaining?: number | undefined;\n}\n\n/**\n * Ошибка, возвращённая сервером итд.com (HTTP-статус ≥ 400).\n *\n * API отдаёт ошибки в двух разных формах — `{ error: { … } }` и `{ code, message, violations }`.\n * Библиотека сводит обе к этому классу, поэтому разбирать форму ответа вручную не нужно.\n *\n * @example\n * ```ts\n * try {\n *   await itd.users.updateMe({ username: 'занятое_имя' });\n * } catch (e) {\n *   if (e instanceof ItdValidationError) {\n *     console.log(e.fieldErrors.username); // ['Имя уже занято']\n *   }\n * }\n * ```\n */\nexport class ItdApiError extends ItdError {\n  /**\n   * Разновидность ошибки: та же информация, что и класс, но пригодная для сравнения.\n   *\n   * Позволяет разбирать ошибку через `switch`, а проверкам вроде {@link isItdAuthError} —\n   * работать даже когда в проекте оказались две копии библиотеки.\n   */\n  readonly apiKind: ItdApiErrorKind;\n  /** HTTP-статус ответа. */\n  readonly status: number;\n  /** Строковый код ошибки, например `VALIDATION_ERROR`. */\n  readonly code: ItdErrorCode;\n  /** Расширенное описание, если сервер его прислал. */\n  readonly detail: string | undefined;\n  /** Заголовок ошибки, если сервер его прислал. */\n  readonly title: string | undefined;\n  /** Ошибки по полям. Пустой объект, если сервер их не прислал. */\n  readonly fieldErrors: ItdFieldErrors;\n  /** Идентификатор запроса из заголовков ответа. */\n  readonly requestId: string | undefined;\n  /** HTTP-метод запроса. */\n  readonly method: string;\n  /** Путь запроса без базового URL. */\n  readonly path: string;\n  /** Тело ответа как оно пришло. */\n  readonly raw: unknown;\n  /** Объект ответа. Тело уже прочитано и повторно прочитано быть не может. */\n  readonly response: Response | undefined;\n  /** Пауза из заголовка `Retry-After` в миллисекундах. Сервер итд.com его не присылает. */\n  readonly retryAfter: number | undefined;\n  /**\n   * Сколько запросов разрешено в окне — заголовок `x-ratelimit-limit`.\n   *\n   * Времени сброса окна сервер не сообщает, поэтому точный момент повтора неизвестен.\n   */\n  readonly rateLimit: number | undefined;\n  /** Сколько запросов осталось в окне — заголовок `x-ratelimit-remaining`. */\n  readonly rateLimitRemaining: number | undefined;\n\n  /**\n   * @param apiKind разновидность; подставляется подклассами, снаружи задавать не нужно\n   */\n  constructor(init: ItdApiErrorInit, apiKind: ItdApiErrorKind = ItdApiErrorKind.Generic) {\n    super(ItdErrorKind.Api, init.message);\n    this.name = 'ItdApiError';\n    this.apiKind = apiKind;\n    this.status = init.status;\n    this.code = init.code;\n    this.detail = init.detail;\n    this.title = init.title;\n    this.fieldErrors = init.fieldErrors ?? {};\n    this.requestId = init.requestId;\n    this.method = init.method;\n    this.path = init.path;\n    this.raw = init.raw;\n    this.response = init.response;\n    this.retryAfter = init.retryAfter;\n    this.rateLimit = init.rateLimit;\n    this.rateLimitRemaining = init.rateLimitRemaining;\n  }\n\n  /**\n   * Проверяет код ошибки. Удобнее, чем сравнивать строки вручную.\n   *\n   * @example\n   * ```ts\n   * if (err.hasCode('OTP_INVALID', 'MISSING_FLOW_TOKEN')) await restartOtpFlow();\n   * ```\n   */\n  hasCode(...codes: ItdErrorCode[]): boolean {\n    return codes.includes(this.code);\n  }\n\n  /** Имеет ли смысл повторить запрос: `429` и серверные ошибки `5xx`. */\n  get isRetryable(): boolean {\n    return this.status === 429 || this.status >= 500;\n  }\n}\n\n/** `400` / `422` — данные не прошли валидацию. Подробности в {@link ItdApiError.fieldErrors}. */\nexport class ItdValidationError extends ItdApiError {\n  constructor(init: ItdApiErrorInit) {\n    super(init, ItdApiErrorKind.Validation);\n    this.name = 'ItdValidationError';\n  }\n}\n\n/** `401` — токен отсутствует, истёк или отозван. */\nexport class ItdAuthError extends ItdApiError {\n  constructor(init: ItdApiErrorInit) {\n    super(init, ItdApiErrorKind.Auth);\n    this.name = 'ItdAuthError';\n  }\n}\n\n/** `403` — доступ запрещён либо действие ограничено настройками приватности. */\nexport class ItdForbiddenError extends ItdApiError {\n  constructor(init: ItdApiErrorInit) {\n    super(init, ItdApiErrorKind.Forbidden);\n    this.name = 'ItdForbiddenError';\n  }\n}\n\n/** `404` — сущность не найдена. */\nexport class ItdNotFoundError extends ItdApiError {\n  constructor(init: ItdApiErrorInit) {\n    super(init, ItdApiErrorKind.NotFound);\n    this.name = 'ItdNotFoundError';\n  }\n}\n\n/** `409` — сущность уже существует. */\nexport class ItdConflictError extends ItdApiError {\n  constructor(init: ItdApiErrorInit) {\n    super(init, ItdApiErrorKind.Conflict);\n    this.name = 'ItdConflictError';\n  }\n}\n\n/**\n * `429` — превышен лимит запросов.\n *\n * Если сервер прислал `Retry-After`, пауза доступна в {@link ItdApiError.retryAfter}\n * (в миллисекундах). При включённых ретраях библиотека выдерживает её автоматически.\n */\nexport class ItdRateLimitError extends ItdApiError {\n  constructor(init: ItdApiErrorInit) {\n    super(init, ItdApiErrorKind.RateLimit);\n    this.name = 'ItdRateLimitError';\n  }\n}\n\n/**\n * Действие требует подтверждённого телефона (`PHONE_VERIFICATION_REQUIRED`).\n *\n * Подтверждение проходит через Telegram-бота: ссылка лежит в {@link verificationUrl}.\n */\nexport class ItdPhoneVerificationError extends ItdApiError {\n  /** Ссылка на бота подтверждения, если удалось определить идентификатор пользователя. */\n  readonly verificationUrl: string | undefined;\n\n  constructor(init: ItdApiErrorInit & { userId?: string | undefined }) {\n    super(init, ItdApiErrorKind.PhoneVerification);\n    this.name = 'ItdPhoneVerificationError';\n    this.verificationUrl = init.userId\n      ? `https://t.me/itd_verification_bot?start=${encodeURIComponent(init.userId)}`\n      : undefined;\n  }\n}\n\n/** `5xx` — ошибка на стороне сервера. */\nexport class ItdServerError extends ItdApiError {\n  constructor(init: ItdApiErrorInit) {\n    super(init, ItdApiErrorKind.Server);\n    this.name = 'ItdServerError';\n  }\n}\n\n/** Причина ошибки получения вложения. */\nexport const ItdFileErrorReason = Object.freeze({\n  /** Сетевой сбой при получении источника. */\n  Network: 'network',\n  /** Источник ответил ошибочным HTTP-статусом. */\n  Http: 'http',\n  /** Источник превысил разрешённый размер. */\n  TooLarge: 'too_large',\n  /** Среда или источник не предоставили поток. */\n  StreamUnavailable: 'stream_unavailable',\n  /** Поток источника завершился ошибкой. */\n  Read: 'read',\n} as const);\nexport type ItdFileErrorReason = (typeof ItdFileErrorReason)[keyof typeof ItdFileErrorReason];\n\n/** Не удалось получить или прочитать содержимое вложения. */\nexport class ItdFileError extends ItdError {\n  readonly reason: ItdFileErrorReason;\n  /** Адрес источника, если файл получался по сети. */\n  readonly url: string | undefined;\n  /** HTTP-статус источника. */\n  readonly status: number | undefined;\n  /** Разрешённый размер в байтах. */\n  readonly limit: number | undefined;\n  /** Обнаруженный размер в байтах. */\n  readonly actual: number | undefined;\n  /** Имеет ли смысл повторить получение источника. */\n  readonly retryable: boolean;\n\n  constructor(\n    message: string,\n    init: {\n      reason: ItdFileErrorReason;\n      url?: string | undefined;\n      status?: number | undefined;\n      limit?: number | undefined;\n      actual?: number | undefined;\n      retryable?: boolean | undefined;\n      cause?: unknown;\n    },\n  ) {\n    super(ItdErrorKind.File, message, { cause: init.cause });\n    this.name = 'ItdFileError';\n    this.reason = init.reason;\n    this.url = init.url;\n    this.status = init.status;\n    this.limit = init.limit;\n    this.actual = init.actual;\n    this.retryable = init.retryable ?? false;\n  }\n}\n\n/** Запрос не дошёл до сервера: DNS, обрыв соединения, отсутствие сети. */\nexport class ItdNetworkError extends ItdError {\n  /** HTTP-метод запроса. */\n  readonly method: string;\n  /** Путь запроса без базового URL. */\n  readonly path: string;\n\n  constructor(message: string, init: { method: string; path: string; cause?: unknown }) {\n    super(ItdErrorKind.Network, message, { cause: init.cause });\n    this.name = 'ItdNetworkError';\n    this.method = init.method;\n    this.path = init.path;\n  }\n}\n\n/** Истёк таймаут запроса, заданный опцией `timeout`. */\nexport class ItdTimeoutError extends ItdError {\n  /** Значение таймаута в миллисекундах. */\n  readonly timeout: number;\n  /** HTTP-метод запроса. */\n  readonly method: string;\n  /** Путь запроса без базового URL. */\n  readonly path: string;\n\n  constructor(init: { timeout: number; method: string; path: string }) {\n    super(\n      ItdErrorKind.Timeout,\n      `Запрос ${init.method} ${init.path} превысил таймаут ${init.timeout} мс`,\n    );\n    this.name = 'ItdTimeoutError';\n    this.timeout = init.timeout;\n    this.method = init.method;\n    this.path = init.path;\n  }\n}\n\n/** Запрос отменён через переданный `AbortSignal`. */\nexport class ItdAbortError extends ItdError {\n  constructor(message = 'Запрос отменён', options?: { cause?: unknown }) {\n    super(ItdErrorKind.Abort, message, options);\n    this.name = 'ItdAbortError';\n  }\n}\n\n/**\n * Операция невозможна в текущем состоянии объекта.\n *\n * Например, клиент уже окончательно освобождён через `dispose()` и не может выполнять\n * новые запросы или создавать realtime-потоки.\n */\nexport class ItdStateError extends ItdError {\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(ItdErrorKind.State, message, options);\n    this.name = 'ItdStateError';\n  }\n}\n\n/**\n * Некорректная конфигурация или аргументы — обнаружено до обращения к сети.\n *\n * Этим же классом сообщают о нарушенных инвариантах билдеры: например, опрос\n * с одним вариантом ответа.\n */\nexport class ItdConfigError extends ItdError {\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(ItdErrorKind.Config, message, options);\n    this.name = 'ItdConfigError';\n  }\n}\n\n/** Любая ошибка, порождённая этой библиотекой. */\nexport function isItdError(value: unknown): value is ItdError {\n  return typeof value === 'object' && value !== null && ITD_ERROR in value;\n}\n\n/** Ошибка, пришедшая от сервера итд.com (статус ≥ 400). */\nexport function isItdApiError(value: unknown): value is ItdApiError {\n  return isItdError(value) && value.kind === ItdErrorKind.Api;\n}\n\n/** Ошибка получения или чтения вложения. */\nexport function isItdFileError(value: unknown): value is ItdFileError {\n  return isItdError(value) && value.kind === ItdErrorKind.File;\n}\n\n/** Операция невозможна в текущем состоянии объекта. */\nexport function isItdStateError(value: unknown): value is ItdStateError {\n  return isItdError(value) && value.kind === ItdErrorKind.State;\n}\n\n/**\n * Проверяет разновидность ошибки API.\n *\n * Намеренно не `instanceof`: две копии пакета в дереве зависимостей или смешение сборок\n * ESM и CJS дают разные классы для одной и той же ошибки, и проверка по классу молча\n * перестаёт срабатывать. Поле {@link ItdApiError.apiKind} от этого не зависит.\n */\nfunction hasApiKind(value: unknown, kind: ItdApiErrorKind): boolean {\n  return isItdApiError(value) && value.apiKind === kind;\n}\n\n/** Ошибка валидации: `VALIDATION_ERROR` либо статус `400`/`422`. */\nexport function isItdValidationError(value: unknown): value is ItdValidationError {\n  return hasApiKind(value, ItdApiErrorKind.Validation);\n}\n\n/** Ошибка авторизации: истёкший или отозванный токен. */\nexport function isItdAuthError(value: unknown): value is ItdAuthError {\n  return hasApiKind(value, ItdApiErrorKind.Auth);\n}\n\n/** Доступ запрещён либо действие ограничено настройками приватности. */\nexport function isItdForbiddenError(value: unknown): value is ItdForbiddenError {\n  return hasApiKind(value, ItdApiErrorKind.Forbidden);\n}\n\n/** Сущность не найдена. */\nexport function isItdNotFoundError(value: unknown): value is ItdNotFoundError {\n  return hasApiKind(value, ItdApiErrorKind.NotFound);\n}\n\n/** Сущность уже существует. */\nexport function isItdConflictError(value: unknown): value is ItdConflictError {\n  return hasApiKind(value, ItdApiErrorKind.Conflict);\n}\n\n/** Превышен лимит запросов. */\nexport function isItdRateLimitError(value: unknown): value is ItdRateLimitError {\n  return hasApiKind(value, ItdApiErrorKind.RateLimit);\n}\n\n/** Действие требует подтверждённого телефона. Ссылка — в `verificationUrl`. */\nexport function isItdPhoneVerificationError(value: unknown): value is ItdPhoneVerificationError {\n  return hasApiKind(value, ItdApiErrorKind.PhoneVerification);\n}\n\n/** Ошибка на стороне сервера (`5xx`). */\nexport function isItdServerError(value: unknown): value is ItdServerError {\n  return hasApiKind(value, ItdApiErrorKind.Server);\n}\n"],"mappings":"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"}
+{"version":3,"file":"errors-BmP3TKoW.cjs","names":[],"sources":["../../src/core/errors.ts"],"sourcesContent":["import type { ItdErrorCode } from '../types/enums.js';\n\n/** Бренд, по которому ошибки библиотеки распознаются надёжнее, чем через `instanceof`. */\nconst ITD_ERROR = Symbol.for('itd.error');\n\n/**\n * Категория ошибки. Определяет, какие поля у неё есть.\n *\n * Значение, а не только тип: категорию нужно с чем-то сравнивать в рантайме.\n */\nexport const ItdErrorKind = Object.freeze({\n  /** Сервер ответил статусом ≥ 400. */\n  Api: 'api',\n  /** Запрос не дошёл до сервера. */\n  Network: 'network',\n  /** Истёк таймаут запроса. */\n  Timeout: 'timeout',\n  /** Запрос отменён через `AbortSignal`. */\n  Abort: 'abort',\n  /** Операция невозможна в текущем состоянии объекта. */\n  State: 'state',\n  /** Не удалось получить или подготовить содержимое вложения. */\n  File: 'file',\n  /** Некорректная конфигурация или аргументы — обнаружено до обращения к сети. */\n  Config: 'config',\n} as const);\nexport type ItdErrorKind = (typeof ItdErrorKind)[keyof typeof ItdErrorKind];\n\n/**\n * Разновидность ошибки API — то же, что класс ошибки, но в виде данных.\n *\n * Существует потому, что `instanceof` подводит, когда в дереве зависимостей оказались\n * две копии пакета или смешаны сборки ESM и CJS: классы тогда разные, хотя ошибка та же.\n * Проверки {@link isItdValidationError} и соседние опираются на это поле, а не на класс.\n */\nexport const ItdApiErrorKind = Object.freeze({\n  /** Ни одна из специализаций не подошла. */\n  Generic: 'generic',\n  Validation: 'validation',\n  Auth: 'auth',\n  Forbidden: 'forbidden',\n  NotFound: 'not_found',\n  Conflict: 'conflict',\n  RateLimit: 'rate_limit',\n  PhoneVerification: 'phone_verification',\n  Server: 'server',\n} as const);\nexport type ItdApiErrorKind = (typeof ItdApiErrorKind)[keyof typeof ItdApiErrorKind];\n\n/** Ошибки по полям формы: `{ email: ['уже занят'] }`. */\nexport type ItdFieldErrors = Record<string, string[]>;\n\n/**\n * Базовый класс всех ошибок библиотеки.\n *\n * Ловить его имеет смысл, чтобы отделить проблемы обращения к итд.com от прочих исключений.\n * Для разбора конкретной причины используйте {@link isItdApiError} и поле {@link ItdApiError.code}.\n *\n * @example\n * ```ts\n * try {\n *   await itd.posts.like(id);\n * } catch (e) {\n *   if (isItdError(e)) console.error('итд.com:', e.message);\n *   else throw e;\n * }\n * ```\n */\nexport class ItdError extends Error {\n  /** @internal */\n  readonly [ITD_ERROR] = true as const;\n\n  /** Категория ошибки. */\n  readonly kind: ItdErrorKind;\n\n  constructor(kind: ItdErrorKind, message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.kind = kind;\n    this.name = 'ItdError';\n  }\n}\n\n/** Параметры конструктора {@link ItdApiError}. */\nexport interface ItdApiErrorInit {\n  /** HTTP-статус ответа. */\n  status: number;\n  /** Строковый код ошибки из тела ответа. */\n  code: ItdErrorCode;\n  /** Человекочитаемое сообщение. */\n  message: string;\n  /** Расширенное описание, если сервер его прислал. */\n  detail?: string | undefined;\n  /** Заголовок ошибки, если сервер его прислал. */\n  title?: string | undefined;\n  /** Ошибки по конкретным полям (сведены из `errors` и `violations`). */\n  fieldErrors?: ItdFieldErrors | undefined;\n  /** Идентификатор запроса из заголовков ответа, если есть. */\n  requestId?: string | undefined;\n  /** HTTP-метод запроса. */\n  method: string;\n  /** Путь запроса без базового URL. */\n  path: string;\n  /** Тело ответа как оно пришло — на случай, если документация разошлась с реальностью. */\n  raw: unknown;\n  /** Сам объект ответа. Тело уже прочитано. */\n  response?: Response | undefined;\n  /** Значение `Retry-After` в миллисекундах, если заголовок был. */\n  retryAfter?: number | undefined;\n  /** Сколько запросов разрешено в окне (`x-ratelimit-limit`). */\n  rateLimit?: number | undefined;\n  /** Сколько запросов осталось в окне (`x-ratelimit-remaining`). */\n  rateLimitRemaining?: number | undefined;\n}\n\n/**\n * Ошибка, возвращённая сервером итд.com (HTTP-статус ≥ 400).\n *\n * API отдаёт ошибки в двух разных формах — `{ error: { … } }` и `{ code, message, violations }`.\n * Библиотека сводит обе к этому классу, поэтому разбирать форму ответа вручную не нужно.\n *\n * @example\n * ```ts\n * try {\n *   await itd.users.updateMe({ username: 'занятое_имя' });\n * } catch (e) {\n *   if (e instanceof ItdValidationError) {\n *     console.log(e.fieldErrors.username); // ['Имя уже занято']\n *   }\n * }\n * ```\n */\nexport class ItdApiError extends ItdError {\n  /**\n   * Разновидность ошибки: та же информация, что и класс, но пригодная для сравнения.\n   *\n   * Позволяет разбирать ошибку через `switch`, а проверкам вроде {@link isItdAuthError} —\n   * работать даже когда в проекте оказались две копии библиотеки.\n   */\n  readonly apiKind: ItdApiErrorKind;\n  /** HTTP-статус ответа. */\n  readonly status: number;\n  /** Строковый код ошибки, например `VALIDATION_ERROR`. */\n  readonly code: ItdErrorCode;\n  /** Расширенное описание, если сервер его прислал. */\n  readonly detail: string | undefined;\n  /** Заголовок ошибки, если сервер его прислал. */\n  readonly title: string | undefined;\n  /** Ошибки по полям. Пустой объект, если сервер их не прислал. */\n  readonly fieldErrors: ItdFieldErrors;\n  /** Идентификатор запроса из заголовков ответа. */\n  readonly requestId: string | undefined;\n  /** HTTP-метод запроса. */\n  readonly method: string;\n  /** Путь запроса без базового URL. */\n  readonly path: string;\n  /** Тело ответа как оно пришло. */\n  readonly raw: unknown;\n  /** Объект ответа. Тело уже прочитано и повторно прочитано быть не может. */\n  readonly response: Response | undefined;\n  /** Пауза из заголовка `Retry-After` в миллисекундах. Сервер итд.com его не присылает. */\n  readonly retryAfter: number | undefined;\n  /**\n   * Сколько запросов разрешено в окне — заголовок `x-ratelimit-limit`.\n   *\n   * Времени сброса окна сервер не сообщает, поэтому точный момент повтора неизвестен.\n   */\n  readonly rateLimit: number | undefined;\n  /** Сколько запросов осталось в окне — заголовок `x-ratelimit-remaining`. */\n  readonly rateLimitRemaining: number | undefined;\n\n  /**\n   * @param apiKind разновидность; подставляется подклассами, снаружи задавать не нужно\n   */\n  constructor(init: ItdApiErrorInit, apiKind: ItdApiErrorKind = ItdApiErrorKind.Generic) {\n    super(ItdErrorKind.Api, init.message);\n    this.name = 'ItdApiError';\n    this.apiKind = apiKind;\n    this.status = init.status;\n    this.code = init.code;\n    this.detail = init.detail;\n    this.title = init.title;\n    this.fieldErrors = init.fieldErrors ?? {};\n    this.requestId = init.requestId;\n    this.method = init.method;\n    this.path = init.path;\n    this.raw = init.raw;\n    this.response = init.response;\n    this.retryAfter = init.retryAfter;\n    this.rateLimit = init.rateLimit;\n    this.rateLimitRemaining = init.rateLimitRemaining;\n  }\n\n  /**\n   * Проверяет код ошибки. Удобнее, чем сравнивать строки вручную.\n   *\n   * @example\n   * ```ts\n   * if (err.hasCode('OTP_INVALID', 'MISSING_FLOW_TOKEN')) await restartOtpFlow();\n   * ```\n   */\n  hasCode(...codes: ItdErrorCode[]): boolean {\n    return codes.includes(this.code);\n  }\n\n  /** Имеет ли смысл повторить запрос: `429` и серверные ошибки `5xx`. */\n  get isRetryable(): boolean {\n    return this.status === 429 || this.status >= 500;\n  }\n}\n\n/** `400` / `422` — данные не прошли валидацию. Подробности в {@link ItdApiError.fieldErrors}. */\nexport class ItdValidationError extends ItdApiError {\n  constructor(init: ItdApiErrorInit) {\n    super(init, ItdApiErrorKind.Validation);\n    this.name = 'ItdValidationError';\n  }\n}\n\n/** `401` — токен отсутствует, истёк или отозван. */\nexport class ItdAuthError extends ItdApiError {\n  constructor(init: ItdApiErrorInit) {\n    super(init, ItdApiErrorKind.Auth);\n    this.name = 'ItdAuthError';\n  }\n}\n\n/** `403` — доступ запрещён либо действие ограничено настройками приватности. */\nexport class ItdForbiddenError extends ItdApiError {\n  constructor(init: ItdApiErrorInit) {\n    super(init, ItdApiErrorKind.Forbidden);\n    this.name = 'ItdForbiddenError';\n  }\n}\n\n/** `404` — сущность не найдена. */\nexport class ItdNotFoundError extends ItdApiError {\n  constructor(init: ItdApiErrorInit) {\n    super(init, ItdApiErrorKind.NotFound);\n    this.name = 'ItdNotFoundError';\n  }\n}\n\n/** `409` — сущность уже существует. */\nexport class ItdConflictError extends ItdApiError {\n  constructor(init: ItdApiErrorInit) {\n    super(init, ItdApiErrorKind.Conflict);\n    this.name = 'ItdConflictError';\n  }\n}\n\n/**\n * `429` — превышен лимит запросов.\n *\n * Если сервер прислал `Retry-After`, пауза доступна в {@link ItdApiError.retryAfter}\n * (в миллисекундах). При включённых ретраях библиотека выдерживает её автоматически.\n */\nexport class ItdRateLimitError extends ItdApiError {\n  constructor(init: ItdApiErrorInit) {\n    super(init, ItdApiErrorKind.RateLimit);\n    this.name = 'ItdRateLimitError';\n  }\n}\n\n/**\n * Действие требует подтверждённого телефона (`PHONE_VERIFICATION_REQUIRED`).\n *\n * Подтверждение проходит через Telegram-бота: ссылка лежит в {@link verificationUrl}.\n */\nexport class ItdPhoneVerificationError extends ItdApiError {\n  /** Ссылка на бота подтверждения, если удалось определить идентификатор пользователя. */\n  readonly verificationUrl: string | undefined;\n\n  constructor(init: ItdApiErrorInit & { userId?: string | undefined }) {\n    super(init, ItdApiErrorKind.PhoneVerification);\n    this.name = 'ItdPhoneVerificationError';\n    this.verificationUrl = init.userId\n      ? `https://t.me/itd_verification_bot?start=${encodeURIComponent(init.userId)}`\n      : undefined;\n  }\n}\n\n/** `5xx` — ошибка на стороне сервера. */\nexport class ItdServerError extends ItdApiError {\n  constructor(init: ItdApiErrorInit) {\n    super(init, ItdApiErrorKind.Server);\n    this.name = 'ItdServerError';\n  }\n}\n\n/** Причина ошибки получения вложения. */\nexport const ItdFileErrorReason = Object.freeze({\n  /** Сетевой сбой при получении источника. */\n  Network: 'network',\n  /** Источник ответил ошибочным HTTP-статусом. */\n  Http: 'http',\n  /** Источник превысил разрешённый размер. */\n  TooLarge: 'too_large',\n  /** Среда или источник не предоставили поток. */\n  StreamUnavailable: 'stream_unavailable',\n  /** Поток источника завершился ошибкой. */\n  Read: 'read',\n} as const);\nexport type ItdFileErrorReason = (typeof ItdFileErrorReason)[keyof typeof ItdFileErrorReason];\n\n/** Не удалось получить или прочитать содержимое вложения. */\nexport class ItdFileError extends ItdError {\n  readonly reason: ItdFileErrorReason;\n  /** Адрес источника без секретных параметров запроса, если файл получался по сети. */\n  readonly url: string | undefined;\n  /** HTTP-статус источника. */\n  readonly status: number | undefined;\n  /** Разрешённый размер в байтах. */\n  readonly limit: number | undefined;\n  /** Обнаруженный размер в байтах. */\n  readonly actual: number | undefined;\n  /** Имеет ли смысл повторить получение источника. */\n  readonly retryable: boolean;\n\n  constructor(\n    message: string,\n    init: {\n      reason: ItdFileErrorReason;\n      url?: string | undefined;\n      status?: number | undefined;\n      limit?: number | undefined;\n      actual?: number | undefined;\n      retryable?: boolean | undefined;\n      cause?: unknown;\n    },\n  ) {\n    super(ItdErrorKind.File, message, { cause: init.cause });\n    this.name = 'ItdFileError';\n    this.reason = init.reason;\n    this.url = init.url;\n    this.status = init.status;\n    this.limit = init.limit;\n    this.actual = init.actual;\n    this.retryable = init.retryable ?? false;\n  }\n}\n\n/** Запрос не дошёл до сервера: DNS, обрыв соединения, отсутствие сети. */\nexport class ItdNetworkError extends ItdError {\n  /** HTTP-метод запроса. */\n  readonly method: string;\n  /** Путь запроса без базового URL. */\n  readonly path: string;\n\n  constructor(message: string, init: { method: string; path: string; cause?: unknown }) {\n    super(ItdErrorKind.Network, message, { cause: init.cause });\n    this.name = 'ItdNetworkError';\n    this.method = init.method;\n    this.path = init.path;\n  }\n}\n\n/** Истёк таймаут запроса, заданный опцией `timeout`. */\nexport class ItdTimeoutError extends ItdError {\n  /** Значение таймаута в миллисекундах. */\n  readonly timeout: number;\n  /** HTTP-метод запроса. */\n  readonly method: string;\n  /** Путь запроса без базового URL. */\n  readonly path: string;\n\n  constructor(init: { timeout: number; method: string; path: string }) {\n    super(\n      ItdErrorKind.Timeout,\n      `Запрос ${init.method} ${init.path} превысил таймаут ${init.timeout} мс`,\n    );\n    this.name = 'ItdTimeoutError';\n    this.timeout = init.timeout;\n    this.method = init.method;\n    this.path = init.path;\n  }\n}\n\n/** Запрос отменён через переданный `AbortSignal`. */\nexport class ItdAbortError extends ItdError {\n  constructor(message = 'Запрос отменён', options?: { cause?: unknown }) {\n    super(ItdErrorKind.Abort, message, options);\n    this.name = 'ItdAbortError';\n  }\n}\n\n/**\n * Операция невозможна в текущем состоянии объекта.\n *\n * Например, клиент уже окончательно освобождён через `dispose()` и не может выполнять\n * новые запросы или создавать событийные соединения.\n */\nexport class ItdStateError extends ItdError {\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(ItdErrorKind.State, message, options);\n    this.name = 'ItdStateError';\n  }\n}\n\n/**\n * Некорректная конфигурация или аргументы — обнаружено до обращения к сети.\n *\n * Этим же классом сообщают о нарушенных инвариантах билдеры: например, опрос\n * с одним вариантом ответа.\n */\nexport class ItdConfigError extends ItdError {\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(ItdErrorKind.Config, message, options);\n    this.name = 'ItdConfigError';\n  }\n}\n\n/** Любая ошибка, порождённая этой библиотекой. */\nexport function isItdError(value: unknown): value is ItdError {\n  return typeof value === 'object' && value !== null && ITD_ERROR in value;\n}\n\n/** Ошибка, пришедшая от сервера итд.com (статус ≥ 400). */\nexport function isItdApiError(value: unknown): value is ItdApiError {\n  return isItdError(value) && value.kind === ItdErrorKind.Api;\n}\n\n/** Ошибка получения или чтения вложения. */\nexport function isItdFileError(value: unknown): value is ItdFileError {\n  return isItdError(value) && value.kind === ItdErrorKind.File;\n}\n\n/** Операция невозможна в текущем состоянии объекта. */\nexport function isItdStateError(value: unknown): value is ItdStateError {\n  return isItdError(value) && value.kind === ItdErrorKind.State;\n}\n\n/**\n * Проверяет разновидность ошибки API.\n *\n * Намеренно не `instanceof`: две копии пакета в дереве зависимостей или смешение сборок\n * ESM и CJS дают разные классы для одной и той же ошибки, и проверка по классу молча\n * перестаёт срабатывать. Поле {@link ItdApiError.apiKind} от этого не зависит.\n */\nfunction hasApiKind(value: unknown, kind: ItdApiErrorKind): boolean {\n  return isItdApiError(value) && value.apiKind === kind;\n}\n\n/** Ошибка валидации: `VALIDATION_ERROR` либо статус `400`/`422`. */\nexport function isItdValidationError(value: unknown): value is ItdValidationError {\n  return hasApiKind(value, ItdApiErrorKind.Validation);\n}\n\n/** Ошибка авторизации: истёкший или отозванный токен. */\nexport function isItdAuthError(value: unknown): value is ItdAuthError {\n  return hasApiKind(value, ItdApiErrorKind.Auth);\n}\n\n/** Доступ запрещён либо действие ограничено настройками приватности. */\nexport function isItdForbiddenError(value: unknown): value is ItdForbiddenError {\n  return hasApiKind(value, ItdApiErrorKind.Forbidden);\n}\n\n/** Сущность не найдена. */\nexport function isItdNotFoundError(value: unknown): value is ItdNotFoundError {\n  return hasApiKind(value, ItdApiErrorKind.NotFound);\n}\n\n/** Сущность уже существует. */\nexport function isItdConflictError(value: unknown): value is ItdConflictError {\n  return hasApiKind(value, ItdApiErrorKind.Conflict);\n}\n\n/** Превышен лимит запросов. */\nexport function isItdRateLimitError(value: unknown): value is ItdRateLimitError {\n  return hasApiKind(value, ItdApiErrorKind.RateLimit);\n}\n\n/** Действие требует подтверждённого телефона. Ссылка — в `verificationUrl`. */\nexport function isItdPhoneVerificationError(value: unknown): value is ItdPhoneVerificationError {\n  return hasApiKind(value, ItdApiErrorKind.PhoneVerification);\n}\n\n/** Ошибка на стороне сервера (`5xx`). */\nexport function isItdServerError(value: unknown): value is ItdServerError {\n  return hasApiKind(value, ItdApiErrorKind.Server);\n}\n"],"mappings":"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"}

package/dist/shared/{errors-Bhrd2fJd.js → errors-GI10kZxk.js}

@@ -244,7 +244,7 @@ const ItdFileErrorReason = Object.freeze({
 /** Не удалось получить или прочитать содержимое вложения. */
 var ItdFileError = class extends ItdError {
 	reason;
-	/** Адрес источника, если файл получался по сети. */
+	/** Адрес источника без секретных параметров запроса, если файл получался по сети. */
 	url;
 	/** HTTP-статус источника. */
 	status;
@@ -305,7 +305,7 @@ var ItdAbortError = class extends ItdError {
 * Операция невозможна в текущем состоянии объекта.
 *
 * Например, клиент уже окончательно освобождён через `dispose()` и не может выполнять
-* новые запросы или создавать realtime-потоки.
+* новые запросы или создавать событийные соединения.
 */
 var ItdStateError = class extends ItdError {
 	constructor(message, options) {
@@ -386,4 +386,4 @@ function isItdServerError(value) {
 //#endregion
 export { isItdStateError as A, isItdError as C, isItdPhoneVerificationError as D, isItdNotFoundError as E, isItdRateLimitError as O, isItdConflictError as S, isItdForbiddenError as T, ItdStateError as _, ItdConfigError as a, isItdApiError as b, ItdErrorKind as c, ItdForbiddenError as d, ItdNetworkError as f, ItdServerError as g, ItdRateLimitError as h, ItdAuthError as i, isItdValidationError as j, isItdServerError as k, ItdFileError as l, ItdPhoneVerificationError as m, ItdApiError as n, ItdConflictError as o, ItdNotFoundError as p, ItdApiErrorKind as r, ItdError as s, ItdAbortError as t, ItdFileErrorReason as u, ItdTimeoutError as v, isItdFileError as w, isItdAuthError as x, ItdValidationError as y };
 
-//# sourceMappingURL=errors-Bhrd2fJd.js.map
+//# sourceMappingURL=errors-GI10kZxk.js.map