itd-api 0.1.0 → 0.3.0

package/dist/runtime-CFEsf-jD.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-CFEsf-jD.cjs","names":["ItdConfigError"],"sources":["../src/core/runtime.ts"],"sourcesContent":["import { ItdConfigError } from './errors.js';\n\n/**\n * Как библиотека обращается с cookie.\n *\n * - `browser` — cookie ведёт браузер, запросы уходят с `credentials: 'include'`;\n * - `server` — cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную;\n * - `auto` — определяется по среде исполнения (значение по умолчанию).\n */\nexport const RuntimeMode = Object.freeze({\n  /** Определяется по среде исполнения. Значение по умолчанию. */\n  Auto: 'auto',\n  /** Cookie ведёт браузер, запросы уходят с `credentials: 'include'`. */\n  Browser: 'browser',\n  /** Cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную. */\n  Server: 'server',\n} as const);\nexport type RuntimeMode = (typeof RuntimeMode)[keyof typeof RuntimeMode];\n\n/** Распознанная среда исполнения. */\nexport const DetectedRuntime = Object.freeze({\n  Browser: 'browser',\n  /** Есть `window`, но нет `document`; cookie ведёт нативный сетевой слой. */\n  ReactNative: 'react-native',\n  Server: 'server',\n} as const);\nexport type DetectedRuntime = (typeof DetectedRuntime)[keyof typeof DetectedRuntime];\n\n/**\n * Определяет среду исполнения.\n *\n * React Native выделен отдельно намеренно: там есть `window`, но нет `document`, а cookie\n * хранит нативный сетевой слой (`NSHTTPCookieStorage` / `OkHttp`). Свой jar в этой среде\n * привёл бы к отправке cookie дважды.\n */\nexport function detectRuntime(): DetectedRuntime {\n  const nav = (globalThis as { navigator?: { product?: string } }).navigator;\n  if (nav?.product === 'ReactNative') return DetectedRuntime.ReactNative;\n\n  if (typeof document !== 'undefined') return DetectedRuntime.Browser;\n\n  return DetectedRuntime.Server;\n}\n\n/**\n * Нужно ли вести собственный cookie-jar.\n *\n * Только в серверных средах: в браузере `Set-Cookie` из JS не читается и не нужен,\n * в React Native cookie ведёт нативный слой.\n */\nexport function shouldUseCookieJar(mode: RuntimeMode): boolean {\n  if (mode === RuntimeMode.Browser) return false;\n  if (mode === RuntimeMode.Server) return true;\n  return detectRuntime() === DetectedRuntime.Server;\n}\n\n/**\n * Нужно ли отправлять запросы с `credentials: 'include'`.\n *\n * Только в браузере: именно так refresh-cookie попадает в запрос `POST /api/v1/auth/refresh`.\n * Требует настроенного CORS на стороне итд.com — если его нет, укажите свой прокси в `baseUrl`.\n */\nexport function shouldSendCredentials(mode: RuntimeMode): boolean {\n  if (mode === RuntimeMode.Browser) return true;\n  if (mode === RuntimeMode.Server) return false;\n  return detectRuntime() === DetectedRuntime.Browser;\n}\n\n/**\n * Возвращает реализацию `fetch`.\n *\n * @param custom реализация из конфигурации клиента, если пользователь её передал\n * @throws {ItdConfigError} если `fetch` недоступен — например, на Node ниже 18\n */\nexport function resolveFetch(custom?: typeof fetch): typeof fetch {\n  if (custom !== undefined) {\n    if (typeof custom !== 'function') {\n      throw new ItdConfigError('fetch должен быть функцией');\n    }\n    return custom;\n  }\n\n  if (typeof globalThis.fetch === 'function') {\n    // Привязка к globalThis обязательна: в некоторых средах несвязанный fetch бросает\n    // «Illegal invocation».\n    return globalThis.fetch.bind(globalThis);\n  }\n\n  throw new ItdConfigError(\n    'В этой среде нет глобального fetch. Обновитесь до Node 18+ либо передайте свою ' +\n      'реализацию через опцию fetch.',\n  );\n}\n\n/**\n * Проверки бинарных типов, безопасные в любой среде.\n *\n * Обычный `instanceof` здесь недостаточен: конструктора может не быть вовсе, и тогда\n * проверка падает с `ReferenceError`, а не возвращает `false`. `Blob` есть в Node с 18.0,\n * но `File` стал глобальным только в Node 20 — при заявленной поддержке Node 18 голый\n * `instanceof File` ронял бы любую загрузку.\n */\nexport function isBlob(value: unknown): value is Blob {\n  return typeof Blob !== 'undefined' && value instanceof Blob;\n}\n\n/** @see {@link isBlob} */\nexport function isFile(value: unknown): value is File {\n  return typeof File !== 'undefined' && value instanceof File;\n}\n\n/** Доступно ли потоковое чтение тела ответа — от этого зависит, сработает ли SSE. */\nexport function supportsStreamingBody(): boolean {\n  return typeof ReadableStream !== 'undefined' && typeof TextDecoder !== 'undefined';\n}\n\n/**\n * Создаёт идентификатор устройства для заголовка `X-Device-Id` — UUID v4.\n *\n * `crypto.randomUUID` есть в Node 19+, браузерах и Deno, но отсутствует в Node 18 вне\n * защищённого контекста, поэтому предусмотрен запасной путь.\n */\nexport function createDeviceId(): string {\n  const webCrypto = (globalThis as { crypto?: Crypto }).crypto;\n\n  if (typeof webCrypto?.randomUUID === 'function') return webCrypto.randomUUID();\n\n  // Форма UUID v4 собирается вручную: серверу важна стабильность значения, а не его энтропия.\n  const bytes = new Uint8Array(16);\n  if (typeof webCrypto?.getRandomValues === 'function') webCrypto.getRandomValues(bytes);\n  else for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);\n\n  // biome-ignore lint/style/noNonNullAssertion: длина массива фиксирована выше\n  bytes[6] = (bytes[6]! & 0x0f) | 0x40;\n  // biome-ignore lint/style/noNonNullAssertion: длина массива фиксирована выше\n  bytes[8] = (bytes[8]! & 0x3f) | 0x80;\n\n  const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');\n\n  return [\n    hex.slice(0, 8),\n    hex.slice(8, 12),\n    hex.slice(12, 16),\n    hex.slice(16, 20),\n    hex.slice(20, 32),\n  ].join('-');\n}\n\n/** Есть ли в среде `localStorage`. Проверка безопасна: доступ к нему может бросать. */\nexport function hasLocalStorage(): boolean {\n  try {\n    return typeof globalThis.localStorage !== 'undefined' && globalThis.localStorage !== null;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,cAAc,OAAO,OAAO;;CAEvC,MAAM;;CAEN,SAAS;;CAET,QAAQ;AACV,CAAU;;AAIV,MAAa,kBAAkB,OAAO,OAAO;CAC3C,SAAS;;CAET,aAAa;CACb,QAAQ;AACV,CAAU;;;;;;;;AAUV,SAAgB,gBAAiC;CAE/C,IADa,WAAoD,WACxD,YAAY,eAAe,OAAO,gBAAgB;CAE3D,IAAI,OAAO,aAAa,aAAa,OAAO,gBAAgB;CAE5D,OAAO,gBAAgB;AACzB;;;;;;;AAQA,SAAgB,mBAAmB,MAA4B;CAC7D,IAAI,SAAS,YAAY,SAAS,OAAO;CACzC,IAAI,SAAS,YAAY,QAAQ,OAAO;CACxC,OAAO,cAAc,MAAM,gBAAgB;AAC7C;;;;;;;AAQA,SAAgB,sBAAsB,MAA4B;CAChE,IAAI,SAAS,YAAY,SAAS,OAAO;CACzC,IAAI,SAAS,YAAY,QAAQ,OAAO;CACxC,OAAO,cAAc,MAAM,gBAAgB;AAC7C;;;;;;;AAQA,SAAgB,aAAa,QAAqC;CAChE,IAAI,WAAW,KAAA,GAAW;EACxB,IAAI,OAAO,WAAW,YACpB,MAAM,IAAIA,gBAAAA,eAAe,4BAA4B;EAEvD,OAAO;CACT;CAEA,IAAI,OAAO,WAAW,UAAU,YAG9B,OAAO,WAAW,MAAM,KAAK,UAAU;CAGzC,MAAM,IAAIA,gBAAAA,eACR,8GAEF;AACF;;;;;;;;;AAUA,SAAgB,OAAO,OAA+B;CACpD,OAAO,OAAO,SAAS,eAAe,iBAAiB;AACzD;;AAGA,SAAgB,OAAO,OAA+B;CACpD,OAAO,OAAO,SAAS,eAAe,iBAAiB;AACzD;;AAGA,SAAgB,wBAAiC;CAC/C,OAAO,OAAO,mBAAmB,eAAe,OAAO,gBAAgB;AACzE;;;;;;;AAQA,SAAgB,iBAAyB;CACvC,MAAM,YAAa,WAAmC;CAEtD,IAAI,OAAO,WAAW,eAAe,YAAY,OAAO,UAAU,WAAW;CAG7E,MAAM,wBAAQ,IAAI,WAAW,EAAE;CAC/B,IAAI,OAAO,WAAW,oBAAoB,YAAY,UAAU,gBAAgB,KAAK;MAChF,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,MAAM,KAAK,KAAK,MAAM,KAAK,OAAO,IAAI,GAAG;CAGrF,MAAM,KAAM,MAAM,KAAM,KAAQ;CAEhC,MAAM,KAAM,MAAM,KAAM,KAAQ;CAEhC,MAAM,MAAM,MAAM,KAAK,QAAQ,SAAS,KAAK,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE;CAEnF,OAAO;EACL,IAAI,MAAM,GAAG,CAAC;EACd,IAAI,MAAM,GAAG,EAAE;EACf,IAAI,MAAM,IAAI,EAAE;EAChB,IAAI,MAAM,IAAI,EAAE;EAChB,IAAI,MAAM,IAAI,EAAE;CAClB,CAAC,CAAC,KAAK,GAAG;AACZ;;AAGA,SAAgB,kBAA2B;CACzC,IAAI;EACF,OAAO,OAAO,WAAW,iBAAiB,eAAe,WAAW,iBAAiB;CACvF,QAAQ;EACN,OAAO;CACT;AACF"}

package/dist/runtime-DHxDn8gf.js

@@ -0,0 +1,126 @@
+import { c as ItdConfigError } from "./storage-D9tfHx7Z.js";
+//#region src/core/runtime.ts
+/**
+* Как библиотека обращается с cookie.
+*
+* - `browser` — cookie ведёт браузер, запросы уходят с `credentials: 'include'`;
+* - `server` — cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную;
+* - `auto` — определяется по среде исполнения (значение по умолчанию).
+*/
+const RuntimeMode = Object.freeze({
+	/** Определяется по среде исполнения. Значение по умолчанию. */
+	Auto: "auto",
+	/** Cookie ведёт браузер, запросы уходят с `credentials: 'include'`. */
+	Browser: "browser",
+	/** Cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную. */
+	Server: "server"
+});
+/** Распознанная среда исполнения. */
+const DetectedRuntime = Object.freeze({
+	Browser: "browser",
+	/** Есть `window`, но нет `document`; cookie ведёт нативный сетевой слой. */
+	ReactNative: "react-native",
+	Server: "server"
+});
+/**
+* Определяет среду исполнения.
+*
+* React Native выделен отдельно намеренно: там есть `window`, но нет `document`, а cookie
+* хранит нативный сетевой слой (`NSHTTPCookieStorage` / `OkHttp`). Свой jar в этой среде
+* привёл бы к отправке cookie дважды.
+*/
+function detectRuntime() {
+	if (globalThis.navigator?.product === "ReactNative") return DetectedRuntime.ReactNative;
+	if (typeof document !== "undefined") return DetectedRuntime.Browser;
+	return DetectedRuntime.Server;
+}
+/**
+* Нужно ли вести собственный cookie-jar.
+*
+* Только в серверных средах: в браузере `Set-Cookie` из JS не читается и не нужен,
+* в React Native cookie ведёт нативный слой.
+*/
+function shouldUseCookieJar(mode) {
+	if (mode === RuntimeMode.Browser) return false;
+	if (mode === RuntimeMode.Server) return true;
+	return detectRuntime() === DetectedRuntime.Server;
+}
+/**
+* Нужно ли отправлять запросы с `credentials: 'include'`.
+*
+* Только в браузере: именно так refresh-cookie попадает в запрос `POST /api/v1/auth/refresh`.
+* Требует настроенного CORS на стороне итд.com — если его нет, укажите свой прокси в `baseUrl`.
+*/
+function shouldSendCredentials(mode) {
+	if (mode === RuntimeMode.Browser) return true;
+	if (mode === RuntimeMode.Server) return false;
+	return detectRuntime() === DetectedRuntime.Browser;
+}
+/**
+* Возвращает реализацию `fetch`.
+*
+* @param custom реализация из конфигурации клиента, если пользователь её передал
+* @throws {ItdConfigError} если `fetch` недоступен — например, на Node ниже 18
+*/
+function resolveFetch(custom) {
+	if (custom !== void 0) {
+		if (typeof custom !== "function") throw new ItdConfigError("fetch должен быть функцией");
+		return custom;
+	}
+	if (typeof globalThis.fetch === "function") return globalThis.fetch.bind(globalThis);
+	throw new ItdConfigError("В этой среде нет глобального fetch. Обновитесь до Node 18+ либо передайте свою реализацию через опцию fetch.");
+}
+/**
+* Проверки бинарных типов, безопасные в любой среде.
+*
+* Обычный `instanceof` здесь недостаточен: конструктора может не быть вовсе, и тогда
+* проверка падает с `ReferenceError`, а не возвращает `false`. `Blob` есть в Node с 18.0,
+* но `File` стал глобальным только в Node 20 — при заявленной поддержке Node 18 голый
+* `instanceof File` ронял бы любую загрузку.
+*/
+function isBlob(value) {
+	return typeof Blob !== "undefined" && value instanceof Blob;
+}
+/** @see {@link isBlob} */
+function isFile(value) {
+	return typeof File !== "undefined" && value instanceof File;
+}
+/** Доступно ли потоковое чтение тела ответа — от этого зависит, сработает ли SSE. */
+function supportsStreamingBody() {
+	return typeof ReadableStream !== "undefined" && typeof TextDecoder !== "undefined";
+}
+/**
+* Создаёт идентификатор устройства для заголовка `X-Device-Id` — UUID v4.
+*
+* `crypto.randomUUID` есть в Node 19+, браузерах и Deno, но отсутствует в Node 18 вне
+* защищённого контекста, поэтому предусмотрен запасной путь.
+*/
+function createDeviceId() {
+	const webCrypto = globalThis.crypto;
+	if (typeof webCrypto?.randomUUID === "function") return webCrypto.randomUUID();
+	const bytes = /* @__PURE__ */ new Uint8Array(16);
+	if (typeof webCrypto?.getRandomValues === "function") webCrypto.getRandomValues(bytes);
+	else for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);
+	bytes[6] = bytes[6] & 15 | 64;
+	bytes[8] = bytes[8] & 63 | 128;
+	const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+	return [
+		hex.slice(0, 8),
+		hex.slice(8, 12),
+		hex.slice(12, 16),
+		hex.slice(16, 20),
+		hex.slice(20, 32)
+	].join("-");
+}
+/** Есть ли в среде `localStorage`. Проверка безопасна: доступ к нему может бросать. */
+function hasLocalStorage() {
+	try {
+		return typeof globalThis.localStorage !== "undefined" && globalThis.localStorage !== null;
+	} catch {
+		return false;
+	}
+}
+//#endregion
+export { isBlob as a, shouldSendCredentials as c, hasLocalStorage as i, shouldUseCookieJar as l, RuntimeMode as n, isFile as o, createDeviceId as r, resolveFetch as s, DetectedRuntime as t, supportsStreamingBody as u };
+
+//# sourceMappingURL=runtime-DHxDn8gf.js.map

package/dist/runtime-DHxDn8gf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-DHxDn8gf.js","names":[],"sources":["../src/core/runtime.ts"],"sourcesContent":["import { ItdConfigError } from './errors.js';\n\n/**\n * Как библиотека обращается с cookie.\n *\n * - `browser` — cookie ведёт браузер, запросы уходят с `credentials: 'include'`;\n * - `server` — cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную;\n * - `auto` — определяется по среде исполнения (значение по умолчанию).\n */\nexport const RuntimeMode = Object.freeze({\n  /** Определяется по среде исполнения. Значение по умолчанию. */\n  Auto: 'auto',\n  /** Cookie ведёт браузер, запросы уходят с `credentials: 'include'`. */\n  Browser: 'browser',\n  /** Cookie ведёт встроенный jar, заголовок `Cookie` подставляется вручную. */\n  Server: 'server',\n} as const);\nexport type RuntimeMode = (typeof RuntimeMode)[keyof typeof RuntimeMode];\n\n/** Распознанная среда исполнения. */\nexport const DetectedRuntime = Object.freeze({\n  Browser: 'browser',\n  /** Есть `window`, но нет `document`; cookie ведёт нативный сетевой слой. */\n  ReactNative: 'react-native',\n  Server: 'server',\n} as const);\nexport type DetectedRuntime = (typeof DetectedRuntime)[keyof typeof DetectedRuntime];\n\n/**\n * Определяет среду исполнения.\n *\n * React Native выделен отдельно намеренно: там есть `window`, но нет `document`, а cookie\n * хранит нативный сетевой слой (`NSHTTPCookieStorage` / `OkHttp`). Свой jar в этой среде\n * привёл бы к отправке cookie дважды.\n */\nexport function detectRuntime(): DetectedRuntime {\n  const nav = (globalThis as { navigator?: { product?: string } }).navigator;\n  if (nav?.product === 'ReactNative') return DetectedRuntime.ReactNative;\n\n  if (typeof document !== 'undefined') return DetectedRuntime.Browser;\n\n  return DetectedRuntime.Server;\n}\n\n/**\n * Нужно ли вести собственный cookie-jar.\n *\n * Только в серверных средах: в браузере `Set-Cookie` из JS не читается и не нужен,\n * в React Native cookie ведёт нативный слой.\n */\nexport function shouldUseCookieJar(mode: RuntimeMode): boolean {\n  if (mode === RuntimeMode.Browser) return false;\n  if (mode === RuntimeMode.Server) return true;\n  return detectRuntime() === DetectedRuntime.Server;\n}\n\n/**\n * Нужно ли отправлять запросы с `credentials: 'include'`.\n *\n * Только в браузере: именно так refresh-cookie попадает в запрос `POST /api/v1/auth/refresh`.\n * Требует настроенного CORS на стороне итд.com — если его нет, укажите свой прокси в `baseUrl`.\n */\nexport function shouldSendCredentials(mode: RuntimeMode): boolean {\n  if (mode === RuntimeMode.Browser) return true;\n  if (mode === RuntimeMode.Server) return false;\n  return detectRuntime() === DetectedRuntime.Browser;\n}\n\n/**\n * Возвращает реализацию `fetch`.\n *\n * @param custom реализация из конфигурации клиента, если пользователь её передал\n * @throws {ItdConfigError} если `fetch` недоступен — например, на Node ниже 18\n */\nexport function resolveFetch(custom?: typeof fetch): typeof fetch {\n  if (custom !== undefined) {\n    if (typeof custom !== 'function') {\n      throw new ItdConfigError('fetch должен быть функцией');\n    }\n    return custom;\n  }\n\n  if (typeof globalThis.fetch === 'function') {\n    // Привязка к globalThis обязательна: в некоторых средах несвязанный fetch бросает\n    // «Illegal invocation».\n    return globalThis.fetch.bind(globalThis);\n  }\n\n  throw new ItdConfigError(\n    'В этой среде нет глобального fetch. Обновитесь до Node 18+ либо передайте свою ' +\n      'реализацию через опцию fetch.',\n  );\n}\n\n/**\n * Проверки бинарных типов, безопасные в любой среде.\n *\n * Обычный `instanceof` здесь недостаточен: конструктора может не быть вовсе, и тогда\n * проверка падает с `ReferenceError`, а не возвращает `false`. `Blob` есть в Node с 18.0,\n * но `File` стал глобальным только в Node 20 — при заявленной поддержке Node 18 голый\n * `instanceof File` ронял бы любую загрузку.\n */\nexport function isBlob(value: unknown): value is Blob {\n  return typeof Blob !== 'undefined' && value instanceof Blob;\n}\n\n/** @see {@link isBlob} */\nexport function isFile(value: unknown): value is File {\n  return typeof File !== 'undefined' && value instanceof File;\n}\n\n/** Доступно ли потоковое чтение тела ответа — от этого зависит, сработает ли SSE. */\nexport function supportsStreamingBody(): boolean {\n  return typeof ReadableStream !== 'undefined' && typeof TextDecoder !== 'undefined';\n}\n\n/**\n * Создаёт идентификатор устройства для заголовка `X-Device-Id` — UUID v4.\n *\n * `crypto.randomUUID` есть в Node 19+, браузерах и Deno, но отсутствует в Node 18 вне\n * защищённого контекста, поэтому предусмотрен запасной путь.\n */\nexport function createDeviceId(): string {\n  const webCrypto = (globalThis as { crypto?: Crypto }).crypto;\n\n  if (typeof webCrypto?.randomUUID === 'function') return webCrypto.randomUUID();\n\n  // Форма UUID v4 собирается вручную: серверу важна стабильность значения, а не его энтропия.\n  const bytes = new Uint8Array(16);\n  if (typeof webCrypto?.getRandomValues === 'function') webCrypto.getRandomValues(bytes);\n  else for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);\n\n  // biome-ignore lint/style/noNonNullAssertion: длина массива фиксирована выше\n  bytes[6] = (bytes[6]! & 0x0f) | 0x40;\n  // biome-ignore lint/style/noNonNullAssertion: длина массива фиксирована выше\n  bytes[8] = (bytes[8]! & 0x3f) | 0x80;\n\n  const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');\n\n  return [\n    hex.slice(0, 8),\n    hex.slice(8, 12),\n    hex.slice(12, 16),\n    hex.slice(16, 20),\n    hex.slice(20, 32),\n  ].join('-');\n}\n\n/** Есть ли в среде `localStorage`. Проверка безопасна: доступ к нему может бросать. */\nexport function hasLocalStorage(): boolean {\n  try {\n    return typeof globalThis.localStorage !== 'undefined' && globalThis.localStorage !== null;\n  } catch {\n    return false;\n  }\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,cAAc,OAAO,OAAO;;CAEvC,MAAM;;CAEN,SAAS;;CAET,QAAQ;AACV,CAAU;;AAIV,MAAa,kBAAkB,OAAO,OAAO;CAC3C,SAAS;;CAET,aAAa;CACb,QAAQ;AACV,CAAU;;;;;;;;AAUV,SAAgB,gBAAiC;CAE/C,IADa,WAAoD,WACxD,YAAY,eAAe,OAAO,gBAAgB;CAE3D,IAAI,OAAO,aAAa,aAAa,OAAO,gBAAgB;CAE5D,OAAO,gBAAgB;AACzB;;;;;;;AAQA,SAAgB,mBAAmB,MAA4B;CAC7D,IAAI,SAAS,YAAY,SAAS,OAAO;CACzC,IAAI,SAAS,YAAY,QAAQ,OAAO;CACxC,OAAO,cAAc,MAAM,gBAAgB;AAC7C;;;;;;;AAQA,SAAgB,sBAAsB,MAA4B;CAChE,IAAI,SAAS,YAAY,SAAS,OAAO;CACzC,IAAI,SAAS,YAAY,QAAQ,OAAO;CACxC,OAAO,cAAc,MAAM,gBAAgB;AAC7C;;;;;;;AAQA,SAAgB,aAAa,QAAqC;CAChE,IAAI,WAAW,KAAA,GAAW;EACxB,IAAI,OAAO,WAAW,YACpB,MAAM,IAAI,eAAe,4BAA4B;EAEvD,OAAO;CACT;CAEA,IAAI,OAAO,WAAW,UAAU,YAG9B,OAAO,WAAW,MAAM,KAAK,UAAU;CAGzC,MAAM,IAAI,eACR,8GAEF;AACF;;;;;;;;;AAUA,SAAgB,OAAO,OAA+B;CACpD,OAAO,OAAO,SAAS,eAAe,iBAAiB;AACzD;;AAGA,SAAgB,OAAO,OAA+B;CACpD,OAAO,OAAO,SAAS,eAAe,iBAAiB;AACzD;;AAGA,SAAgB,wBAAiC;CAC/C,OAAO,OAAO,mBAAmB,eAAe,OAAO,gBAAgB;AACzE;;;;;;;AAQA,SAAgB,iBAAyB;CACvC,MAAM,YAAa,WAAmC;CAEtD,IAAI,OAAO,WAAW,eAAe,YAAY,OAAO,UAAU,WAAW;CAG7E,MAAM,wBAAQ,IAAI,WAAW,EAAE;CAC/B,IAAI,OAAO,WAAW,oBAAoB,YAAY,UAAU,gBAAgB,KAAK;MAChF,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,MAAM,KAAK,KAAK,MAAM,KAAK,OAAO,IAAI,GAAG;CAGrF,MAAM,KAAM,MAAM,KAAM,KAAQ;CAEhC,MAAM,KAAM,MAAM,KAAM,KAAQ;CAEhC,MAAM,MAAM,MAAM,KAAK,QAAQ,SAAS,KAAK,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE;CAEnF,OAAO;EACL,IAAI,MAAM,GAAG,CAAC;EACd,IAAI,MAAM,GAAG,EAAE;EACf,IAAI,MAAM,IAAI,EAAE;EAChB,IAAI,MAAM,IAAI,EAAE;EAChB,IAAI,MAAM,IAAI,EAAE;CAClB,CAAC,CAAC,KAAK,GAAG;AACZ;;AAGA,SAAgB,kBAA2B;CACzC,IAAI;EACF,OAAO,OAAO,WAAW,iBAAiB,eAAe,WAAW,iBAAiB;CACvF,QAAQ;EACN,OAAO;CACT;AACF"}

package/dist/storage-BjNRlkbE.d.cts

@@ -0,0 +1,82 @@
+//#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 storage = createTokenStorage({
+ *   get: async () => JSON.parse((await AsyncStorage.getItem('itd')) ?? 'null'),
+ *   set: (session) => AsyncStorage.setItem('itd', JSON.stringify(session)),
+ *   clear: () => AsyncStorage.removeItem('itd'),
+ * });
+ * ```
+ */
+interface TokenStorage {
+  /** Прочитать сессию. `null`, если её нет. */
+  get(): ItdSession | null | Promise<ItdSession | null>;
+  /** Сохранить сессию целиком. */
+  set(session: ItdSession): void | Promise<void>;
+  /** Удалить сессию. Вызывается при выходе и при неудачном обновлении токена. */
+  clear(): void | Promise<void>;
+}
+/**
+ * Хранилище в памяти процесса — вариант по умолчанию.
+ *
+ * Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`
+ * из `itd-api/node`, для браузера — `LocalStorageTokenStorage` из `itd-api/web`.
+ */
+declare class MemoryTokenStorage implements TokenStorage {
+  #private;
+  constructor(initial?: ItdSession | null);
+  get(): ItdSession | null;
+  set(session: ItdSession): void;
+  clear(): void;
+}
+/**
+ * Собирает {@link TokenStorage} из трёх функций — когда заводить класс избыточно.
+ *
+ * @example
+ * ```ts
+ * const storage = createTokenStorage({
+ *   get: () => db.getSession(userId),
+ *   set: (session) => db.saveSession(userId, session),
+ *   clear: () => db.deleteSession(userId),
+ * });
+ * ```
+ */
+declare function createTokenStorage(handlers: TokenStorage): TokenStorage;
+//#endregion
+export { createTokenStorage as i, MemoryTokenStorage as n, TokenStorage as r, ItdSession as t };
+//# sourceMappingURL=storage-BjNRlkbE.d.cts.map

package/dist/storage-BjNRlkbE.d.ts

@@ -0,0 +1,82 @@
+//#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 storage = createTokenStorage({
+ *   get: async () => JSON.parse((await AsyncStorage.getItem('itd')) ?? 'null'),
+ *   set: (session) => AsyncStorage.setItem('itd', JSON.stringify(session)),
+ *   clear: () => AsyncStorage.removeItem('itd'),
+ * });
+ * ```
+ */
+interface TokenStorage {
+  /** Прочитать сессию. `null`, если её нет. */
+  get(): ItdSession | null | Promise<ItdSession | null>;
+  /** Сохранить сессию целиком. */
+  set(session: ItdSession): void | Promise<void>;
+  /** Удалить сессию. Вызывается при выходе и при неудачном обновлении токена. */
+  clear(): void | Promise<void>;
+}
+/**
+ * Хранилище в памяти процесса — вариант по умолчанию.
+ *
+ * Сессия теряется при перезапуске. Для долгоживущих ботов возьмите `FileTokenStorage`
+ * из `itd-api/node`, для браузера — `LocalStorageTokenStorage` из `itd-api/web`.
+ */
+declare class MemoryTokenStorage implements TokenStorage {
+  #private;
+  constructor(initial?: ItdSession | null);
+  get(): ItdSession | null;
+  set(session: ItdSession): void;
+  clear(): void;
+}
+/**
+ * Собирает {@link TokenStorage} из трёх функций — когда заводить класс избыточно.
+ *
+ * @example
+ * ```ts
+ * const storage = createTokenStorage({
+ *   get: () => db.getSession(userId),
+ *   set: (session) => db.saveSession(userId, session),
+ *   clear: () => db.deleteSession(userId),
+ * });
+ * ```
+ */
+declare function createTokenStorage(handlers: TokenStorage): TokenStorage;
+//#endregion
+export { createTokenStorage as i, MemoryTokenStorage as n, TokenStorage as r, ItdSession as t };
+//# sourceMappingURL=storage-BjNRlkbE.d.ts.map