itd-api 0.4.0 → 0.5.0

package/dist/storage-Doe3lpFQ.d.cts

@@ -0,0 +1,152 @@
+//#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.
+ */
+declare function createRecordKeyValueStore<T>(source: RecordKeyValueStoreSource<T>): EnumerableKeyValueStore<T>;
+//#endregion
+//#region src/core/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-Doe3lpFQ.d.cts.map

package/dist/storage-Doe3lpFQ.d.ts

@@ -0,0 +1,152 @@
+//#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.
+ */
+declare function createRecordKeyValueStore<T>(source: RecordKeyValueStoreSource<T>): EnumerableKeyValueStore<T>;
+//#endregion
+//#region src/core/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-Doe3lpFQ.d.ts.map

package/dist/{storage-ycBqLBRB.cjs → storage-dF8Tio5y.cjs}

@@ -15,6 +15,8 @@ const ItdErrorKind = Object.freeze({
 	Timeout: "timeout",
 	/** Запрос отменён через `AbortSignal`. */
 	Abort: "abort",
+	/** Операция невозможна в текущем состоянии объекта. */
+	State: "state",
 	/** Не удалось получить или подготовить содержимое вложения. */
 	File: "file",
 	/** Некорректная конфигурация или аргументы — обнаружено до обращения к сети. */
@@ -300,14 +302,26 @@ var ItdAbortError = class extends ItdError {
 	}
 };
 /**
+* Операция невозможна в текущем состоянии объекта.
+*
+* Например, клиент уже окончательно освобождён через `dispose()` и не может выполнять
+* новые запросы или создавать realtime-потоки.
+*/
+var ItdStateError = class extends ItdError {
+	constructor(message, options) {
+		super(ItdErrorKind.State, message, options);
+		this.name = "ItdStateError";
+	}
+};
+/**
 * Некорректная конфигурация или аргументы — обнаружено до обращения к сети.
 *
 * Этим же классом сообщают о нарушенных инвариантах билдеры: например, опрос
 * с одним вариантом ответа.
 */
 var ItdConfigError = class extends ItdError {
-	constructor(message) {
-		super(ItdErrorKind.Config, message);
+	constructor(message, options) {
+		super(ItdErrorKind.Config, message, options);
 		this.name = "ItdConfigError";
 	}
 };
@@ -323,6 +337,10 @@ function isItdApiError(value) {
 function isItdFileError(value) {
 	return isItdError(value) && value.kind === ItdErrorKind.File;
 }
+/** Операция невозможна в текущем состоянии объекта. */
+function isItdStateError(value) {
+	return isItdError(value) && value.kind === ItdErrorKind.State;
+}
 /**
 * Проверяет разновидность ошибки API.
 *
@@ -366,6 +384,158 @@ function isItdServerError(value) {
 	return hasApiKind(value, ItdApiErrorKind.Server);
 }
 //#endregion
+//#region src/core/key-value-store.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requireStore(value) {
+	const store = value;
+	if (!isRecord(store)) throw new ItdConfigError("KeyValueStore должен быть объектом");
+	for (const method of [
+		"get",
+		"set",
+		"delete"
+	]) if (typeof store[method] !== "function") throw new ItdConfigError(`KeyValueStore.${method} должен быть функцией`);
+	if (store.keys !== void 0 && typeof store.keys !== "function") throw new ItdConfigError("KeyValueStore.keys должен быть функцией");
+}
+/** Собирает {@link KeyValueStore} из функций конкретного backend. */
+function createKeyValueStore(handlers) {
+	requireStore(handlers);
+	return handlers;
+}
+/** Проверяет доступность перечисления ключей. */
+function isEnumerableKeyValueStore(store) {
+	return typeof store.keys === "function";
+}
+/** @internal */
+async function collectKeyValueStoreKeys(store, prefix) {
+	const source = await store.keys(prefix);
+	const result = [];
+	for await (const key of source) {
+		if (typeof key !== "string") throw new ItdConfigError("KeyValueStore.keys() должен возвращать только строки");
+		if (prefix === void 0 || key.startsWith(prefix)) result.push(key);
+	}
+	return result;
+}
+/** Key-value backend в памяти процесса. Значения сохраняются по ссылке. */
+var MemoryKeyValueStore = class {
+	#values = /* @__PURE__ */ new Map();
+	constructor(initial) {
+		for (const [key, value] of initial ?? []) this.#values.set(key, value);
+	}
+	get(key) {
+		return this.#values.get(key);
+	}
+	set(key, value) {
+		this.#values.set(key, value);
+	}
+	delete(key) {
+		this.#values.delete(key);
+	}
+	keys(prefix = "") {
+		return [...this.#values.keys()].filter((key) => key.startsWith(prefix));
+	}
+};
+/** Добавляет namespace ко всем ключам, не меняя исходный backend. */
+function withNamespace(store, namespace, separator = ":") {
+	requireStore(store);
+	if (typeof namespace !== "string" || typeof separator !== "string") throw new ItdConfigError("namespace и separator KeyValueStore должны быть строками");
+	const base = namespace.length === 0 ? "" : `${namespace}${separator}`;
+	const key = (value) => `${base}${value}`;
+	const namespaced = {
+		get: (value) => store.get(key(value)),
+		set: (value, data) => store.set(key(value), data),
+		delete: (value) => store.delete(key(value))
+	};
+	if (isEnumerableKeyValueStore(store)) namespaced.keys = async (prefix = "") => {
+		return (await collectKeyValueStoreKeys(store, key(prefix))).map((value) => value.slice(base.length));
+	};
+	return namespaced;
+}
+/** Преобразует значения на границе backend, сохраняя его пространство ключей. */
+function withCodec(store, codec) {
+	requireStore(store);
+	if (!isRecord(codec) || typeof codec.encode !== "function" || typeof codec.decode !== "function") throw new ItdConfigError("codec должен содержать функции encode и decode");
+	const encoded = {
+		async get(key) {
+			const value = await store.get(key);
+			return value === void 0 ? void 0 : codec.decode(value);
+		},
+		async set(key, value) {
+			await store.set(key, await codec.encode(value));
+		},
+		delete: (key) => store.delete(key)
+	};
+	if (isEnumerableKeyValueStore(store)) encoded.keys = (prefix) => store.keys(prefix);
+	return encoded;
+}
+/** Создаёт запись без прототипа, чтобы любые пользовательские ключи оставались данными. */
+function emptyRecord() {
+	return Object.create(null);
+}
+function copyRecord(record) {
+	const copy = emptyRecord();
+	for (const [key, value] of Object.entries(record ?? {})) copy[key] = value;
+	return copy;
+}
+/**
+* Создаёт key-value backend поверх одной общей записи.
+*
+* Чтение выполняется один раз, изменения сразу попадают в локальный снимок, а записи
+* выстраиваются последовательно. Несколько экземпляров или процессов требуют внешней
+* синхронизации со стороны source.
+*/
+function createRecordKeyValueStore(source) {
+	if (!isRecord(source) || typeof source.read !== "function" || typeof source.write !== "function") throw new ItdConfigError("RecordKeyValueStoreSource должен содержать read и write");
+	if (source.delete !== void 0 && typeof source.delete !== "function") throw new ItdConfigError("RecordKeyValueStoreSource.delete должен быть функцией");
+	let snapshot;
+	let loading;
+	let writing = Promise.resolve();
+	const load = async () => {
+		if (snapshot !== void 0) return snapshot;
+		loading ??= Promise.resolve(source.read()).then((value) => {
+			if (value !== void 0 && !isRecord(value)) throw new ItdConfigError("RecordKeyValueStoreSource.read() должен вернуть объект");
+			snapshot = copyRecord(value);
+			return snapshot;
+		}).finally(() => {
+			loading = void 0;
+		});
+		return loading;
+	};
+	const flush = () => {
+		const current = copyRecord(snapshot);
+		const operation = async () => {
+			if (source.delete && Object.keys(current).length === 0) await source.delete();
+			else await source.write(current);
+		};
+		writing = writing.then(operation, operation);
+		return writing;
+	};
+	return {
+		async get(key) {
+			const current = await load();
+			await writing;
+			return Object.hasOwn(current, key) ? current[key] : void 0;
+		},
+		async set(key, value) {
+			const current = await load();
+			current[key] = value;
+			await flush();
+		},
+		async delete(key) {
+			const current = await load();
+			if (!Object.hasOwn(current, key)) return;
+			delete current[key];
+			await flush();
+		},
+		async keys(prefix = "") {
+			const current = await load();
+			await writing;
+			return Object.keys(current).filter((key) => key.startsWith(prefix));
+		}
+	};
+}
+//#endregion
 //#region src/core/storage.ts
 /**
 * Создаёт независимый снимок сессии.
@@ -386,37 +556,50 @@ function copySession(session) {
 * Хранилище в памяти процесса — вариант по умолчанию.
 *
 * Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`
-* из `itd-api/node`, для браузера — `LocalStorageTokenStorage` из `itd-api/web`.
+* из `itd-api/node`, для браузера — `LocalStorageTokenStorage` или
+* `SessionStorageTokenStorage` из `itd-api/web`.
 */
 var MemoryTokenStorage = class {
-	#session = null;
+	#store = new MemoryKeyValueStore();
 	constructor(initial) {
-		this.#session = initial ? copySession(initial) : null;
+		if (initial) this.#store.set(TOKEN_STORAGE_KEY, copySession(initial));
 	}
 	get() {
-		return this.#session ? copySession(this.#session) : null;
+		const session = this.#store.get(TOKEN_STORAGE_KEY);
+		return session ? copySession(session) : null;
 	}
 	set(session) {
-		this.#session = copySession(session);
+		this.#store.set(TOKEN_STORAGE_KEY, copySession(session));
 	}
 	clear() {
-		this.#session = null;
+		this.#store.delete(TOKEN_STORAGE_KEY);
 	}
 };
+const TOKEN_STORAGE_KEY = "session";
+function isPromise(value) {
+	return typeof value === "object" && value !== null && typeof value.then === "function";
+}
 /**
-* Собирает {@link TokenStorage} из трёх функций — когда заводить класс избыточно.
+* Создаёт доменное хранилище сессии поверх общего {@link KeyValueStore}.
 *
 * @example
 * ```ts
-* const storage = createTokenStorage({
-*   get: () => db.getSession(userId),
-*   set: (session) => db.saveSession(userId, session),
-*   clear: () => db.deleteSession(userId),
-* });
+* const storage = createTokenStorage(withNamespace(redisStore, 'itd'));
 * ```
 */
-function createTokenStorage(handlers) {
-	return handlers;
+function createTokenStorage(store, options = {}) {
+	const key = options.key ?? TOKEN_STORAGE_KEY;
+	if (typeof key !== "string") throw new ItdConfigError("key TokenStorage должен быть строкой");
+	const backend = createKeyValueStore(store);
+	return {
+		get() {
+			const value = backend.get(key);
+			if (isPromise(value)) return value.then((session) => session ? copySession(session) : null);
+			return value ? copySession(value) : null;
+		},
+		set: (session) => backend.set(key, copySession(session)),
+		clear: () => backend.delete(key)
+	};
 }
 //#endregion
 Object.defineProperty(exports, "ItdAbortError", {
@@ -515,6 +698,12 @@ Object.defineProperty(exports, "ItdServerError", {
 		return ItdServerError;
 	}
 });
+Object.defineProperty(exports, "ItdStateError", {
+	enumerable: true,
+	get: function() {
+		return ItdStateError;
+	}
+});
 Object.defineProperty(exports, "ItdTimeoutError", {
 	enumerable: true,
 	get: function() {
@@ -527,24 +716,54 @@ Object.defineProperty(exports, "ItdValidationError", {
 		return ItdValidationError;
 	}
 });
+Object.defineProperty(exports, "MemoryKeyValueStore", {
+	enumerable: true,
+	get: function() {
+		return MemoryKeyValueStore;
+	}
+});
 Object.defineProperty(exports, "MemoryTokenStorage", {
 	enumerable: true,
 	get: function() {
 		return MemoryTokenStorage;
 	}
 });
+Object.defineProperty(exports, "collectKeyValueStoreKeys", {
+	enumerable: true,
+	get: function() {
+		return collectKeyValueStoreKeys;
+	}
+});
 Object.defineProperty(exports, "copySession", {
 	enumerable: true,
 	get: function() {
 		return copySession;
 	}
 });
+Object.defineProperty(exports, "createKeyValueStore", {
+	enumerable: true,
+	get: function() {
+		return createKeyValueStore;
+	}
+});
+Object.defineProperty(exports, "createRecordKeyValueStore", {
+	enumerable: true,
+	get: function() {
+		return createRecordKeyValueStore;
+	}
+});
 Object.defineProperty(exports, "createTokenStorage", {
 	enumerable: true,
 	get: function() {
 		return createTokenStorage;
 	}
 });
+Object.defineProperty(exports, "isEnumerableKeyValueStore", {
+	enumerable: true,
+	get: function() {
+		return isEnumerableKeyValueStore;
+	}
+});
 Object.defineProperty(exports, "isItdApiError", {
 	enumerable: true,
 	get: function() {
@@ -605,11 +824,29 @@ Object.defineProperty(exports, "isItdServerError", {
 		return isItdServerError;
 	}
 });
+Object.defineProperty(exports, "isItdStateError", {
+	enumerable: true,
+	get: function() {
+		return isItdStateError;
+	}
+});
 Object.defineProperty(exports, "isItdValidationError", {
 	enumerable: true,
 	get: function() {
 		return isItdValidationError;
 	}
 });
+Object.defineProperty(exports, "withCodec", {
+	enumerable: true,
+	get: function() {
+		return withCodec;
+	}
+});
+Object.defineProperty(exports, "withNamespace", {
+	enumerable: true,
+	get: function() {
+		return withNamespace;
+	}
+});
 
-//# sourceMappingURL=storage-ycBqLBRB.cjs.map
+//# sourceMappingURL=storage-dF8Tio5y.cjs.map