itd-sdk-js 1.0.0

package/src/token-storage.js

@@ -0,0 +1,66 @@
+/**
+ * Утилита для сохранения токена в .env файл
+ */
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * Обновляет ITD_ACCESS_TOKEN в .env файле
+ * 
+ * @param {string} newToken - Новый access token
+ * @returns {Promise<boolean>} True если успешно
+ */
+export async function saveAccessToken(newToken) {
+    try {
+        const envPath = path.join(__dirname, '..', '.env');
+        
+        if (!fs.existsSync(envPath)) {
+            console.warn('⚠️  Файл .env не найден, токен не сохранен');
+            return false;
+        }
+        
+        let content = fs.readFileSync(envPath, 'utf8');
+        
+        // Ищем строку с ITD_ACCESS_TOKEN
+        const tokenRegex = /^ITD_ACCESS_TOKEN=.*$/m;
+        
+        if (tokenRegex.test(content)) {
+            // Заменяем существующий токен
+            content = content.replace(tokenRegex, `ITD_ACCESS_TOKEN=${newToken}`);
+        } else {
+            // Добавляем новую строку, если токена нет
+            content += `\nITD_ACCESS_TOKEN=${newToken}\n`;
+        }
+        
+        fs.writeFileSync(envPath, content, 'utf8');
+        console.log('✅ Токен сохранен в .env');
+        return true;
+    } catch (error) {
+        console.error('❌ Ошибка сохранения токена в .env:', error.message);
+        return false;
+    }
+}
+
+/**
+ * Сохраняет cookies в файл .cookies
+ * 
+ * @param {string} newCookieHeader - Новый cookie header
+ * @returns {Promise<boolean>} True если успешно
+ */
+export async function saveCookieHeader(newCookieHeader) {
+    try {
+        const cookiesPath = path.join(__dirname, '..', '.cookies');
+        
+        // Просто записываем cookies в файл (одна строка)
+        fs.writeFileSync(cookiesPath, newCookieHeader, 'utf8');
+        console.log('✅ Cookies сохранены в .cookies');
+        return true;
+    } catch (error) {
+        console.error('❌ Ошибка сохранения cookies в .cookies:', error.message);
+        return false;
+    }
+}

package/src/users.js

@@ -0,0 +1,416 @@
+/**
+ * Модуль для работы с пользователями
+ */
+export class UsersManager {
+    constructor(client) {
+        this.client = client;
+        this.axios = client.axios;
+    }
+
+    /**
+     * Обновляет описание профиля текущего пользователя
+     * 
+     * @param {string} bio - Новое описание профиля
+     * @param {string|null} displayName - Новое отображаемое имя (опционально)
+     * @returns {Promise<Object|null>} Обновленные данные профиля или null при ошибке
+     */
+    async updateProfile(bio, displayName = null) {
+        if (!await this.client.auth.checkAuth()) {
+            console.error('Ошибка: необходимо войти в аккаунт');
+            return null;
+        }
+
+        try {
+            const updateUrl = `${this.client.baseUrl}/api/users/me`;
+            
+            const updateData = {};
+            if (bio !== null && bio !== undefined) {
+                updateData.bio = bio;
+            }
+            if (displayName !== null && displayName !== undefined) {
+                updateData.displayName = displayName;
+            }
+
+            const response = await this.axios.put(updateUrl, updateData);
+
+            if (response.status === 200) {
+                return response.data;
+            } else {
+                console.error(`Ошибка обновления профиля: ${response.status}`);
+                if (response.data) {
+                    console.error('Response data:', response.data);
+                }
+                return null;
+            }
+        } catch (error) {
+            console.error('Исключение при обновлении профиля:', error.message);
+            if (error.response) {
+                console.error('Response status:', error.response.status);
+                console.error('Response data:', error.response.data);
+            }
+            return null;
+        }
+    }
+
+    /**
+     * Получает данные текущего пользователя
+     * 
+     * @returns {Promise<Object|null>} Данные профиля или null при ошибке
+     */
+    async getMyProfile() {
+        if (!await this.client.auth.checkAuth()) {
+            console.error('Ошибка: необходимо войти в аккаунт');
+            return null;
+        }
+
+        try {
+            const profileUrl = `${this.client.baseUrl}/api/users/me`;
+            const response = await this.axios.get(profileUrl);
+
+            if (response.status === 200) {
+                return response.data;
+            } else {
+                console.error(`Ошибка получения профиля: ${response.status}`);
+                if (response.data) {
+                    console.error('Response data:', response.data);
+                }
+                return null;
+            }
+        } catch (error) {
+            console.error('Исключение при получении профиля:', error.message);
+            if (error.response) {
+                console.error('Response status:', error.response.status);
+                console.error('Response data:', error.response.data);
+            }
+            return null;
+        }
+    }
+
+    /**
+     * Получает профиль пользователя по username
+     * 
+     * @param {string} username - Имя пользователя
+     * @returns {Promise<Object|null>} Данные профиля или null при ошибке
+     * 
+     * Примечание: Авторизация не требуется для просмотра публичных профилей
+     */
+    async getUserProfile(username) {
+        try {
+            const profileUrl = `${this.client.baseUrl}/api/users/${username}`;
+            const response = await this.axios.get(profileUrl);
+
+            if (response.status === 200) {
+                // Структура может быть { data: {...} } или просто {...}
+                return response.data.data || response.data;
+            } else {
+                console.error(`Ошибка получения профиля пользователя: ${response.status}`);
+                if (response.data) {
+                    console.error('Response data:', response.data);
+                }
+                return null;
+            }
+        } catch (error) {
+            console.error('Исключение при получении профиля пользователя:', error.message);
+            if (error.response) {
+                console.error('Response status:', error.response.status);
+                console.error('Response data:', error.response.data);
+            }
+            return null;
+        }
+    }
+
+    /**
+     * Подписывается на пользователя
+     * 
+     * @param {string} username - Имя пользователя
+     * @returns {Promise<Object|null>} { following: true, followersCount: number } или null при ошибке
+     */
+    async followUser(username) {
+        if (!await this.client.auth.checkAuth()) {
+            console.error('Ошибка: необходимо войти в аккаунт');
+            return null;
+        }
+
+        try {
+            const followUrl = `${this.client.baseUrl}/api/users/${username}/follow`;
+            const response = await this.axios.post(followUrl);
+
+            if (response.status === 200 || response.status === 201) {
+                return response.data; // { following: true, followersCount: number }
+            } else {
+                console.error(`Ошибка подписки: ${response.status}`);
+                if (response.data) {
+                    console.error('Response data:', response.data);
+                }
+                return null;
+            }
+        } catch (error) {
+            console.error('Исключение при подписке:', error.message);
+            if (error.response) {
+                console.error('Response status:', error.response.status);
+                console.error('Response data:', error.response.data);
+            }
+            return null;
+        }
+    }
+
+    /**
+     * Отписывается от пользователя
+     * 
+     * @param {string} username - Имя пользователя
+     * @returns {Promise<Object|null>} { following: false, followersCount: number } или null при ошибке
+     */
+    async unfollowUser(username) {
+        if (!await this.client.auth.checkAuth()) {
+            console.error('Ошибка: необходимо войти в аккаунт');
+            return null;
+        }
+
+        try {
+            const unfollowUrl = `${this.client.baseUrl}/api/users/${username}/follow`;
+            const response = await this.axios.delete(unfollowUrl);
+
+            if (response.status === 200 || response.status === 204) {
+                return response.data || { following: false, followersCount: 0 };
+            } else {
+                console.error(`Ошибка отписки: ${response.status}`);
+                if (response.data) {
+                    console.error('Response data:', response.data);
+                }
+                return null;
+            }
+        } catch (error) {
+            console.error('Исключение при отписке:', error.message);
+            if (error.response) {
+                console.error('Response status:', error.response.status);
+                console.error('Response data:', error.response.data);
+            }
+            return null;
+        }
+    }
+
+    /**
+     * Получает список подписчиков пользователя
+     * 
+     * @param {string} username - Имя пользователя
+     * @param {number} page - Номер страницы (начиная с 1)
+     * @param {number} limit - Количество на странице
+     * @returns {Promise<Object|null>} { users: [], pagination: {} } или null при ошибке
+     * 
+     * Примечание: Авторизация не требуется для просмотра подписчиков
+     */
+    async getFollowers(username, page = 1, limit = 30) {
+        try {
+            const followersUrl = `${this.client.baseUrl}/api/users/${username}/followers`;
+            const params = { page, limit };
+            const response = await this.axios.get(followersUrl, { params });
+
+            if (response.status === 200) {
+                const data = response.data;
+                // Структура: { data: { users: [...], pagination: {...} } }
+                if (data.data && data.data.users) {
+                    return {
+                        users: data.data.users,
+                        pagination: data.data.pagination || {}
+                    };
+                } else if (data.users) {
+                    return {
+                        users: data.users,
+                        pagination: data.pagination || {}
+                    };
+                }
+                return { users: [], pagination: {} };
+            } else {
+                console.error(`Ошибка получения подписчиков: ${response.status}`);
+                return null;
+            }
+        } catch (error) {
+            console.error('Исключение при получении подписчиков:', error.message);
+            if (error.response) {
+                console.error('Response status:', error.response.status);
+                console.error('Response data:', error.response.data);
+            }
+            return null;
+        }
+    }
+
+    /**
+     * Получает список подписок пользователя
+     * 
+     * @param {string} username - Имя пользователя
+     * @param {number} page - Номер страницы (начиная с 1)
+     * @param {number} limit - Количество на странице
+     * @returns {Promise<Object|null>} { users: [], pagination: {} } или null при ошибке
+     * 
+     * Примечание: Авторизация не требуется для просмотра подписок
+     */
+    async getFollowing(username, page = 1, limit = 30) {
+        try {
+            const followingUrl = `${this.client.baseUrl}/api/users/${username}/following`;
+            const params = { page, limit };
+            const response = await this.axios.get(followingUrl, { params });
+
+            if (response.status === 200) {
+                const data = response.data;
+                // Структура: { data: { users: [...], pagination: {...} } }
+                if (data.data && data.data.users) {
+                    return {
+                        users: data.data.users,
+                        pagination: data.data.pagination || {}
+                    };
+                } else if (data.users) {
+                    return {
+                        users: data.users,
+                        pagination: data.pagination || {}
+                    };
+                }
+                return { users: [], pagination: {} };
+            } else {
+                console.error(`Ошибка получения подписок: ${response.status}`);
+                return null;
+            }
+        } catch (error) {
+            console.error('Исключение при получении подписок:', error.message);
+            if (error.response) {
+                console.error('Response status:', error.response.status);
+                console.error('Response data:', error.response.data);
+            }
+            return null;
+        }
+    }
+
+    /**
+     * Получает клан пользователя (эмодзи из avatar)
+     * 
+     * @param {string} username - Имя пользователя
+     * @returns {Promise<string|null>} Эмодзи клана или null при ошибке
+     */
+    async getUserClan(username) {
+        const profile = await this.getUserProfile(username);
+        if (!profile) {
+            return null;
+        }
+        // Клан - это эмодзи в поле avatar
+        return profile.avatar || null;
+    }
+
+    /**
+     * Получает топ кланов по количеству участников
+     * 
+     * @returns {Promise<Array|null>} Массив кланов [{ avatar: "🦎", memberCount: 3794 }, ...] или null при ошибке
+     */
+    async getTopClans() {
+        try {
+            const topClansUrl = `${this.client.baseUrl}/api/users/stats/top-clans`;
+            const response = await this.axios.get(topClansUrl);
+
+            if (response.status === 200) {
+                const data = response.data;
+                // Структура: { clans: [...] }
+                return data.clans || [];
+            } else {
+                console.error(`Ошибка получения топ кланов: ${response.status}`);
+                return null;
+            }
+        } catch (error) {
+            console.error('Исключение при получении топ кланов:', error.message);
+            if (error.response) {
+                console.error('Response status:', error.response.status);
+                console.error('Response data:', error.response.data);
+            }
+            return null;
+        }
+    }
+
+    /**
+     * Получает рекомендации кого подписаться
+     * 
+     * @returns {Promise<Array|null>} Массив пользователей или null при ошибке
+     */
+    async getWhoToFollow() {
+        if (!await this.client.auth.checkAuth()) {
+            console.error('Ошибка: необходимо войти в аккаунт');
+            return null;
+        }
+
+        try {
+            const suggestionsUrl = `${this.client.baseUrl}/api/users/suggestions/who-to-follow`;
+            const response = await this.axios.get(suggestionsUrl);
+
+            if (response.status === 200) {
+                const data = response.data;
+                // Структура: { users: [...] }
+                return data.users || [];
+            } else {
+                console.error(`Ошибка получения рекомендаций: ${response.status}`);
+                return null;
+            }
+        } catch (error) {
+            console.error('Исключение при получении рекомендаций:', error.message);
+            if (error.response) {
+                console.error('Response status:', error.response.status);
+                console.error('Response data:', error.response.data);
+            }
+            return null;
+        }
+    }
+    
+    // ========== USER-FRIENDLY МЕТОДЫ ==========
+    
+    // getMyProfile() уже реализован выше (строка 60) - это удобный метод по умолчанию
+    
+    /**
+     * Проверяет, подписан ли текущий пользователь на указанного (удобный метод)
+     * 
+     * @param {string} username - Имя пользователя для проверки
+     * @returns {Promise<boolean>} True если подписан, false если нет или ошибка
+     */
+    async isFollowing(username) {
+        if (!await this.client.auth.checkAuth()) {
+            return false;
+        }
+        const profile = await this.getUserProfile(username);
+        return profile ? (profile.isFollowing === true) : false;
+    }
+    
+    /**
+     * Получает количество своих подписчиков (удобный метод)
+     * 
+     * @returns {Promise<number>} Количество подписчиков
+     */
+    async getMyFollowersCount() {
+        const profile = await this.getMyProfile();
+        return profile ? (profile.followersCount || 0) : 0;
+    }
+    
+    /**
+     * Получает количество своих подписок (удобный метод)
+     * 
+     * @returns {Promise<number>} Количество подписок
+     */
+    async getMyFollowingCount() {
+        const profile = await this.getMyProfile();
+        return profile ? (profile.followingCount || 0) : 0;
+    }
+    
+    /**
+     * Получает свой клан (эмодзи аватара) (удобный метод)
+     * 
+     * @returns {Promise<string|null>} Эмодзи клана или null
+     */
+    async getMyClan() {
+        const profile = await this.getMyProfile();
+        return profile ? (profile.avatar || null) : null;
+    }
+    
+    /**
+     * Получает клан пользователя (эмодзи аватара) (удобный метод)
+     * 
+     * @param {string} username - Имя пользователя
+     * @returns {Promise<string|null>} Эмодзи клана или null
+     */
+    async getUserClan(username) {
+        const profile = await this.getUserProfile(username);
+        return profile ? (profile.avatar || null) : null;
+    }
+}