itd-api 0.7.2 → 0.9.0

package/dist/shared/storage-BPJR_k4-.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage-BPJR_k4-.cjs","names":["ItdConfigError","#values","#store","ItdConfigError"],"sources":["../../src/core/key-value-store.ts","../../src/session/storage.ts"],"sourcesContent":["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 * видимым чтениям только после подтверждения source. Несколько экземпляров или процессов\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 committed: Record<string, T> | undefined;\n  let loading: Promise<Record<string, T>> | undefined;\n  let writes: Promise<void> = Promise.resolve();\n\n  const load = async (): Promise<Record<string, T>> => {\n    if (committed !== undefined) return committed;\n    loading ??= Promise.resolve(source.read())\n      .then((value) => {\n        if (value !== undefined && !isRecord(value)) {\n          throw new ItdConfigError('RecordKeyValueStoreSource.read() должен вернуть объект');\n        }\n        committed = copyRecord(value as Readonly<Record<string, T>> | undefined);\n        return committed;\n      })\n      .finally(() => {\n        loading = undefined;\n      });\n    return loading;\n  };\n\n  /**\n   * Записывает изменение и фиксирует его только после подтверждения source.\n   *\n   * Черновик строится внутри очереди записей, от текущего зафиксированного состояния.\n   *\n   * @param apply вносит изменение в черновик; `false` — менять нечего\n   */\n  const mutate = (apply: (draft: Record<string, T>) => boolean): Promise<void> => {\n    const run = async (): Promise<void> => {\n      const draft = copyRecord(await load());\n      if (!apply(draft)) return;\n\n      if (source.delete && Object.keys(draft).length === 0) await source.delete();\n      else await source.write(draft);\n      committed = draft;\n    };\n    writes = writes.then(run, run);\n    return writes;\n  };\n\n  return {\n    async get(key) {\n      const current = await load();\n      return Object.hasOwn(current, key) ? current[key] : undefined;\n    },\n    set(key, value) {\n      return mutate((draft) => {\n        draft[key] = value;\n        return true;\n      });\n    },\n    delete(key) {\n      return mutate((draft) => {\n        if (!Object.hasOwn(draft, key)) return false;\n        delete draft[key];\n        return true;\n      });\n    },\n    async keys(prefix = '') {\n      const current = await load();\n      return Object.keys(current).filter((key) => key.startsWith(prefix));\n    },\n  };\n}\n","import { ItdConfigError } from '../core/errors.js';\nimport {\n  createKeyValueStore,\n  type KeyValueStore,\n  MemoryKeyValueStore,\n} from '../core/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/shared/storage-C_eICCep.d.cts

@@ -1,152 +0,0 @@
-//#region src/core/key-value-store.d.ts
-/** Синхронный или асинхронный результат операции хранилища. */
-type KeyValueStoreResult<T> = T | Promise<T>;
-/** Синхронный или асинхронный источник ключей. */
-type KeyValueStoreKeys = Iterable<string> | AsyncIterable<string>;
-/**
- * Минимальный backend именованных значений.
- *
- * Контракт ничего не знает о сессиях, сериализации или конкретной базе данных. Значение
- * `undefined` означает отсутствие ключа; хранить `undefined` как самостоятельное значение нельзя.
- */
-interface KeyValueStore<T> {
-  /** Читает значение либо возвращает `undefined`, если ключ отсутствует. */
-  get(key: string): KeyValueStoreResult<T | undefined>;
-  /** Полностью заменяет значение ключа. */
-  set(key: string, value: T): KeyValueStoreResult<void>;
-  /** Удаляет ключ. Отсутствующий ключ не должен считаться ошибкой. */
-  delete(key: string): KeyValueStoreResult<void>;
-  /** Перечисляет ключи, при возможности ограничивая их префиксом. */
-  keys?(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;
-}
-/** Backend, который гарантированно умеет перечислять ключи. */
-interface EnumerableKeyValueStore<T> extends KeyValueStore<T> {
-  keys(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;
-}
-/** Кодирует значения для хранения в backend другого типа. */
-interface KeyValueCodec<T, Stored> {
-  /** Преобразует доменное значение перед записью. */
-  encode(value: T): KeyValueStoreResult<Stored>;
-  /** Восстанавливает доменное значение после чтения. */
-  decode(value: Stored): KeyValueStoreResult<T>;
-}
-/** Источник одной записи, содержащей всю карту key-value. */
-interface RecordKeyValueStoreSource<T> {
-  /** Читает всю карту. `undefined` означает отсутствие записи. */
-  read(): KeyValueStoreResult<Readonly<Record<string, T>> | undefined>;
-  /** Записывает стабильный снимок всей карты. */
-  write(record: Readonly<Record<string, T>>): KeyValueStoreResult<void>;
-  /** Удаляет запись, когда карта становится пустой. */
-  delete?(): KeyValueStoreResult<void>;
-}
-declare function createKeyValueStore<T>(handlers: EnumerableKeyValueStore<T>): EnumerableKeyValueStore<T>;
-declare function createKeyValueStore<T>(handlers: KeyValueStore<T>): KeyValueStore<T>;
-/** Проверяет доступность перечисления ключей. */
-declare function isEnumerableKeyValueStore<T>(store: KeyValueStore<T>): store is EnumerableKeyValueStore<T>;
-/** Key-value backend в памяти процесса. Значения сохраняются по ссылке. */
-declare class MemoryKeyValueStore<T> implements EnumerableKeyValueStore<T> {
-  #private;
-  constructor(initial?: Iterable<readonly [string, T]>);
-  get(key: string): T | undefined;
-  set(key: string, value: T): void;
-  delete(key: string): void;
-  keys(prefix?: string): string[];
-}
-declare function withNamespace<T>(store: EnumerableKeyValueStore<T>, namespace: string, separator?: string): EnumerableKeyValueStore<T>;
-declare function withNamespace<T>(store: KeyValueStore<T>, namespace: string, separator?: string): KeyValueStore<T>;
-declare function withCodec<T, Stored>(store: EnumerableKeyValueStore<Stored>, codec: KeyValueCodec<T, Stored>): EnumerableKeyValueStore<T>;
-declare function withCodec<T, Stored>(store: KeyValueStore<Stored>, codec: KeyValueCodec<T, Stored>): KeyValueStore<T>;
-/**
- * Создаёт key-value backend поверх одной общей записи.
- *
- * Чтение выполняется один раз, а записи выстраиваются последовательно. Изменение становится
- * видимым чтениям только после подтверждения source. Несколько экземпляров или процессов
- * требуют внешней синхронизации со стороны source.
- */
-declare function createRecordKeyValueStore<T>(source: RecordKeyValueStoreSource<T>): EnumerableKeyValueStore<T>;
-//#endregion
-//#region src/session/storage.d.ts
-/**
- * Сохранённая сессия.
- *
- * Кроме токенов сюда попадают cookie: refresh-токен итд.com живёт именно в cookie, и без них
- * восстановить сессию после перезапуска процесса невозможно.
- */
-interface ItdSession {
-  /** Токен доступа для заголовка `Authorization: Bearer`. */
-  accessToken?: string | undefined;
-  /**
-   * Refresh-токен, если удалось получить его явным значением.
-   *
-   * Обычно сервер держит его в httpOnly-cookie и наружу не отдаёт — тогда поле останется
-   * пустым, а обновление пойдёт через {@link ItdSession.cookies}.
-   */
-  refreshToken?: string | undefined;
-  /** Сырые cookie в форме `имя=значение`, привязанные к origin API. */
-  cookies?: string[] | undefined;
-  /**
-   * Идентификатор устройства для заголовка `X-Device-Id`.
-   *
-   * Сервер различает по нему записи в списке сессий, поэтому значение должно пережить
-   * перезапуск процесса — иначе каждый старт бота порождает новую сессию. Библиотека
-   * заводит его сама при первом запросе и хранит здесь.
-   */
-  deviceId?: string | undefined;
-  /** Когда сессия получена, мс с начала эпохи. Нужно для диагностики. */
-  obtainedAt?: number | undefined;
-}
-/**
- * Хранилище сессии.
- *
- * Подключаемый компонент: библиотека не знает, где вы держите токены, и обращается к ним
- * только через этот интерфейс. Все методы могут быть как синхронными, так и асинхронными.
- *
- * @example Своё хранилище поверх AsyncStorage в React Native
- * ```ts
- * const backend = withCodec(createKeyValueStore({
- *   get: (key) => AsyncStorage.getItem(key).then((value) => value ?? undefined),
- *   set: (key, value) => AsyncStorage.setItem(key, value),
- *   delete: (key) => AsyncStorage.removeItem(key),
- * }), { encode: JSON.stringify, decode: JSON.parse });
- * const storage = createTokenStorage(withNamespace(backend, 'my-app'));
- * ```
- */
-interface TokenStorage {
-  /** Прочитать сессию. `null`, если её нет. */
-  get(): ItdSession | null | Promise<ItdSession | null>;
-  /** Сохранить сессию целиком. */
-  set(session: ItdSession): void | Promise<void>;
-  /** Удалить сессию. Вызывается при выходе и при неудачном обновлении токена. */
-  clear(): void | Promise<void>;
-}
-/**
- * Хранилище в памяти процесса — вариант по умолчанию.
- *
- * Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`
- * из `itd-api/node`, для браузера — `LocalStorageTokenStorage` или
- * `SessionStorageTokenStorage` из `itd-api/web`.
- */
-declare class MemoryTokenStorage implements TokenStorage {
-  #private;
-  constructor(initial?: ItdSession | null);
-  get(): ItdSession | null;
-  set(session: ItdSession): void;
-  clear(): void;
-}
-/** Настройки доменного адаптера одной сессии. */
-interface TokenStorageAdapterOptions {
-  /** Ключ сессии в backend. По умолчанию `session`. */
-  key?: string | undefined;
-}
-/**
- * Создаёт доменное хранилище сессии поверх общего {@link KeyValueStore}.
- *
- * @example
- * ```ts
- * const storage = createTokenStorage(withNamespace(redisStore, 'itd'));
- * ```
- */
-declare function createTokenStorage(store: KeyValueStore<ItdSession>, options?: TokenStorageAdapterOptions): TokenStorage;
-//#endregion
-export { withNamespace as _, createTokenStorage as a, KeyValueStore as c, MemoryKeyValueStore as d, RecordKeyValueStoreSource as f, withCodec as g, isEnumerableKeyValueStore as h, TokenStorageAdapterOptions as i, KeyValueStoreKeys as l, createRecordKeyValueStore as m, MemoryTokenStorage as n, EnumerableKeyValueStore as o, createKeyValueStore as p, TokenStorage as r, KeyValueCodec as s, ItdSession as t, KeyValueStoreResult as u };
-//# sourceMappingURL=storage-C_eICCep.d.cts.map

package/dist/shared/storage-C_eICCep.d.ts

@@ -1,152 +0,0 @@
-//#region src/core/key-value-store.d.ts
-/** Синхронный или асинхронный результат операции хранилища. */
-type KeyValueStoreResult<T> = T | Promise<T>;
-/** Синхронный или асинхронный источник ключей. */
-type KeyValueStoreKeys = Iterable<string> | AsyncIterable<string>;
-/**
- * Минимальный backend именованных значений.
- *
- * Контракт ничего не знает о сессиях, сериализации или конкретной базе данных. Значение
- * `undefined` означает отсутствие ключа; хранить `undefined` как самостоятельное значение нельзя.
- */
-interface KeyValueStore<T> {
-  /** Читает значение либо возвращает `undefined`, если ключ отсутствует. */
-  get(key: string): KeyValueStoreResult<T | undefined>;
-  /** Полностью заменяет значение ключа. */
-  set(key: string, value: T): KeyValueStoreResult<void>;
-  /** Удаляет ключ. Отсутствующий ключ не должен считаться ошибкой. */
-  delete(key: string): KeyValueStoreResult<void>;
-  /** Перечисляет ключи, при возможности ограничивая их префиксом. */
-  keys?(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;
-}
-/** Backend, который гарантированно умеет перечислять ключи. */
-interface EnumerableKeyValueStore<T> extends KeyValueStore<T> {
-  keys(prefix?: string): KeyValueStoreResult<KeyValueStoreKeys>;
-}
-/** Кодирует значения для хранения в backend другого типа. */
-interface KeyValueCodec<T, Stored> {
-  /** Преобразует доменное значение перед записью. */
-  encode(value: T): KeyValueStoreResult<Stored>;
-  /** Восстанавливает доменное значение после чтения. */
-  decode(value: Stored): KeyValueStoreResult<T>;
-}
-/** Источник одной записи, содержащей всю карту key-value. */
-interface RecordKeyValueStoreSource<T> {
-  /** Читает всю карту. `undefined` означает отсутствие записи. */
-  read(): KeyValueStoreResult<Readonly<Record<string, T>> | undefined>;
-  /** Записывает стабильный снимок всей карты. */
-  write(record: Readonly<Record<string, T>>): KeyValueStoreResult<void>;
-  /** Удаляет запись, когда карта становится пустой. */
-  delete?(): KeyValueStoreResult<void>;
-}
-declare function createKeyValueStore<T>(handlers: EnumerableKeyValueStore<T>): EnumerableKeyValueStore<T>;
-declare function createKeyValueStore<T>(handlers: KeyValueStore<T>): KeyValueStore<T>;
-/** Проверяет доступность перечисления ключей. */
-declare function isEnumerableKeyValueStore<T>(store: KeyValueStore<T>): store is EnumerableKeyValueStore<T>;
-/** Key-value backend в памяти процесса. Значения сохраняются по ссылке. */
-declare class MemoryKeyValueStore<T> implements EnumerableKeyValueStore<T> {
-  #private;
-  constructor(initial?: Iterable<readonly [string, T]>);
-  get(key: string): T | undefined;
-  set(key: string, value: T): void;
-  delete(key: string): void;
-  keys(prefix?: string): string[];
-}
-declare function withNamespace<T>(store: EnumerableKeyValueStore<T>, namespace: string, separator?: string): EnumerableKeyValueStore<T>;
-declare function withNamespace<T>(store: KeyValueStore<T>, namespace: string, separator?: string): KeyValueStore<T>;
-declare function withCodec<T, Stored>(store: EnumerableKeyValueStore<Stored>, codec: KeyValueCodec<T, Stored>): EnumerableKeyValueStore<T>;
-declare function withCodec<T, Stored>(store: KeyValueStore<Stored>, codec: KeyValueCodec<T, Stored>): KeyValueStore<T>;
-/**
- * Создаёт key-value backend поверх одной общей записи.
- *
- * Чтение выполняется один раз, а записи выстраиваются последовательно. Изменение становится
- * видимым чтениям только после подтверждения source. Несколько экземпляров или процессов
- * требуют внешней синхронизации со стороны source.
- */
-declare function createRecordKeyValueStore<T>(source: RecordKeyValueStoreSource<T>): EnumerableKeyValueStore<T>;
-//#endregion
-//#region src/session/storage.d.ts
-/**
- * Сохранённая сессия.
- *
- * Кроме токенов сюда попадают cookie: refresh-токен итд.com живёт именно в cookie, и без них
- * восстановить сессию после перезапуска процесса невозможно.
- */
-interface ItdSession {
-  /** Токен доступа для заголовка `Authorization: Bearer`. */
-  accessToken?: string | undefined;
-  /**
-   * Refresh-токен, если удалось получить его явным значением.
-   *
-   * Обычно сервер держит его в httpOnly-cookie и наружу не отдаёт — тогда поле останется
-   * пустым, а обновление пойдёт через {@link ItdSession.cookies}.
-   */
-  refreshToken?: string | undefined;
-  /** Сырые cookie в форме `имя=значение`, привязанные к origin API. */
-  cookies?: string[] | undefined;
-  /**
-   * Идентификатор устройства для заголовка `X-Device-Id`.
-   *
-   * Сервер различает по нему записи в списке сессий, поэтому значение должно пережить
-   * перезапуск процесса — иначе каждый старт бота порождает новую сессию. Библиотека
-   * заводит его сама при первом запросе и хранит здесь.
-   */
-  deviceId?: string | undefined;
-  /** Когда сессия получена, мс с начала эпохи. Нужно для диагностики. */
-  obtainedAt?: number | undefined;
-}
-/**
- * Хранилище сессии.
- *
- * Подключаемый компонент: библиотека не знает, где вы держите токены, и обращается к ним
- * только через этот интерфейс. Все методы могут быть как синхронными, так и асинхронными.
- *
- * @example Своё хранилище поверх AsyncStorage в React Native
- * ```ts
- * const backend = withCodec(createKeyValueStore({
- *   get: (key) => AsyncStorage.getItem(key).then((value) => value ?? undefined),
- *   set: (key, value) => AsyncStorage.setItem(key, value),
- *   delete: (key) => AsyncStorage.removeItem(key),
- * }), { encode: JSON.stringify, decode: JSON.parse });
- * const storage = createTokenStorage(withNamespace(backend, 'my-app'));
- * ```
- */
-interface TokenStorage {
-  /** Прочитать сессию. `null`, если её нет. */
-  get(): ItdSession | null | Promise<ItdSession | null>;
-  /** Сохранить сессию целиком. */
-  set(session: ItdSession): void | Promise<void>;
-  /** Удалить сессию. Вызывается при выходе и при неудачном обновлении токена. */
-  clear(): void | Promise<void>;
-}
-/**
- * Хранилище в памяти процесса — вариант по умолчанию.
- *
- * Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`
- * из `itd-api/node`, для браузера — `LocalStorageTokenStorage` или
- * `SessionStorageTokenStorage` из `itd-api/web`.
- */
-declare class MemoryTokenStorage implements TokenStorage {
-  #private;
-  constructor(initial?: ItdSession | null);
-  get(): ItdSession | null;
-  set(session: ItdSession): void;
-  clear(): void;
-}
-/** Настройки доменного адаптера одной сессии. */
-interface TokenStorageAdapterOptions {
-  /** Ключ сессии в backend. По умолчанию `session`. */
-  key?: string | undefined;
-}
-/**
- * Создаёт доменное хранилище сессии поверх общего {@link KeyValueStore}.
- *
- * @example
- * ```ts
- * const storage = createTokenStorage(withNamespace(redisStore, 'itd'));
- * ```
- */
-declare function createTokenStorage(store: KeyValueStore<ItdSession>, options?: TokenStorageAdapterOptions): TokenStorage;
-//#endregion
-export { withNamespace as _, createTokenStorage as a, KeyValueStore as c, MemoryKeyValueStore as d, RecordKeyValueStoreSource as f, withCodec as g, isEnumerableKeyValueStore as h, TokenStorageAdapterOptions as i, KeyValueStoreKeys as l, createRecordKeyValueStore as m, MemoryTokenStorage as n, EnumerableKeyValueStore as o, createKeyValueStore as p, TokenStorage as r, KeyValueCodec as s, ItdSession as t, KeyValueStoreResult as u };
-//# sourceMappingURL=storage-C_eICCep.d.ts.map

package/dist/shared/storage-D86edNCB.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage-D86edNCB.js","names":["#values","#store"],"sources":["../../src/core/key-value-store.ts","../../src/session/storage.ts"],"sourcesContent":["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 * видимым чтениям только после подтверждения source. Несколько экземпляров или процессов\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 committed: Record<string, T> | undefined;\n  let loading: Promise<Record<string, T>> | undefined;\n  let writes: Promise<void> = Promise.resolve();\n\n  const load = async (): Promise<Record<string, T>> => {\n    if (committed !== undefined) return committed;\n    loading ??= Promise.resolve(source.read())\n      .then((value) => {\n        if (value !== undefined && !isRecord(value)) {\n          throw new ItdConfigError('RecordKeyValueStoreSource.read() должен вернуть объект');\n        }\n        committed = copyRecord(value as Readonly<Record<string, T>> | undefined);\n        return committed;\n      })\n      .finally(() => {\n        loading = undefined;\n      });\n    return loading;\n  };\n\n  /**\n   * Записывает изменение и фиксирует его только после подтверждения source.\n   *\n   * Черновик строится внутри очереди записей, от текущего зафиксированного состояния.\n   *\n   * @param apply вносит изменение в черновик; `false` — менять нечего\n   */\n  const mutate = (apply: (draft: Record<string, T>) => boolean): Promise<void> => {\n    const run = async (): Promise<void> => {\n      const draft = copyRecord(await load());\n      if (!apply(draft)) return;\n\n      if (source.delete && Object.keys(draft).length === 0) await source.delete();\n      else await source.write(draft);\n      committed = draft;\n    };\n    writes = writes.then(run, run);\n    return writes;\n  };\n\n  return {\n    async get(key) {\n      const current = await load();\n      return Object.hasOwn(current, key) ? current[key] : undefined;\n    },\n    set(key, value) {\n      return mutate((draft) => {\n        draft[key] = value;\n        return true;\n      });\n    },\n    delete(key) {\n      return mutate((draft) => {\n        if (!Object.hasOwn(draft, key)) return false;\n        delete draft[key];\n        return true;\n      });\n    },\n    async keys(prefix = '') {\n      const current = await load();\n      return Object.keys(current).filter((key) => key.startsWith(prefix));\n    },\n  };\n}\n","import { ItdConfigError } from '../core/errors.js';\nimport {\n  createKeyValueStore,\n  type KeyValueStore,\n  MemoryKeyValueStore,\n} from '../core/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":";;AAgDA,SAAS,SAAS,OAA4D;CAC5E,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,aAAa,OAAyD;CAC7E,MAAM,QAAQ;CACd,IAAI,CAAC,SAAS,KAAK,GAAG,MAAM,IAAI,eAAe,oCAAoC;CACnF,KAAK,MAAM,UAAU;EAAC;EAAO;EAAO;CAAQ,GAC1C,IAAI,OAAO,MAAM,YAAY,YAC3B,MAAM,IAAI,eAAe,iBAAiB,OAAO,sBAAsB;CAG3E,IAAI,MAAM,SAAS,KAAA,KAAa,OAAO,MAAM,SAAS,YACpD,MAAM,IAAI,eAAe,yCAAyC;AAEtE;;AAOA,SAAgB,oBAAuB,UAA8C;CACnF,aAAa,QAAQ;CACrB,OAAO;AACT;;AAGA,SAAgB,0BACd,OACqC;CACrC,OAAO,OAAO,MAAM,SAAS;AAC/B;;AAGA,eAAsB,yBACpB,OACA,QACmB;CACnB,MAAM,SAAS,MAAM,MAAM,KAAK,MAAM;CACtC,MAAM,SAAmB,CAAC;CAC1B,WAAW,MAAM,OAAO,QAAQ;EAC9B,IAAI,OAAO,QAAQ,UACjB,MAAM,IAAI,eAAe,sDAAsD;EAEjF,IAAI,WAAW,KAAA,KAAa,IAAI,WAAW,MAAM,GAAG,OAAO,KAAK,GAAG;CACrE;CACA,OAAO;AACT;;AAGA,IAAa,sBAAb,MAA0E;CACxE,0BAAmB,IAAI,IAAe;CAEtC,YAAY,SAA0C;EACpD,KAAK,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAG,KAAKA,QAAQ,IAAI,KAAK,KAAK;CACvE;CAEA,IAAI,KAA4B;EAC9B,OAAO,KAAKA,QAAQ,IAAI,GAAG;CAC7B;CAEA,IAAI,KAAa,OAAgB;EAC/B,KAAKA,QAAQ,IAAI,KAAK,KAAK;CAC7B;CAEA,OAAO,KAAmB;EACxB,KAAKA,QAAQ,OAAO,GAAG;CACzB;CAEA,KAAK,SAAS,IAAc;EAC1B,OAAO,CAAC,GAAG,KAAKA,QAAQ,KAAK,CAAC,CAAC,CAAC,QAAQ,QAAQ,IAAI,WAAW,MAAM,CAAC;CACxE;AACF;;AAaA,SAAgB,cACd,OACA,WACA,YAAY,KACM;CAClB,aAAa,KAAK;CAClB,IAAI,OAAO,cAAc,YAAY,OAAO,cAAc,UACxD,MAAM,IAAI,eAAe,0DAA0D;CAErF,MAAM,OAAO,UAAU,WAAW,IAAI,KAAK,GAAG,YAAY;CAC1D,MAAM,OAAO,UAAkB,GAAG,OAAO;CACzC,MAAM,aAA+B;EACnC,MAAM,UAAU,MAAM,IAAI,IAAI,KAAK,CAAC;EACpC,MAAM,OAAO,SAAS,MAAM,IAAI,IAAI,KAAK,GAAG,IAAI;EAChD,SAAS,UAAU,MAAM,OAAO,IAAI,KAAK,CAAC;CAC5C;CAEA,IAAI,0BAA0B,KAAK,GACjC,WAAW,OAAO,OAAO,SAAS,OAAO;EAEvC,QAAO,MADY,yBAAyB,OAAO,IAAI,MAAM,CAAC,EAAA,CAClD,KAAK,UAAU,MAAM,MAAM,KAAK,MAAM,CAAC;CACrD;CAEF,OAAO;AACT;;AAWA,SAAgB,UACd,OACA,OACkB;CAClB,aAAa,KAAK;CAClB,IACE,CAAC,SAAS,KAAK,KACf,OAAO,MAAM,WAAW,cACxB,OAAO,MAAM,WAAW,YAExB,MAAM,IAAI,eAAe,gDAAgD;CAE3E,MAAM,UAA4B;EAChC,MAAM,IAAI,KAAK;GACb,MAAM,QAAQ,MAAM,MAAM,IAAI,GAAG;GACjC,OAAO,UAAU,KAAA,IAAY,KAAA,IAAY,MAAM,OAAO,KAAK;EAC7D;EACA,MAAM,IAAI,KAAK,OAAO;GACpB,MAAM,MAAM,IAAI,KAAK,MAAM,MAAM,OAAO,KAAK,CAAC;EAChD;EACA,SAAS,QAAQ,MAAM,OAAO,GAAG;CACnC;CACA,IAAI,0BAA0B,KAAK,GAAG,QAAQ,QAAQ,WAAW,MAAM,KAAK,MAAM;CAClF,OAAO;AACT;;AAGA,SAAS,cAAoC;CAC3C,OAAO,OAAO,OAAO,IAAI;AAC3B;AAEA,SAAS,WAAc,QAAoE;CACzF,MAAM,OAAO,YAAe;CAC5B,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,UAAU,CAAC,CAAC,GAAG,KAAK,OAAO;CACrE,OAAO;AACT;;;;;;;;AASA,SAAgB,0BACd,QAC4B;CAC5B,IACE,CAAC,SAAS,MAAM,KAChB,OAAO,OAAO,SAAS,cACvB,OAAO,OAAO,UAAU,YAExB,MAAM,IAAI,eAAe,yDAAyD;CAEpF,IAAI,OAAO,WAAW,KAAA,KAAa,OAAO,OAAO,WAAW,YAC1D,MAAM,IAAI,eAAe,uDAAuD;CAGlF,IAAI;CACJ,IAAI;CACJ,IAAI,SAAwB,QAAQ,QAAQ;CAE5C,MAAM,OAAO,YAAwC;EACnD,IAAI,cAAc,KAAA,GAAW,OAAO;EACpC,YAAY,QAAQ,QAAQ,OAAO,KAAK,CAAC,CAAC,CACvC,MAAM,UAAU;GACf,IAAI,UAAU,KAAA,KAAa,CAAC,SAAS,KAAK,GACxC,MAAM,IAAI,eAAe,wDAAwD;GAEnF,YAAY,WAAW,KAAgD;GACvE,OAAO;EACT,CAAC,CAAC,CACD,cAAc;GACb,UAAU,KAAA;EACZ,CAAC;EACH,OAAO;CACT;;;;;;;;CASA,MAAM,UAAU,UAAgE;EAC9E,MAAM,MAAM,YAA2B;GACrC,MAAM,QAAQ,WAAW,MAAM,KAAK,CAAC;GACrC,IAAI,CAAC,MAAM,KAAK,GAAG;GAEnB,IAAI,OAAO,UAAU,OAAO,KAAK,KAAK,CAAC,CAAC,WAAW,GAAG,MAAM,OAAO,OAAO;QACrE,MAAM,OAAO,MAAM,KAAK;GAC7B,YAAY;EACd;EACA,SAAS,OAAO,KAAK,KAAK,GAAG;EAC7B,OAAO;CACT;CAEA,OAAO;EACL,MAAM,IAAI,KAAK;GACb,MAAM,UAAU,MAAM,KAAK;GAC3B,OAAO,OAAO,OAAO,SAAS,GAAG,IAAI,QAAQ,OAAO,KAAA;EACtD;EACA,IAAI,KAAK,OAAO;GACd,OAAO,QAAQ,UAAU;IACvB,MAAM,OAAO;IACb,OAAO;GACT,CAAC;EACH;EACA,OAAO,KAAK;GACV,OAAO,QAAQ,UAAU;IACvB,IAAI,CAAC,OAAO,OAAO,OAAO,GAAG,GAAG,OAAO;IACvC,OAAO,MAAM;IACb,OAAO;GACT,CAAC;EACH;EACA,MAAM,KAAK,SAAS,IAAI;GACtB,MAAM,UAAU,MAAM,KAAK;GAC3B,OAAO,OAAO,KAAK,OAAO,CAAC,CAAC,QAAQ,QAAQ,IAAI,WAAW,MAAM,CAAC;EACpE;CACF;AACF;;;;;;;;;;;;ACpPA,SAAgB,YAAY,SAAiC;CAC3D,OAAO;EACL,GAAG;EACH,GAAI,QAAQ,UAAU,EAAE,SAAS,CAAC,GAAG,QAAQ,OAAO,EAAE,IAAI,CAAC;CAC7D;AACF;;;;;;;;AAkCA,IAAa,qBAAb,MAAwD;CACtD,SAAkB,IAAI,oBAAgC;CAEtD,YAAY,SAA6B;EACvC,IAAI,SAAS,KAAKC,OAAO,IAAI,mBAAmB,YAAY,OAAO,CAAC;CACtE;CAEA,MAAyB;EACvB,MAAM,UAAU,KAAKA,OAAO,IAAI,iBAAiB;EACjD,OAAO,UAAU,YAAY,OAAO,IAAI;CAC1C;CAEA,IAAI,SAA2B;EAC7B,KAAKA,OAAO,IAAI,mBAAmB,YAAY,OAAO,CAAC;CACzD;CAEA,QAAc;EACZ,KAAKA,OAAO,OAAO,iBAAiB;CACtC;AACF;AAEA,MAAM,oBAAoB;AAQ1B,SAAS,UAAa,OAA4C;CAChE,OACE,OAAO,UAAU,YAAY,UAAU,QAAQ,OAAQ,MAAqB,SAAS;AAEzF;;;;;;;;;AAUA,SAAgB,mBACd,OACA,UAAsC,CAAC,GACzB;CACd,MAAM,MAAM,QAAQ,OAAO;CAC3B,IAAI,OAAO,QAAQ,UAAU,MAAM,IAAI,eAAe,sCAAsC;CAC5F,MAAM,UAAU,oBAAoB,KAAK;CACzC,OAAO;EACL,MAAM;GACJ,MAAM,QAAQ,QAAQ,IAAI,GAAG;GAC7B,IAAI,UAAU,KAAK,GACjB,OAAO,MAAM,MAAM,YAAa,UAAU,YAAY,OAAO,IAAI,IAAK;GAExE,OAAO,QAAQ,YAAY,KAAK,IAAI;EACtC;EACA,MAAM,YAAY,QAAQ,IAAI,KAAK,YAAY,OAAO,CAAC;EACvD,aAAa,QAAQ,OAAO,GAAG;CACjC;AACF"}