itd-api 0.7.2 → 0.9.0

package/dist/shared/storage-BQrtKon9.d.cts

@@ -0,0 +1,86 @@
+import { r as KeyValueStore } from "./key-value-store-COZaNHZS.cjs";
+//#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 { createTokenStorage as a, TokenStorageAdapterOptions as i, MemoryTokenStorage as n, TokenStorage as r, ItdSession as t };
+//# sourceMappingURL=storage-BQrtKon9.d.cts.map

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

@@ -0,0 +1,86 @@
+import { r as KeyValueStore } from "./key-value-store-COZaNHZS.js";
+//#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 { createTokenStorage as a, TokenStorageAdapterOptions as i, MemoryTokenStorage as n, TokenStorage as r, ItdSession as t };
+//# sourceMappingURL=storage-CTRGT5wF.d.ts.map

package/dist/shared/storage-CfHKzVHf.js

@@ -0,0 +1,71 @@
+import { a as ItdConfigError } from "./errors-GI10kZxk.js";
+import { r as createKeyValueStore, t as MemoryKeyValueStore } from "./key-value-store-Bt2PSMxY.js";
+//#region src/session/storage.ts
+/**
+* Создаёт независимый снимок сессии.
+*
+* Сессии пересекают границу пользовательского кода и внутреннего состояния клиента.
+* Возвращать или сохранять их по ссылке нельзя: последующая мутация объекта или массива
+* cookie меняла бы уже сохранённую сессию без вызова `set()`.
+*
+* @internal
+*/
+function copySession(session) {
+	return {
+		...session,
+		...session.cookies ? { cookies: [...session.cookies] } : {}
+	};
+}
+/**
+* Хранилище в памяти процесса — вариант по умолчанию.
+*
+* Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`
+* из `itd-api/node`, для браузера — `LocalStorageTokenStorage` или
+* `SessionStorageTokenStorage` из `itd-api/web`.
+*/
+var MemoryTokenStorage = class {
+	#store = new MemoryKeyValueStore();
+	constructor(initial) {
+		if (initial) this.#store.set(TOKEN_STORAGE_KEY, copySession(initial));
+	}
+	get() {
+		const session = this.#store.get(TOKEN_STORAGE_KEY);
+		return session ? copySession(session) : null;
+	}
+	set(session) {
+		this.#store.set(TOKEN_STORAGE_KEY, copySession(session));
+	}
+	clear() {
+		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 KeyValueStore}.
+*
+* @example
+* ```ts
+* const storage = createTokenStorage(withNamespace(redisStore, 'itd'));
+* ```
+*/
+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
+export { copySession as n, createTokenStorage as r, MemoryTokenStorage as t };
+
+//# sourceMappingURL=storage-CfHKzVHf.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-CfHKzVHf.js","names":["#store"],"sources":["../../src/session/storage.ts"],"sourcesContent":["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":";;;;;;;;;;;;AA8CA,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,KAAKA,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"}

package/dist/shared/storage-QNVxzpDB.cjs

@@ -0,0 +1,88 @@
+const require_errors = require("./errors-BmP3TKoW.cjs");
+const require_key_value_store = require("./key-value-store-B5GYVEYZ.cjs");
+//#region src/session/storage.ts
+/**
+* Создаёт независимый снимок сессии.
+*
+* Сессии пересекают границу пользовательского кода и внутреннего состояния клиента.
+* Возвращать или сохранять их по ссылке нельзя: последующая мутация объекта или массива
+* cookie меняла бы уже сохранённую сессию без вызова `set()`.
+*
+* @internal
+*/
+function copySession(session) {
+	return {
+		...session,
+		...session.cookies ? { cookies: [...session.cookies] } : {}
+	};
+}
+/**
+* Хранилище в памяти процесса — вариант по умолчанию.
+*
+* Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`
+* из `itd-api/node`, для браузера — `LocalStorageTokenStorage` или
+* `SessionStorageTokenStorage` из `itd-api/web`.
+*/
+var MemoryTokenStorage = class {
+	#store = new require_key_value_store.MemoryKeyValueStore();
+	constructor(initial) {
+		if (initial) this.#store.set(TOKEN_STORAGE_KEY, copySession(initial));
+	}
+	get() {
+		const session = this.#store.get(TOKEN_STORAGE_KEY);
+		return session ? copySession(session) : null;
+	}
+	set(session) {
+		this.#store.set(TOKEN_STORAGE_KEY, copySession(session));
+	}
+	clear() {
+		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 KeyValueStore}.
+*
+* @example
+* ```ts
+* const storage = createTokenStorage(withNamespace(redisStore, 'itd'));
+* ```
+*/
+function createTokenStorage(store, options = {}) {
+	const key = options.key ?? TOKEN_STORAGE_KEY;
+	if (typeof key !== "string") throw new require_errors.ItdConfigError("key TokenStorage должен быть строкой");
+	const backend = require_key_value_store.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, "MemoryTokenStorage", {
+	enumerable: true,
+	get: function() {
+		return MemoryTokenStorage;
+	}
+});
+Object.defineProperty(exports, "copySession", {
+	enumerable: true,
+	get: function() {
+		return copySession;
+	}
+});
+Object.defineProperty(exports, "createTokenStorage", {
+	enumerable: true,
+	get: function() {
+		return createTokenStorage;
+	}
+});
+
+//# sourceMappingURL=storage-QNVxzpDB.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-QNVxzpDB.cjs","names":["#store","MemoryKeyValueStore","ItdConfigError","createKeyValueStore"],"sources":["../../src/session/storage.ts"],"sourcesContent":["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":";;;;;;;;;;;;AA8CA,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,IAAIC,wBAAAA,oBAAgC;CAEtD,YAAY,SAA6B;EACvC,IAAI,SAAS,KAAKD,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,IAAIE,eAAAA,eAAe,sCAAsC;CAC5F,MAAM,UAAUC,wBAAAA,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"}