@pushler/js 1.0.3 → 1.1.1

package/README.md

@@ -23,8 +23,7 @@ import Pushler from '@pushler/js';
 
 // Создание клиента
 const pushler = Pushler.Create({
-  appKey: 'your-app-key',
-  apiUrl: 'https://api.pushler.ru' // URL вашего бэкенда для авторизации каналов
+  appKey: 'your-app-key'
 });
 
 // Обработка событий подключения
@@ -57,8 +56,7 @@ import Pushler from '@pushler/js';
 // Создание серверного клиента
 const server = Pushler.Server({
   appKey: 'your-app-key',
-  appSecret: 'your-app-secret',
-  apiUrl: 'https://api.pushler.ru'
+  appSecret: 'your-app-secret'
 });
 
 // Отправка сообщения в канал
@@ -84,19 +82,44 @@ await server.trigger(
 ```javascript
 const pushler = Pushler.Create({
   appKey: 'your-app-key',           // Обязательно
-  apiUrl: 'https://api.pushler.ru', // URL вашего бэкенда для авторизации каналов
   authEndpoint: '/pushler/auth',    // Путь для авторизации приватных каналов
   autoConnect: true,                // Автоподключение (по умолчанию: true)
   reconnectDelay: 1000,             // Задержка переподключения (мс)
-  maxReconnectAttempts: 5           // Максимум попыток переподключения
+  maxReconnectAttempts: 5,          // Максимум попыток переподключения
+  
+  // Кастомные заголовки авторизации (опционально)
+  authHeaders: {
+    'Authorization': 'Bearer your-token'
+  },
+  
+  // Или динамические заголовки
+  getAuthHeaders: () => ({
+    'Authorization': `Bearer ${getToken()}`
+  })
 });
 ```
 
+#### Promise-based подключение
+
+```javascript
+// connect() возвращает Promise
+const { socketId } = await pushler.connect();
+console.log('Подключено! Socket ID:', socketId);
+
+// Или с таймаутом
+try {
+  await pushler.waitForConnection(10000); // 10 секунд
+} catch (error) {
+  console.error('Не удалось подключиться:', error.message);
+}
+```
+
 #### Методы
 
 | Метод | Описание |
 |-------|----------|
-| `connect()` | Подключиться к серверу |
+| `connect()` | Подключиться к серверу (возвращает Promise) |
+| `waitForConnection(timeout?)` | Ожидание подключения с таймаутом |
 | `disconnect()` | Отключиться от сервера |
 | `subscribe(channelName, options?)` | Подписаться на канал |
 | `unsubscribe(channelName)` | Отписаться от канала |
@@ -134,7 +157,6 @@ const pushler = Pushler.Create({
 const server = Pushler.Server({
   appKey: 'your-app-key',           // Обязательно
   appSecret: 'your-app-secret',     // Обязательно
-  apiUrl: 'https://api.pushler.ru', // URL API
   timeout: 10000                    // Таймаут запросов (мс)
 });
 ```

package/dist/pushler-ru.cjs

@@ -207,6 +207,8 @@ class PushlerClient {
     this.wsUrl = options.wsUrl || `wss://ws.pushler.ru/app/${this.appKey}`;
     this.apiUrl = options.apiUrl;
     this.authEndpoint = options.authEndpoint || '/pushler/auth'; // Путь для авторизации каналов
+    this.authHeaders = options.authHeaders || null; // Кастомные заголовки для авторизации
+    this.getAuthHeaders = options.getAuthHeaders || null; // Функция для динамических заголовков
     this.autoConnect = options.autoConnect !== false;
     this.reconnectDelay = options.reconnectDelay || 1000;
     this.maxReconnectAttempts = options.maxReconnectAttempts || 5;
@@ -221,6 +223,11 @@ class PushlerClient {
     this.reconnectTimer = null;
     this.authTimeout = null;
     
+    // Promise для ожидания подключения
+    this.connectionPromise = null;
+    this.connectionResolve = null;
+    this.connectionReject = null;
+    
     // Автоматическое подключение
     if (this.autoConnect) {
       this.connect();
@@ -256,13 +263,25 @@ class PushlerClient {
 
   /**
    * Подключение к WebSocket серверу
+   * @returns {Promise} Promise, который резолвится при успешном подключении
    */
   connect() {
-    if (this.connectionState === ConnectionStates.CONNECTED || 
-        this.connectionState === ConnectionStates.CONNECTING) {
-      return;
+    // Если уже подключены - возвращаем резолвленный Promise
+    if (this.connectionState === ConnectionStates.CONNECTED) {
+      return Promise.resolve({ socketId: this.socketId });
+    }
+    
+    // Если уже идёт подключение - возвращаем существующий Promise
+    if (this.connectionState === ConnectionStates.CONNECTING && this.connectionPromise) {
+      return this.connectionPromise;
     }
 
+    // Создаём новый Promise для ожидания подключения
+    this.connectionPromise = new Promise((resolve, reject) => {
+      this.connectionResolve = resolve;
+      this.connectionReject = reject;
+    });
+
     this.connectionState = ConnectionStates.CONNECTING;
     this.emit(Events.CONNECTION_STATE_CHANGED, this.connectionState);
 
@@ -277,7 +296,66 @@ class PushlerClient {
     } catch (error) {
       console.error('PushlerClient: Error creating WebSocket connection:', error);
       this.handleConnectionError(error);
+      if (this.connectionReject) {
+        this.connectionReject(error);
+        this.connectionPromise = null;
+        this.connectionResolve = null;
+        this.connectionReject = null;
+      }
     }
+    
+    return this.connectionPromise;
+  }
+
+  /**
+   * Ожидание установления соединения
+   * @param {number} timeout - Таймаут в мс (по умолчанию 10000)
+   * @returns {Promise} Promise с socketId
+   */
+  waitForConnection(timeout = 10000) {
+    // Если уже подключены
+    if (this.connectionState === ConnectionStates.CONNECTED && this.socketId) {
+      return Promise.resolve({ socketId: this.socketId });
+    }
+    
+    // Если есть активный Promise подключения
+    if (this.connectionPromise) {
+      return Promise.race([
+        this.connectionPromise,
+        new Promise((_, reject) => 
+          setTimeout(() => reject(new Error('Connection timeout')), timeout)
+        )
+      ]);
+    }
+    
+    // Если не подключаемся - начинаем подключение
+    if (this.connectionState === ConnectionStates.DISCONNECTED) {
+      return this.connect();
+    }
+    
+    // Для других состояний создаём Promise, который ждёт connected события
+    return new Promise((resolve, reject) => {
+      const timeoutId = setTimeout(() => {
+        this.off(Events.CONNECTED, onConnected);
+        this.off(Events.ERROR, onError);
+        reject(new Error('Connection timeout'));
+      }, timeout);
+      
+      const onConnected = (data) => {
+        clearTimeout(timeoutId);
+        this.off(Events.ERROR, onError);
+        resolve(data);
+      };
+      
+      const onError = (err) => {
+        clearTimeout(timeoutId);
+        this.off(Events.CONNECTED, onConnected);
+        reject(err);
+      };
+      
+      this.on(Events.CONNECTED, onConnected);
+      this.on(Events.ERROR, onError);
+    });
   }
 
   /**
@@ -367,6 +445,14 @@ class PushlerClient {
     
     console.log('Connection established with socket ID:', this.socketId);
     
+    // Резолвим Promise подключения
+    if (this.connectionResolve) {
+      this.connectionResolve({ socketId: this.socketId });
+      this.connectionPromise = null;
+      this.connectionResolve = null;
+      this.connectionReject = null;
+    }
+    
     // Переподписываемся на все каналы после переподключения
     this.resubscribeAllChannels();
     
@@ -543,6 +629,24 @@ class PushlerClient {
     }
   }
 
+  /**
+   * Получение заголовков для авторизации
+   */
+  getAuthRequestHeaders() {
+    const headers = { 'Content-Type': 'application/json' };
+    
+    // Динамические заголовки имеют приоритет
+    if (typeof this.getAuthHeaders === 'function') {
+      const dynamicHeaders = this.getAuthHeaders();
+      Object.assign(headers, dynamicHeaders);
+    } else if (this.authHeaders) {
+      // Статические заголовки
+      Object.assign(headers, this.authHeaders);
+    }
+    
+    return headers;
+  }
+
   /**
    * Получение подписи с бэкенда
    */
@@ -552,11 +656,15 @@ class PushlerClient {
       ? this.authEndpoint 
       : `${this.apiUrl}${this.authEndpoint}`;
     
+    const headers = this.getAuthRequestHeaders();
+    const hasAuthHeaders = this.authHeaders || this.getAuthHeaders;
+    
     const response = await fetch(authUrl, {
       method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-      },
+      headers,
+      // Если есть authHeaders, не используем credentials (JWT режим)
+      // Если нет — используем cookies
+      ...(hasAuthHeaders ? {} : { credentials: 'include' }),
       body: JSON.stringify({
         channel_name: channelName,
         socket_id: socketId,
@@ -566,7 +674,7 @@ class PushlerClient {
     });
 
     if (!response.ok) {
-      const error = await response.json();
+      const error = await response.json().catch(() => ({ error: 'Auth request failed' }));
       throw new Error(error.error || 'Failed to get channel signature');
     }
 
@@ -699,6 +807,14 @@ class PushlerClient {
     
     console.error('PushlerClient connection error:', fullErrorMessage);
     
+    // Реджектим Promise подключения
+    if (this.connectionReject) {
+      this.connectionReject(new Error(fullErrorMessage));
+      this.connectionPromise = null;
+      this.connectionResolve = null;
+      this.connectionReject = null;
+    }
+    
     this.emit(Events.ERROR, {
       code: ErrorCodes.CONNECTION_FAILED,
       message: fullErrorMessage,
@@ -806,11 +922,12 @@ var PushlerClient$1 = PushlerClient;
  * Используется на сервере Node.js для отправки событий в каналы
  */
 class PushlerServer {
+  static API_URL = 'https://api.pushler.ru';
+
   /**
    * @param {Object} options - Параметры клиента
    * @param {string} options.appKey - Ключ приложения (key_xxx)
    * @param {string} options.appSecret - Секрет приложения (secret_xxx)
-   * @param {string} [options.apiUrl='http://localhost:8000/api'] - URL API сервера
    * @param {number} [options.timeout=10000] - Таймаут запроса в мс
    */
   constructor(options = {}) {
@@ -823,7 +940,6 @@ class PushlerServer {
 
     this.appKey = options.appKey;
     this.appSecret = options.appSecret;
-    this.apiUrl = (options.apiUrl || 'http://localhost:8000/api').replace(/\/$/, '');
     this.timeout = options.timeout || 10000;
   }
 
@@ -1107,7 +1223,7 @@ class PushlerServer {
    * @returns {Promise<Object>} Результат запроса
    */
   async makeSignedRequest(method, endpoint, data = null) {
-    const url = this.apiUrl + endpoint;
+    const url = PushlerServer.API_URL + endpoint;
     const timestamp = Math.floor(Date.now() / 1000);
     const body = data ? JSON.stringify(data) : '';
     const signature = this.generateApiSignature(body, timestamp);
@@ -1155,7 +1271,7 @@ class PushlerServer {
    * @returns {Promise<Object>} Результат запроса
    */
   async makeHttpRequest(method, endpoint, data = null) {
-    const url = this.apiUrl + endpoint;
+    const url = PushlerServer.API_URL + endpoint;
     
     const headers = {
       'Content-Type': 'application/json',
@@ -1196,7 +1312,7 @@ class PushlerServer {
    * @returns {string}
    */
   getApiUrl() {
-    return this.apiUrl;
+    return PushlerServer.API_URL;
   }
 }