itd-api 0.4.0 → 0.5.0

package/dist/storage-dF8Tio5y.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-dF8Tio5y.cjs","names":["#values","#store"],"sources":["../src/core/errors.ts","../src/core/key-value-store.ts","../src/core/storage.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","import { ItdConfigError } from './errors.js';\n\n/** Синхронный или асинхронный результат операции хранилища. */\nexport type KeyValueStoreResult<T> = T | Promise<T>;\n\n/** Синхронный или асинхронный источник ключей. */\nexport type KeyValueStoreKeys = Iterable<string> | AsyncIterable<string>;\n\n/**\n * Минимальный backend именованных значений.\n *\n * Контракт ничего не знает о сессиях, сериализации или конкретной базе данных. Значение\n * `undefined` означает отсутствие ключа; хранить `undefined` как самостоятельное значение нельзя.\n */\nexport interface KeyValueStore<T> {\n  /** Читает значение либо возвращает `undefined`, если ключ отсутствует. */\n  get(key: string): KeyValueStoreResult<T | undefined>;\n  /** Полностью заменяет значение ключа. */\n  set(key: string, value: T): KeyValueStoreResult<void>;\n  /** Удаляет ключ. Отсутствующий ключ не должен считаться ошибкой. */\n  delete(key: string): KeyValueStoreResult<void>;\n  /** Перечисляет ключи, при возможности ограничивая их префиксом. */\n  keys?(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;\n}\n\n/** Backend, который гарантированно умеет перечислять ключи. */\nexport interface EnumerableKeyValueStore<T> extends KeyValueStore<T> {\n  keys(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;\n}\n\n/** Кодирует значения для хранения в backend другого типа. */\nexport interface KeyValueCodec<T, Stored> {\n  /** Преобразует доменное значение перед записью. */\n  encode(value: T): KeyValueStoreResult<Stored>;\n  /** Восстанавливает доменное значение после чтения. */\n  decode(value: Stored): KeyValueStoreResult<T>;\n}\n\n/** Источник одной записи, содержащей всю карту key-value. */\nexport interface RecordKeyValueStoreSource<T> {\n  /** Читает всю карту. `undefined` означает отсутствие записи. */\n  read(): KeyValueStoreResult<Readonly<Record<string, T>> | undefined>;\n  /** Записывает стабильный снимок всей карты. */\n  write(record: Readonly<Record<string, T>>): KeyValueStoreResult<void>;\n  /** Удаляет запись, когда карта становится пустой. */\n  delete?(): KeyValueStoreResult<void>;\n}\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction requireStore(value: unknown): asserts value is KeyValueStore<unknown> {\n  const store = value as KeyValueStore<unknown>;\n  if (!isRecord(store)) throw new ItdConfigError('KeyValueStore должен быть объектом');\n  for (const method of ['get', 'set', 'delete'] as const) {\n    if (typeof store[method] !== 'function') {\n      throw new ItdConfigError(`KeyValueStore.${method} должен быть функцией`);\n    }\n  }\n  if (store.keys !== undefined && typeof store.keys !== 'function') {\n    throw new ItdConfigError('KeyValueStore.keys должен быть функцией');\n  }\n}\n\nexport function createKeyValueStore<T>(\n  handlers: EnumerableKeyValueStore<T>,\n): EnumerableKeyValueStore<T>;\nexport function createKeyValueStore<T>(handlers: KeyValueStore<T>): KeyValueStore<T>;\n/** Собирает {@link KeyValueStore} из функций конкретного backend. */\nexport function createKeyValueStore<T>(handlers: KeyValueStore<T>): KeyValueStore<T> {\n  requireStore(handlers);\n  return handlers;\n}\n\n/** Проверяет доступность перечисления ключей. */\nexport function isEnumerableKeyValueStore<T>(\n  store: KeyValueStore<T>,\n): store is EnumerableKeyValueStore<T> {\n  return typeof store.keys === 'function';\n}\n\n/** @internal */\nexport async function collectKeyValueStoreKeys<T>(\n  store: EnumerableKeyValueStore<T>,\n  prefix?: string,\n): Promise<string[]> {\n  const source = await store.keys(prefix);\n  const result: string[] = [];\n  for await (const key of source) {\n    if (typeof key !== 'string') {\n      throw new ItdConfigError('KeyValueStore.keys() должен возвращать только строки');\n    }\n    if (prefix === undefined || key.startsWith(prefix)) result.push(key);\n  }\n  return result;\n}\n\n/** Key-value backend в памяти процесса. Значения сохраняются по ссылке. */\nexport class MemoryKeyValueStore<T> implements EnumerableKeyValueStore<T> {\n  readonly #values = new Map<string, T>();\n\n  constructor(initial?: Iterable<readonly [string, T]>) {\n    for (const [key, value] of initial ?? []) this.#values.set(key, value);\n  }\n\n  get(key: string): T | undefined {\n    return this.#values.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#values.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#values.delete(key);\n  }\n\n  keys(prefix = ''): string[] {\n    return [...this.#values.keys()].filter((key) => key.startsWith(prefix));\n  }\n}\n\nexport function withNamespace<T>(\n  store: EnumerableKeyValueStore<T>,\n  namespace: string,\n  separator?: string,\n): EnumerableKeyValueStore<T>;\nexport function withNamespace<T>(\n  store: KeyValueStore<T>,\n  namespace: string,\n  separator?: string,\n): KeyValueStore<T>;\n/** Добавляет namespace ко всем ключам, не меняя исходный backend. */\nexport function withNamespace<T>(\n  store: KeyValueStore<T>,\n  namespace: string,\n  separator = ':',\n): KeyValueStore<T> {\n  requireStore(store);\n  if (typeof namespace !== 'string' || typeof separator !== 'string') {\n    throw new ItdConfigError('namespace и separator KeyValueStore должны быть строками');\n  }\n  const base = namespace.length === 0 ? '' : `${namespace}${separator}`;\n  const key = (value: string) => `${base}${value}`;\n  const namespaced: KeyValueStore<T> = {\n    get: (value) => store.get(key(value)),\n    set: (value, data) => store.set(key(value), data),\n    delete: (value) => store.delete(key(value)),\n  };\n\n  if (isEnumerableKeyValueStore(store)) {\n    namespaced.keys = async (prefix = '') => {\n      const keys = await collectKeyValueStoreKeys(store, key(prefix));\n      return keys.map((value) => value.slice(base.length));\n    };\n  }\n  return namespaced;\n}\n\nexport function withCodec<T, Stored>(\n  store: EnumerableKeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): EnumerableKeyValueStore<T>;\nexport function withCodec<T, Stored>(\n  store: KeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): KeyValueStore<T>;\n/** Преобразует значения на границе backend, сохраняя его пространство ключей. */\nexport function withCodec<T, Stored>(\n  store: KeyValueStore<Stored>,\n  codec: KeyValueCodec<T, Stored>,\n): KeyValueStore<T> {\n  requireStore(store);\n  if (\n    !isRecord(codec) ||\n    typeof codec.encode !== 'function' ||\n    typeof codec.decode !== 'function'\n  ) {\n    throw new ItdConfigError('codec должен содержать функции encode и decode');\n  }\n  const encoded: KeyValueStore<T> = {\n    async get(key) {\n      const value = await store.get(key);\n      return value === undefined ? undefined : codec.decode(value);\n    },\n    async set(key, value) {\n      await store.set(key, await codec.encode(value));\n    },\n    delete: (key) => store.delete(key),\n  };\n  if (isEnumerableKeyValueStore(store)) encoded.keys = (prefix) => store.keys(prefix);\n  return encoded;\n}\n\n/** Создаёт запись без прототипа, чтобы любые пользовательские ключи оставались данными. */\nfunction emptyRecord<T>(): Record<string, T> {\n  return Object.create(null) as Record<string, T>;\n}\n\nfunction copyRecord<T>(record: Readonly<Record<string, T>> | undefined): Record<string, T> {\n  const copy = emptyRecord<T>();\n  for (const [key, value] of Object.entries(record ?? {})) copy[key] = value;\n  return copy;\n}\n\n/**\n * Создаёт key-value backend поверх одной общей записи.\n *\n * Чтение выполняется один раз, изменения сразу попадают в локальный снимок, а записи\n * выстраиваются последовательно. Несколько экземпляров или процессов требуют внешней\n * синхронизации со стороны source.\n */\nexport function createRecordKeyValueStore<T>(\n  source: RecordKeyValueStoreSource<T>,\n): EnumerableKeyValueStore<T> {\n  if (\n    !isRecord(source) ||\n    typeof source.read !== 'function' ||\n    typeof source.write !== 'function'\n  ) {\n    throw new ItdConfigError('RecordKeyValueStoreSource должен содержать read и write');\n  }\n  if (source.delete !== undefined && typeof source.delete !== 'function') {\n    throw new ItdConfigError('RecordKeyValueStoreSource.delete должен быть функцией');\n  }\n\n  let snapshot: Record<string, T> | undefined;\n  let loading: Promise<Record<string, T>> | undefined;\n  let writing: Promise<void> = Promise.resolve();\n\n  const load = async (): Promise<Record<string, T>> => {\n    if (snapshot !== undefined) return snapshot;\n    loading ??= Promise.resolve(source.read())\n      .then((value) => {\n        if (value !== undefined && !isRecord(value)) {\n          throw new ItdConfigError('RecordKeyValueStoreSource.read() должен вернуть объект');\n        }\n        snapshot = copyRecord(value as Readonly<Record<string, T>> | undefined);\n        return snapshot;\n      })\n      .finally(() => {\n        loading = undefined;\n      });\n    return loading;\n  };\n\n  const flush = (): Promise<void> => {\n    const current = copyRecord(snapshot);\n    const operation = async () => {\n      if (source.delete && Object.keys(current).length === 0) await source.delete();\n      else await source.write(current);\n    };\n    writing = writing.then(operation, operation);\n    return writing;\n  };\n\n  return {\n    async get(key) {\n      const current = await load();\n      await writing;\n      return Object.hasOwn(current, key) ? current[key] : undefined;\n    },\n    async set(key, value) {\n      const current = await load();\n      current[key] = value;\n      await flush();\n    },\n    async delete(key) {\n      const current = await load();\n      if (!Object.hasOwn(current, key)) return;\n      delete current[key];\n      await flush();\n    },\n    async keys(prefix = '') {\n      const current = await load();\n      await writing;\n      return Object.keys(current).filter((key) => key.startsWith(prefix));\n    },\n  };\n}\n","import { ItdConfigError } from './errors.js';\nimport { createKeyValueStore, type KeyValueStore, MemoryKeyValueStore } from './key-value-store.js';\n\n/**\n * Сохранённая сессия.\n *\n * Кроме токенов сюда попадают cookie: refresh-токен итд.com живёт именно в cookie, и без них\n * восстановить сессию после перезапуска процесса невозможно.\n */\nexport interface ItdSession {\n  /** Токен доступа для заголовка `Authorization: Bearer`. */\n  accessToken?: string | undefined;\n  /**\n   * Refresh-токен, если удалось получить его явным значением.\n   *\n   * Обычно сервер держит его в httpOnly-cookie и наружу не отдаёт — тогда поле останется\n   * пустым, а обновление пойдёт через {@link ItdSession.cookies}.\n   */\n  refreshToken?: string | undefined;\n  /** Сырые cookie в форме `имя=значение`, привязанные к origin API. */\n  cookies?: string[] | undefined;\n  /**\n   * Идентификатор устройства для заголовка `X-Device-Id`.\n   *\n   * Сервер различает по нему записи в списке сессий, поэтому значение должно пережить\n   * перезапуск процесса — иначе каждый старт бота порождает новую сессию. Библиотека\n   * заводит его сама при первом запросе и хранит здесь.\n   */\n  deviceId?: string | undefined;\n  /** Когда сессия получена, мс с начала эпохи. Нужно для диагностики. */\n  obtainedAt?: number | undefined;\n}\n\n/**\n * Создаёт независимый снимок сессии.\n *\n * Сессии пересекают границу пользовательского кода и внутреннего состояния клиента.\n * Возвращать или сохранять их по ссылке нельзя: последующая мутация объекта или массива\n * cookie меняла бы уже сохранённую сессию без вызова `set()`.\n *\n * @internal\n */\nexport function copySession(session: ItdSession): ItdSession {\n  return {\n    ...session,\n    ...(session.cookies ? { cookies: [...session.cookies] } : {}),\n  };\n}\n\n/**\n * Хранилище сессии.\n *\n * Подключаемый компонент: библиотека не знает, где вы держите токены, и обращается к ним\n * только через этот интерфейс. Все методы могут быть как синхронными, так и асинхронными.\n *\n * @example Своё хранилище поверх AsyncStorage в React Native\n * ```ts\n * const backend = withCodec(createKeyValueStore({\n *   get: (key) => AsyncStorage.getItem(key).then((value) => value ?? undefined),\n *   set: (key, value) => AsyncStorage.setItem(key, value),\n *   delete: (key) => AsyncStorage.removeItem(key),\n * }), { encode: JSON.stringify, decode: JSON.parse });\n * const storage = createTokenStorage(withNamespace(backend, 'my-app'));\n * ```\n */\nexport interface TokenStorage {\n  /** Прочитать сессию. `null`, если её нет. */\n  get(): ItdSession | null | Promise<ItdSession | null>;\n  /** Сохранить сессию целиком. */\n  set(session: ItdSession): void | Promise<void>;\n  /** Удалить сессию. Вызывается при выходе и при неудачном обновлении токена. */\n  clear(): void | Promise<void>;\n}\n\n/**\n * Хранилище в памяти процесса — вариант по умолчанию.\n *\n * Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`\n * из `itd-api/node`, для браузера — `LocalStorageTokenStorage` или\n * `SessionStorageTokenStorage` из `itd-api/web`.\n */\nexport class MemoryTokenStorage implements TokenStorage {\n  readonly #store = new MemoryKeyValueStore<ItdSession>();\n\n  constructor(initial?: ItdSession | null) {\n    if (initial) this.#store.set(TOKEN_STORAGE_KEY, copySession(initial));\n  }\n\n  get(): ItdSession | null {\n    const session = this.#store.get(TOKEN_STORAGE_KEY);\n    return session ? copySession(session) : null;\n  }\n\n  set(session: ItdSession): void {\n    this.#store.set(TOKEN_STORAGE_KEY, copySession(session));\n  }\n\n  clear(): void {\n    this.#store.delete(TOKEN_STORAGE_KEY);\n  }\n}\n\nconst TOKEN_STORAGE_KEY = 'session';\n\n/** Настройки доменного адаптера одной сессии. */\nexport interface TokenStorageAdapterOptions {\n  /** Ключ сессии в backend. По умолчанию `session`. */\n  key?: string | undefined;\n}\n\nfunction isPromise<T>(value: T | Promise<T>): value is Promise<T> {\n  return (\n    typeof value === 'object' && value !== null && typeof (value as Promise<T>).then === 'function'\n  );\n}\n\n/**\n * Создаёт доменное хранилище сессии поверх общего {@link KeyValueStore}.\n *\n * @example\n * ```ts\n * const storage = createTokenStorage(withNamespace(redisStore, 'itd'));\n * ```\n */\nexport function createTokenStorage(\n  store: KeyValueStore<ItdSession>,\n  options: TokenStorageAdapterOptions = {},\n): TokenStorage {\n  const key = options.key ?? TOKEN_STORAGE_KEY;\n  if (typeof key !== 'string') throw new ItdConfigError('key TokenStorage должен быть строкой');\n  const backend = createKeyValueStore(store);\n  return {\n    get() {\n      const value = backend.get(key);\n      if (isPromise(value)) {\n        return value.then((session) => (session ? copySession(session) : null));\n      }\n      return value ? copySession(value) : null;\n    },\n    set: (session) => backend.set(key, copySession(session)),\n    clear: () => backend.delete(key),\n  };\n}\n"],"mappings":"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"}

package/dist/web.cjs

@@ -1,16 +1,15 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_storage = require("./storage-ycBqLBRB.cjs");
-const require_runtime = require("./runtime-CFEsf-jD.cjs");
+const require_storage = require("./storage-dF8Tio5y.cjs");
 //#region src/web.ts
 /**
-* `itd-api/web` — хранилище сессии для браузера.
+* `itd-api/web` — хранилища для браузера.
 *
 * Здесь лежит только то, что рассчитано на браузерное окружение. Клиент, аккаунты,
 * билдеры, типы и всё остальное берутся из `itd-api` — одинаково на всех платформах.
 *
-* Отдельная точка входа нужна не сборщику, а вам: {@link LocalStorageTokenStorage}
-* при недоступном `localStorage` молча работает как хранилище в памяти, и такое
-* поведение стоит выбирать осознанно, а не получать вместе с общим импортом.
+* Отдельная точка входа нужна не сборщику, а вам: браузерные хранилища при
+* недоступном Web Storage молча работают в памяти, и такое поведение стоит выбирать
+* осознанно, а не получать вместе с общим импортом.
 *
 * @example
 * ```ts
@@ -22,6 +21,107 @@ const require_runtime = require("./runtime-CFEsf-jD.cjs");
 *
 * @packageDocumentation
 */
+function getWebStorage(property) {
+	try {
+		return globalThis[property] ?? void 0;
+	} catch {
+		return;
+	}
+}
+/** Общая реализация Web Storage; публичные классы ниже фиксируют его вид. */
+var WebStorageKeyValueStore = class {
+	#fallback = new require_storage.MemoryKeyValueStore();
+	#storage;
+	#property;
+	constructor(property) {
+		this.#property = property;
+		this.#storage = getWebStorage(property);
+	}
+	get(key) {
+		if (!this.#storage) return this.#fallback.get(key);
+		let raw;
+		try {
+			raw = this.#storage.getItem(key);
+		} catch {
+			this.#degrade();
+			return this.#fallback.get(key);
+		}
+		if (raw === null) return void 0;
+		try {
+			return JSON.parse(raw);
+		} catch (error) {
+			throw new require_storage.ItdConfigError(`Повреждён JSON в ${this.#property} по ключу «${key}»`, { cause: error });
+		}
+	}
+	set(key, value) {
+		if (this.#storage) try {
+			this.#storage.setItem(key, JSON.stringify(value));
+			return;
+		} catch {
+			this.#degrade();
+		}
+		this.#fallback.set(key, value);
+	}
+	delete(key) {
+		if (this.#storage) try {
+			this.#storage.removeItem(key);
+			return;
+		} catch {
+			this.#degrade();
+		}
+		this.#fallback.delete(key);
+	}
+	keys(prefix = "") {
+		if (!this.#storage) return this.#fallback.keys(prefix);
+		try {
+			const keys = [];
+			for (let index = 0; index < this.#storage.length; index += 1) {
+				const key = this.#storage.key(index);
+				if (key?.startsWith(prefix)) keys.push(key);
+			}
+			return keys;
+		} catch {
+			this.#degrade();
+			return this.#fallback.keys(prefix);
+		}
+	}
+	#degrade() {
+		this.#storage = void 0;
+		this.#fallback = new require_storage.MemoryKeyValueStore();
+	}
+};
+/** JSON key-value backend поверх браузерного `localStorage` с откатом в память. */
+var LocalStorageKeyValueStore = class {
+	#inner = new WebStorageKeyValueStore("localStorage");
+	get(key) {
+		return this.#inner.get(key);
+	}
+	set(key, value) {
+		this.#inner.set(key, value);
+	}
+	delete(key) {
+		this.#inner.delete(key);
+	}
+	keys(prefix = "") {
+		return this.#inner.keys(prefix);
+	}
+};
+/** JSON key-value backend поверх браузерного `sessionStorage` с откатом в память. */
+var SessionStorageKeyValueStore = class {
+	#inner = new WebStorageKeyValueStore("sessionStorage");
+	get(key) {
+		return this.#inner.get(key);
+	}
+	set(key, value) {
+		this.#inner.set(key, value);
+	}
+	delete(key) {
+		this.#inner.delete(key);
+	}
+	keys(prefix = "") {
+		return this.#inner.keys(prefix);
+	}
+};
 /**
 * Хранилище поверх `localStorage` браузера.
 *
@@ -33,55 +133,58 @@ const require_runtime = require("./runtime-CFEsf-jD.cjs");
 * Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,
 * если для вашего приложения это неприемлемый риск.
 *
-* После ошибки записи или удаления хранилище переключается на память до конца
+* Повреждённый JSON считается ошибкой, а не отсутствующей сессией. После ошибки доступа,
+* записи или удаления хранилище переключается на память до конца
 * своего жизненного цикла.
 */
 var LocalStorageTokenStorage = class {
-	#key;
-	#fallback = new require_storage.MemoryTokenStorage();
-	/** Доступен ли `localStorage` для дальнейших операций. */
-	#available;
+	#inner;
 	/** @param key ключ в `localStorage`. По умолчанию `itd-api:session`. */
 	constructor(key = "itd-api:session") {
-		this.#key = key;
-		this.#available = require_runtime.hasLocalStorage();
+		this.#inner = require_storage.createTokenStorage(new LocalStorageKeyValueStore(), { key });
 	}
 	get() {
-		if (!this.#available) return this.#fallback.get();
-		try {
-			const raw = globalThis.localStorage.getItem(this.#key);
-			if (!raw) return null;
-			const parsed = JSON.parse(raw);
-			return typeof parsed === "object" && parsed !== null ? parsed : null;
-		} catch {
-			return null;
-		}
+		return this.#inner.get();
 	}
 	set(session) {
-		if (this.#available) try {
-			globalThis.localStorage.setItem(this.#key, JSON.stringify(session));
-			return;
-		} catch {
-			this.#degrade();
-		}
-		this.#fallback.set(session);
+		this.#inner.set(session);
 	}
 	clear() {
-		if (this.#available) try {
-			globalThis.localStorage.removeItem(this.#key);
-			return;
-		} catch {
-			this.#degrade();
-		}
-		this.#fallback.clear();
+		this.#inner.clear();
 	}
-	/** Переводит хранилище в память без переноса прежнего значения. */
-	#degrade() {
-		this.#available = false;
-		this.#fallback.clear();
+};
+/**
+* Хранилище сессии поверх браузерного `sessionStorage`.
+*
+* Данные переживают перезагрузку страницы, но существуют только в пределах текущей
+* browser page session. Если `sessionStorage` недоступен, экземпляр молча работает
+* в памяти; после ошибки доступа, записи или удаления он также остаётся в памяти до конца
+* своего жизненного цикла.
+* Повреждённый JSON считается ошибкой, а не отсутствующей сессией.
+*
+* Как и `localStorage`, это хранилище доступно скриптам страницы и не защищает сессию
+* от XSS. Выбирайте его ради более короткого срока жизни, а не ради изоляции секрета.
+*/
+var SessionStorageTokenStorage = class {
+	#inner;
+	/** @param key ключ в `sessionStorage`. По умолчанию `itd-api:session`. */
+	constructor(key = "itd-api:session") {
+		this.#inner = require_storage.createTokenStorage(new SessionStorageKeyValueStore(), { key });
+	}
+	get() {
+		return this.#inner.get();
+	}
+	set(session) {
+		this.#inner.set(session);
+	}
+	clear() {
+		this.#inner.clear();
 	}
 };
 //#endregion
+exports.LocalStorageKeyValueStore = LocalStorageKeyValueStore;
 exports.LocalStorageTokenStorage = LocalStorageTokenStorage;
+exports.SessionStorageKeyValueStore = SessionStorageKeyValueStore;
+exports.SessionStorageTokenStorage = SessionStorageTokenStorage;
 
 //# sourceMappingURL=web.cjs.map

package/dist/web.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"web.cjs","names":["#key","#fallback","MemoryTokenStorage","#available","hasLocalStorage","#degrade"],"sources":["../src/web.ts"],"sourcesContent":["/**\n * `itd-api/web` — хранилище сессии для браузера.\n *\n * Здесь лежит только то, что рассчитано на браузерное окружение. Клиент, аккаунты,\n * билдеры, типы и всё остальное берутся из `itd-api` — одинаково на всех платформах.\n *\n * Отдельная точка входа нужна не сборщику, а вам: {@link LocalStorageTokenStorage}\n * при недоступном `localStorage` молча работает как хранилище в памяти, и такое\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 { hasLocalStorage } from './core/runtime.js';\nimport { type ItdSession, MemoryTokenStorage, type TokenStorage } from './core/storage.js';\n\n/**\n * Хранилище поверх `localStorage` браузера.\n *\n * Если `localStorage` недоступен (приватный режим, серверный рендеринг), молча работает\n * как хранилище в памяти — библиотека не должна падать из-за настроек браузера. Сессия\n * в этом случае теряется при перезагрузке страницы; когда это неприемлемо, проверьте\n * доступность сами или возьмите своё хранилище через `createTokenStorage`.\n *\n * Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,\n * если для вашего приложения это неприемлемый риск.\n *\n * После ошибки записи или удаления хранилище переключается на память до конца\n * своего жизненного цикла.\n */\nexport class LocalStorageTokenStorage implements TokenStorage {\n  readonly #key: string;\n  readonly #fallback = new MemoryTokenStorage();\n  /** Доступен ли `localStorage` для дальнейших операций. */\n  #available: boolean;\n\n  /** @param key ключ в `localStorage`. По умолчанию `itd-api:session`. */\n  constructor(key = 'itd-api:session') {\n    this.#key = key;\n    this.#available = hasLocalStorage();\n  }\n\n  get(): ItdSession | null {\n    if (!this.#available) return this.#fallback.get();\n\n    try {\n      const raw = globalThis.localStorage.getItem(this.#key);\n      if (!raw) return null;\n      const parsed: unknown = JSON.parse(raw);\n      return typeof parsed === 'object' && parsed !== null ? (parsed as ItdSession) : null;\n    } catch {\n      // Повреждённое значение — ведём себя так, будто сессии нет.\n      return null;\n    }\n  }\n\n  set(session: ItdSession): void {\n    if (this.#available) {\n      try {\n        globalThis.localStorage.setItem(this.#key, JSON.stringify(session));\n        return;\n      } catch {\n        this.#degrade();\n      }\n    }\n\n    this.#fallback.set(session);\n  }\n\n  clear(): void {\n    if (this.#available) {\n      try {\n        globalThis.localStorage.removeItem(this.#key);\n        return;\n      } catch {\n        this.#degrade();\n      }\n    }\n\n    this.#fallback.clear();\n  }\n\n  /** Переводит хранилище в память без переноса прежнего значения. */\n  #degrade(): void {\n    this.#available = false;\n    this.#fallback.clear();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,IAAa,2BAAb,MAA8D;CAC5D;CACA,YAAqB,IAAIE,gBAAAA,mBAAmB;;CAE5C;;CAGA,YAAY,MAAM,mBAAmB;EACnC,KAAKF,OAAO;EACZ,KAAKG,aAAaC,gBAAAA,gBAAgB;CACpC;CAEA,MAAyB;EACvB,IAAI,CAAC,KAAKD,YAAY,OAAO,KAAKF,UAAU,IAAI;EAEhD,IAAI;GACF,MAAM,MAAM,WAAW,aAAa,QAAQ,KAAKD,IAAI;GACrD,IAAI,CAAC,KAAK,OAAO;GACjB,MAAM,SAAkB,KAAK,MAAM,GAAG;GACtC,OAAO,OAAO,WAAW,YAAY,WAAW,OAAQ,SAAwB;EAClF,QAAQ;GAEN,OAAO;EACT;CACF;CAEA,IAAI,SAA2B;EAC7B,IAAI,KAAKG,YACP,IAAI;GACF,WAAW,aAAa,QAAQ,KAAKH,MAAM,KAAK,UAAU,OAAO,CAAC;GAClE;EACF,QAAQ;GACN,KAAKK,SAAS;EAChB;EAGF,KAAKJ,UAAU,IAAI,OAAO;CAC5B;CAEA,QAAc;EACZ,IAAI,KAAKE,YACP,IAAI;GACF,WAAW,aAAa,WAAW,KAAKH,IAAI;GAC5C;EACF,QAAQ;GACN,KAAKK,SAAS;EAChB;EAGF,KAAKJ,UAAU,MAAM;CACvB;;CAGA,WAAiB;EACf,KAAKE,aAAa;EAClB,KAAKF,UAAU,MAAM;CACvB;AACF"}
+{"version":3,"file":"web.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 './core/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.d.cts

@@ -1,5 +1,21 @@
-import { r as TokenStorage, t as ItdSession } from "./storage-BjNRlkbE.cjs";
+import { r as TokenStorage, t as ItdSession } from "./storage-Doe3lpFQ.cjs";
 //#region src/web.d.ts
+/** JSON key-value backend поверх браузерного `localStorage` с откатом в память. */
+declare class LocalStorageKeyValueStore<T> {
+  #private;
+  get(key: string): T | undefined;
+  set(key: string, value: T): void;
+  delete(key: string): void;
+  keys(prefix?: string): Iterable<string> | AsyncIterable<string>;
+}
+/** JSON key-value backend поверх браузерного `sessionStorage` с откатом в память. */
+declare class SessionStorageKeyValueStore<T> {
+  #private;
+  get(key: string): T | undefined;
+  set(key: string, value: T): void;
+  delete(key: string): void;
+  keys(prefix?: string): Iterable<string> | AsyncIterable<string>;
+}
 /**
  * Хранилище поверх `localStorage` браузера.
  *
@@ -11,7 +27,8 @@ import { r as TokenStorage, t as ItdSession } from "./storage-BjNRlkbE.cjs";
  * Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,
  * если для вашего приложения это неприемлемый риск.
  *
- * После ошибки записи или удаления хранилище переключается на память до конца
+ * Повреждённый JSON считается ошибкой, а не отсутствующей сессией. После ошибки доступа,
+ * записи или удаления хранилище переключается на память до конца
  * своего жизненного цикла.
  */
 declare class LocalStorageTokenStorage implements TokenStorage {
@@ -22,6 +39,26 @@ declare class LocalStorageTokenStorage implements TokenStorage {
   set(session: ItdSession): void;
   clear(): void;
 }
+/**
+ * Хранилище сессии поверх браузерного `sessionStorage`.
+ *
+ * Данные переживают перезагрузку страницы, но существуют только в пределах текущей
+ * browser page session. Если `sessionStorage` недоступен, экземпляр молча работает
+ * в памяти; после ошибки доступа, записи или удаления он также остаётся в памяти до конца
+ * своего жизненного цикла.
+ * Повреждённый JSON считается ошибкой, а не отсутствующей сессией.
+ *
+ * Как и `localStorage`, это хранилище доступно скриптам страницы и не защищает сессию
+ * от XSS. Выбирайте его ради более короткого срока жизни, а не ради изоляции секрета.
+ */
+declare class SessionStorageTokenStorage implements TokenStorage {
+  #private;
+  /** @param key ключ в `sessionStorage`. По умолчанию `itd-api:session`. */
+  constructor(key?: string);
+  get(): ItdSession | null;
+  set(session: ItdSession): void;
+  clear(): void;
+}
 //#endregion
-export { LocalStorageTokenStorage };
+export { LocalStorageKeyValueStore, LocalStorageTokenStorage, SessionStorageKeyValueStore, SessionStorageTokenStorage };
 //# sourceMappingURL=web.d.cts.map

package/dist/web.d.ts

@@ -1,5 +1,21 @@
-import { r as TokenStorage, t as ItdSession } from "./storage-BjNRlkbE.js";
+import { r as TokenStorage, t as ItdSession } from "./storage-Doe3lpFQ.js";
 //#region src/web.d.ts
+/** JSON key-value backend поверх браузерного `localStorage` с откатом в память. */
+declare class LocalStorageKeyValueStore<T> {
+  #private;
+  get(key: string): T | undefined;
+  set(key: string, value: T): void;
+  delete(key: string): void;
+  keys(prefix?: string): Iterable<string> | AsyncIterable<string>;
+}
+/** JSON key-value backend поверх браузерного `sessionStorage` с откатом в память. */
+declare class SessionStorageKeyValueStore<T> {
+  #private;
+  get(key: string): T | undefined;
+  set(key: string, value: T): void;
+  delete(key: string): void;
+  keys(prefix?: string): Iterable<string> | AsyncIterable<string>;
+}
 /**
  * Хранилище поверх `localStorage` браузера.
  *
@@ -11,7 +27,8 @@ import { r as TokenStorage, t as ItdSession } from "./storage-BjNRlkbE.js";
  * Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,
  * если для вашего приложения это неприемлемый риск.
  *
- * После ошибки записи или удаления хранилище переключается на память до конца
+ * Повреждённый JSON считается ошибкой, а не отсутствующей сессией. После ошибки доступа,
+ * записи или удаления хранилище переключается на память до конца
  * своего жизненного цикла.
  */
 declare class LocalStorageTokenStorage implements TokenStorage {
@@ -22,6 +39,26 @@ declare class LocalStorageTokenStorage implements TokenStorage {
   set(session: ItdSession): void;
   clear(): void;
 }
+/**
+ * Хранилище сессии поверх браузерного `sessionStorage`.
+ *
+ * Данные переживают перезагрузку страницы, но существуют только в пределах текущей
+ * browser page session. Если `sessionStorage` недоступен, экземпляр молча работает
+ * в памяти; после ошибки доступа, записи или удаления он также остаётся в памяти до конца
+ * своего жизненного цикла.
+ * Повреждённый JSON считается ошибкой, а не отсутствующей сессией.
+ *
+ * Как и `localStorage`, это хранилище доступно скриптам страницы и не защищает сессию
+ * от XSS. Выбирайте его ради более короткого срока жизни, а не ради изоляции секрета.
+ */
+declare class SessionStorageTokenStorage implements TokenStorage {
+  #private;
+  /** @param key ключ в `sessionStorage`. По умолчанию `itd-api:session`. */
+  constructor(key?: string);
+  get(): ItdSession | null;
+  set(session: ItdSession): void;
+  clear(): void;
+}
 //#endregion
-export { LocalStorageTokenStorage };
+export { LocalStorageKeyValueStore, LocalStorageTokenStorage, SessionStorageKeyValueStore, SessionStorageTokenStorage };
 //# sourceMappingURL=web.d.ts.map