itd-api 0.8.0 → 0.9.0

package/dist/shared/{url-Be9jlWRv.d.ts → url-XBsMdAcv.d.cts}

@@ -312,6 +312,7 @@ declare const ItdErrorCode: Readonly<{
   readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
   readonly MISSING_FLOW_TOKEN: "MISSING_FLOW_TOKEN";
   readonly PROFILE_USERNAME_TAKEN: "PROFILE_USERNAME_TAKEN";
+  readonly PROFILE_USERNAME_RESERVED: "PROFILE_USERNAME_RESERVED";
   readonly PROFILE_RESTRICTION_ACTIVE: "PROFILE_RESTRICTION_ACTIVE";
   readonly PROFILE_MODIFICATION_RESTRICTED: "PROFILE_MODIFICATION_RESTRICTED";
   readonly CONTENT_MODERATION_FAILED: "CONTENT_MODERATION_FAILED";
@@ -403,6 +404,15 @@ declare const BUCKET_LIMITS: Readonly<{
   readonly 'users.updateMe': 3;
   readonly 'reports.create': 3;
   readonly 'verification.submit': 3;
+  readonly shop: 150;
+  readonly 'shop.delivery.cities': 60;
+  readonly 'shop.delivery.calculate': 45;
+  readonly 'shop.delivery.points': 30;
+  readonly 'shop.consents.record': 15;
+  readonly 'shop.orders.pay': 13;
+  readonly 'shop.orders.verifyAccessCode': 13;
+  readonly 'shop.orders.create': 12;
+  readonly 'shop.orders.requestAccessCode': 4;
 }>;
 /** Имя встроенного бакета. */
 type RateLimitBucket = keyof typeof BUCKET_LIMITS;
@@ -845,6 +855,69 @@ declare const OPERATIONS: Readonly<{
     readonly method: "POST";
     readonly retrySafety: "unsafe";
   }>;
+  readonly 'shop.products.list': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "shop";
+  }>;
+  readonly 'shop.products.get': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "shop";
+  }>;
+  readonly 'shop.delivery.countries': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "shop";
+  }>;
+  readonly 'shop.delivery.cities': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "shop.delivery.cities";
+  }>;
+  readonly 'shop.delivery.points': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "shop.delivery.points";
+  }>;
+  readonly 'shop.delivery.calculate': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "safe";
+    readonly bucket: "shop.delivery.calculate";
+  }>;
+  readonly 'shop.orders.create': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "idempotent";
+    readonly bucket: "shop.orders.create";
+  }>;
+  readonly 'shop.orders.list': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'shop.orders.get': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'shop.orders.pay': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "shop.orders.pay";
+  }>;
+  readonly 'shop.orders.requestAccessCode': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "shop.orders.requestAccessCode";
+  }>;
+  readonly 'shop.orders.verifyAccessCode': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "shop.orders.verifyAccessCode";
+  }>;
+  readonly 'shop.consents.record': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "shop.consents.record";
+  }>;
 }>;
 /** Стабильный ID встроенной операции. */
 type BuiltInOperationId = keyof typeof OPERATIONS;
@@ -1289,7 +1362,7 @@ interface OperationDefinition extends OperationMetadata {
 //#endregion
 //#region src/core/version.d.ts
 /** Версия библиотеки. Попадает в `User-Agent`. */
-declare const LIBRARY_VERSION = "0.8.0";
+declare const LIBRARY_VERSION = "0.9.0";
 //#endregion
 //#region src/core/config.d.ts
 /** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
@@ -2118,4 +2191,4 @@ declare function isKnownNotificationType(type: string): boolean;
 declare function resolveNotificationUrl(notification: Notification): string;
 //#endregion
 export { isItdValidationError as $, RateLimitBucket as $t, ItdFieldErrors as A, ResponseContext as At, ItdTimeoutError as B, ItdClock as Bt, ItdApiErrorInit as C, RateLimitBucketContext as Ct, ItdConflictError as D, RequestContext as Dt, ItdConfigError as E, RawRequestOptions as Et, ItdNotFoundError as F, QueryParams as Ft, isItdError as G, OPERATIONS as Gt, isItdApiError as H, BuiltInOperationId as Ht, ItdPhoneVerificationError as I, QueryValue as It, isItdNotFoundError as J, operationBucket as Jt, isItdFileError as K, OperationId as Kt, ItdRateLimitError as L, ServiceDefinition as Lt, ItdFileErrorReason as M, RetryDecisionContext as Mt, ItdForbiddenError as N, RetryOptions as Nt, ItdError as O, RequestExtensions as Ot, ItdNetworkError as P, RuntimeOptions as Pt, isItdStateError as Q, DEFAULT_RATE_LIMIT_BUCKET as Qt, ItdServerError as R, RateLimitPacing as Rt, ItdApiError as S, PaginationOptions as St, ItdAuthError as T, RateLimitOptions as Tt, isItdAuthError as U, CustomOperationId as Ut, ItdValidationError as V, systemClock as Vt, isItdConflictError as W, ItdOperationDefinition as Wt, isItdRateLimitError as X, operationRetrySafety as Xt, isItdPhoneVerificationError as Y, operationMethod as Yt, isItdServerError as Z, BUCKET_LIMITS as Zt, Profile as _, ServiceState as _n, RetrySafety as _t, NotificationEvent as a, AttachmentType as an, tokenProvider as at, UserSummary as b, ViewSource as bn, Logger as bt, NotificationSettings as c, FeedTab as cn, Unsubscribe as ct, Author as d, ItdErrorCode as dn, LIBRARY_VERSION as dt, IsoDate as en, ClientConnection as et, FollowResult as f, LikesVisibility as fn, FeatureOperationId as ft, PrivacySettings as g, ReportTargetType as gn, OperationMethod as gt, PinsResult as h, ReportReason as hn, OperationMetadata as ht, formatNotificationText as i, AccessType as in, bearerToken as it, ItdFileError as j, RetryContext as jt, ItdErrorKind as k, RequestOptions as kt, Actor as l, IncidentKind as ln, DEFAULT_BASE_URL as lt, Pin as m, NotificationType as mn, OperationContract as mt, canonicalNotificationType as n, UserId as nn, AuthProvider as nt, normalizeNotification as o, CommentSort as on, Emitter as ot, MyProfile as p, Loose as pn, OperationAnnotations as pt, isItdForbiddenError as q, isBuiltInOperationId as qt, isKnownNotificationType as r, UserRef as rn, anonymousAuth as rt, Notification as s, EventChannelStatus as sn, Listener as st, resolveNotificationUrl as t, Span as tn, AuthIdentity as tt, AuthState as u, InteractionType as un, STATUS_SERVICE as ut, PublicProfile as v, SpanType as vn, ClientHooks as vt, ItdApiErrorKind as w, RateLimitBucketOverride as wt, ItdAbortError as x, WallAccess as xn, OperationRequestOptions as xt, SubscriptionState as y, ViewReason as yn, ErrorContextHook as yt, ItdStateError as z, RuntimeMode as zt };
-//# sourceMappingURL=url-Be9jlWRv.d.ts.map
+//# sourceMappingURL=url-XBsMdAcv.d.cts.map

package/dist/shared/{url-Be9jlWRv.d.cts → url-XBsMdAcv.d.ts}

@@ -312,6 +312,7 @@ declare const ItdErrorCode: Readonly<{
   readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
   readonly MISSING_FLOW_TOKEN: "MISSING_FLOW_TOKEN";
   readonly PROFILE_USERNAME_TAKEN: "PROFILE_USERNAME_TAKEN";
+  readonly PROFILE_USERNAME_RESERVED: "PROFILE_USERNAME_RESERVED";
   readonly PROFILE_RESTRICTION_ACTIVE: "PROFILE_RESTRICTION_ACTIVE";
   readonly PROFILE_MODIFICATION_RESTRICTED: "PROFILE_MODIFICATION_RESTRICTED";
   readonly CONTENT_MODERATION_FAILED: "CONTENT_MODERATION_FAILED";
@@ -403,6 +404,15 @@ declare const BUCKET_LIMITS: Readonly<{
   readonly 'users.updateMe': 3;
   readonly 'reports.create': 3;
   readonly 'verification.submit': 3;
+  readonly shop: 150;
+  readonly 'shop.delivery.cities': 60;
+  readonly 'shop.delivery.calculate': 45;
+  readonly 'shop.delivery.points': 30;
+  readonly 'shop.consents.record': 15;
+  readonly 'shop.orders.pay': 13;
+  readonly 'shop.orders.verifyAccessCode': 13;
+  readonly 'shop.orders.create': 12;
+  readonly 'shop.orders.requestAccessCode': 4;
 }>;
 /** Имя встроенного бакета. */
 type RateLimitBucket = keyof typeof BUCKET_LIMITS;
@@ -845,6 +855,69 @@ declare const OPERATIONS: Readonly<{
     readonly method: "POST";
     readonly retrySafety: "unsafe";
   }>;
+  readonly 'shop.products.list': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "shop";
+  }>;
+  readonly 'shop.products.get': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "shop";
+  }>;
+  readonly 'shop.delivery.countries': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "shop";
+  }>;
+  readonly 'shop.delivery.cities': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "shop.delivery.cities";
+  }>;
+  readonly 'shop.delivery.points': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+    readonly bucket: "shop.delivery.points";
+  }>;
+  readonly 'shop.delivery.calculate': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "safe";
+    readonly bucket: "shop.delivery.calculate";
+  }>;
+  readonly 'shop.orders.create': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "idempotent";
+    readonly bucket: "shop.orders.create";
+  }>;
+  readonly 'shop.orders.list': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'shop.orders.get': Readonly<{
+    readonly method: "GET";
+    readonly retrySafety: "safe";
+  }>;
+  readonly 'shop.orders.pay': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "shop.orders.pay";
+  }>;
+  readonly 'shop.orders.requestAccessCode': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "shop.orders.requestAccessCode";
+  }>;
+  readonly 'shop.orders.verifyAccessCode': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "shop.orders.verifyAccessCode";
+  }>;
+  readonly 'shop.consents.record': Readonly<{
+    readonly method: "POST";
+    readonly retrySafety: "unsafe";
+    readonly bucket: "shop.consents.record";
+  }>;
 }>;
 /** Стабильный ID встроенной операции. */
 type BuiltInOperationId = keyof typeof OPERATIONS;
@@ -1289,7 +1362,7 @@ interface OperationDefinition extends OperationMetadata {
 //#endregion
 //#region src/core/version.d.ts
 /** Версия библиотеки. Попадает в `User-Agent`. */
-declare const LIBRARY_VERSION = "0.8.0";
+declare const LIBRARY_VERSION = "0.9.0";
 //#endregion
 //#region src/core/config.d.ts
 /** Базовый URL API итд.com. Домен записан в punycode: `итд.com`. */
@@ -2118,4 +2191,4 @@ declare function isKnownNotificationType(type: string): boolean;
 declare function resolveNotificationUrl(notification: Notification): string;
 //#endregion
 export { isItdValidationError as $, RateLimitBucket as $t, ItdFieldErrors as A, ResponseContext as At, ItdTimeoutError as B, ItdClock as Bt, ItdApiErrorInit as C, RateLimitBucketContext as Ct, ItdConflictError as D, RequestContext as Dt, ItdConfigError as E, RawRequestOptions as Et, ItdNotFoundError as F, QueryParams as Ft, isItdError as G, OPERATIONS as Gt, isItdApiError as H, BuiltInOperationId as Ht, ItdPhoneVerificationError as I, QueryValue as It, isItdNotFoundError as J, operationBucket as Jt, isItdFileError as K, OperationId as Kt, ItdRateLimitError as L, ServiceDefinition as Lt, ItdFileErrorReason as M, RetryDecisionContext as Mt, ItdForbiddenError as N, RetryOptions as Nt, ItdError as O, RequestExtensions as Ot, ItdNetworkError as P, RuntimeOptions as Pt, isItdStateError as Q, DEFAULT_RATE_LIMIT_BUCKET as Qt, ItdServerError as R, RateLimitPacing as Rt, ItdApiError as S, PaginationOptions as St, ItdAuthError as T, RateLimitOptions as Tt, isItdAuthError as U, CustomOperationId as Ut, ItdValidationError as V, systemClock as Vt, isItdConflictError as W, ItdOperationDefinition as Wt, isItdRateLimitError as X, operationRetrySafety as Xt, isItdPhoneVerificationError as Y, operationMethod as Yt, isItdServerError as Z, BUCKET_LIMITS as Zt, Profile as _, ServiceState as _n, RetrySafety as _t, NotificationEvent as a, AttachmentType as an, tokenProvider as at, UserSummary as b, ViewSource as bn, Logger as bt, NotificationSettings as c, FeedTab as cn, Unsubscribe as ct, Author as d, ItdErrorCode as dn, LIBRARY_VERSION as dt, IsoDate as en, ClientConnection as et, FollowResult as f, LikesVisibility as fn, FeatureOperationId as ft, PrivacySettings as g, ReportTargetType as gn, OperationMethod as gt, PinsResult as h, ReportReason as hn, OperationMetadata as ht, formatNotificationText as i, AccessType as in, bearerToken as it, ItdFileError as j, RetryContext as jt, ItdErrorKind as k, RequestOptions as kt, Actor as l, IncidentKind as ln, DEFAULT_BASE_URL as lt, Pin as m, NotificationType as mn, OperationContract as mt, canonicalNotificationType as n, UserId as nn, AuthProvider as nt, normalizeNotification as o, CommentSort as on, Emitter as ot, MyProfile as p, Loose as pn, OperationAnnotations as pt, isItdForbiddenError as q, isBuiltInOperationId as qt, isKnownNotificationType as r, UserRef as rn, anonymousAuth as rt, Notification as s, EventChannelStatus as sn, Listener as st, resolveNotificationUrl as t, Span as tn, AuthIdentity as tt, AuthState as u, InteractionType as un, STATUS_SERVICE as ut, PublicProfile as v, SpanType as vn, ClientHooks as vt, ItdApiErrorKind as w, RateLimitBucketOverride as wt, ItdAbortError as x, WallAccess as xn, OperationRequestOptions as xt, SubscriptionState as y, ViewReason as yn, ErrorContextHook as yt, ItdStateError as z, RuntimeMode as zt };
-//# sourceMappingURL=url-Be9jlWRv.d.cts.map
+//# sourceMappingURL=url-XBsMdAcv.d.ts.map

package/dist/web/index.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_errors = require("../shared/errors-BmP3TKoW.cjs");
-const require_storage = require("../shared/storage-BLmXmzKF.cjs");
+const require_key_value_store = require("../shared/key-value-store-B5GYVEYZ.cjs");
+const require_storage = require("../shared/storage-QNVxzpDB.cjs");
 //#region src/web.ts
 /**
 * `itd-api/web` — хранилища для браузера.
@@ -31,7 +32,7 @@ function getWebStorage(property) {
 }
 /** Общая реализация Web Storage; публичные классы ниже фиксируют его вид. */
 var WebStorageKeyValueStore = class {
-	#fallback = new require_storage.MemoryKeyValueStore();
+	#fallback = new require_key_value_store.MemoryKeyValueStore();
 	#storage;
 	#property;
 	constructor(property) {
@@ -88,7 +89,7 @@ var WebStorageKeyValueStore = class {
 	}
 	#degrade() {
 		this.#storage = void 0;
-		this.#fallback = new require_storage.MemoryKeyValueStore();
+		this.#fallback = new require_key_value_store.MemoryKeyValueStore();
 	}
 };
 /** JSON key-value backend поверх браузерного `localStorage` с откатом в память. */

package/dist/web/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["MemoryKeyValueStore","#property","#storage","#fallback","#degrade","ItdConfigError","#inner","createTokenStorage"],"sources":["../../src/web.ts"],"sourcesContent":["/**\n * `itd-api/web` — хранилища для браузера.\n *\n * Здесь лежит только то, что рассчитано на браузерное окружение. Клиент, аккаунты,\n * билдеры, типы и всё остальное берутся из `itd-api` — одинаково на всех платформах.\n *\n * Отдельная точка входа нужна не сборщику, а вам: браузерные хранилища при\n * недоступном Web Storage молча работают в памяти, и такое поведение стоит выбирать\n * осознанно, а не получать вместе с общим импортом.\n *\n * @example\n * ```ts\n * import { ItdClient } from 'itd-api';\n * import { LocalStorageTokenStorage } from 'itd-api/web';\n *\n * const itd = new ItdClient({ storage: new LocalStorageTokenStorage() });\n * ```\n *\n * @packageDocumentation\n */\n\nimport { ItdConfigError } from './core/errors.js';\nimport { MemoryKeyValueStore } from './core/key-value-store.js';\nimport { createTokenStorage, type ItdSession, type TokenStorage } from './session/storage.js';\n\ntype WebStorageProperty = 'localStorage' | 'sessionStorage';\n\nfunction getWebStorage(property: WebStorageProperty): Storage | undefined {\n  try {\n    return globalThis[property] ?? undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Общая реализация Web Storage; публичные классы ниже фиксируют его вид. */\nclass WebStorageKeyValueStore<T> {\n  #fallback = new MemoryKeyValueStore<T>();\n  #storage: Storage | undefined;\n  readonly #property: WebStorageProperty;\n\n  constructor(property: WebStorageProperty) {\n    this.#property = property;\n    this.#storage = getWebStorage(property);\n  }\n\n  get(key: string): T | undefined {\n    if (!this.#storage) return this.#fallback.get(key);\n    let raw: string | null;\n    try {\n      raw = this.#storage.getItem(key);\n    } catch {\n      this.#degrade();\n      return this.#fallback.get(key);\n    }\n    if (raw === null) return undefined;\n    try {\n      return JSON.parse(raw) as T;\n    } catch (error) {\n      throw new ItdConfigError(`Повреждён JSON в ${this.#property} по ключу «${key}»`, {\n        cause: error,\n      });\n    }\n  }\n\n  set(key: string, value: T): void {\n    if (this.#storage) {\n      try {\n        this.#storage.setItem(key, JSON.stringify(value));\n        return;\n      } catch {\n        this.#degrade();\n      }\n    }\n    this.#fallback.set(key, value);\n  }\n\n  delete(key: string): void {\n    if (this.#storage) {\n      try {\n        this.#storage.removeItem(key);\n        return;\n      } catch {\n        this.#degrade();\n      }\n    }\n    this.#fallback.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    if (!this.#storage) return this.#fallback.keys(prefix);\n    try {\n      const keys: string[] = [];\n      for (let index = 0; index < this.#storage.length; index += 1) {\n        const key = this.#storage.key(index);\n        if (key?.startsWith(prefix)) keys.push(key);\n      }\n      return keys;\n    } catch {\n      this.#degrade();\n      return this.#fallback.keys(prefix);\n    }\n  }\n\n  #degrade(): void {\n    this.#storage = undefined;\n    this.#fallback = new MemoryKeyValueStore<T>();\n  }\n}\n\n/** JSON key-value backend поверх браузерного `localStorage` с откатом в память. */\nexport class LocalStorageKeyValueStore<T> {\n  readonly #inner = new WebStorageKeyValueStore<T>('localStorage');\n\n  get(key: string): T | undefined {\n    return this.#inner.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#inner.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#inner.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    return this.#inner.keys(prefix);\n  }\n}\n\n/** JSON key-value backend поверх браузерного `sessionStorage` с откатом в память. */\nexport class SessionStorageKeyValueStore<T> {\n  readonly #inner = new WebStorageKeyValueStore<T>('sessionStorage');\n\n  get(key: string): T | undefined {\n    return this.#inner.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#inner.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#inner.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    return this.#inner.keys(prefix);\n  }\n}\n\n/**\n * Хранилище поверх `localStorage` браузера.\n *\n * Если `localStorage` недоступен (приватный режим, серверный рендеринг), молча работает\n * как хранилище в памяти — библиотека не должна падать из-за настроек браузера. Сессия\n * в этом случае теряется при перезагрузке страницы; когда это неприемлемо, проверьте\n * доступность сами или возьмите своё хранилище через `createTokenStorage`.\n *\n * Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,\n * если для вашего приложения это неприемлемый риск.\n *\n * Повреждённый JSON считается ошибкой, а не отсутствующей сессией. После ошибки доступа,\n * записи или удаления хранилище переключается на память до конца\n * своего жизненного цикла.\n */\nexport class LocalStorageTokenStorage implements TokenStorage {\n  readonly #inner: TokenStorage;\n\n  /** @param key ключ в `localStorage`. По умолчанию `itd-api:session`. */\n  constructor(key = 'itd-api:session') {\n    this.#inner = createTokenStorage(new LocalStorageKeyValueStore<ItdSession>(), { key });\n  }\n\n  get(): ItdSession | null {\n    return this.#inner.get() as ItdSession | null;\n  }\n\n  set(session: ItdSession): void {\n    void this.#inner.set(session);\n  }\n\n  clear(): void {\n    void this.#inner.clear();\n  }\n}\n\n/**\n * Хранилище сессии поверх браузерного `sessionStorage`.\n *\n * Данные переживают перезагрузку страницы, но существуют только в пределах текущей\n * browser page session. Если `sessionStorage` недоступен, экземпляр молча работает\n * в памяти; после ошибки доступа, записи или удаления он также остаётся в памяти до конца\n * своего жизненного цикла.\n * Повреждённый JSON считается ошибкой, а не отсутствующей сессией.\n *\n * Как и `localStorage`, это хранилище доступно скриптам страницы и не защищает сессию\n * от XSS. Выбирайте его ради более короткого срока жизни, а не ради изоляции секрета.\n */\nexport class SessionStorageTokenStorage implements TokenStorage {\n  readonly #inner: TokenStorage;\n\n  /** @param key ключ в `sessionStorage`. По умолчанию `itd-api:session`. */\n  constructor(key = 'itd-api:session') {\n    this.#inner = createTokenStorage(new SessionStorageKeyValueStore<ItdSession>(), { key });\n  }\n\n  get(): ItdSession | null {\n    return this.#inner.get() as ItdSession | null;\n  }\n\n  set(session: ItdSession): void {\n    void this.#inner.set(session);\n  }\n\n  clear(): void {\n    void this.#inner.clear();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAS,cAAc,UAAmD;CACxE,IAAI;EACF,OAAO,WAAW,aAAa,KAAA;CACjC,QAAQ;EACN;CACF;AACF;;AAGA,IAAM,0BAAN,MAAiC;CAC/B,YAAY,IAAIA,gBAAAA,oBAAuB;CACvC;CACA;CAEA,YAAY,UAA8B;EACxC,KAAKC,YAAY;EACjB,KAAKC,WAAW,cAAc,QAAQ;CACxC;CAEA,IAAI,KAA4B;EAC9B,IAAI,CAAC,KAAKA,UAAU,OAAO,KAAKC,UAAU,IAAI,GAAG;EACjD,IAAI;EACJ,IAAI;GACF,MAAM,KAAKD,SAAS,QAAQ,GAAG;EACjC,QAAQ;GACN,KAAKE,SAAS;GACd,OAAO,KAAKD,UAAU,IAAI,GAAG;EAC/B;EACA,IAAI,QAAQ,MAAM,OAAO,KAAA;EACzB,IAAI;GACF,OAAO,KAAK,MAAM,GAAG;EACvB,SAAS,OAAO;GACd,MAAM,IAAIE,eAAAA,eAAe,oBAAoB,KAAKJ,UAAU,aAAa,IAAI,IAAI,EAC/E,OAAO,MACT,CAAC;EACH;CACF;CAEA,IAAI,KAAa,OAAgB;EAC/B,IAAI,KAAKC,UACP,IAAI;GACF,KAAKA,SAAS,QAAQ,KAAK,KAAK,UAAU,KAAK,CAAC;GAChD;EACF,QAAQ;GACN,KAAKE,SAAS;EAChB;EAEF,KAAKD,UAAU,IAAI,KAAK,KAAK;CAC/B;CAEA,OAAO,KAAmB;EACxB,IAAI,KAAKD,UACP,IAAI;GACF,KAAKA,SAAS,WAAW,GAAG;GAC5B;EACF,QAAQ;GACN,KAAKE,SAAS;EAChB;EAEF,KAAKD,UAAU,OAAO,GAAG;CAC3B;CAEA,KAAK,SAAS,IAA8C;EAC1D,IAAI,CAAC,KAAKD,UAAU,OAAO,KAAKC,UAAU,KAAK,MAAM;EACrD,IAAI;GACF,MAAM,OAAiB,CAAC;GACxB,KAAK,IAAI,QAAQ,GAAG,QAAQ,KAAKD,SAAS,QAAQ,SAAS,GAAG;IAC5D,MAAM,MAAM,KAAKA,SAAS,IAAI,KAAK;IACnC,IAAI,KAAK,WAAW,MAAM,GAAG,KAAK,KAAK,GAAG;GAC5C;GACA,OAAO;EACT,QAAQ;GACN,KAAKE,SAAS;GACd,OAAO,KAAKD,UAAU,KAAK,MAAM;EACnC;CACF;CAEA,WAAiB;EACf,KAAKD,WAAW,KAAA;EAChB,KAAKC,YAAY,IAAIH,gBAAAA,oBAAuB;CAC9C;AACF;;AAGA,IAAa,4BAAb,MAA0C;CACxC,SAAkB,IAAI,wBAA2B,cAAc;CAE/D,IAAI,KAA4B;EAC9B,OAAO,KAAKM,OAAO,IAAI,GAAG;CAC5B;CAEA,IAAI,KAAa,OAAgB;EAC/B,KAAKA,OAAO,IAAI,KAAK,KAAK;CAC5B;CAEA,OAAO,KAAmB;EACxB,KAAKA,OAAO,OAAO,GAAG;CACxB;CAEA,KAAK,SAAS,IAA8C;EAC1D,OAAO,KAAKA,OAAO,KAAK,MAAM;CAChC;AACF;;AAGA,IAAa,8BAAb,MAA4C;CAC1C,SAAkB,IAAI,wBAA2B,gBAAgB;CAEjE,IAAI,KAA4B;EAC9B,OAAO,KAAKA,OAAO,IAAI,GAAG;CAC5B;CAEA,IAAI,KAAa,OAAgB;EAC/B,KAAKA,OAAO,IAAI,KAAK,KAAK;CAC5B;CAEA,OAAO,KAAmB;EACxB,KAAKA,OAAO,OAAO,GAAG;CACxB;CAEA,KAAK,SAAS,IAA8C;EAC1D,OAAO,KAAKA,OAAO,KAAK,MAAM;CAChC;AACF;;;;;;;;;;;;;;;;AAiBA,IAAa,2BAAb,MAA8D;CAC5D;;CAGA,YAAY,MAAM,mBAAmB;EACnC,KAAKA,SAASC,gBAAAA,mBAAmB,IAAI,0BAAsC,GAAG,EAAE,IAAI,CAAC;CACvF;CAEA,MAAyB;EACvB,OAAO,KAAKD,OAAO,IAAI;CACzB;CAEA,IAAI,SAA2B;EAC7B,KAAUA,OAAO,IAAI,OAAO;CAC9B;CAEA,QAAc;EACZ,KAAUA,OAAO,MAAM;CACzB;AACF;;;;;;;;;;;;;AAcA,IAAa,6BAAb,MAAgE;CAC9D;;CAGA,YAAY,MAAM,mBAAmB;EACnC,KAAKA,SAASC,gBAAAA,mBAAmB,IAAI,4BAAwC,GAAG,EAAE,IAAI,CAAC;CACzF;CAEA,MAAyB;EACvB,OAAO,KAAKD,OAAO,IAAI;CACzB;CAEA,IAAI,SAA2B;EAC7B,KAAUA,OAAO,IAAI,OAAO;CAC9B;CAEA,QAAc;EACZ,KAAUA,OAAO,MAAM;CACzB;AACF"}
+{"version":3,"file":"index.cjs","names":["MemoryKeyValueStore","#property","#storage","#fallback","#degrade","ItdConfigError","#inner","createTokenStorage"],"sources":["../../src/web.ts"],"sourcesContent":["/**\n * `itd-api/web` — хранилища для браузера.\n *\n * Здесь лежит только то, что рассчитано на браузерное окружение. Клиент, аккаунты,\n * билдеры, типы и всё остальное берутся из `itd-api` — одинаково на всех платформах.\n *\n * Отдельная точка входа нужна не сборщику, а вам: браузерные хранилища при\n * недоступном Web Storage молча работают в памяти, и такое поведение стоит выбирать\n * осознанно, а не получать вместе с общим импортом.\n *\n * @example\n * ```ts\n * import { ItdClient } from 'itd-api';\n * import { LocalStorageTokenStorage } from 'itd-api/web';\n *\n * const itd = new ItdClient({ storage: new LocalStorageTokenStorage() });\n * ```\n *\n * @packageDocumentation\n */\n\nimport { ItdConfigError } from './core/errors.js';\nimport { MemoryKeyValueStore } from './core/key-value-store.js';\nimport { createTokenStorage, type ItdSession, type TokenStorage } from './session/storage.js';\n\ntype WebStorageProperty = 'localStorage' | 'sessionStorage';\n\nfunction getWebStorage(property: WebStorageProperty): Storage | undefined {\n  try {\n    return globalThis[property] ?? undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Общая реализация Web Storage; публичные классы ниже фиксируют его вид. */\nclass WebStorageKeyValueStore<T> {\n  #fallback = new MemoryKeyValueStore<T>();\n  #storage: Storage | undefined;\n  readonly #property: WebStorageProperty;\n\n  constructor(property: WebStorageProperty) {\n    this.#property = property;\n    this.#storage = getWebStorage(property);\n  }\n\n  get(key: string): T | undefined {\n    if (!this.#storage) return this.#fallback.get(key);\n    let raw: string | null;\n    try {\n      raw = this.#storage.getItem(key);\n    } catch {\n      this.#degrade();\n      return this.#fallback.get(key);\n    }\n    if (raw === null) return undefined;\n    try {\n      return JSON.parse(raw) as T;\n    } catch (error) {\n      throw new ItdConfigError(`Повреждён JSON в ${this.#property} по ключу «${key}»`, {\n        cause: error,\n      });\n    }\n  }\n\n  set(key: string, value: T): void {\n    if (this.#storage) {\n      try {\n        this.#storage.setItem(key, JSON.stringify(value));\n        return;\n      } catch {\n        this.#degrade();\n      }\n    }\n    this.#fallback.set(key, value);\n  }\n\n  delete(key: string): void {\n    if (this.#storage) {\n      try {\n        this.#storage.removeItem(key);\n        return;\n      } catch {\n        this.#degrade();\n      }\n    }\n    this.#fallback.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    if (!this.#storage) return this.#fallback.keys(prefix);\n    try {\n      const keys: string[] = [];\n      for (let index = 0; index < this.#storage.length; index += 1) {\n        const key = this.#storage.key(index);\n        if (key?.startsWith(prefix)) keys.push(key);\n      }\n      return keys;\n    } catch {\n      this.#degrade();\n      return this.#fallback.keys(prefix);\n    }\n  }\n\n  #degrade(): void {\n    this.#storage = undefined;\n    this.#fallback = new MemoryKeyValueStore<T>();\n  }\n}\n\n/** JSON key-value backend поверх браузерного `localStorage` с откатом в память. */\nexport class LocalStorageKeyValueStore<T> {\n  readonly #inner = new WebStorageKeyValueStore<T>('localStorage');\n\n  get(key: string): T | undefined {\n    return this.#inner.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#inner.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#inner.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    return this.#inner.keys(prefix);\n  }\n}\n\n/** JSON key-value backend поверх браузерного `sessionStorage` с откатом в память. */\nexport class SessionStorageKeyValueStore<T> {\n  readonly #inner = new WebStorageKeyValueStore<T>('sessionStorage');\n\n  get(key: string): T | undefined {\n    return this.#inner.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#inner.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#inner.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    return this.#inner.keys(prefix);\n  }\n}\n\n/**\n * Хранилище поверх `localStorage` браузера.\n *\n * Если `localStorage` недоступен (приватный режим, серверный рендеринг), молча работает\n * как хранилище в памяти — библиотека не должна падать из-за настроек браузера. Сессия\n * в этом случае теряется при перезагрузке страницы; когда это неприемлемо, проверьте\n * доступность сами или возьмите своё хранилище через `createTokenStorage`.\n *\n * Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,\n * если для вашего приложения это неприемлемый риск.\n *\n * Повреждённый JSON считается ошибкой, а не отсутствующей сессией. После ошибки доступа,\n * записи или удаления хранилище переключается на память до конца\n * своего жизненного цикла.\n */\nexport class LocalStorageTokenStorage implements TokenStorage {\n  readonly #inner: TokenStorage;\n\n  /** @param key ключ в `localStorage`. По умолчанию `itd-api:session`. */\n  constructor(key = 'itd-api:session') {\n    this.#inner = createTokenStorage(new LocalStorageKeyValueStore<ItdSession>(), { key });\n  }\n\n  get(): ItdSession | null {\n    return this.#inner.get() as ItdSession | null;\n  }\n\n  set(session: ItdSession): void {\n    void this.#inner.set(session);\n  }\n\n  clear(): void {\n    void this.#inner.clear();\n  }\n}\n\n/**\n * Хранилище сессии поверх браузерного `sessionStorage`.\n *\n * Данные переживают перезагрузку страницы, но существуют только в пределах текущей\n * browser page session. Если `sessionStorage` недоступен, экземпляр молча работает\n * в памяти; после ошибки доступа, записи или удаления он также остаётся в памяти до конца\n * своего жизненного цикла.\n * Повреждённый JSON считается ошибкой, а не отсутствующей сессией.\n *\n * Как и `localStorage`, это хранилище доступно скриптам страницы и не защищает сессию\n * от XSS. Выбирайте его ради более короткого срока жизни, а не ради изоляции секрета.\n */\nexport class SessionStorageTokenStorage implements TokenStorage {\n  readonly #inner: TokenStorage;\n\n  /** @param key ключ в `sessionStorage`. По умолчанию `itd-api:session`. */\n  constructor(key = 'itd-api:session') {\n    this.#inner = createTokenStorage(new SessionStorageKeyValueStore<ItdSession>(), { key });\n  }\n\n  get(): ItdSession | null {\n    return this.#inner.get() as ItdSession | null;\n  }\n\n  set(session: ItdSession): void {\n    void this.#inner.set(session);\n  }\n\n  clear(): void {\n    void this.#inner.clear();\n  }\n}\n"],"mappings":"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"}

package/dist/web/index.d.cts

@@ -1,4 +1,4 @@
-import { r as TokenStorage, t as ItdSession } from "../shared/storage-C_eICCep.cjs";
+import { r as TokenStorage, t as ItdSession } from "../shared/storage-BQrtKon9.cjs";
 //#region src/web.d.ts
 /** JSON key-value backend поверх браузерного `localStorage` с откатом в память. */
 declare class LocalStorageKeyValueStore<T> {

package/dist/web/index.d.ts

@@ -1,4 +1,4 @@
-import { r as TokenStorage, t as ItdSession } from "../shared/storage-C_eICCep.js";
+import { r as TokenStorage, t as ItdSession } from "../shared/storage-CTRGT5wF.js";
 //#region src/web.d.ts
 /** JSON key-value backend поверх браузерного `localStorage` с откатом в память. */
 declare class LocalStorageKeyValueStore<T> {

package/dist/web/index.js

@@ -1,5 +1,6 @@
 import { a as ItdConfigError } from "../shared/errors-GI10kZxk.js";
-import { i as MemoryKeyValueStore, r as createTokenStorage } from "../shared/storage-CCxn0Kkv.js";
+import { t as MemoryKeyValueStore } from "../shared/key-value-store-Bt2PSMxY.js";
+import { r as createTokenStorage } from "../shared/storage-CfHKzVHf.js";
 //#region src/web.ts
 /**
 * `itd-api/web` — хранилища для браузера.

package/dist/web/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["#property","#storage","#fallback","#degrade","#inner"],"sources":["../../src/web.ts"],"sourcesContent":["/**\n * `itd-api/web` — хранилища для браузера.\n *\n * Здесь лежит только то, что рассчитано на браузерное окружение. Клиент, аккаунты,\n * билдеры, типы и всё остальное берутся из `itd-api` — одинаково на всех платформах.\n *\n * Отдельная точка входа нужна не сборщику, а вам: браузерные хранилища при\n * недоступном Web Storage молча работают в памяти, и такое поведение стоит выбирать\n * осознанно, а не получать вместе с общим импортом.\n *\n * @example\n * ```ts\n * import { ItdClient } from 'itd-api';\n * import { LocalStorageTokenStorage } from 'itd-api/web';\n *\n * const itd = new ItdClient({ storage: new LocalStorageTokenStorage() });\n * ```\n *\n * @packageDocumentation\n */\n\nimport { ItdConfigError } from './core/errors.js';\nimport { MemoryKeyValueStore } from './core/key-value-store.js';\nimport { createTokenStorage, type ItdSession, type TokenStorage } from './session/storage.js';\n\ntype WebStorageProperty = 'localStorage' | 'sessionStorage';\n\nfunction getWebStorage(property: WebStorageProperty): Storage | undefined {\n  try {\n    return globalThis[property] ?? undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Общая реализация Web Storage; публичные классы ниже фиксируют его вид. */\nclass WebStorageKeyValueStore<T> {\n  #fallback = new MemoryKeyValueStore<T>();\n  #storage: Storage | undefined;\n  readonly #property: WebStorageProperty;\n\n  constructor(property: WebStorageProperty) {\n    this.#property = property;\n    this.#storage = getWebStorage(property);\n  }\n\n  get(key: string): T | undefined {\n    if (!this.#storage) return this.#fallback.get(key);\n    let raw: string | null;\n    try {\n      raw = this.#storage.getItem(key);\n    } catch {\n      this.#degrade();\n      return this.#fallback.get(key);\n    }\n    if (raw === null) return undefined;\n    try {\n      return JSON.parse(raw) as T;\n    } catch (error) {\n      throw new ItdConfigError(`Повреждён JSON в ${this.#property} по ключу «${key}»`, {\n        cause: error,\n      });\n    }\n  }\n\n  set(key: string, value: T): void {\n    if (this.#storage) {\n      try {\n        this.#storage.setItem(key, JSON.stringify(value));\n        return;\n      } catch {\n        this.#degrade();\n      }\n    }\n    this.#fallback.set(key, value);\n  }\n\n  delete(key: string): void {\n    if (this.#storage) {\n      try {\n        this.#storage.removeItem(key);\n        return;\n      } catch {\n        this.#degrade();\n      }\n    }\n    this.#fallback.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    if (!this.#storage) return this.#fallback.keys(prefix);\n    try {\n      const keys: string[] = [];\n      for (let index = 0; index < this.#storage.length; index += 1) {\n        const key = this.#storage.key(index);\n        if (key?.startsWith(prefix)) keys.push(key);\n      }\n      return keys;\n    } catch {\n      this.#degrade();\n      return this.#fallback.keys(prefix);\n    }\n  }\n\n  #degrade(): void {\n    this.#storage = undefined;\n    this.#fallback = new MemoryKeyValueStore<T>();\n  }\n}\n\n/** JSON key-value backend поверх браузерного `localStorage` с откатом в память. */\nexport class LocalStorageKeyValueStore<T> {\n  readonly #inner = new WebStorageKeyValueStore<T>('localStorage');\n\n  get(key: string): T | undefined {\n    return this.#inner.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#inner.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#inner.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    return this.#inner.keys(prefix);\n  }\n}\n\n/** JSON key-value backend поверх браузерного `sessionStorage` с откатом в память. */\nexport class SessionStorageKeyValueStore<T> {\n  readonly #inner = new WebStorageKeyValueStore<T>('sessionStorage');\n\n  get(key: string): T | undefined {\n    return this.#inner.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#inner.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#inner.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    return this.#inner.keys(prefix);\n  }\n}\n\n/**\n * Хранилище поверх `localStorage` браузера.\n *\n * Если `localStorage` недоступен (приватный режим, серверный рендеринг), молча работает\n * как хранилище в памяти — библиотека не должна падать из-за настроек браузера. Сессия\n * в этом случае теряется при перезагрузке страницы; когда это неприемлемо, проверьте\n * доступность сами или возьмите своё хранилище через `createTokenStorage`.\n *\n * Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,\n * если для вашего приложения это неприемлемый риск.\n *\n * Повреждённый JSON считается ошибкой, а не отсутствующей сессией. После ошибки доступа,\n * записи или удаления хранилище переключается на память до конца\n * своего жизненного цикла.\n */\nexport class LocalStorageTokenStorage implements TokenStorage {\n  readonly #inner: TokenStorage;\n\n  /** @param key ключ в `localStorage`. По умолчанию `itd-api:session`. */\n  constructor(key = 'itd-api:session') {\n    this.#inner = createTokenStorage(new LocalStorageKeyValueStore<ItdSession>(), { key });\n  }\n\n  get(): ItdSession | null {\n    return this.#inner.get() as ItdSession | null;\n  }\n\n  set(session: ItdSession): void {\n    void this.#inner.set(session);\n  }\n\n  clear(): void {\n    void this.#inner.clear();\n  }\n}\n\n/**\n * Хранилище сессии поверх браузерного `sessionStorage`.\n *\n * Данные переживают перезагрузку страницы, но существуют только в пределах текущей\n * browser page session. Если `sessionStorage` недоступен, экземпляр молча работает\n * в памяти; после ошибки доступа, записи или удаления он также остаётся в памяти до конца\n * своего жизненного цикла.\n * Повреждённый JSON считается ошибкой, а не отсутствующей сессией.\n *\n * Как и `localStorage`, это хранилище доступно скриптам страницы и не защищает сессию\n * от XSS. Выбирайте его ради более короткого срока жизни, а не ради изоляции секрета.\n */\nexport class SessionStorageTokenStorage implements TokenStorage {\n  readonly #inner: TokenStorage;\n\n  /** @param key ключ в `sessionStorage`. По умолчанию `itd-api:session`. */\n  constructor(key = 'itd-api:session') {\n    this.#inner = createTokenStorage(new SessionStorageKeyValueStore<ItdSession>(), { key });\n  }\n\n  get(): ItdSession | null {\n    return this.#inner.get() as ItdSession | null;\n  }\n\n  set(session: ItdSession): void {\n    void this.#inner.set(session);\n  }\n\n  clear(): void {\n    void this.#inner.clear();\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["#property","#storage","#fallback","#degrade","#inner"],"sources":["../../src/web.ts"],"sourcesContent":["/**\n * `itd-api/web` — хранилища для браузера.\n *\n * Здесь лежит только то, что рассчитано на браузерное окружение. Клиент, аккаунты,\n * билдеры, типы и всё остальное берутся из `itd-api` — одинаково на всех платформах.\n *\n * Отдельная точка входа нужна не сборщику, а вам: браузерные хранилища при\n * недоступном Web Storage молча работают в памяти, и такое поведение стоит выбирать\n * осознанно, а не получать вместе с общим импортом.\n *\n * @example\n * ```ts\n * import { ItdClient } from 'itd-api';\n * import { LocalStorageTokenStorage } from 'itd-api/web';\n *\n * const itd = new ItdClient({ storage: new LocalStorageTokenStorage() });\n * ```\n *\n * @packageDocumentation\n */\n\nimport { ItdConfigError } from './core/errors.js';\nimport { MemoryKeyValueStore } from './core/key-value-store.js';\nimport { createTokenStorage, type ItdSession, type TokenStorage } from './session/storage.js';\n\ntype WebStorageProperty = 'localStorage' | 'sessionStorage';\n\nfunction getWebStorage(property: WebStorageProperty): Storage | undefined {\n  try {\n    return globalThis[property] ?? undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Общая реализация Web Storage; публичные классы ниже фиксируют его вид. */\nclass WebStorageKeyValueStore<T> {\n  #fallback = new MemoryKeyValueStore<T>();\n  #storage: Storage | undefined;\n  readonly #property: WebStorageProperty;\n\n  constructor(property: WebStorageProperty) {\n    this.#property = property;\n    this.#storage = getWebStorage(property);\n  }\n\n  get(key: string): T | undefined {\n    if (!this.#storage) return this.#fallback.get(key);\n    let raw: string | null;\n    try {\n      raw = this.#storage.getItem(key);\n    } catch {\n      this.#degrade();\n      return this.#fallback.get(key);\n    }\n    if (raw === null) return undefined;\n    try {\n      return JSON.parse(raw) as T;\n    } catch (error) {\n      throw new ItdConfigError(`Повреждён JSON в ${this.#property} по ключу «${key}»`, {\n        cause: error,\n      });\n    }\n  }\n\n  set(key: string, value: T): void {\n    if (this.#storage) {\n      try {\n        this.#storage.setItem(key, JSON.stringify(value));\n        return;\n      } catch {\n        this.#degrade();\n      }\n    }\n    this.#fallback.set(key, value);\n  }\n\n  delete(key: string): void {\n    if (this.#storage) {\n      try {\n        this.#storage.removeItem(key);\n        return;\n      } catch {\n        this.#degrade();\n      }\n    }\n    this.#fallback.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    if (!this.#storage) return this.#fallback.keys(prefix);\n    try {\n      const keys: string[] = [];\n      for (let index = 0; index < this.#storage.length; index += 1) {\n        const key = this.#storage.key(index);\n        if (key?.startsWith(prefix)) keys.push(key);\n      }\n      return keys;\n    } catch {\n      this.#degrade();\n      return this.#fallback.keys(prefix);\n    }\n  }\n\n  #degrade(): void {\n    this.#storage = undefined;\n    this.#fallback = new MemoryKeyValueStore<T>();\n  }\n}\n\n/** JSON key-value backend поверх браузерного `localStorage` с откатом в память. */\nexport class LocalStorageKeyValueStore<T> {\n  readonly #inner = new WebStorageKeyValueStore<T>('localStorage');\n\n  get(key: string): T | undefined {\n    return this.#inner.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#inner.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#inner.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    return this.#inner.keys(prefix);\n  }\n}\n\n/** JSON key-value backend поверх браузерного `sessionStorage` с откатом в память. */\nexport class SessionStorageKeyValueStore<T> {\n  readonly #inner = new WebStorageKeyValueStore<T>('sessionStorage');\n\n  get(key: string): T | undefined {\n    return this.#inner.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#inner.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#inner.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    return this.#inner.keys(prefix);\n  }\n}\n\n/**\n * Хранилище поверх `localStorage` браузера.\n *\n * Если `localStorage` недоступен (приватный режим, серверный рендеринг), молча работает\n * как хранилище в памяти — библиотека не должна падать из-за настроек браузера. Сессия\n * в этом случае теряется при перезагрузке страницы; когда это неприемлемо, проверьте\n * доступность сами или возьмите своё хранилище через `createTokenStorage`.\n *\n * Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,\n * если для вашего приложения это неприемлемый риск.\n *\n * Повреждённый JSON считается ошибкой, а не отсутствующей сессией. После ошибки доступа,\n * записи или удаления хранилище переключается на память до конца\n * своего жизненного цикла.\n */\nexport class LocalStorageTokenStorage implements TokenStorage {\n  readonly #inner: TokenStorage;\n\n  /** @param key ключ в `localStorage`. По умолчанию `itd-api:session`. */\n  constructor(key = 'itd-api:session') {\n    this.#inner = createTokenStorage(new LocalStorageKeyValueStore<ItdSession>(), { key });\n  }\n\n  get(): ItdSession | null {\n    return this.#inner.get() as ItdSession | null;\n  }\n\n  set(session: ItdSession): void {\n    void this.#inner.set(session);\n  }\n\n  clear(): void {\n    void this.#inner.clear();\n  }\n}\n\n/**\n * Хранилище сессии поверх браузерного `sessionStorage`.\n *\n * Данные переживают перезагрузку страницы, но существуют только в пределах текущей\n * browser page session. Если `sessionStorage` недоступен, экземпляр молча работает\n * в памяти; после ошибки доступа, записи или удаления он также остаётся в памяти до конца\n * своего жизненного цикла.\n * Повреждённый JSON считается ошибкой, а не отсутствующей сессией.\n *\n * Как и `localStorage`, это хранилище доступно скриптам страницы и не защищает сессию\n * от XSS. Выбирайте его ради более короткого срока жизни, а не ради изоляции секрета.\n */\nexport class SessionStorageTokenStorage implements TokenStorage {\n  readonly #inner: TokenStorage;\n\n  /** @param key ключ в `sessionStorage`. По умолчанию `itd-api:session`. */\n  constructor(key = 'itd-api:session') {\n    this.#inner = createTokenStorage(new SessionStorageKeyValueStore<ItdSession>(), { key });\n  }\n\n  get(): ItdSession | null {\n    return this.#inner.get() as ItdSession | null;\n  }\n\n  set(session: ItdSession): void {\n    void this.#inner.set(session);\n  }\n\n  clear(): void {\n    void this.#inner.clear();\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "itd-api",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "JS/TS SDK & API клиент для соцсети ИТД (итд.com)",
   "repository": {
     "type": "git",