itd-sdk-js 1.0.8 → 1.1.0

package/src/notifications.js

@@ -8,14 +8,15 @@ export class NotificationsManager {
     }
 
     /**
-     * Получает список уведомлений
-     * 
+     * Получает список уведомлений.
+     * GET /api/notifications/?offset=0&limit=20 → { notifications: [], hasMore }
+     *
      * @param {number} limit - Количество уведомлений
-     * @param {string|null} cursor - Курсор для пагинации
-     * @param {string|null} type - Фильтр по типу: 'reply', 'like', 'wall_post', 'follow', 'comment' (опционально)
-     * @returns {Promise<Object|null>} { notifications: [], pagination: {} } или null при ошибке
+     * @param {number} offset - Смещение для пагинации
+     * @param {string|null} type - Фильтр по типу: 'reply', 'like', 'wall_post', 'follow', 'comment' (на клиенте)
+     * @returns {Promise<Object|null>} { notifications: [], hasMore } или null при ошибке
      */
-    async getNotifications(limit = 20, cursor = null, type = null) {
+    async getNotifications(limit = 20, offset = 0, type = null) {
         if (!await this.client.auth.checkAuth()) {
             console.error('Ошибка: необходимо войти в аккаунт');
             return null;
@@ -23,42 +24,20 @@ export class NotificationsManager {
 
         try {
             const notificationsUrl = `${this.client.baseUrl}/api/notifications`;
-            const params = { limit };
-            if (cursor) {
-                params.cursor = cursor;
-            }
-            // Пробуем передать type в параметрах (если API поддерживает)
-            if (type) {
-                params.type = type;
-            }
+            const params = { limit, offset };
 
             const response = await this.axios.get(notificationsUrl, { params });
 
             if (response.status === 200) {
                 const data = response.data;
-                let notifications = [];
-                let pagination = {};
-                
-                // Предполагаемая структура: { data: { notifications: [...], pagination: {...} } }
-                if (data.data && data.data.notifications) {
-                    notifications = data.data.notifications;
-                    pagination = data.data.pagination || {};
-                } else if (Array.isArray(data)) {
-                    notifications = data;
-                } else if (data.notifications) {
-                    notifications = data.notifications;
-                    pagination = data.pagination || {};
-                }
-                
-                // Фильтруем по типу на клиенте (если API не поддерживает фильтрацию)
+                let notifications = Array.isArray(data?.notifications) ? data.notifications : [];
+                const hasMore = Boolean(data?.hasMore);
+
                 if (type && notifications.length > 0) {
                     notifications = notifications.filter(notif => notif.type === type);
                 }
-                
-                return {
-                    notifications: notifications,
-                    pagination: pagination
-                };
+
+                return { notifications, hasMore };
             } else {
                 console.error(`Ошибка получения уведомлений: ${response.status}`);
                 return null;
@@ -73,6 +52,34 @@ export class NotificationsManager {
         }
     }
 
+    /**
+     * Отмечает несколько уведомлений как прочитанные.
+     * POST /api/notifications/read-batch → { success: true, count: number }
+     *
+     * @param {string[]} ids - Массив ID уведомлений
+     * @returns {Promise<Object|null>} { success: true, count } или null при ошибке
+     */
+    async markAsReadBatch(ids) {
+        if (!await this.client.auth.checkAuth()) {
+            console.error('Ошибка: необходимо войти в аккаунт');
+            return null;
+        }
+        if (!Array.isArray(ids) || ids.length === 0) {
+            return { success: true, count: 0 };
+        }
+        try {
+            const url = `${this.client.baseUrl}/api/notifications/read-batch`;
+            const response = await this.axios.post(url, { ids });
+            if (response.status === 200) {
+                return response.data;
+            }
+            return null;
+        } catch (error) {
+            console.error('Исключение при отметке уведомлений:', error.message);
+            return null;
+        }
+    }
+
     /**
      * Отмечает уведомление как прочитанное
      * 
@@ -143,8 +150,9 @@ export class NotificationsManager {
     }
 
     /**
-     * Отмечает все уведомления как прочитанные
-     * 
+     * Отмечает все уведомления как прочитанные.
+     * POST /api/notifications/read-all → { success: true }
+     *
      * @returns {Promise<boolean>} True если успешно
      */
     async markAllAsRead() {
@@ -154,12 +162,11 @@ export class NotificationsManager {
         }
 
         try {
-            // Нужно найти реальный endpoint, пока используем предположительный
             const readAllUrl = `${this.client.baseUrl}/api/notifications/read-all`;
             const response = await this.axios.post(readAllUrl);
 
             if (response.status === 200 || response.status === 204) {
-                return true;
+                return response.data?.success !== false;
             } else {
                 console.error(`Ошибка отметки всех уведомлений: ${response.status}`);
                 if (response.data) {
@@ -172,10 +179,6 @@ export class NotificationsManager {
             if (error.response) {
                 console.error('Response status:', error.response.status);
                 console.error('Response data:', error.response.data);
-                // Если 404 - значит endpoint неправильный, нужно найти реальный
-                if (error.response.status === 404) {
-                    console.error('💡 Endpoint не найден. Найди реальный URL в DevTools');
-                }
             }
             return false;
         }
@@ -195,21 +198,16 @@ export class NotificationsManager {
     
     /**
      * Получает только непрочитанные уведомления (удобный метод)
-     * 
+     *
      * @param {number} limit - Количество уведомлений
-     * @param {string|null} cursor - Курсор для пагинации
-     * @returns {Promise<Object|null>} { notifications: [], pagination: {} } или null
+     * @param {number} offset - Смещение для пагинации
+     * @returns {Promise<Object|null>} { notifications: [], hasMore } или null
      */
-    async getUnreadNotifications(limit = 20, cursor = null) {
-        const all = await this.getNotifications(limit, cursor);
+    async getUnreadNotifications(limit = 20, offset = 0) {
+        const all = await this.getNotifications(limit, offset);
         if (!all) return null;
-        
-        // Фильтруем только непрочитанные
         const unread = all.notifications.filter(n => !n.read);
-        return {
-            notifications: unread,
-            pagination: all.pagination
-        };
+        return { notifications: unread, hasMore: all.hasMore };
     }
 
 }

package/src/posts.js

@@ -230,6 +230,38 @@ export class PostsManager {
         }
     }
     
+    /**
+     * Получает лайкнутые посты пользователя.
+     * GET /api/posts/user/{username}/liked → { data: { posts: [], pagination: {} } }
+     *
+     * @param {string} username - Имя пользователя
+     * @param {number} limit - Количество постов (по умолчанию 20)
+     * @param {string|null} cursor - Курсор для пагинации (pagination.nextCursor)
+     * @returns {Promise<Object>} { posts: [], pagination: { limit, nextCursor, hasMore } }
+     */
+    async getLikedPosts(username, limit = 20, cursor = null) {
+        try {
+            const url = `${this.client.baseUrl}/api/posts/user/${encodeURIComponent(username)}/liked`;
+            const params = { limit };
+            if (cursor) params.cursor = cursor;
+
+            const response = await this.axios.get(url, { params });
+
+            if (response.status === 200) {
+                const data = response.data;
+                const inner = data?.data ?? data;
+                return {
+                    posts: inner?.posts || [],
+                    pagination: inner?.pagination || {}
+                };
+            }
+            return { posts: [], pagination: {} };
+        } catch (error) {
+            console.error('Ошибка получения лайкнутых постов:', error.message);
+            return { posts: [], pagination: {} };
+        }
+    }
+
     /**
      * Получает популярные посты (лента популярного)
      * 
@@ -257,6 +289,52 @@ export class PostsManager {
     }
     
     
+    /**
+     * Отмечает пост как просмотренный. POST /api/posts/{id}/view
+     *
+     * @param {string} postId - ID поста
+     * @returns {Promise<boolean>} True если успешно
+     */
+    async viewPost(postId) {
+        if (!await this.client.auth.checkAuth()) return false;
+        try {
+            const url = `${this.client.baseUrl}/api/posts/${postId}/view`;
+            const response = await this.axios.post(url);
+            return response.status === 200 || response.status === 201 || response.status === 204;
+        } catch (error) {
+            console.error('Исключение при отметке просмотра:', error.message);
+            return false;
+        }
+    }
+
+    /**
+     * Получает посты на стене пользователя. GET /api/posts/user/{username}/wall
+     *
+     * @param {string} username - Имя пользователя
+     * @param {number} limit - Количество
+     * @param {string|null} cursor - Курсор пагинации
+     * @returns {Promise<Object>} { posts: [], pagination: {} }
+     */
+    async getWallByUser(username, limit = 20, cursor = null) {
+        try {
+            const url = `${this.client.baseUrl}/api/posts/user/${encodeURIComponent(username)}/wall`;
+            const params = { limit };
+            if (cursor) params.cursor = cursor;
+            const response = await this.axios.get(url, { params });
+            if (response.status === 200) {
+                const data = response.data?.data ?? response.data;
+                return {
+                    posts: data?.posts || [],
+                    pagination: data?.pagination || {}
+                };
+            }
+            return { posts: [], pagination: {} };
+        } catch (error) {
+            console.error('Ошибка получения постов со стены:', error.message);
+            return { posts: [], pagination: {} };
+        }
+    }
+
     /**
      * Получает конкретный пост по ID
      * 
@@ -314,7 +392,7 @@ export class PostsManager {
             const response = await this.axios.put(editUrl, postData);
             
             if (response.status === 200) {
-                return response.data;
+                return response.data?.data ?? response.data;
             } else {
                 console.error(`Ошибка редактирования поста: ${response.status} - ${JSON.stringify(response.data)}`);
                 return null;
@@ -348,26 +426,40 @@ export class PostsManager {
             
             if (response.status === 200 || response.status === 204) {
                 return true;
-            } else {
-                console.error(`Ошибка удаления поста: ${response.status}`);
-                if (response.data) {
-                    console.error('Response data:', response.data);
-                }
-                return false;
             }
+            return false;
         } catch (error) {
             console.error('Исключение при удалении поста:', error.message);
-            if (error.response) {
-                console.error('Response status:', error.response.status);
-                console.error('Response data:', error.response.data);
-            }
+            return false;
+        }
+    }
+
+    /**
+     * Восстанавливает удалённый пост.
+     * POST /api/posts/{id}/restore — пустой ответ при успехе
+     *
+     * @param {string} postId - ID поста
+     * @returns {Promise<boolean>} True если успешно
+     */
+    async restorePost(postId) {
+        if (!await this.client.auth.checkAuth()) {
+            console.error('Ошибка: необходимо войти в аккаунт');
+            return false;
+        }
+        try {
+            const url = `${this.client.baseUrl}/api/posts/${postId}/restore`;
+            const response = await this.axios.post(url);
+            return response.status === 200 || response.status === 201 || response.status === 204;
+        } catch (error) {
+            console.error('Исключение при восстановлении поста:', error.message);
             return false;
         }
     }
     
     /**
-     * Закрепляет пост
-     * 
+     * Закрепляет пост.
+     * POST /api/posts/{id}/pin → { success: true, pinnedPostId }
+     *
      * @param {string} postId - ID поста
      * @returns {Promise<boolean>} True если успешно
      */
@@ -376,27 +468,41 @@ export class PostsManager {
             console.error('Ошибка: необходимо войти в аккаунт');
             return false;
         }
-        
         try {
             const pinUrl = `${this.client.baseUrl}/api/posts/${postId}/pin`;
             const response = await this.axios.post(pinUrl);
-            
             if (response.status === 200 || response.status === 201) {
-                return true;
-            } else {
-                console.error(`Ошибка закрепления поста: ${response.status}`);
-                if (response.data) {
-                    console.error('Response data:', response.data);
-                }
-                return false;
+                return response.data?.success !== false;
             }
+            return false;
         } catch (error) {
             console.error('Исключение при закреплении поста:', error.message);
-            if (error.response) {
-                console.error('Response status:', error.response.status);
-                console.error('Response data:', error.response.data);
+            return false;
+        }
+    }
+
+    /**
+     * Открепляет пост.
+     * DELETE /api/posts/{id}/pin → { success: true, pinnedPostId: null }
+     *
+     * @param {string} postId - ID поста
+     * @returns {Promise<boolean>} True если успешно
+     */
+    async unpinPost(postId) {
+        if (!await this.client.auth.checkAuth()) {
+            console.error('Ошибка: необходимо войти в аккаунт');
+            return false;
+        }
+        try {
+            const pinUrl = `${this.client.baseUrl}/api/posts/${postId}/pin`;
+            const response = await this.axios.delete(pinUrl);
+            if (response.status === 200 || response.status === 204) {
+                return response.data?.success !== false;
             }
             return false;
+        } catch (error) {
+            console.error('Исключение при откреплении поста:', error.message);
+            return false;
         }
     }
     
@@ -424,7 +530,7 @@ export class PostsManager {
             const response = await this.axios.post(repostUrl, repostData);
             
             if (response.status === 200 || response.status === 201) {
-                return response.data;
+                return response.data?.data ?? response.data;
             } else {
                 console.error(`Ошибка репоста: ${response.status}`);
                 if (response.data) {

package/src/reports.js

@@ -8,11 +8,12 @@ export class ReportsManager {
     }
 
     /**
-     * Отправляет репорт на пост, комментарий или пользователя
-     * 
+     * Отправляет репорт на пост, комментарий или пользователя.
+     * POST /api/reports → { data: { id, createdAt } }
+     *
      * @param {string} targetType - Тип цели: "post", "comment", "user"
      * @param {string} targetId - ID цели (поста, комментария или пользователя)
-     * @param {string} reason - Причина репорта (например, "other", "spam", "harassment", "inappropriate")
+     * @param {string} reason - Причина: "spam", "violence", "hate", "adult", "fraud", "other"
      * @param {string} description - Описание проблемы (опционально)
      * @returns {Promise<Object|null>} { id, createdAt } или null при ошибке
      */
@@ -61,9 +62,9 @@ export class ReportsManager {
 
     /**
      * Отправляет репорт на пост
-     * 
+     *
      * @param {string} postId - ID поста
-     * @param {string} reason - Причина репорта (по умолчанию "other")
+     * @param {string} reason - Причина: "spam", "violence", "hate", "adult", "fraud", "other" (по умолчанию "other")
      * @param {string} description - Описание проблемы
      * @returns {Promise<Object|null>} { id, createdAt } или null при ошибке
      */
@@ -75,7 +76,7 @@ export class ReportsManager {
      * Отправляет репорт на комментарий
      * 
      * @param {string} commentId - ID комментария
-     * @param {string} reason - Причина репорта (по умолчанию "other")
+     * @param {string} reason - Причина: "spam", "violence", "hate", "adult", "fraud", "other"
      * @param {string} description - Описание проблемы
      * @returns {Promise<Object|null>} { id, createdAt } или null при ошибке
      */
@@ -87,7 +88,7 @@ export class ReportsManager {
      * Отправляет репорт на пользователя
      * 
      * @param {string} userId - ID пользователя
-     * @param {string} reason - Причина репорта (по умолчанию "other")
+     * @param {string} reason - Причина: "spam", "violence", "hate", "adult", "fraud", "other"
      * @param {string} description - Описание проблемы
      * @returns {Promise<Object|null>} { id, createdAt } или null при ошибке
      */

package/src/users.js

@@ -8,13 +8,16 @@ export class UsersManager {
     }
 
     /**
-     * Обновляет описание профиля текущего пользователя
-     * 
-     * @param {string} bio - Новое описание профиля
+     * Обновляет профиль текущего пользователя.
+     * PUT /api/users/me → { id, username, displayName, bio, updatedAt }
+     *
+     * @param {string|null} bio - Новое описание профиля (опционально)
      * @param {string|null} displayName - Новое отображаемое имя (опционально)
+     * @param {string|null} username - Новый username (опционально)
+     * @param {string|null} bannerId - ID загруженного баннера (опционально)
      * @returns {Promise<Object|null>} Обновленные данные профиля или null при ошибке
      */
-    async updateProfile(bio, displayName = null) {
+    async updateProfile(bio = null, displayName = null, username = null, bannerId = null) {
         if (!await this.client.auth.checkAuth()) {
             console.error('Ошибка: необходимо войти в аккаунт');
             return null;
@@ -22,19 +25,19 @@ export class UsersManager {
 
         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;
+            if (bio != null) updateData.bio = bio;
+            if (displayName != null) updateData.displayName = displayName;
+            if (username != null) updateData.username = username;
+            if (bannerId != null) updateData.bannerId = bannerId;
+            if (Object.keys(updateData).length === 0) {
+                return await this.getMyProfile();
             }
 
             const response = await this.axios.put(updateUrl, updateData);
 
             if (response.status === 200) {
-                return response.data;
+                return response.data?.data ?? response.data;
             } else {
                 console.error(`Ошибка обновления профиля: ${response.status}`);
                 if (response.data) {
@@ -86,6 +89,60 @@ export class UsersManager {
         }
     }
 
+    /**
+     * Получает настройки приватности текущего пользователя.
+     * GET /api/users/me/privacy → { isPrivate, wallClosed }
+     *
+     * @returns {Promise<Object|null>} { isPrivate, wallClosed } или null при ошибке
+     */
+    async getPrivacy() {
+        if (!await this.client.auth.checkAuth()) {
+            console.error('Ошибка: необходимо войти в аккаунт');
+            return null;
+        }
+        try {
+            const url = `${this.client.baseUrl}/api/users/me/privacy`;
+            const response = await this.axios.get(url);
+            if (response.status === 200) {
+                return response.data?.data ?? response.data;
+            }
+            return null;
+        } catch (error) {
+            console.error('Ошибка получения приватности:', error.message);
+            return null;
+        }
+    }
+
+    /**
+     * Обновляет настройки приватности.
+     * PUT /api/users/me/privacy → { isPrivate, wallClosed }
+     *
+     * @param {Object} options - { isPrivate?: boolean, wallClosed?: boolean }
+     * @returns {Promise<Object|null>} { isPrivate, wallClosed } или null при ошибке
+     */
+    async updatePrivacy(options = {}) {
+        if (!await this.client.auth.checkAuth()) {
+            console.error('Ошибка: необходимо войти в аккаунт');
+            return null;
+        }
+        try {
+            const url = `${this.client.baseUrl}/api/users/me/privacy`;
+            const payload = {};
+            if (options.isPrivate != null) payload.isPrivate = options.isPrivate;
+            if (options.wallClosed != null) payload.wallClosed = options.wallClosed;
+            if (Object.keys(payload).length === 0) return await this.getPrivacy();
+
+            const response = await this.axios.put(url, payload);
+            if (response.status === 200) {
+                return response.data?.data ?? response.data;
+            }
+            return null;
+        } catch (error) {
+            console.error('Ошибка обновления приватности:', error.message);
+            return null;
+        }
+    }
+
     /**
      * Получает профиль пользователя по username
      * 
@@ -306,9 +363,8 @@ export class UsersManager {
             const response = await this.axios.get(topClansUrl);
 
             if (response.status === 200) {
-                const data = response.data;
-                // Структура: { clans: [...] }
-                return data.clans || [];
+                const data = response.data?.data ?? response.data;
+                return data?.clans || [];
             } else {
                 console.error(`Ошибка получения топ кланов: ${response.status}`);
                 return null;
@@ -403,15 +459,4 @@ export class UsersManager {
         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;
-    }
 }

package/src/verification.js

@@ -0,0 +1,50 @@
+/**
+ * Модуль верификации аккаунта
+ */
+export class VerificationManager {
+    constructor(client) {
+        this.client = client;
+        this.axios = client.axios;
+    }
+
+    /**
+     * Получает статус верификации. GET /api/verification/status
+     *
+     * @returns {Promise<Object|null>} Статус верификации или null
+     */
+    async getStatus() {
+        if (!await this.client.auth.checkAuth()) return null;
+        try {
+            const url = `${this.client.baseUrl}/api/verification/status`;
+            const response = await this.axios.get(url);
+            if (response.status === 200) {
+                return response.data?.data ?? response.data;
+            }
+            return null;
+        } catch (error) {
+            console.error('Ошибка получения статуса верификации:', error.message);
+            return null;
+        }
+    }
+
+    /**
+     * Подаёт заявку на верификацию. POST /api/verification/submit
+     *
+     * @param {string} videoUrl - URL загруженного видео (из uploadFile)
+     * @returns {Promise<Object|null>} { success, request: { id, status, ... } } или null
+     */
+    async submit(videoUrl) {
+        if (!await this.client.auth.checkAuth()) return null;
+        try {
+            const url = `${this.client.baseUrl}/api/verification/submit`;
+            const response = await this.axios.post(url, { videoUrl });
+            if (response.status === 200 || response.status === 201) {
+                return response.data?.data ?? response.data;
+            }
+            return null;
+        } catch (error) {
+            console.error('Ошибка подачи заявки на верификацию:', error.message);
+            return null;
+        }
+    }
+}