itd-api 0.1.0 → 0.3.0

package/dist/web.cjs

@@ -0,0 +1,87 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_storage = require("./storage-ycBqLBRB.cjs");
+const require_runtime = require("./runtime-CFEsf-jD.cjs");
+//#region src/web.ts
+/**
+* `itd-api/web` — хранилище сессии для браузера.
+*
+* Здесь лежит только то, что рассчитано на браузерное окружение. Клиент, аккаунты,
+* билдеры, типы и всё остальное берутся из `itd-api` — одинаково на всех платформах.
+*
+* Отдельная точка входа нужна не сборщику, а вам: {@link LocalStorageTokenStorage}
+* при недоступном `localStorage` молча работает как хранилище в памяти, и такое
+* поведение стоит выбирать осознанно, а не получать вместе с общим импортом.
+*
+* @example
+* ```ts
+* import { ItdClient } from 'itd-api';
+* import { LocalStorageTokenStorage } from 'itd-api/web';
+*
+* const itd = new ItdClient({ storage: new LocalStorageTokenStorage() });
+* ```
+*
+* @packageDocumentation
+*/
+/**
+* Хранилище поверх `localStorage` браузера.
+*
+* Если `localStorage` недоступен (приватный режим, серверный рендеринг), молча работает
+* как хранилище в памяти — библиотека не должна падать из-за настроек браузера. Сессия
+* в этом случае теряется при перезагрузке страницы; когда это неприемлемо, проверьте
+* доступность сами или возьмите своё хранилище через `createTokenStorage`.
+*
+* Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,
+* если для вашего приложения это неприемлемый риск.
+*
+* После ошибки записи или удаления хранилище переключается на память до конца
+* своего жизненного цикла.
+*/
+var LocalStorageTokenStorage = class {
+	#key;
+	#fallback = new require_storage.MemoryTokenStorage();
+	/** Доступен ли `localStorage` для дальнейших операций. */
+	#available;
+	/** @param key ключ в `localStorage`. По умолчанию `itd-api:session`. */
+	constructor(key = "itd-api:session") {
+		this.#key = key;
+		this.#available = require_runtime.hasLocalStorage();
+	}
+	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;
+		}
+	}
+	set(session) {
+		if (this.#available) try {
+			globalThis.localStorage.setItem(this.#key, JSON.stringify(session));
+			return;
+		} catch {
+			this.#degrade();
+		}
+		this.#fallback.set(session);
+	}
+	clear() {
+		if (this.#available) try {
+			globalThis.localStorage.removeItem(this.#key);
+			return;
+		} catch {
+			this.#degrade();
+		}
+		this.#fallback.clear();
+	}
+	/** Переводит хранилище в память без переноса прежнего значения. */
+	#degrade() {
+		this.#available = false;
+		this.#fallback.clear();
+	}
+};
+//#endregion
+exports.LocalStorageTokenStorage = LocalStorageTokenStorage;
+
+//# sourceMappingURL=web.cjs.map

package/dist/web.cjs.map

@@ -0,0 +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"}

package/dist/web.d.cts

@@ -0,0 +1,27 @@
+import { r as TokenStorage, t as ItdSession } from "./storage-BjNRlkbE.cjs";
+//#region src/web.d.ts
+/**
+ * Хранилище поверх `localStorage` браузера.
+ *
+ * Если `localStorage` недоступен (приватный режим, серверный рендеринг), молча работает
+ * как хранилище в памяти — библиотека не должна падать из-за настроек браузера. Сессия
+ * в этом случае теряется при перезагрузке страницы; когда это неприемлемо, проверьте
+ * доступность сами или возьмите своё хранилище через `createTokenStorage`.
+ *
+ * Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,
+ * если для вашего приложения это неприемлемый риск.
+ *
+ * После ошибки записи или удаления хранилище переключается на память до конца
+ * своего жизненного цикла.
+ */
+declare class LocalStorageTokenStorage implements TokenStorage {
+  #private;
+  /** @param key ключ в `localStorage`. По умолчанию `itd-api:session`. */
+  constructor(key?: string);
+  get(): ItdSession | null;
+  set(session: ItdSession): void;
+  clear(): void;
+}
+//#endregion
+export { LocalStorageTokenStorage };
+//# sourceMappingURL=web.d.cts.map

package/dist/web.d.ts

@@ -0,0 +1,27 @@
+import { r as TokenStorage, t as ItdSession } from "./storage-BjNRlkbE.js";
+//#region src/web.d.ts
+/**
+ * Хранилище поверх `localStorage` браузера.
+ *
+ * Если `localStorage` недоступен (приватный режим, серверный рендеринг), молча работает
+ * как хранилище в памяти — библиотека не должна падать из-за настроек браузера. Сессия
+ * в этом случае теряется при перезагрузке страницы; когда это неприемлемо, проверьте
+ * доступность сами или возьмите своё хранилище через `createTokenStorage`.
+ *
+ * Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,
+ * если для вашего приложения это неприемлемый риск.
+ *
+ * После ошибки записи или удаления хранилище переключается на память до конца
+ * своего жизненного цикла.
+ */
+declare class LocalStorageTokenStorage implements TokenStorage {
+  #private;
+  /** @param key ключ в `localStorage`. По умолчанию `itd-api:session`. */
+  constructor(key?: string);
+  get(): ItdSession | null;
+  set(session: ItdSession): void;
+  clear(): void;
+}
+//#endregion
+export { LocalStorageTokenStorage };
+//# sourceMappingURL=web.d.ts.map

package/dist/web.js

@@ -0,0 +1,86 @@
+import { t as MemoryTokenStorage } from "./storage-D9tfHx7Z.js";
+import { i as hasLocalStorage } from "./runtime-DHxDn8gf.js";
+//#region src/web.ts
+/**
+* `itd-api/web` — хранилище сессии для браузера.
+*
+* Здесь лежит только то, что рассчитано на браузерное окружение. Клиент, аккаунты,
+* билдеры, типы и всё остальное берутся из `itd-api` — одинаково на всех платформах.
+*
+* Отдельная точка входа нужна не сборщику, а вам: {@link LocalStorageTokenStorage}
+* при недоступном `localStorage` молча работает как хранилище в памяти, и такое
+* поведение стоит выбирать осознанно, а не получать вместе с общим импортом.
+*
+* @example
+* ```ts
+* import { ItdClient } from 'itd-api';
+* import { LocalStorageTokenStorage } from 'itd-api/web';
+*
+* const itd = new ItdClient({ storage: new LocalStorageTokenStorage() });
+* ```
+*
+* @packageDocumentation
+*/
+/**
+* Хранилище поверх `localStorage` браузера.
+*
+* Если `localStorage` недоступен (приватный режим, серверный рендеринг), молча работает
+* как хранилище в памяти — библиотека не должна падать из-за настроек браузера. Сессия
+* в этом случае теряется при перезагрузке страницы; когда это неприемлемо, проверьте
+* доступность сами или возьмите своё хранилище через `createTokenStorage`.
+*
+* Помните, что `localStorage` доступен любому скрипту на странице: не используйте его,
+* если для вашего приложения это неприемлемый риск.
+*
+* После ошибки записи или удаления хранилище переключается на память до конца
+* своего жизненного цикла.
+*/
+var LocalStorageTokenStorage = class {
+	#key;
+	#fallback = new MemoryTokenStorage();
+	/** Доступен ли `localStorage` для дальнейших операций. */
+	#available;
+	/** @param key ключ в `localStorage`. По умолчанию `itd-api:session`. */
+	constructor(key = "itd-api:session") {
+		this.#key = key;
+		this.#available = hasLocalStorage();
+	}
+	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;
+		}
+	}
+	set(session) {
+		if (this.#available) try {
+			globalThis.localStorage.setItem(this.#key, JSON.stringify(session));
+			return;
+		} catch {
+			this.#degrade();
+		}
+		this.#fallback.set(session);
+	}
+	clear() {
+		if (this.#available) try {
+			globalThis.localStorage.removeItem(this.#key);
+			return;
+		} catch {
+			this.#degrade();
+		}
+		this.#fallback.clear();
+	}
+	/** Переводит хранилище в память без переноса прежнего значения. */
+	#degrade() {
+		this.#available = false;
+		this.#fallback.clear();
+	}
+};
+//#endregion
+export { LocalStorageTokenStorage };
+
+//# sourceMappingURL=web.js.map

package/dist/web.js.map

@@ -0,0 +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"}

package/package.json

@@ -1,21 +1,24 @@
 {
   "name": "itd-api",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Клиент REST и realtime API социальной сети итд.com для JavaScript и TypeScript",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/KiowDev/itd-api.git"
   },
-  "homepage": "https://github.com/KiowDev/itd-api",
+  "homepage": "https://kiowdev.github.io/itd-api/",
   "bugs": {
     "url": "https://github.com/KiowDev/itd-api/issues"
   },
   "author": "Kiow",
   "keywords": [
     "itd",
+    "итд",
     "api",
+    "rest-api",
     "client",
     "sdk",
+    "realtime",
     "social",
     "typescript"
   ],
@@ -27,7 +30,6 @@
   },
   "files": [
     "dist",
-    "guides",
     "NOTICE",
     "LICENSE",
     "README.md"
@@ -36,10 +38,7 @@
     "access": "public"
   },
   "workspaces": [
-    "turnstile",
-    "crypto",
-    "proxy",
-    "cache"
+    "packages/*"
   ],
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -48,6 +47,9 @@
     "*": {
       "node": [
         "./dist/node.d.ts"
+      ],
+      "web": [
+        "./dist/web.d.ts"
       ]
     }
   },
@@ -72,21 +74,36 @@
         "default": "./dist/node.cjs"
       }
     },
+    "./web": {
+      "import": {
+        "types": "./dist/web.d.ts",
+        "default": "./dist/web.js"
+      },
+      "require": {
+        "types": "./dist/web.d.cts",
+        "default": "./dist/web.cjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "scripts": {
     "sync-version": "node scripts/sync-version.mjs",
     "prebuild": "npm run sync-version",
-    "build": "tsup",
-    "dev": "tsup --watch",
+    "build": "tsdown",
+    "dev": "tsdown --watch",
     "test": "vitest run",
     "test:all": "npm run test && npm run test --workspaces --if-present",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
-    "lint": "biome check src test turnstile/src turnstile/test crypto/src crypto/test proxy/src proxy/test cache/src cache/test",
-    "lint:fix": "biome check --write src test turnstile/src turnstile/test crypto/src crypto/test proxy/src proxy/test cache/src cache/test",
-    "docs": "typedoc",
+    "lint": "biome check src test packages",
+    "lint:fix": "biome check --write src test packages",
+    "docs": "npm run docs:build",
+    "docs:api": "node scripts/build-docs.mjs",
+    "docs:dev": "npm run docs:api && vitepress dev guides",
+    "docs:build": "npm run docs:api && vitepress build guides",
+    "docs:preview": "vitepress preview guides",
+    "docs:check": "npm run docs:build",
     "check:pack": "publint && attw --pack .",
     "version": "npm run sync-version && git add src/core/version.ts",
     "prepublishOnly": "npm run typecheck && npm run test && npm run build && npm run check:pack"
@@ -97,11 +114,14 @@
     "@types/node": "^26.1.1",
     "@vitest/coverage-v8": "^4.1.10",
     "eventsource-parser": "^3.1.0",
-    "publint": "^0.3.21",
+    "publint": "^0.3.22",
     "set-cookie-parser": "^3.1.2",
-    "tsup": "^8.5.1",
+    "tsdown": "^0.22.14",
     "typedoc": "^0.28.20",
+    "typedoc-plugin-markdown": "^4.12.0",
+    "typedoc-vitepress-theme": "^1.1.3",
     "typescript": "^5.9.3",
+    "vitepress": "^1.6.4",
     "vitest": "^4.1.10"
   }
 }