itd-sdk-js 1.0.0 → 1.0.2

package/API_REFERENCE.md

@@ -2,6 +2,20 @@
 
 Техническое руководство по методам и настройке библиотеки для работы с API сайта `итд.com`.
 
+## Установка
+
+### Через npm
+
+```bash
+npm install itd-sdk-js
+```
+
+### Использование
+
+```javascript
+import { ITDClient } from 'itd-sdk-js';
+```
+
 ## Настройка проекта
 
 ### 1. Переменные окружения (.env)
@@ -25,7 +39,7 @@
 JavaScript
 
 ```
-import { ITDClient } from './src/client.js';
+import { ITDClient } from 'itd-sdk-js';
 import dotenv from 'dotenv';
 
 dotenv.config();
@@ -49,6 +63,18 @@ client.auth.isAuthenticated = true;
 
 - **Параметры**: `text` (string), `imagePath` (string, опционально).
 
+### createWallPost(username, text, imagePath?)
+
+Создает пост **на стене другого пользователя** (wall post).
+
+- Делается через `POST /api/posts` с телом `{ content, wallRecipientId }`.
+- `wallRecipientId` — это **ID пользователя-получателя**, поэтому метод сначала запрашивает профиль через `getUserProfile(username)` и берет `profile.id`.
+
+- **Параметры**:
+  - `username` — username получателя (string)
+  - `text` — текст поста (string)
+  - `imagePath` — путь к изображению (string, опционально)
+
 ### getPost(postId)
 
 Запрашивает данные конкретного поста.
@@ -234,4 +260,4 @@ if (result.pagination.hasMore) {
 
 ---
 
-**Последнее обновление документации**: 2026-01-27.
+**Последнее обновление документации**: 2026-01-28.

package/README.md

@@ -10,16 +10,23 @@
 
 ## Установка
 
-Bash
+### Через npm (рекомендуется)
 
+```bash
+npm install itd-sdk-js
 ```
-npm install
 
+### Из исходников
+
+```bash
+git clone https://github.com/FriceKa/ITD-SDK-js.git
+cd ITD-SDK-js
+npm install
 ```
 
 ## Настройка
 
-1. Создайте `.env` на основе `.env.example`.
+1. Создайте `.env` на основе `.env.example` (или используйте переменные окружения).
 2. Вставьте свой `ITD_ACCESS_TOKEN` (его можно вытащить из Network в DevTools).
 3. Для работы авто-обновления сессии создайте файл `.cookies` и вставьте туда строку `Cookie` из любого запроса к сайту в браузере.
 
@@ -32,8 +39,9 @@ npm install
 JavaScript
 
 ```
-import { ITDClient } from './src/client.js';
+import { ITDClient } from 'itd-sdk-js';
 import dotenv from 'dotenv';
+
 dotenv.config();
 
 const client = new ITDClient();
@@ -76,6 +84,13 @@ console.log(`${stats.likes} лайков, ${stats.views} просмотров`);
 
 Полное описание каждого метода — в **[API_REFERENCE.md](API_REFERENCE.md)**.
 
+## Пост на чужой стене (wall post)
+
+```javascript
+// Пишем пост на стене другого пользователя (нужен wallRecipientId, SDK получит его сам)
+await client.createWallPost('ITD_API', 'Тестовый пост на чужой стене 🦫');
+```
+
 ## Важно
 
 Это неофициальный проект. Если разработчики сайта изменят структуру API или введут новую защиту, методы могут временно перестать работать. Используйте аккуратно и не спамьте запросами.

package/examples/README.md

@@ -58,8 +58,23 @@ node examples/auto-refresh.js
 
 ## ⚙️ Настройка перед запуском
 
-1. Установите зависимости: `npm install`
-2. Скопируйте `.env.example` в `.env` и заполните `ITD_ACCESS_TOKEN`
-3. Создайте файл `.cookies` и вставьте туда cookies из браузера
+### Установка через npm (рекомендуется)
+
+```bash
+npm install itd-sdk-js
+```
+
+### Установка из исходников
+
+```bash
+git clone https://github.com/FriceKa/ITD-SDK-js.git
+cd ITD-SDK-js
+npm install
+```
+
+### Конфигурация
+
+1. Скопируйте `.env.example` в `.env` и заполните `ITD_ACCESS_TOKEN`
+2. Создайте файл `.cookies` и вставьте туда cookies из браузера
 
 Подробнее см. **[README.md](../README.md)**

package/examples/auto-refresh.js

@@ -5,7 +5,7 @@
  * Вы просто используете API - всё работает "из коробки"!
  */
 
-import { ITDClient } from '../src/client.js';
+import { ITDClient } from 'itd-sdk-js';
 import dotenv from 'dotenv';
 
 dotenv.config();

package/examples/basic-usage.js

@@ -4,7 +4,7 @@
  * Показывает простоту работы с API через удобные методы.
  */
 
-import { ITDClient } from '../src/client.js';
+import { ITDClient } from 'itd-sdk-js';
 import dotenv from 'dotenv';
 
 dotenv.config();

package/examples/quick-start.js

@@ -11,7 +11,7 @@
  * 4. Запустите: node examples/quick-start.js
  */
 
-import { ITDClient } from '../src/client.js';
+import { ITDClient } from 'itd-sdk-js';
 import dotenv from 'dotenv';
 
 // Загружаем переменные окружения из .env файла

package/examples/user-friendly.js

@@ -5,7 +5,7 @@
  * Показывает, как просто работать с данными без сложных запросов.
  */
 
-import { ITDClient } from '../src/client.js';
+import { ITDClient } from 'itd-sdk-js';
 import dotenv from 'dotenv';
 
 dotenv.config();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "itd-sdk-js",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "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",

package/src/client.js

@@ -239,6 +239,18 @@ export class ITDClient {
         return await this.posts.createPost(text, imagePath);
     }
     
+    /**
+     * Создает пост на стене другого пользователя (wall post)
+     * 
+     * @param {string} username - Имя пользователя, на чью стену нужно написать
+     * @param {string} text - Текст поста
+     * @param {string|null} imagePath - Путь к изображению (опционально)
+     * @returns {Promise<Object|null>} Данные созданного поста или null
+     */
+    async createWallPost(username, text, imagePath = null) {
+        return await this.posts.createWallPost(username, text, imagePath);
+    }
+    
     /**
      * Редактирует пост (удобный метод)
      * 

package/src/posts.js

@@ -69,6 +69,71 @@ export class PostsManager {
         }
     }
     
+    /**
+     * Создает пост на стене другого пользователя (wall post)
+     * 
+     * @param {string} username - Имя пользователя, на чью стену нужно написать
+     * @param {string} text - Текст поста
+     * @param {string|null} imagePath - Путь к изображению (опционально)
+     * @returns {Promise<Object|null>} Данные созданного поста или null при ошибке
+     */
+    async createWallPost(username, text, imagePath = null) {
+        if (!await this.client.auth.checkAuth()) {
+            console.error('Ошибка: необходимо войти в аккаунт');
+            return null;
+        }
+        
+        try {
+            // Получаем профиль пользователя, чтобы получить его ID
+            const profile = await this.client.users.getUserProfile(username);
+            if (!profile || !profile.id) {
+                console.error(`Ошибка: не удалось получить профиль пользователя ${username}`);
+                return null;
+            }
+            
+            const wallRecipientId = profile.id;
+            
+            // Реальный URL из анализа
+            const postUrl = `${this.client.baseUrl}/api/posts`;
+            
+            // Подготовка данных с wallRecipientId
+            let postData = {
+                content: text,
+                wallRecipientId: wallRecipientId,  // ID получателя поста на стене
+            };
+            
+            // Если есть изображение
+            if (imagePath) {
+                // Сначала загружаем файл через /api/files/upload
+                const uploadedFile = await this.client.files.uploadFile(imagePath);
+                if (!uploadedFile) {
+                    console.error('Ошибка: не удалось загрузить изображение');
+                    return null;
+                }
+                
+                // Затем создаем пост с ID загруженного файла
+                postData.attachments = [uploadedFile.id];
+            }
+            
+            // Создаем пост на стене
+            const response = await this.axios.post(postUrl, postData);
+            
+            if (response.status === 200 || response.status === 201) {
+                return response.data;
+            } else {
+                console.error(`Ошибка создания поста на стене: ${response.status} - ${JSON.stringify(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;
+        }
+    }
+    
     /**
      * Получает список постов пользователя или ленту
      *