itd-sdk-js 1.0.0

package/examples/quick-start.js

@@ -0,0 +1,326 @@
+/**
+ * 🚀 QUICK START - Быстрый старт с ITD SDK
+ * 
+ * Этот пример показывает основные возможности SDK с подробными комментариями.
+ * Идеально для тех, кто только начинает работать с библиотекой.
+ * 
+ * ПЕРЕД ЗАПУСКОМ:
+ * 1. Установите зависимости: npm install
+ * 2. Скопируйте .env.example в .env и заполните ITD_ACCESS_TOKEN
+ * 3. Создайте файл .cookies и вставьте туда cookies из браузера
+ * 4. Запустите: node examples/quick-start.js
+ */
+
+import { ITDClient } from '../src/client.js';
+import dotenv from 'dotenv';
+
+// Загружаем переменные окружения из .env файла
+dotenv.config();
+
+async function quickStart() {
+    console.log('🚀 === ITD SDK - Quick Start ===\n');
+
+    // ============================================
+    // ШАГ 1: Создание клиента
+    // ============================================
+    console.log('📦 Шаг 1: Создаю клиент...\n');
+    
+    // Создаем экземпляр клиента
+    // Клиент автоматически:
+    // - Загружает настройки из .env (ITD_BASE_URL, ITD_USER_AGENT и т.д.)
+    // - Загружает cookies из файла .cookies
+    // - Настраивает автоматическое обновление токена
+    const client = new ITDClient();
+    
+    console.log('✅ Клиент создан\n');
+
+    // ============================================
+    // ШАГ 2: Настройка авторизации
+    // ============================================
+    console.log('🔐 Шаг 2: Настраиваю авторизацию...\n');
+    
+    // Получаем токен из переменных окружения (.env файл)
+    const accessToken = process.env.ITD_ACCESS_TOKEN;
+    
+    if (!accessToken) {
+        console.log('❌ ОШИБКА: ITD_ACCESS_TOKEN не найден в .env\n');
+        console.log('📋 Как получить токен:');
+        console.log('1. Откройте итд.com в браузере и войдите');
+        console.log('2. Откройте DevTools (F12) → вкладка Network');
+        console.log('3. Найдите запрос POST /api/v1/auth/refresh');
+        console.log('4. Откройте Response → скопируйте accessToken');
+        console.log('5. Вставьте в .env: ITD_ACCESS_TOKEN=ваш_токен\n');
+        return;
+    }
+    
+    // Устанавливаем токен в клиент
+    // Это нужно для авторизации всех запросов
+    client.setAccessToken(accessToken);
+    
+    // Помечаем клиент как авторизованный
+    // Это позволяет использовать методы, требующие авторизации
+    client.auth.isAuthenticated = true;
+    
+    console.log('✅ Авторизация настроена (токен загружен из .env)\n');
+
+    // ============================================
+    // ШАГ 3: Получение информации о себе
+    // ============================================
+    console.log('👤 Шаг 3: Получаю информацию о текущем пользователе...\n');
+    
+    // Получаем профиль текущего авторизованного пользователя
+    // Этот метод требует авторизации
+    const myProfile = await client.getMyProfile();
+    
+    if (myProfile) {
+        console.log('✅ Профиль получен:');
+        console.log(`   Имя: ${myProfile.displayName}`);
+        console.log(`   Username: @${myProfile.username}`);
+        console.log(`   Клан (эмодзи): ${myProfile.avatar}`);
+        console.log(`   Подписчиков: ${myProfile.followersCount || 0}`);
+        console.log(`   Подписок: ${myProfile.followingCount || 0}`);
+        console.log(`   Постов: ${myProfile.postsCount || 0}\n`);
+    } else {
+        console.log('⚠️  Не удалось получить профиль (возможно токен недействителен)\n');
+        return;
+    }
+
+    // ============================================
+    // ШАГ 4: Получение постов пользователя
+    // ============================================
+    console.log('📰 Шаг 4: Получаю посты пользователя...\n');
+    
+    // Получаем последние 5 постов пользователя
+    // Параметры:
+    // - username: имя пользователя (или null для своих постов)
+    // - limit: количество постов (по умолчанию 20)
+    // - sort: сортировка ('new', 'old', 'popular')
+    const username = myProfile.username; // Используем свой username
+    const postsResult = await client.getPosts(username, 5, 'new');
+    
+    if (postsResult && postsResult.posts.length > 0) {
+        console.log(`✅ Найдено постов: ${postsResult.posts.length}\n`);
+        
+        // Показываем первый пост
+        const firstPost = postsResult.posts[0];
+        console.log('📝 Первый пост:');
+        console.log(`   ID: ${firstPost.id}`);
+        console.log(`   Текст: ${(firstPost.content || 'Без текста').substring(0, 100)}...`);
+        console.log(`   Лайков: ${firstPost.likesCount || 0}`);
+        console.log(`   Комментариев: ${firstPost.commentsCount || 0}`);
+        console.log(`   Просмотров: ${firstPost.viewsCount || 0}`);
+        console.log(`   Дата: ${new Date(firstPost.createdAt).toLocaleString('ru-RU')}\n`);
+        
+        // Сохраняем ID первого поста для дальнейших примеров
+        const postId = firstPost.id;
+        
+        // ============================================
+        // ШАГ 5: Лайк поста
+        // ============================================
+        console.log('❤️  Шаг 5: Ставлю лайк на первый пост...\n');
+        
+        // Ставим лайк на пост
+        // Метод возвращает объект с информацией о лайке
+        const likeResult = await client.likePost(postId);
+        
+        if (likeResult) {
+            console.log(`✅ Лайк поставлен! Всего лайков: ${likeResult.likesCount}\n`);
+        } else {
+            console.log('⚠️  Не удалось поставить лайк (возможно уже лайкнуто)\n');
+        }
+        
+        // ============================================
+        // ШАГ 6: Получение комментариев
+        // ============================================
+        console.log('💬 Шаг 6: Получаю комментарии к посту...\n');
+        
+        // Получаем комментарии к посту
+        // Параметры:
+        // - postId: ID поста
+        // - limit: количество комментариев (по умолчанию 20)
+        // - sort: сортировка ('new', 'old', 'popular')
+        const commentsResult = await client.getComments(postId, 5, 'new');
+        
+        if (commentsResult && commentsResult.comments.length > 0) {
+            console.log(`✅ Найдено комментариев: ${commentsResult.comments.length}\n`);
+            
+            // Показываем первый комментарий
+            const firstComment = commentsResult.comments[0];
+            console.log('💬 Первый комментарий:');
+            console.log(`   Автор: @${firstComment.author.username}`);
+            console.log(`   Текст: ${(firstComment.content || '').substring(0, 80)}...`);
+            console.log(`   Лайков: ${firstComment.likesCount || 0}\n`);
+        } else {
+            console.log('📝 Комментариев пока нет\n');
+        }
+        
+        // ============================================
+        // ШАГ 7: Добавление комментария
+        // ============================================
+        console.log('✍️  Шаг 7: Добавляю комментарий к посту...\n');
+        
+        // Добавляем комментарий к посту
+        // Параметры:
+        // - postId: ID поста
+        // - text: текст комментария
+        // - replyToId: ID комментария для ответа (опционально)
+        const commentText = 'Отличный пост! 👍';
+        const newComment = await client.addComment(postId, commentText);
+        
+        if (newComment) {
+            console.log(`✅ Комментарий добавлен! ID: ${newComment.id}\n`);
+        } else {
+            console.log('⚠️  Не удалось добавить комментарий\n');
+        }
+        
+    } else {
+        console.log('📝 Посты не найдены\n');
+    }
+
+    // ============================================
+    // ШАГ 8: Получение профиля другого пользователя
+    // ============================================
+    console.log('🔍 Шаг 8: Получаю профиль другого пользователя...\n');
+    
+    // Получаем профиль другого пользователя (публичная информация)
+    // Этот метод НЕ требует авторизации
+    const otherUsername = 'nowkie'; // Пример: известный пользователь
+    const otherProfile = await client.getUserProfile(otherUsername);
+    
+    if (otherProfile) {
+        console.log(`✅ Профиль @${otherUsername}:`);
+        console.log(`   Имя: ${otherProfile.displayName}`);
+        console.log(`   Клан: ${otherProfile.avatar}`);
+        console.log(`   Подписчиков: ${otherProfile.followersCount || 0}`);
+        console.log(`   Постов: ${otherProfile.postsCount || 0}`);
+        console.log(`   Верифицирован: ${otherProfile.verified ? '✅' : '❌'}\n`);
+    } else {
+        console.log(`⚠️  Пользователь @${otherUsername} не найден\n`);
+    }
+
+    // ============================================
+    // ШАГ 9: Поиск пользователей
+    // ============================================
+    console.log('🔎 Шаг 9: Ищу пользователей...\n');
+    
+    // Ищем пользователей по запросу
+    // Параметры:
+    // - query: поисковый запрос
+    // - limit: максимальное количество результатов (по умолчанию 5)
+    const searchQuery = 'itd';
+    const searchResult = await client.searchUsers(searchQuery, 3);
+    
+    if (searchResult && searchResult.length > 0) {
+        console.log(`✅ Найдено пользователей: ${searchResult.length}\n`);
+        searchResult.forEach((user, index) => {
+            console.log(`   ${index + 1}. @${user.username} - ${user.displayName} (${user.followersCount} подписчиков)`);
+        });
+        console.log();
+    } else {
+        console.log('📝 Пользователи не найдены\n');
+    }
+
+    // ============================================
+    // ШАГ 10: Получение уведомлений
+    // ============================================
+    console.log('🔔 Шаг 10: Получаю уведомления...\n');
+    
+    // Получаем список уведомлений
+    // Параметры:
+    // - limit: количество уведомлений (по умолчанию 20)
+    // - cursor: курсор для пагинации (опционально)
+    const notificationsResult = await client.getNotifications(5);
+    
+    if (notificationsResult && notificationsResult.notifications.length > 0) {
+        console.log(`✅ Найдено уведомлений: ${notificationsResult.notifications.length}\n`);
+        
+        // Показываем первое уведомление
+        const firstNotification = notificationsResult.notifications[0];
+        console.log('🔔 Первое уведомление:');
+        console.log(`   Тип: ${firstNotification.type || 'N/A'}`);
+        console.log(`   Прочитано: ${firstNotification.read ? '✅' : '❌'}`);
+        console.log(`   Дата: ${new Date(firstNotification.createdAt).toLocaleString('ru-RU')}\n`);
+    } else {
+        console.log('📭 Уведомлений нет\n');
+    }
+
+    // ============================================
+    // ШАГ 11: Получение трендовых хэштегов
+    // ============================================
+    console.log('🏷️  Шаг 11: Получаю трендовые хэштеги...\n');
+    
+    // Получаем трендовые хэштеги
+    // Параметры:
+    // - limit: количество хэштегов (по умолчанию 10)
+    const hashtagsResult = await client.getTrendingHashtags(5);
+    
+    if (hashtagsResult && hashtagsResult.hashtags.length > 0) {
+        console.log(`✅ Найдено хэштегов: ${hashtagsResult.hashtags.length}\n`);
+        hashtagsResult.hashtags.forEach((hashtag, index) => {
+            console.log(`   ${index + 1}. #${hashtag.name} - ${hashtag.postsCount} постов`);
+        });
+        console.log();
+    } else {
+        console.log('📝 Хэштеги не найдены\n');
+    }
+
+    // ============================================
+    // ШАГ 12: Получение популярных постов (лента)
+    // ============================================
+    console.log('🔥 Шаг 12: Получаю популярные посты...\n');
+    
+    // Получаем популярные посты (публичная лента)
+    // Параметры:
+    // - limit: количество постов (по умолчанию 20)
+    // - cursor: курсор для пагинации (опционально)
+    const popularPosts = await client.getFeedPopular(3);
+    
+    if (popularPosts && popularPosts.posts.length > 0) {
+        console.log(`✅ Найдено популярных постов: ${popularPosts.posts.length}\n`);
+        
+        // Показываем самый популярный пост
+        const topPost = popularPosts.posts[0];
+        console.log('🔥 Самый популярный пост:');
+        console.log(`   Автор: @${topPost.author.username}`);
+        console.log(`   Лайков: ${topPost.likesCount}`);
+        console.log(`   Просмотров: ${topPost.viewsCount}`);
+        console.log(`   Текст: ${(topPost.content || 'Без текста').substring(0, 60)}...\n`);
+    } else {
+        console.log('📝 Популярные посты не найдены\n');
+    }
+
+    // ============================================
+    // ЗАВЕРШЕНИЕ
+    // ============================================
+    console.log('✅ === Quick Start завершен! ===\n');
+    console.log('📚 Что дальше?');
+    console.log('1. Изучите API_REFERENCE.md для полного списка методов');
+    console.log('2. Посмотрите другие примеры в папке examples/');
+    console.log('3. Создайте свой проект используя ITD SDK!\n');
+}
+
+// Запускаем quick start
+(async () => {
+    try {
+        await quickStart();
+    } catch (error) {
+        console.error('\n❌ ОШИБКА при выполнении:');
+        console.error(error.message);
+        
+        // Если есть детали ошибки - показываем их
+        if (error.response) {
+            console.error('\n📋 Детали ошибки:');
+            console.error(`   Статус: ${error.response.status}`);
+            console.error(`   Данные: ${JSON.stringify(error.response.data, null, 2)}`);
+        }
+        
+        // Полезные советы при ошибках
+        console.error('\n💡 Возможные решения:');
+        console.error('1. Проверьте, что ITD_ACCESS_TOKEN указан в .env');
+        console.error('2. Проверьте, что файл .cookies существует и содержит refresh_token');
+        console.error('3. Обновите токен в .env из браузера (DevTools → Network → /api/v1/auth/refresh)');
+        console.error('4. Обновите cookies в .cookies из браузера\n');
+        
+        process.exit(1);
+    }
+})();

package/examples/user-friendly.js

@@ -0,0 +1,79 @@
+/**
+ * ✨ Пример 2: Удобные методы (User-Friendly)
+ * 
+ * Демонстрирует преимущества удобных методов SDK.
+ * Показывает, как просто работать с данными без сложных запросов.
+ */
+
+import { ITDClient } from '../src/client.js';
+import dotenv from 'dotenv';
+
+dotenv.config();
+
+async function main() {
+    console.log('✨ === Удобные методы SDK ===\n');
+
+    const client = new ITDClient();
+    client.setAccessToken(process.env.ITD_ACCESS_TOKEN);
+    client.auth.isAuthenticated = true;
+
+    try {
+        // Пример 1: Проверка подписки - одна строка вместо сложного запроса
+        console.log('1️⃣  Проверка подписки:');
+        const username = 'BobrishYa';
+        const isFollowing = await client.isFollowing(username);
+        console.log(`   Подписан на ${username}: ${isFollowing ? '✅ Да' : '❌ Нет'}`);
+        console.log();
+
+        // Пример 2: Получение статистики поста - просто и понятно
+        console.log('2️⃣  Статистика поста:');
+        const postId = '936bd898-f1f4-4fcd-a498-f3a7ee8e67bb'; // Замените на реальный ID
+        const stats = await client.getPostStats(postId);
+        if (stats) {
+            console.log(`   Лайков: ${stats.likes}`);
+            console.log(`   Просмотров: ${stats.views}`);
+            console.log(`   Комментариев: ${stats.comments}`);
+            console.log(`   Репостов: ${stats.reposts}`);
+        } else {
+            console.log('   Пост не найден');
+        }
+        console.log();
+
+        // Пример 3: Проверка уведомлений - удобно и быстро
+        console.log('3️⃣  Проверка уведомлений:');
+        const hasUnread = await client.hasUnreadNotifications();
+        if (hasUnread) {
+            const unread = await client.getUnreadNotifications(5);
+            console.log(`   Непрочитанных: ${unread.notifications.length}`);
+            unread.notifications.forEach((notif, i) => {
+                console.log(`   ${i + 1}. ${notif.type} - ${notif.read ? '✅' : '🔔'}`);
+            });
+        } else {
+            console.log('   Нет непрочитанных уведомлений');
+        }
+        console.log();
+
+        // Пример 4: Получение клана пользователя - просто
+        console.log('4️⃣  Клан пользователя:');
+        const myClan = await client.getMyClan();
+        const userClan = await client.getUserClan(username);
+        console.log(`   Мой клан: ${myClan}`);
+        console.log(`   Клан ${username}: ${userClan}`);
+        console.log();
+
+        // Пример 5: Получение последнего поста - удобно
+        console.log('5️⃣  Последний пост пользователя:');
+        const latestPost = await client.getUserLatestPost(username);
+        if (latestPost) {
+            console.log(`   Последний пост: ${latestPost.content?.substring(0, 60)}...`);
+            console.log(`   Лайков: ${latestPost.likesCount}, Просмотров: ${latestPost.viewsCount}`);
+        } else {
+            console.log('   Постов не найдено');
+        }
+
+    } catch (error) {
+        console.error('❌ Ошибка:', error.message);
+    }
+}
+
+main();

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "itd-sdk-js",
+  "version": "1.0.0",
+  "description": "Unofficial SDK for итд.com - Node.js library for working with API. Automatic token refresh, session management, and convenient methods for posts, comments, users, and notifications.",
+  "main": "src/client.js",
+  "type": "module",
+  "exports": {
+    ".": "./src/client.js"
+  },
+  "files": [
+    "src/",
+    "README.md",
+    "API_REFERENCE.md",
+    "examples/auto-refresh.js",
+    "examples/basic-usage.js",
+    "examples/quick-start.js",
+    "examples/user-friendly.js",
+    "examples/README.md",
+    ".env.example",
+    ".cookies.example"
+  ],
+  "scripts": {
+    "test": "node examples/basic-usage.js"
+  },
+  "keywords": [
+    "itd",
+    "itd.com",
+    "api",
+    "client",
+    "sdk",
+    "blog",
+    "social-media",
+    "unofficial-api",
+    "nodejs",
+    "javascript"
+  ],
+  "author": "FriceKa",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FriceKa/ITD-SDK-js.git"
+  },
+  "bugs": {
+    "url": "https://github.com/FriceKa/ITD-SDK-js/issues"
+  },
+  "homepage": "https://github.com/FriceKa/ITD-SDK-js#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "axios-cookiejar-support": "^6.0.4",
+    "dotenv": "^16.3.1",
+    "form-data": "^4.0.0",
+    "tough-cookie": "^4.1.3"
+  }
+}

package/src/auth.js

@@ -0,0 +1,126 @@
+/**
+ * Модуль аутентификации
+ */
+import { saveAccessToken, saveCookieHeader } from './token-storage.js';
+
+export class AuthManager {
+    /**
+     * Управление аутентификацией
+     * 
+     * @param {ITDClient} client - Главный клиент
+     */
+    constructor(client) {
+        this.client = client;
+        this.axios = client.axios;
+        this.isAuthenticated = false;
+        this.userData = null;
+    }
+    
+    /**
+     * Обновляет accessToken через /api/v1/auth/refresh
+     * ВАЖНО: обычно этот endpoint работает только при наличии refresh-cookie,
+     * который браузер/сервер поставил ранее.
+     *
+     * @returns {Promise<string|null>} accessToken или null
+     */
+    async refreshAccessToken() {
+        try {
+            const refreshUrl = `${this.client.baseUrl}/api/v1/auth/refresh`;
+
+            const headers = {
+                'Referer': `${this.client.baseUrl}/`,
+                'Origin': this.client.baseUrl,
+            };
+
+            const response = await this.axios.post(refreshUrl, {}, { headers });
+
+            if (response.status === 200 && response.data?.accessToken) {
+                const newToken = response.data.accessToken;
+                
+                // Обновляем токен в клиенте
+                this.client.setAccessToken(newToken);
+                this.isAuthenticated = true;
+                
+                // Сохраняем токен в .env файл
+                await saveAccessToken(newToken);
+                
+                // Обновляем cookies, если они пришли в ответе
+                if (response.headers['set-cookie']) {
+                    const cookies = response.headers['set-cookie'];
+                    // Обновляем CookieJar с новыми cookies
+                    for (const cookieString of cookies) {
+                        try {
+                            this.client.cookieJar.setCookieSync(cookieString, this.client.baseUrl);
+                        } catch (e) {
+                            // Игнорируем ошибки парсинга отдельных cookies
+                        }
+                    }
+                    
+                    // Получаем все cookies из jar и обновляем .cookies файл
+                    try {
+                        const allCookies = await this.client.cookieJar.getCookiesSync(this.client.baseUrl);
+                        // Сохраняем только важные cookies (refresh_token и другие auth cookies)
+                        const importantCookies = allCookies.filter(c => 
+                            c.key === 'refresh_token' || 
+                            c.key.startsWith('__ddg') || 
+                            c.key === 'is_auth'
+                        );
+                        if (importantCookies.length > 0) {
+                            const cookieHeader = importantCookies.map(c => `${c.key}=${c.value}`).join('; ');
+                            await saveCookieHeader(cookieHeader);
+                        }
+                    } catch (e) {
+                        console.warn('⚠️  Не удалось сохранить обновленные cookies:', e.message);
+                    }
+                }
+                
+                return newToken;
+            }
+
+            return null;
+        } catch (error) {
+            if (error.response) {
+                console.error('refreshAccessToken failed:', error.response.status, error.response.data);
+            } else {
+                console.error('refreshAccessToken failed:', error.message);
+            }
+            return null;
+        }
+    }
+    
+    /**
+     * Выход из аккаунта
+     * 
+     * @returns {Promise<boolean>} True если успешно
+     */
+    async logout() {
+        try {
+            const logoutUrl = `${this.client.baseUrl}/api/v1/auth/sign-out`;
+            const response = await this.axios.post(logoutUrl);
+            
+            if (response.status === 200) {
+                this.isAuthenticated = false;
+                this.userData = null;
+                this.client.setAccessToken(null);
+                // Очистка cookies
+                this.axios.defaults.headers.common['Cookie'] = '';
+                return true;
+            }
+            return false;
+        } catch (error) {
+            console.error('Ошибка выхода:', error.message);
+            return false;
+        }
+    }
+    
+    /**
+     * Проверяет, авторизован ли пользователь
+     * 
+     * @returns {Promise<boolean>} True если авторизован
+     */
+    async checkAuth() {
+        // Проверяем наличие accessToken - если он есть, считаем что авторизован
+        // Реальная проверка происходит на уровне API (401 ошибка)
+        return !!(this.client.accessToken || this.isAuthenticated);
+    }
+}