@ipcom/asterisk-ari 0.0.157 → 0.0.159

package/dist/esm/index.js

@@ -1782,7 +1782,7 @@ var ChannelInstance = class {
    * Otherwise, all listeners for the given event type are removed.
    *
    * @param {T} event - The type of WebSocket event to remove listener(s) for
-   * @param {Function} [listener] - Optional specific listener to remove
+   * @param {(data: WebSocketEvent) => void} [listener] - Optional specific listener to remove
    * @throws {Error} If no event type is provided
    */
   off(event, listener) {
@@ -2744,7 +2744,7 @@ var PlaybackInstance = class {
    * Registers an event listener for a specific WebSocket event type.
    *
    * @param {T} event - Event type to listen for
-   * @param {Function} listener - Callback function for the event
+   * @param {(data: WebSocketEvent) => void} listener - Callback function for the event
    */
   on(event, listener) {
     if (!event) {
@@ -2772,7 +2772,7 @@ var PlaybackInstance = class {
    * Registers a one-time event listener for a specific WebSocket event type.
    *
    * @param {T} event - Event type to listen for
-   * @param {Function} listener - Callback function for the event
+   * @param {(data: WebSocketEvent) => void} listener - Callback function for the event
    */
   once(event, listener) {
     if (!event) {
@@ -2802,7 +2802,7 @@ var PlaybackInstance = class {
    * Removes event listener(s) for a specific WebSocket event type.
    *
    * @param {T} event - Event type to remove listener(s) for
-   * @param {Function} [listener] - Optional specific listener to remove
+   * @param {(data: WebSocketEvent) => void} [listener] - Optional specific listener to remove
    */
   off(event, listener) {
     if (!event) {
@@ -2983,11 +2983,11 @@ var Playbacks = class {
    * This method performs the following cleanup operations:
    * 1. Clears all pending timeouts in the event queue.
    * 2. Removes all playback instances.
-   * 
+   *
    * @remarks
    * This method should be called when the Playbacks instance is no longer needed
    * to ensure proper resource management and prevent memory leaks.
-   * 
+   *
    * @returns {void} This method doesn't return a value.
    */
   cleanup() {
@@ -3297,13 +3297,64 @@ var WebSocketClient = class extends EventEmitter4 {
       (event) => queryParams.append("event", event)
     );
     this.lastWsUrl = `${protocol}://${encodeURIComponent(username)}:${encodeURIComponent(password)}@${normalizedHost}/ari/events?${queryParams.toString()}`;
-    console.log("Connecting to WebSocket...");
     try {
       await this.initializeWebSocket(this.lastWsUrl);
     } finally {
       this.isConnecting = false;
     }
   }
+  /**
+   * Reconecta o WebSocket com uma lista atualizada de aplicações.
+   *
+   * @param {string[]} newApps - Lista de aplicações para reconectar
+   * @param {WebSocketEventType[]} [subscribedEvents] - Tipos de eventos para se inscrever (opcional)
+   * @returns {Promise<void>} Promise resolvida quando reconectado com sucesso
+   */
+  async reconnectWithApps(newApps, subscribedEvents) {
+    if (!newApps.length) {
+      throw new Error("At least one application name is required");
+    }
+    const uniqueApps = Array.from(/* @__PURE__ */ new Set([...this.apps, ...newApps]));
+    if (uniqueApps.length === this.apps.length && uniqueApps.every((app) => this.apps.includes(app))) {
+      console.log(
+        "No changes in applications list, maintaining current connection"
+      );
+      return;
+    }
+    console.log(
+      `Reconnecting WebSocket with updated applications: ${uniqueApps.join(", ")}`
+    );
+    this.apps = uniqueApps;
+    if (subscribedEvents) {
+      this.subscribedEvents = subscribedEvents;
+    }
+    if (this.ws) {
+      await new Promise((resolve) => {
+        this.once("disconnected", () => resolve());
+        this.close();
+      });
+    }
+    await this.connect();
+    console.log("WebSocket reconnected successfully with updated applications");
+  }
+  /**
+   * Adiciona novas aplicações à conexão WebSocket existente.
+   *
+   * @param {string[]} newApps - Lista de novas aplicações para adicionar
+   * @param {WebSocketEventType[]} [subscribedEvents] - Tipos de eventos para se inscrever (opcional)
+   * @returns {Promise<void>} Promise resolvida quando as aplicações são adicionadas com sucesso
+   */
+  async addApps(newApps, subscribedEvents) {
+    if (!newApps.length) {
+      throw new Error("At least one application name is required");
+    }
+    const appsToAdd = newApps.filter((app) => !this.apps.includes(app));
+    if (appsToAdd.length === 0) {
+      console.log("All applications are already registered");
+      return;
+    }
+    await this.reconnectWithApps(appsToAdd, subscribedEvents);
+  }
   /**
    * Initializes a WebSocket connection with exponential backoff retry mechanism.
    *
@@ -3325,7 +3376,6 @@ var WebSocketClient = class extends EventEmitter4 {
         try {
           this.ws = new WebSocket(wsUrl);
           this.ws.once("open", () => {
-            console.log("WebSocket connection established successfully");
             this.setupHeartbeat();
             if (this.isReconnecting) {
               this.emit("reconnected", {
@@ -3576,7 +3626,6 @@ var AriClient = class {
   baseClient;
   webSocketClient;
   eventListeners = /* @__PURE__ */ new Map();
-  // Armazena os listeners para limpeza
   channels;
   endpoints;
   applications;
@@ -3634,16 +3683,19 @@ var AriClient = class {
    * @param {string[]} apps - List of application names to subscribe to
    * @param {WebSocketEventType[]} [subscribedEvents] - Optional list of specific event types to subscribe to
    * @returns {Promise<void>} Resolves when connection is established
-   * @throws {Error} If connection fails or if WebSocket is already connected
+   * @throws {Error} If connection fails
    */
   async connectWebSocket(apps, subscribedEvents) {
     try {
       if (!apps.length) {
         throw new Error("At least one application name is required.");
       }
-      if (this.webSocketClient) {
-        await this.closeWebSocket();
-        await new Promise((resolve) => setTimeout(resolve, 1e3));
+      if (this.webSocketClient && this.webSocketClient.isConnected()) {
+        console.log(
+          "WebSocket already connected. Reconnecting with updated apps..."
+        );
+        await this.webSocketClient.reconnectWithApps(apps, subscribedEvents);
+        return;
       }
       this.webSocketClient = new WebSocketClient(
         this.baseClient,
@@ -3652,17 +3704,31 @@ var AriClient = class {
         this
       );
       await this.webSocketClient.connect();
-      console.log("WebSocket connection established successfully.");
     } catch (error) {
       console.error("Failed to establish WebSocket connection:", error);
-      this.webSocketClient = void 0;
       throw error;
     }
   }
+  /**
+   * Adds applications to the existing WebSocket connection.
+   *
+   * @param {string[]} apps - Additional applications to subscribe to
+   * @param {WebSocketEventType[]} [subscribedEvents] - Optional list of specific event types to subscribe to
+   * @returns {Promise<void>} Resolves when applications are added successfully
+   * @throws {Error} If no WebSocket connection exists or if the operation fails
+   */
+  async addApplicationsToWebSocket(apps, subscribedEvents) {
+    if (!this.webSocketClient || !this.webSocketClient.isConnected()) {
+      throw new Error(
+        "No active WebSocket connection. Create one first with connectWebSocket()."
+      );
+    }
+    await this.webSocketClient.addApps(apps, subscribedEvents);
+  }
   /**
    * Destroys the ARI Client instance, cleaning up all resources and removing circular references.
    * This method should be called when the ARI Client is no longer needed to ensure proper cleanup.
-   * 
+   *
    * @returns {Promise<void>} A promise that resolves when the destruction process is complete.
    * @throws {Error} If an error occurs during the destruction process.
    */
@@ -3684,6 +3750,13 @@ var AriClient = class {
       throw error;
     }
   }
+  /**
+   * Registers an event listener for WebSocket events.
+   *
+   * @param {T} event - The event type to listen for
+   * @param {Function} listener - Callback function for handling the event
+   * @throws {Error} If WebSocket is not connected
+   */
   /**
    * Registers an event listener for WebSocket events.
    *
@@ -3728,7 +3801,10 @@ var AriClient = class {
       this.off(event, wrappedListener);
     };
     this.webSocketClient.once(event, wrappedListener);
-    this.eventListeners.set(event, [...existingListeners, wrappedListener]);
+    this.eventListeners.set(event, [
+      ...existingListeners,
+      wrappedListener
+    ]);
     console.log(`One-time event listener registered for ${event}`);
   }
   /**
@@ -3746,7 +3822,9 @@ var AriClient = class {
     const existingListeners = this.eventListeners.get(event) || [];
     this.eventListeners.set(
       event,
-      existingListeners.filter((l) => l !== listener)
+      existingListeners.filter(
+        (l) => l !== listener
+      )
     );
     console.log(`Event listener removed for ${event}`);
   }