itd-api 0.3.0 → 0.5.0

package/dist/web.cjs

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

package/dist/web.cjs.map

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

package/dist/web.d.cts

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

package/dist/web.d.ts

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

package/dist/web.js

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

package/dist/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","names":["#key","#fallback","#available","#degrade"],"sources":["../src/web.ts"],"sourcesContent":["/**\n * `itd-api/web` — хранилище сессии для браузера.\n *\n * Здесь лежит только то, что рассчитано на браузерное окружение. Клиент, аккаунты,\n * билдеры, типы и всё остальное берутся из `itd-api` — одинаково на всех платформах.\n *\n * Отдельная точка входа нужна не сборщику, а вам: {@link LocalStorageTokenStorage}\n * при недоступном `localStorage` молча работает как хранилище в памяти, и такое\n * поведение стоит выбирать осознанно, а не получать вместе с общим импортом.\n *\n * @example\n * ```ts\n * import { ItdClient } from 'itd-api';\n * import { LocalStorageTokenStorage } from 'itd-api/web';\n *\n * const itd = new ItdClient({ storage: new LocalStorageTokenStorage() });\n * ```\n *\n * @packageDocumentation\n */\n\nimport { hasLocalStorage } from './core/runtime.js';\nimport { type ItdSession, MemoryTokenStorage, type TokenStorage } from './core/storage.js';\n\n/**\n * Хранилище поверх `localStorage` браузера.\n *\n * Если `localStorage` недоступен (приватный режим, серверный рендеринг), молча работает\n * как хранилище в памяти — библиотека не должна падать из-за настроек браузера. Сессия\n * в этом случае теряется при перезагрузке страницы; когда это неприемлемо, проверьте\n * доступность сами или возьмите своё хранилище через `createTokenStorage`.\n *\n * Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,\n * если для вашего приложения это неприемлемый риск.\n *\n * После ошибки записи или удаления хранилище переключается на память до конца\n * своего жизненного цикла.\n */\nexport class LocalStorageTokenStorage implements TokenStorage {\n  readonly #key: string;\n  readonly #fallback = new MemoryTokenStorage();\n  /** Доступен ли `localStorage` для дальнейших операций. */\n  #available: boolean;\n\n  /** @param key ключ в `localStorage`. По умолчанию `itd-api:session`. */\n  constructor(key = 'itd-api:session') {\n    this.#key = key;\n    this.#available = hasLocalStorage();\n  }\n\n  get(): ItdSession | null {\n    if (!this.#available) return this.#fallback.get();\n\n    try {\n      const raw = globalThis.localStorage.getItem(this.#key);\n      if (!raw) return null;\n      const parsed: unknown = JSON.parse(raw);\n      return typeof parsed === 'object' && parsed !== null ? (parsed as ItdSession) : null;\n    } catch {\n      // Повреждённое значение — ведём себя так, будто сессии нет.\n      return null;\n    }\n  }\n\n  set(session: ItdSession): void {\n    if (this.#available) {\n      try {\n        globalThis.localStorage.setItem(this.#key, JSON.stringify(session));\n        return;\n      } catch {\n        this.#degrade();\n      }\n    }\n\n    this.#fallback.set(session);\n  }\n\n  clear(): void {\n    if (this.#available) {\n      try {\n        globalThis.localStorage.removeItem(this.#key);\n        return;\n      } catch {\n        this.#degrade();\n      }\n    }\n\n    this.#fallback.clear();\n  }\n\n  /** Переводит хранилище в память без переноса прежнего значения. */\n  #degrade(): void {\n    this.#available = false;\n    this.#fallback.clear();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,IAAa,2BAAb,MAA8D;CAC5D;CACA,YAAqB,IAAI,mBAAmB;;CAE5C;;CAGA,YAAY,MAAM,mBAAmB;EACnC,KAAKA,OAAO;EACZ,KAAKE,aAAa,gBAAgB;CACpC;CAEA,MAAyB;EACvB,IAAI,CAAC,KAAKA,YAAY,OAAO,KAAKD,UAAU,IAAI;EAEhD,IAAI;GACF,MAAM,MAAM,WAAW,aAAa,QAAQ,KAAKD,IAAI;GACrD,IAAI,CAAC,KAAK,OAAO;GACjB,MAAM,SAAkB,KAAK,MAAM,GAAG;GACtC,OAAO,OAAO,WAAW,YAAY,WAAW,OAAQ,SAAwB;EAClF,QAAQ;GAEN,OAAO;EACT;CACF;CAEA,IAAI,SAA2B;EAC7B,IAAI,KAAKE,YACP,IAAI;GACF,WAAW,aAAa,QAAQ,KAAKF,MAAM,KAAK,UAAU,OAAO,CAAC;GAClE;EACF,QAAQ;GACN,KAAKG,SAAS;EAChB;EAGF,KAAKF,UAAU,IAAI,OAAO;CAC5B;CAEA,QAAc;EACZ,IAAI,KAAKC,YACP,IAAI;GACF,WAAW,aAAa,WAAW,KAAKF,IAAI;GAC5C;EACF,QAAQ;GACN,KAAKG,SAAS;EAChB;EAGF,KAAKF,UAAU,MAAM;CACvB;;CAGA,WAAiB;EACf,KAAKC,aAAa;EAClB,KAAKD,UAAU,MAAM;CACvB;AACF"}
+{"version":3,"file":"web.js","names":["#property","#storage","#fallback","#degrade","#inner"],"sources":["../src/web.ts"],"sourcesContent":["/**\n * `itd-api/web` — хранилища для браузера.\n *\n * Здесь лежит только то, что рассчитано на браузерное окружение. Клиент, аккаунты,\n * билдеры, типы и всё остальное берутся из `itd-api` — одинаково на всех платформах.\n *\n * Отдельная точка входа нужна не сборщику, а вам: браузерные хранилища при\n * недоступном Web Storage молча работают в памяти, и такое поведение стоит выбирать\n * осознанно, а не получать вместе с общим импортом.\n *\n * @example\n * ```ts\n * import { ItdClient } from 'itd-api';\n * import { LocalStorageTokenStorage } from 'itd-api/web';\n *\n * const itd = new ItdClient({ storage: new LocalStorageTokenStorage() });\n * ```\n *\n * @packageDocumentation\n */\n\nimport { ItdConfigError } from './core/errors.js';\nimport { MemoryKeyValueStore } from './core/key-value-store.js';\nimport { createTokenStorage, type ItdSession, type TokenStorage } from './core/storage.js';\n\ntype WebStorageProperty = 'localStorage' | 'sessionStorage';\n\nfunction getWebStorage(property: WebStorageProperty): Storage | undefined {\n  try {\n    return globalThis[property] ?? undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Общая реализация Web Storage; публичные классы ниже фиксируют его вид. */\nclass WebStorageKeyValueStore<T> {\n  #fallback = new MemoryKeyValueStore<T>();\n  #storage: Storage | undefined;\n  readonly #property: WebStorageProperty;\n\n  constructor(property: WebStorageProperty) {\n    this.#property = property;\n    this.#storage = getWebStorage(property);\n  }\n\n  get(key: string): T | undefined {\n    if (!this.#storage) return this.#fallback.get(key);\n    let raw: string | null;\n    try {\n      raw = this.#storage.getItem(key);\n    } catch {\n      this.#degrade();\n      return this.#fallback.get(key);\n    }\n    if (raw === null) return undefined;\n    try {\n      return JSON.parse(raw) as T;\n    } catch (error) {\n      throw new ItdConfigError(`Повреждён JSON в ${this.#property} по ключу «${key}»`, {\n        cause: error,\n      });\n    }\n  }\n\n  set(key: string, value: T): void {\n    if (this.#storage) {\n      try {\n        this.#storage.setItem(key, JSON.stringify(value));\n        return;\n      } catch {\n        this.#degrade();\n      }\n    }\n    this.#fallback.set(key, value);\n  }\n\n  delete(key: string): void {\n    if (this.#storage) {\n      try {\n        this.#storage.removeItem(key);\n        return;\n      } catch {\n        this.#degrade();\n      }\n    }\n    this.#fallback.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    if (!this.#storage) return this.#fallback.keys(prefix);\n    try {\n      const keys: string[] = [];\n      for (let index = 0; index < this.#storage.length; index += 1) {\n        const key = this.#storage.key(index);\n        if (key?.startsWith(prefix)) keys.push(key);\n      }\n      return keys;\n    } catch {\n      this.#degrade();\n      return this.#fallback.keys(prefix);\n    }\n  }\n\n  #degrade(): void {\n    this.#storage = undefined;\n    this.#fallback = new MemoryKeyValueStore<T>();\n  }\n}\n\n/** JSON key-value backend поверх браузерного `localStorage` с откатом в память. */\nexport class LocalStorageKeyValueStore<T> {\n  readonly #inner = new WebStorageKeyValueStore<T>('localStorage');\n\n  get(key: string): T | undefined {\n    return this.#inner.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#inner.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#inner.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    return this.#inner.keys(prefix);\n  }\n}\n\n/** JSON key-value backend поверх браузерного `sessionStorage` с откатом в память. */\nexport class SessionStorageKeyValueStore<T> {\n  readonly #inner = new WebStorageKeyValueStore<T>('sessionStorage');\n\n  get(key: string): T | undefined {\n    return this.#inner.get(key);\n  }\n\n  set(key: string, value: T): void {\n    this.#inner.set(key, value);\n  }\n\n  delete(key: string): void {\n    this.#inner.delete(key);\n  }\n\n  keys(prefix = ''): Iterable<string> | AsyncIterable<string> {\n    return this.#inner.keys(prefix);\n  }\n}\n\n/**\n * Хранилище поверх `localStorage` браузера.\n *\n * Если `localStorage` недоступен (приватный режим, серверный рендеринг), молча работает\n * как хранилище в памяти — библиотека не должна падать из-за настроек браузера. Сессия\n * в этом случае теряется при перезагрузке страницы; когда это неприемлемо, проверьте\n * доступность сами или возьмите своё хранилище через `createTokenStorage`.\n *\n * Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,\n * если для вашего приложения это неприемлемый риск.\n *\n * Повреждённый JSON считается ошибкой, а не отсутствующей сессией. После ошибки доступа,\n * записи или удаления хранилище переключается на память до конца\n * своего жизненного цикла.\n */\nexport class LocalStorageTokenStorage implements TokenStorage {\n  readonly #inner: TokenStorage;\n\n  /** @param key ключ в `localStorage`. По умолчанию `itd-api:session`. */\n  constructor(key = 'itd-api:session') {\n    this.#inner = createTokenStorage(new LocalStorageKeyValueStore<ItdSession>(), { key });\n  }\n\n  get(): ItdSession | null {\n    return this.#inner.get() as ItdSession | null;\n  }\n\n  set(session: ItdSession): void {\n    void this.#inner.set(session);\n  }\n\n  clear(): void {\n    void this.#inner.clear();\n  }\n}\n\n/**\n * Хранилище сессии поверх браузерного `sessionStorage`.\n *\n * Данные переживают перезагрузку страницы, но существуют только в пределах текущей\n * browser page session. Если `sessionStorage` недоступен, экземпляр молча работает\n * в памяти; после ошибки доступа, записи или удаления он также остаётся в памяти до конца\n * своего жизненного цикла.\n * Повреждённый JSON считается ошибкой, а не отсутствующей сессией.\n *\n * Как и `localStorage`, это хранилище доступно скриптам страницы и не защищает сессию\n * от XSS. Выбирайте его ради более короткого срока жизни, а не ради изоляции секрета.\n */\nexport class SessionStorageTokenStorage implements TokenStorage {\n  readonly #inner: TokenStorage;\n\n  /** @param key ключ в `sessionStorage`. По умолчанию `itd-api:session`. */\n  constructor(key = 'itd-api:session') {\n    this.#inner = createTokenStorage(new SessionStorageKeyValueStore<ItdSession>(), { key });\n  }\n\n  get(): ItdSession | null {\n    return this.#inner.get() as ItdSession | null;\n  }\n\n  set(session: ItdSession): void {\n    void this.#inner.set(session);\n  }\n\n  clear(): void {\n    void this.#inner.clear();\n  }\n}\n"],"mappings":"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"}