ravejs 1.13.9 → 1.15.9

package/README.RU.md

@@ -0,0 +1,392 @@
+<div align="center">
+    <h1>RaveJS</h1>
+    <a href="https://t.me/aminodorks"><img src="https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white" alt="Telegram"></a>
+    <a href="https://www.npmjs.com/package/ravejs"><img src="https://img.shields.io/badge/NPM-%23CB3837.svg?style=for-the-badge&logo=npm&logoColor=white" alt="NPM"></a>
+</div>
+<div align="center">
+    <img src="https://img.shields.io/npm/dm/ravejs" alt="Downloads">
+    <img src="https://img.shields.io/npm/v/ravejs.svg" alt="Version">
+    <h2>RaveJS — библиотека на TypeScript для взаимодействия с API приложения Rave: Watch Party</h2>
+</div> 
+
+- [README на английском](https://github.com/AminoDorks/ravejs/blob/master/README.MD)  
+- [README на русском](https://github.com/AminoDorks/ravejs/blob/master/README.RU.MD)
+
+---
+
+## Содержание  
+- [Возможности](#возможности)  
+- [Начало работы](#начало-работы)  
+- [Использование](#использование)  
+- [Документация API](#документация-api)  
+- [Участие в разработке](#участие-в-разработке)  
+- [Лицензия](#лицензия)  
+
+---
+
+## Возможности  
+
+RaveJS обладает рядом преимуществ:  
+- Модульная архитектура  
+- Простота в использовании  
+- Поддержка всех необходимых функций  
+- Первая библиотека на TypeScript для Rave API  
+
+---
+
+## Начало работы  
+
+Чтобы начать использовать RaveJS, выполните следующие шаги:
+
+1. Инициализируйте npm-пакет:  
+```bash
+npm init
+```
+2. Установите TypeScript глобально (опционально):  
+```bash
+npm install -g typescript
+```
+3. Создайте конфигурацию TypeScript:  
+```bash
+tsc --init
+```
+4. Установите RaveJS:  
+```bash
+npm install ravejs
+```
+
+---
+
+## Использование  
+
+### Базовая авторизация  
+
+```typescript
+import { Rave } from 'ravejs';
+
+(async () => {
+  const rave = new Rave();
+  await rave.auth.authenticate('токен', 'девайс айди')
+  console.log(`Авторизован как ${rave.account?.id}`);
+})();
+```
+
+---
+
+## Документация API  
+
+### `Rave(config: RaveConfig)`  
+Главный класс для взаимодействия с API Rave.
+
+#### Конфигурация (`RaveConfig`)
+- `credentials?`: `{ deviceId: string, token: string }` — данные для авторизации и опции  
+- `enableLogging?`: `boolean` — включить логирование  
+- `account?`: `Account` — профиль пользователя после авторизации  
+
+#### Свойства экземпляра `Rave`
+1. `token: string` — Bearer-токен авторизации  
+2. `JWT: string` — JWT-токен для Web Mesh API  
+3. `account: Account?` — информация о профиле пользователя  
+4. `proxy?: string` — прокси для запросов (поддерживаются SOCKS-прокси; можно задать через сеттер)
+
+#### Методы экземпляра `Rave`
+1. `proxyIsAlive = async (): Promise<boolean>` - Проверить, работает ли прокси
+2. `offProxy = (): Promise<void>` - Удалить прокси из экземпляра Rave
+
+---
+
+### Фабрики  
+
+RaveJS использует модульную архитектуру, основанную на *фабриках*.
+
+---
+
+#### `AuthFactory`  
+Фабрика для авторизации и аутентификации. Доступна через `rave.auth`.
+
+##### Методы `AuthFactory`
+1. `refreshJWT(deviceId?: string): Promise<string>` — обновить JWT-токен  
+
+2. `getAccount(): Promise<Account>` — получить данные авторизованного пользователя
+
+3. `authenticate = async (token: string, deviceId: string): Promise<Account>` - Функция аутентификации с использованием токена и идентификатора устройства, автоматически создает JWT и данные аккаунта.
+
+1. `sendMagicLink(email: string, language = 'ru'): Promise<{ stateId: string }>`  
+  Отправить «волшебную» ссылку на почту для входа или регистрации.
+
+2. `checkRegisterState(stateId: string): Promise<CheckRegisterStateResponse>`  
+  Проверить статус регистрации по `stateId`.  
+  **Ответ:**  
+```ts
+{
+  authenticated: boolean,
+  isSecondFactorLogin: boolean,
+  oauth: {
+    accessToken: string,
+    idToken: string,
+    refreshToken: string,
+    expiresIn: string,
+    tokenType: string
+  },
+  user: {
+    createdAt: string,
+    updatedAt: string,
+    issuer: string,
+    userId: string,
+    identifier: string,
+    email: string
+  }
+}
+```
+
+3. `parseUserCredentials(idToken: string, email: string): Promise<{ objectId: string; createdAt: string; username: string; sessionToken: string }>`  
+  Извлечь учётные данные из `idToken` и email.
+
+4. `mojoLogin(email: string, parseId: string, parseToken: string, name: string, deviceId?: string, language = 'ru'): Promise<{ data: { isValid: boolean; newUser: boolean; suggestedHandles: string[] } }>`  
+  Вход через сервис Mojo.
+
+5. `login(stateId: string, name?: string, deviceId?: string, language = 'ru'): Promise<AuthenticateResponse>`  
+  Упрощённый метод входа (комбинирует предыдущие шаги).  
+  **Ответ (`AuthenticateResponse`):**  
+```ts
+{
+  isNewUser: boolean,
+  email: string,
+  username: string,
+  deviceId: string,
+  token: string
+}
+```
+
+6. `register(email: string, name: string, deviceId?: string, language = 'ru'): Promise<RegisterResponse>`  
+  Регистрация нового пользователя (аналогично `login`, но гарантирует создание аккаунта).
+
+---
+
+#### `MeshFactory`  
+Фабрика для работы с *мешами* (комнатами просмотра). Доступна через `rave.mesh`.
+
+##### Методы `MeshFactory`
+1. `get(meshId: string): Promise<GetMeshResponse>`  
+  Получить информацию о меше по ID.  
+  **Ответ (`GetMeshResponse.data`):**
+```ts
+{
+  blurT?: boolean;
+  category: string;
+  channel: number;
+  createdAt: string;
+  currentState: 'play' | 'paus';
+  explicit: boolean;
+  id: string;
+  isFriend: boolean;
+  isLocal: boolean;
+  isPublic: boolean;
+  kickMode: string;
+  maturity: string;
+  mediaUrl: string;
+  originator: number;
+  playMode: string;
+  position: number;
+  server: string;
+  shareLink: string;
+  thumbnails?: {
+    channel?: string;
+    standard?: string;
+    animated?: string;
+    maxres?: string;
+    medium?: string;
+    default?: string;
+    high?: string;
+  };
+  time: number;
+  videoAuthor: string;
+  videoDuration: number;
+  videoProvider: string;
+  videoPublishedAt: string;
+  videoThumbnail: string;
+  videoTitle: string;
+  videoUrl: string;
+  vikiPass: boolean;
+  voipMode: string;
+  users: {
+    avatar: string;
+    country: string;
+    displayName?: string;
+    handle?: string;
+    id: number;
+    lang?: string;
+    lat: number;
+    lng: number;
+    name: string;
+  }[];
+}
+```
+
+2. `getByLink(meshLink: string): Promise<GetMeshResponse>`  
+  Получить меш по публичной ссылке (`shareLink`).
+
+3. `getMany(params: GetManyMeshesParams): Promise<GetMeshResponse[]>`  
+  Получить список мешей.  
+  **Параметры (`GetManyMeshesParams`):**
+```ts
+{
+  isPublic?: boolean;
+  limit: number;
+  hasFriends: boolean;
+  local: boolean;
+  hasInvited: boolean;
+  language?: string;
+}
+```
+
+4. `join(meshId: string): Promise<MeshSocket>`  
+  Присоединиться к мешу. Возвращает экземпляр `MeshSocket` для взаимодействия через WebSocket.
+
+---
+
+#### `ThreadFactory`  
+Фабрика для работы с переписками. Доступна через `rave.thread`.
+
+##### Методы `ThreadFactory`
+1. `getMany(): Promise<Thread[]>`  
+  Получить все переписки.  
+  **Структура `Thread`:**
+```ts
+{
+  expiryMode: number;
+  isFriend: boolean;
+  myself: number;
+  opposingUser: number;
+  spokenLangs: string[];
+  threadId: string;
+}
+```
+
+2. `create(userId: number): Promise<Thread>`  
+  Создать новую переписку с пользователем.
+
+3. `sendMessage(threadId: string, content: string): Promise<SendMessageResponse>`  
+  Отправить сообщение в переписку.  
+  **Ответ (`SendMessageResponse.data`):**
+```ts
+{
+  correlateId: string;
+  threadId: string;
+  messageType: string;
+  originator: number;
+  messageBody: {
+    content: string;
+    detectedLang: string;
+    id: string;
+    translations: Record<string, string>;
+  }
+}
+```
+
+---
+
+#### `UserFactory`  
+Фабрика для работы с пользователями. Доступна через `rave.user`.
+
+##### Методы `UserFactory`
+1. `get(userId: number): Promise<GetUserResponse>`  
+  Получить профиль пользователя.  
+  **Ответ (`GetUserResponse.data`):**
+```ts
+{
+  bio: {
+    bio?: string;
+    metadata: { position: number; privacy: string };
+  };
+  profile: {
+    avatar: string;
+    country: string;
+    displayName?: string;
+    handle?: string;
+  };
+}
+```
+
+2. `sendFriendship(userId: number): Promise<FriendshipResponse>`  
+  Отправить запрос на добавление в друзья.  
+  **Ответ (`FriendshipResponse.data`):**
+```ts
+{
+  fromUserId: number;
+  state: string;
+  toUserId: number;
+}
+```
+
+3. `acceptFriendship(userId: number): Promise<void>`  
+  Принять запрос в друзья.
+
+4. `declineFriendship(userId: number): Promise<void>`  
+  Отклонить запрос в друзья.
+
+5. `edit(builder: EditProfileBuilder): Promise<EditProfileResponse>`  
+  Редактировать профиль.  
+  **Параметры (`EditProfileBuilder`):**
+```ts
+{
+  displayAvatar?: string;
+  displayName?: string;
+  handle?: string;
+}
+```
+  **Ответ (`EditProfileResponse.data`)** — объект `User`.
+
+6. `getAvatarUpload(): Promise<GetAvatarUploadResponse>`  
+  Получить URL для загрузки аватара.  
+  **Ответ (`GetAvatarUploadResponse.data`):**
+```ts
+{
+  expiresAt: string;
+  fileName: string;
+  mime: string;
+  uploadUrl: string;
+}
+```
+
+7. `uploadOnUrl(uploadUrl: string, image: Buffer): Promise<void>`  
+  Загрузить изображение по полученному URL.
+
+8. `uploadAvatar(image: Buffer): Promise<string>`  
+  Упрощённый метод: получить URL и загрузить аватар за один вызов. Возвращает `displayAvatar` (новый URL аватара).
+
+---
+
+#### `MeshSocket`  
+Класс для работы с WebSocket-соединением в меше.
+
+##### Методы и свойства `MeshSocket`
+1. `onclose(handler: () => Promise<void>): void`  
+  Обработчик закрытия соединения.
+
+2. `onerror(handler: () => Promise<void>): void`  
+  Обработчик ошибок.
+
+3. `onmessage(handler: (data: string) => Promise<void>): void`  
+  Обработчик входящих сообщений (сырой JSON-строки).
+
+4. `sendMessage(content: string): void`  
+  Отправить сообщение в меш (например, команды управления воспроизведением).
+
+5. `leave(): void`  
+  Покинуть меш (закрывает сокет).
+
+---
+
+## Участие в разработке  
+
+Приветствуются pull request'ы и предложения по улучшению!  
+Если вы используете мои генераторы кода — напишите мне в [личные сообщения Telegram](https://t.me/celt_is_god).
+
+---
+
+## Лицензия  
+
+RaveJS распространяется под лицензией **MIT**. Подробнее см. в файле [LICENSE](https://github.com/thatcelt/ravejs/blob/master/LICENSE).
+
+---

package/{README.MD → README.md}

@@ -48,13 +48,9 @@ To get started with RaveJS, follow these steps:
 import { Rave } from 'ravejs';
 
 (async () => {
-  const rave = new Rave({
-    credentials: {
-      deviceId: 'your_device_id',
-      token: 'your_token'
-    }
-  });
-  console.log(`logged as ${(await rave.getAccount()).id}`);
+const rave = new Rave();
+await rave.auth.authenticate('token', 'device_id')
+console.log(`logged as ${rave.account?.id}`);
 })();
 ```
 
@@ -65,7 +61,7 @@ import { Rave } from 'ravejs';
 A main class to interacting with API in global namespace of app.
 config - configuration for library, you can find it in `RaveConfig` type...
 `RaveConfig` =>
-*    credentials?: { deviceId: string, token: string, autoJWT?: boolean, autoAccount?: boolean } - main credentials for authorization and options
+*    credentials?: { deviceId: string, token: string } - main credentials for authorization and options
 *    enableLogging?: boolean - enable logging for library
 *    account?: Account - Your user profile information after authorization
 
@@ -73,14 +69,13 @@ config - configuration for library, you can find it in `RaveConfig` type...
 
 1. `Rave.token: string` - Authorization bearer token
 2. `Rave.JWT: string` - Authorization JWT token for we mesh API
-3. `Rave.account: Account` - Your user profile information after authorization
+3. `Rave.account: Account | undefined` - Your user profile information after authorization
 4. `Rave.proxy: string | undefined` - Proxy for requests (you can set socks proxy with proxy property setter too)
 
 #### Rave Methods
 
-1. `refreshJWT = async (deviceId?: string): Promise<string>` - Refresh JWT token for we mesh API
-2. `getAccount = async (): Promise<Account>` - Get your user profile information after authorization
-3. `proxyIsAlive = async (): Promise<boolean>` - Check if proxy is alive
+1. `proxyIsAlive = async (): Promise<boolean>` - Check if proxy is alive
+2. `offProxy = (): Promise<void>` - Remove proxy from Rave instance
 
 -----------------
 Rave haves the fully modular structure and parts called `Factories`. Now i will describe them:
@@ -90,11 +85,16 @@ The main factory for authorization and authentication. Can be called with `Rave.
 
 #### Authenticate Factory methods
 
-1. `sendMagicLink = async (email: string, language: string = DEFAULT_LANGUAGE): Promise<SendMagicLinkResponse> - Send magic link to email for authorization, if you doesn't know your credentials or just wanna register`
+1. `refreshJWT = async (deviceId?: string): Promise<string>` - Refresh JWT token for we mesh API
+
+2. `getAccount = async (): Promise<Account>` - Get your user profile information after authorization
+
+3. `authenticate = async (token: string, deviceId: string): Promise<Account>` - Authenticate with token and device id, creates JWT and account info automatically
+4. `sendMagicLink = async (email: string, language: string = DEFAULT_LANGUAGE): Promise<SendMagicLinkResponse> - Send magic link to email for authorization, if you doesn't know your credentials or just wanna register`
 * DEFAULT_LANGUAGE = 'ru'
 * SendMagicLinkResponse - { stateId: string } - stateId for magic link
 
-2. `checkRegisterState = async (stateId: string): Promise<CheckRegisterStateResponse> - Check stateId for magic link`
+5. `checkRegisterState = async (stateId: string): Promise<CheckRegisterStateResponse> - Check stateId for magic link`
 * CheckRegisterStateResponse - {
   authenticated: boolean,
   isSecondFactorLogin: boolean,
@@ -115,7 +115,7 @@ The main factory for authorization and authentication. Can be called with `Rave.
   }
 }
 
-3. `parseUserCredentials = async (idToken: string, email: string): Promise<ParseUserCredentialsResponse> - Parse user credentials from idToken and email`
+6. `parseUserCredentials = async (idToken: string, email: string): Promise<ParseUserCredentialsResponse> - Parse user credentials from idToken and email`
 * ParseUserCredentialsResponse - {
   objectId: string,
   createdAt: string,
@@ -123,14 +123,14 @@ The main factory for authorization and authentication. Can be called with `Rave.
   sessionToken: string,
 }
 
-4. `mojoLogin = async (email: string, parseId: string, parseToken: string, name: string, deviceId?: string, language = DEFAULT_LANGUAGE): Promise<MojoLoginResponse> - Login with mojo service to Rave`
+7. `mojoLogin = async (email: string, parseId: string, parseToken: string, name: string, deviceId?: string, language = DEFAULT_LANGUAGE): Promise<MojoLoginResponse> - Login with mojo service to Rave`
 * MojoLoginResponse - { data: {
   isValid: boolean,
   newUser: boolean,
   suggestedHandles: string[],
 }}
 
-5. `login = async (stateId: string, name?: string, deviceId?: string, language = DEFAULT_LANGUAGE): Promise<AuthenticateResponse> - Simply summary of previous functions for login`
+8. `login = async (stateId: string, name?: string, deviceId?: string, language = DEFAULT_LANGUAGE): Promise<AuthenticateResponse> - Simply summary of previous functions for login`
 * AuthenticateResponse - {
   isNewUser: boolean,
   email: string,
@@ -139,7 +139,7 @@ The main factory for authorization and authentication. Can be called with `Rave.
   token: string,
 }
 
-6. `register = async (email: string, name: string, deviceId?: string, language = DEFAULT_LANGUAGE): Promise<AuthenticateResponse> - Register a new user`
+9. `register = async (email: string, name: string, deviceId?: string, language = DEFAULT_LANGUAGE): Promise<AuthenticateResponse> - Register a new user`
 * RegisterResponse - {
   isNewUser: boolean,
   email: string,

package/dist/constants.d.ts

@@ -1,5 +1,5 @@
 import { APIErrorData } from './schemas/error';
-export declare const VERSION = "1.13.9";
+export declare const VERSION = "1.15.9";
 export declare const API_URL = "https://api1.a-l-p-a.com";
 export declare const PARSE_API_URL = "https://api3.a-l-p-a.com";
 export declare const EVENTS_API_URL = "https://api2.a-l-p-a.com/api";

package/dist/constants.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CODES_MAP = exports.PARSE_USERS_HEADERS = exports.PATCHED_IP_DATA = exports.PATCHED_DEVICE = exports.MOJO_AUTH_HEADERS = exports.API_HEADERS = exports.SOCKET_PING_DELAY = exports.UUID_PATTERN = exports.DEFAULT_LANGUAGE = exports.HASH_SECRET = exports.MOJO_AUTH_URL = exports.WE_MESH_API_URL = exports.EVENTS_API_URL = exports.PARSE_API_URL = exports.API_URL = exports.VERSION = void 0;
 // Constants
-exports.VERSION = '1.13.9';
+exports.VERSION = '1.15.9';
 exports.API_URL = 'https://api1.a-l-p-a.com';
 exports.PARSE_API_URL = 'https://api3.a-l-p-a.com';
 exports.EVENTS_API_URL = 'https://api2.a-l-p-a.com/api';

package/dist/core/rave.d.ts

@@ -3,7 +3,6 @@ import { MeshFactory } from '../factories/mesh-factory';
 import { UserFactory } from '../factories/user-factory';
 import { RaveConfig } from '../schemas/public';
 import { ThreadFactory } from '../factories/thread-factory';
-import { Account } from '../schemas/rave/account';
 export declare class Rave {
     private __config?;
     private __http;
@@ -14,6 +13,7 @@ export declare class Rave {
     constructor(config?: RaveConfig);
     get token(): string;
     get JWT(): string;
+    get auth(): AuthFactory;
     get account(): {
         acceptDataPolicy: number;
         acceptPrivacy: number;
@@ -32,8 +32,7 @@ export declare class Rave {
         displayName?: string | undefined;
         handle?: string | undefined;
         lang?: string | undefined;
-    };
-    get auth(): AuthFactory;
+    } | undefined;
     get user(): UserFactory;
     get mesh(): MeshFactory;
     get thread(): ThreadFactory;
@@ -41,7 +40,5 @@ export declare class Rave {
     set proxy(proxy: string);
     offProxy: () => void;
     proxyIsAlive: () => Promise<boolean>;
-    refreshJWT: (deviceId?: string) => Promise<string>;
-    getAccount: () => Promise<Account>;
 }
 //# sourceMappingURL=rave.d.ts.map

package/dist/core/rave.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rave.d.ts","sourceRoot":"","sources":["../../src/core/rave.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAS/C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAIlD,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,MAAM,CAAe;IAE7B,OAAO,CAAC,aAAa,CAAC,CAAc;IACpC,OAAO,CAAC,aAAa,CAAC,CAAc;IACpC,OAAO,CAAC,aAAa,CAAC,CAAc;IACpC,OAAO,CAAC,eAAe,CAAC,CAAgB;gBAE5B,MAAM,GAAE,UAAe;IAanC,IAAI,KAAK,WAER;IAED,IAAI,GAAG,WAEN;IAED,IAAI,OAAO;;;;;;;;;;;;;;;;;;MAMV;IAED,IAAI,IAAI,gBAIP;IAED,IAAI,IAAI,gBAIP;IAED,IAAI,IAAI,gBAIP;IAED,IAAI,MAAM,kBAIT;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAMtB;IAEM,QAAQ,aAEb;IAEK,YAAY,QAAa,OAAO,CAAC,OAAO,CAAC,CAa9C;IAEK,UAAU,cAAqB,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,CAU5D;IAEK,UAAU,QAAa,OAAO,CAAC,OAAO,CAAC,CAqB5C;CACH"}
+{"version":3,"file":"rave.d.ts","sourceRoot":"","sources":["../../src/core/rave.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAI5D,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,MAAM,CAAe;IAE7B,OAAO,CAAC,aAAa,CAAC,CAAc;IACpC,OAAO,CAAC,aAAa,CAAC,CAAc;IACpC,OAAO,CAAC,aAAa,CAAC,CAAc;IACpC,OAAO,CAAC,eAAe,CAAC,CAAgB;gBAE5B,MAAM,GAAE,UAAe;IAOnC,IAAI,KAAK,WAER;IAED,IAAI,GAAG,WAEN;IAED,IAAI,IAAI,gBAIP;IAED,IAAI,OAAO;;;;;;;;;;;;;;;;;;kBAEV;IAED,IAAI,IAAI,gBAIP;IAED,IAAI,IAAI,gBAIP;IAED,IAAI,MAAM,kBAIT;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAMtB;IAEM,QAAQ,aAEb;IAEK,YAAY,QAAa,OAAO,CAAC,OAAO,CAAC,CAa9C;CACH"}

package/dist/core/rave.js

@@ -40,13 +40,11 @@ const mesh_factory_1 = require("../factories/mesh-factory");
 const user_factory_1 = require("../factories/user-factory");
 const logger_1 = __importStar(require("../utils/logger"));
 const httpworkflow_1 = require("./httpworkflow");
-const responses_1 = require("../schemas/responses");
 const thread_factory_1 = require("../factories/thread-factory");
 const constants_1 = require("../constants");
 const utils_1 = require("../utils/utils");
 class Rave {
     constructor(config = {}) {
-        var _a, _b, _c;
         this.offProxy = () => {
             this.__http.offDispatcher();
         };
@@ -62,38 +60,8 @@ class Rave {
             }
             return true;
         };
-        this.refreshJWT = async (deviceId) => {
-            var _a, _b;
-            const { data } = await this.__http.sendGet({
-                path: `/users/self/validateMe?deviceId=${deviceId || ((_b = (_a = this.__config) === null || _a === void 0 ? void 0 : _a.credentials) === null || _b === void 0 ? void 0 : _b.deviceId)}`,
-            }, responses_1.ValidateMeSchema);
-            this.__http.weMeshToken = data;
-            return data;
-        };
-        this.getAccount = async () => {
-            var _a, _b;
-            const { data } = await this.__http.sendPost({
-                path: '/auth/login',
-                body: JSON.stringify({
-                    adId: constants_1.PATCHED_DEVICE.adId,
-                    carrierCountry: constants_1.DEFAULT_LANGUAGE.toUpperCase(),
-                    deviceId: (_b = (_a = this.__config) === null || _a === void 0 ? void 0 : _a.credentials) === null || _b === void 0 ? void 0 : _b.deviceId,
-                    lang: constants_1.DEFAULT_LANGUAGE,
-                    storeCountry: constants_1.DEFAULT_LANGUAGE.toUpperCase(),
-                }),
-            }, responses_1.GetAccountSchema);
-            this.__config = Object.assign(Object.assign({}, this.__config), { account: data });
-            return this.__config.account;
-        };
         this.__config = config;
         this.__http = new httpworkflow_1.HttpWorkflow();
-        if ((_a = this.__config.credentials) === null || _a === void 0 ? void 0 : _a.token) {
-            this.__http.token = this.__config.credentials.token;
-            if ((_b = this.__config.credentials) === null || _b === void 0 ? void 0 : _b.autoAccount)
-                this.getAccount();
-            if ((_c = this.__config.credentials) === null || _c === void 0 ? void 0 : _c.autoJWT)
-                this.refreshJWT();
-        }
         (0, logger_1.default)(!!config.enableLogging);
     }
     get token() {
@@ -102,18 +70,15 @@ class Rave {
     get JWT() {
         return this.__http.weMeshToken;
     }
-    get account() {
-        var _a;
-        if (!((_a = this.__config) === null || _a === void 0 ? void 0 : _a.account)) {
-            throw new Error('Account not found');
-        }
-        return this.__config.account;
-    }
     get auth() {
         if (!this.__authFactory)
             return (this.__authFactory = new auth_factory_1.AuthFactory(this.__config, this.__http));
         return this.__authFactory;
     }
+    get account() {
+        var _a;
+        return (_a = this.__config) === null || _a === void 0 ? void 0 : _a.account;
+    }
     get user() {
         if (!this.__userFactory)
             return (this.__userFactory = new user_factory_1.UserFactory(this.__http));

package/dist/factories/auth-factory.d.ts

@@ -1,11 +1,15 @@
 import { HttpWorkflow } from '../core/httpworkflow';
 import { RaveConfig } from '../schemas';
+import { Account } from '../schemas/rave/account';
 import { AuthenticateResponse, CheckRegisterStateResponse, MojoLoginResponse, ParseUserCredentialsResponse, SendMagicLinkResponse } from '../schemas/responses';
 export declare class AuthFactory {
     private __config;
     private readonly __http;
     constructor(config: RaveConfig | undefined, http: HttpWorkflow);
     private __authenticator;
+    getAccount: () => Promise<Account>;
+    refreshJWT: (deviceId?: string) => Promise<string>;
+    authenticate: (token: string, deviceId: string) => Promise<Account>;
     sendMagicLink: (email: string, language?: string) => Promise<SendMagicLinkResponse>;
     checkRegisterState: (stateId: string) => Promise<CheckRegisterStateResponse>;
     parseUserCredentials: (idToken: string, email: string) => Promise<ParseUserCredentialsResponse>;

package/dist/factories/auth-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-factory.d.ts","sourceRoot":"","sources":["../../src/factories/auth-factory.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAEL,oBAAoB,EACpB,0BAA0B,EAE1B,iBAAiB,EAEjB,4BAA4B,EAE5B,qBAAqB,EAEtB,MAAM,sBAAsB,CAAC;AAI9B,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,UAAU,YAAK,EAAE,IAAI,EAAE,YAAY;IAKvD,OAAO,CAAC,eAAe,CAsCrB;IAEK,aAAa,UACX,MAAM,aACH,MAAM,KACf,OAAO,CAAC,qBAAqB,CAAC,CAU/B;IAEK,kBAAkB,YACd,MAAM,KACd,OAAO,CAAC,0BAA0B,CAAC,CASpC;IAEK,oBAAoB,YAChB,MAAM,SACR,MAAM,KACZ,OAAO,CAAC,4BAA4B,CAAC,CAiBtC;IAEK,SAAS,UACP,MAAM,WACJ,MAAM,cACH,MAAM,QACZ,MAAM,aACF,MAAM,aACN,MAAM,KACf,OAAO,CAAC,iBAAiB,CAAC,CAsB3B;IAEK,KAAK,YACD,MAAM,SACR,MAAM,aACF,MAAM,aACN,MAAM,KAChB,OAAO,CAAC,oBAAoB,CAAC,CAQ9B;IAEK,QAAQ,YACJ,MAAM,SACR,MAAM,aACF,MAAM,aACN,MAAM,KAChB,OAAO,CAAC,oBAAoB,CAAC,CAQ9B;CACH"}
+{"version":3,"file":"auth-factory.d.ts","sourceRoot":"","sources":["../../src/factories/auth-factory.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAEL,oBAAoB,EACpB,0BAA0B,EAE1B,iBAAiB,EAEjB,4BAA4B,EAE5B,qBAAqB,EAMtB,MAAM,sBAAsB,CAAC;AAI9B,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,UAAU,YAAK,EAAE,IAAI,EAAE,YAAY;IAKvD,OAAO,CAAC,eAAe,CAsCrB;IAEK,UAAU,QAAa,OAAO,CAAC,OAAO,CAAC,CAqB5C;IAEK,UAAU,cAAqB,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,CAU5D;IAEK,YAAY,UACV,MAAM,YACH,MAAM,KACf,OAAO,CAAC,OAAO,CAAC,CAYjB;IAEK,aAAa,UACX,MAAM,aACH,MAAM,KACf,OAAO,CAAC,qBAAqB,CAAC,CAU/B;IAEK,kBAAkB,YACd,MAAM,KACd,OAAO,CAAC,0BAA0B,CAAC,CASpC;IAEK,oBAAoB,YAChB,MAAM,SACR,MAAM,KACZ,OAAO,CAAC,4BAA4B,CAAC,CAiBtC;IAEK,SAAS,UACP,MAAM,WACJ,MAAM,cACH,MAAM,QACZ,MAAM,aACF,MAAM,aACN,MAAM,KACf,OAAO,CAAC,iBAAiB,CAAC,CAsB3B;IAEK,KAAK,YACD,MAAM,SACR,MAAM,aACF,MAAM,aACN,MAAM,KAChB,OAAO,CAAC,oBAAoB,CAAC,CAQ9B;IAEK,QAAQ,YACJ,MAAM,SACR,MAAM,aACF,MAAM,aACN,MAAM,KAChB,OAAO,CAAC,oBAAoB,CAAC,CAQ9B;CACH"}

package/dist/factories/auth-factory.js

@@ -25,6 +25,37 @@ class AuthFactory {
                 token: userCredentials.sessionToken.slice(2, userCredentials.sessionToken.length),
             });
         };
+        this.getAccount = async () => {
+            var _a, _b;
+            const { data } = await this.__http.sendPost({
+                path: '/auth/login',
+                body: JSON.stringify({
+                    adId: constants_1.PATCHED_DEVICE.adId,
+                    carrierCountry: constants_1.DEFAULT_LANGUAGE.toUpperCase(),
+                    deviceId: (_b = (_a = this.__config) === null || _a === void 0 ? void 0 : _a.credentials) === null || _b === void 0 ? void 0 : _b.deviceId,
+                    lang: constants_1.DEFAULT_LANGUAGE,
+                    storeCountry: constants_1.DEFAULT_LANGUAGE.toUpperCase(),
+                }),
+            }, responses_1.GetAccountSchema);
+            this.__config = Object.assign(Object.assign({}, this.__config), { account: data });
+            return this.__config.account;
+        };
+        this.refreshJWT = async (deviceId) => {
+            var _a, _b;
+            const { data } = await this.__http.sendGet({
+                path: `/users/self/validateMe?deviceId=${deviceId || ((_b = (_a = this.__config) === null || _a === void 0 ? void 0 : _a.credentials) === null || _b === void 0 ? void 0 : _b.deviceId)}`,
+            }, responses_1.ValidateMeSchema);
+            this.__http.weMeshToken = data;
+            return data;
+        };
+        this.authenticate = async (token, deviceId) => {
+            this.__config.credentials = Object.assign(Object.assign({}, this.__config.credentials), { token,
+                deviceId });
+            this.__http.token = token;
+            const account = await this.getAccount();
+            await this.refreshJWT(deviceId);
+            return account;
+        };
         this.sendMagicLink = async (email, language = constants_1.DEFAULT_LANGUAGE) => {
             return await this.__http.sendRaw({
                 method: 'POST',

package/dist/schemas/public.d.ts

@@ -2,6 +2,15 @@ import z from 'zod';
 export declare const LanguagesSchema: z.ZodEnum<{
     ru: "ru";
     en: "en";
+    de: "de";
+    fr: "fr";
+    es: "es";
+    it: "it";
+    pt: "pt";
+    ar: "ar";
+    pl: "pl";
+    nl: "nl";
+    uk: "uk";
 }>;
 export declare const AuthenticatorMethodSchema: z.ZodEnum<{
     LOGIN: "LOGIN";
@@ -13,8 +22,6 @@ export declare const CredentialsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const RaveConfigSchema: z.ZodObject<{
     credentials: z.ZodOptional<z.ZodObject<{
-        autoJWT: z.ZodOptional<z.ZodBoolean>;
-        autoAccount: z.ZodOptional<z.ZodBoolean>;
         token: z.ZodString;
         deviceId: z.ZodString;
     }, z.core.$strip>>;
@@ -53,6 +60,15 @@ export declare const GetManyMeshesSchema: z.ZodObject<{
     language: z.ZodEnum<{
         ru: "ru";
         en: "en";
+        de: "de";
+        fr: "fr";
+        es: "es";
+        it: "it";
+        pt: "pt";
+        ar: "ar";
+        pl: "pl";
+        nl: "nl";
+        uk: "uk";
     }>;
 }, z.core.$strip>;
 export type Credentials = z.infer<typeof CredentialsSchema>;

package/dist/schemas/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/schemas/public.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAGpB,eAAO,MAAM,eAAe;;;EAAuB,CAAC;AACpD,eAAO,MAAM,yBAAyB;;;EAAgC,CAAC;AAEvE,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU3B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;iBAInC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;iBAO9B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/schemas/public.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAGpB,eAAO,MAAM,eAAe;;;;;;;;;;;;EAY1B,CAAC;AACH,eAAO,MAAM,yBAAyB;;;EAAgC,CAAC;AAEvE,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ3B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;iBAInC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;iBAO9B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACtE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/schemas/public.js

@@ -6,7 +6,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetManyMeshesSchema = exports.EditProfileBuilderSchema = exports.RaveConfigSchema = exports.CredentialsSchema = exports.AuthenticatorMethodSchema = exports.LanguagesSchema = void 0;
 const zod_1 = __importDefault(require("zod"));
 const account_1 = require("./rave/account");
-exports.LanguagesSchema = zod_1.default.enum(['en', 'ru']);
+exports.LanguagesSchema = zod_1.default.enum([
+    'en',
+    'ru',
+    'de',
+    'fr',
+    'es',
+    'it',
+    'pt',
+    'ar',
+    'pl',
+    'nl',
+    'uk',
+]);
 exports.AuthenticatorMethodSchema = zod_1.default.enum(['LOGIN', 'REGISTER']);
 exports.CredentialsSchema = zod_1.default.object({
     token: zod_1.default.string(),
@@ -14,7 +26,7 @@ exports.CredentialsSchema = zod_1.default.object({
 });
 exports.RaveConfigSchema = zod_1.default.object({
     credentials: zod_1.default
-        .object(Object.assign(Object.assign({}, exports.CredentialsSchema.shape), { autoJWT: zod_1.default.boolean().optional(), autoAccount: zod_1.default.boolean().optional() }))
+        .object(Object.assign({}, exports.CredentialsSchema.shape))
         .optional(),
     enableLogging: zod_1.default.boolean().optional(),
     account: account_1.AccountSchema.optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ravejs",
-  "version": "1.13.9",
+  "version": "1.15.9",
   "private": false,
   "main": "dist/index.js",
   "files": [

package/README.RU.MD

@@ -1,391 +0,0 @@
-  <div align="center">
-      <h1>RaveJS</h1>
-      <a href="https://t.me/aminodorks"><img src="https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white" alt="Telegram"></a>
-      <a href="https://www.npmjs.com/package/ravejs"><img src="https://img.shields.io/badge/NPM-%23CB3837.svg?style=for-the-badge&logo=npm&logoColor=white" alt="NPM"></a>
-  </div>
-  <div align="center">
-      <img src="https://img.shields.io/npm/dm/ravejs" alt="Downloads">
-      <img src="https://img.shields.io/npm/v/ravejs.svg" alt="Version">
-      <h2>RaveJS — библиотека на TypeScript для взаимодействия с API приложения Rave: Watch Party</h2>
-  </div> 
-  
-  - [README на английском](https://github.com/AminoDorks/ravejs/blob/master/README.MD)  
-  - [README на русском](https://github.com/AminoDorks/ravejs/blob/master/README.RU.MD)
-  
-  ---
-  
-  ## Содержание  
-  - [Возможности](#возможности)  
-  - [Начало работы](#начало-работы)  
-  - [Использование](#использование)  
-  - [Документация API](#документация-api)  
-  - [Участие в разработке](#участие-в-разработке)  
-  - [Лицензия](#лицензия)  
-  
-  ---
-  
-  ## Возможности  
-  
-  RaveJS обладает рядом преимуществ:  
-  - Модульная архитектура  
-  - Простота в использовании  
-  - Поддержка всех необходимых функций  
-  - Первая библиотека на TypeScript для Rave API  
-  
-  ---
-  
-  ## Начало работы  
-  
-  Чтобы начать использовать RaveJS, выполните следующие шаги:
-  
-  1. Инициализируйте npm-пакет:  
-  ```bash
-  npm init
-  ```
-  2. Установите TypeScript глобально (опционально):  
-  ```bash
-  npm install -g typescript
-  ```
-  3. Создайте конфигурацию TypeScript:  
-  ```bash
-  tsc --init
-  ```
-  4. Установите RaveJS:  
-  ```bash
-  npm install ravejs
-  ```
-  
-  ---
-  
-  ## Использование  
-  
-  ### Базовая авторизация  
-  
-  ```typescript
-  import { Rave } from 'ravejs';
-  
-  (async () => {
-    const rave = new Rave({
-      credentials: {
-        deviceId: 'ваш_device_id',
-        token: 'ваш_токен'
-      }
-    });
-    console.log(`Авторизован как ${(await rave.getAccount()).id}`);
-  })();
-  ```
-  
-  ---
-  
-  ## Документация API  
-  
-  ### `Rave(config: RaveConfig)`  
-  Главный класс для взаимодействия с API Rave.
-  
-  #### Конфигурация (`RaveConfig`)
-  - `credentials?`: `{ deviceId: string, token: string, autoJWT?: boolean, autoAccount?: boolean }` — данные для авторизации и опции  
-  - `enableLogging?`: `boolean` — включить логирование  
-  - `account?`: `Account` — профиль пользователя после авторизации  
-  
-  #### Свойства экземпляра `Rave`
-  1. `token: string` — Bearer-токен авторизации  
-  2. `JWT: string` — JWT-токен для Web Mesh API  
-  3. `account: Account` — информация о профиле пользователя  
-  4. `proxy?: string` — прокси для запросов (поддерживаются SOCKS-прокси; можно задать через сеттер)
-  
-  #### Методы экземпляра `Rave`
-  1. `refreshJWT(deviceId?: string): Promise<string>` — обновить JWT-токен  
-  2. `getAccount(): Promise<Account>` — получить данные авторизованного пользователя
-  3. `proxyIsAlive = async (): Promise<boolean>` - Проверить, работает ли прокси
-  
-  ---
-  
-  ### Фабрики  
-  
-  RaveJS использует модульную архитектуру, основанную на *фабриках*.
-  
-  ---
-  
-  #### `AuthFactory`  
-  Фабрика для авторизации и аутентификации. Доступна через `rave.auth`.
-  
-  ##### Методы `AuthFactory`
-  1. `sendMagicLink(email: string, language = 'ru'): Promise<{ stateId: string }>`  
-    Отправить «волшебную» ссылку на почту для входа или регистрации.
-  
-  2. `checkRegisterState(stateId: string): Promise<CheckRegisterStateResponse>`  
-    Проверить статус регистрации по `stateId`.  
-    **Ответ:**  
-  ```ts
-  {
-    authenticated: boolean,
-    isSecondFactorLogin: boolean,
-    oauth: {
-      accessToken: string,
-      idToken: string,
-      refreshToken: string,
-      expiresIn: string,
-      tokenType: string
-    },
-    user: {
-      createdAt: string,
-      updatedAt: string,
-      issuer: string,
-      userId: string,
-      identifier: string,
-      email: string
-    }
-  }
-  ```
-  
-  3. `parseUserCredentials(idToken: string, email: string): Promise<{ objectId: string; createdAt: string; username: string; sessionToken: string }>`  
-    Извлечь учётные данные из `idToken` и email.
-  
-  4. `mojoLogin(email: string, parseId: string, parseToken: string, name: string, deviceId?: string, language = 'ru'): Promise<{ data: { isValid: boolean; newUser: boolean; suggestedHandles: string[] } }>`  
-    Вход через сервис Mojo.
-  
-  5. `login(stateId: string, name?: string, deviceId?: string, language = 'ru'): Promise<AuthenticateResponse>`  
-    Упрощённый метод входа (комбинирует предыдущие шаги).  
-    **Ответ (`AuthenticateResponse`):**  
-  ```ts
-  {
-    isNewUser: boolean,
-    email: string,
-    username: string,
-    deviceId: string,
-    token: string
-  }
-  ```
-  
-  6. `register(email: string, name: string, deviceId?: string, language = 'ru'): Promise<RegisterResponse>`  
-    Регистрация нового пользователя (аналогично `login`, но гарантирует создание аккаунта).
-  
-  ---
-  
-  #### `MeshFactory`  
-  Фабрика для работы с *мешами* (комнатами просмотра). Доступна через `rave.mesh`.
-  
-  ##### Методы `MeshFactory`
-  1. `get(meshId: string): Promise<GetMeshResponse>`  
-    Получить информацию о меше по ID.  
-    **Ответ (`GetMeshResponse.data`):**
-  ```ts
-  {
-    blurT?: boolean;
-    category: string;
-    channel: number;
-    createdAt: string;
-    currentState: 'play' | 'paus';
-    explicit: boolean;
-    id: string;
-    isFriend: boolean;
-    isLocal: boolean;
-    isPublic: boolean;
-    kickMode: string;
-    maturity: string;
-    mediaUrl: string;
-    originator: number;
-    playMode: string;
-    position: number;
-    server: string;
-    shareLink: string;
-    thumbnails?: {
-      channel?: string;
-      standard?: string;
-      animated?: string;
-      maxres?: string;
-      medium?: string;
-      default?: string;
-      high?: string;
-    };
-    time: number;
-    videoAuthor: string;
-    videoDuration: number;
-    videoProvider: string;
-    videoPublishedAt: string;
-    videoThumbnail: string;
-    videoTitle: string;
-    videoUrl: string;
-    vikiPass: boolean;
-    voipMode: string;
-    users: {
-      avatar: string;
-      country: string;
-      displayName?: string;
-      handle?: string;
-      id: number;
-      lang?: string;
-      lat: number;
-      lng: number;
-      name: string;
-    }[];
-  }
-  ```
-  
-  2. `getByLink(meshLink: string): Promise<GetMeshResponse>`  
-    Получить меш по публичной ссылке (`shareLink`).
-  
-  3. `getMany(params: GetManyMeshesParams): Promise<GetMeshResponse[]>`  
-    Получить список мешей.  
-    **Параметры (`GetManyMeshesParams`):**
-  ```ts
-  {
-    isPublic?: boolean;
-    limit: number;
-    hasFriends: boolean;
-    local: boolean;
-    hasInvited: boolean;
-    language?: string;
-  }
-  ```
-  
-  4. `join(meshId: string): Promise<MeshSocket>`  
-    Присоединиться к мешу. Возвращает экземпляр `MeshSocket` для взаимодействия через WebSocket.
-  
-  ---
-  
-  #### `ThreadFactory`  
-  Фабрика для работы с переписками. Доступна через `rave.thread`.
-  
-  ##### Методы `ThreadFactory`
-  1. `getMany(): Promise<Thread[]>`  
-    Получить все переписки.  
-    **Структура `Thread`:**
-  ```ts
-  {
-    expiryMode: number;
-    isFriend: boolean;
-    myself: number;
-    opposingUser: number;
-    spokenLangs: string[];
-    threadId: string;
-  }
-  ```
-  
-  2. `create(userId: number): Promise<Thread>`  
-    Создать новую переписку с пользователем.
-  
-  3. `sendMessage(threadId: string, content: string): Promise<SendMessageResponse>`  
-    Отправить сообщение в переписку.  
-    **Ответ (`SendMessageResponse.data`):**
-  ```ts
-  {
-    correlateId: string;
-    threadId: string;
-    messageType: string;
-    originator: number;
-    messageBody: {
-      content: string;
-      detectedLang: string;
-      id: string;
-      translations: Record<string, string>;
-    }
-  }
-  ```
-  
-  ---
-  
-  #### `UserFactory`  
-  Фабрика для работы с пользователями. Доступна через `rave.user`.
-  
-  ##### Методы `UserFactory`
-  1. `get(userId: number): Promise<GetUserResponse>`  
-    Получить профиль пользователя.  
-    **Ответ (`GetUserResponse.data`):**
-  ```ts
-  {
-    bio: {
-      bio?: string;
-      metadata: { position: number; privacy: string };
-    };
-    profile: {
-      avatar: string;
-      country: string;
-      displayName?: string;
-      handle?: string;
-    };
-  }
-  ```
-  
-  2. `sendFriendship(userId: number): Promise<FriendshipResponse>`  
-    Отправить запрос на добавление в друзья.  
-    **Ответ (`FriendshipResponse.data`):**
-  ```ts
-  {
-    fromUserId: number;
-    state: string;
-    toUserId: number;
-  }
-  ```
-  
-  3. `acceptFriendship(userId: number): Promise<void>`  
-    Принять запрос в друзья.
-  
-  4. `declineFriendship(userId: number): Promise<void>`  
-    Отклонить запрос в друзья.
-  
-  5. `edit(builder: EditProfileBuilder): Promise<EditProfileResponse>`  
-    Редактировать профиль.  
-    **Параметры (`EditProfileBuilder`):**
-  ```ts
-  {
-    displayAvatar?: string;
-    displayName?: string;
-    handle?: string;
-  }
-  ```
-    **Ответ (`EditProfileResponse.data`)** — объект `User`.
-  
-  6. `getAvatarUpload(): Promise<GetAvatarUploadResponse>`  
-    Получить URL для загрузки аватара.  
-    **Ответ (`GetAvatarUploadResponse.data`):**
-  ```ts
-  {
-    expiresAt: string;
-    fileName: string;
-    mime: string;
-    uploadUrl: string;
-  }
-  ```
-  
-  7. `uploadOnUrl(uploadUrl: string, image: Buffer): Promise<void>`  
-    Загрузить изображение по полученному URL.
-  
-  8. `uploadAvatar(image: Buffer): Promise<string>`  
-    Упрощённый метод: получить URL и загрузить аватар за один вызов. Возвращает `displayAvatar` (новый URL аватара).
-  
-  ---
-  
-  #### `MeshSocket`  
-  Класс для работы с WebSocket-соединением в меше.
-  
-  ##### Методы и свойства `MeshSocket`
-  1. `onclose(handler: () => Promise<void>): void`  
-    Обработчик закрытия соединения.
-  
-  2. `onerror(handler: () => Promise<void>): void`  
-    Обработчик ошибок.
-  
-  3. `onmessage(handler: (data: string) => Promise<void>): void`  
-    Обработчик входящих сообщений (сырой JSON-строки).
-  
-  4. `sendMessage(content: string): void`  
-    Отправить сообщение в меш (например, команды управления воспроизведением).
-  
-  5. `leave(): void`  
-    Покинуть меш (закрывает сокет).
-  
-  ---
-  
-  ## Участие в разработке  
-  
-  Приветствуются pull request'ы и предложения по улучшению!  
-  Если вы используете мои генераторы кода — напишите мне в [личные сообщения Telegram](https://t.me/celt_is_god).
-  
-  ---
-  
-  ## Лицензия  
-  
-  RaveJS распространяется под лицензией **MIT**. Подробнее см. в файле [LICENSE](https://github.com/thatcelt/ravejs/blob/master/LICENSE).
-  
-  ---