@ipcom/asterisk-ari 0.0.23 → 0.0.25

package/dist/cjs/index.cjs

@@ -582,6 +582,7 @@ __export(src_exports, {
   Applications: () => Applications,
   AriClient: () => AriClient,
   Asterisk: () => Asterisk,
+  Bridges: () => Bridges,
   Channels: () => Channels,
   Endpoints: () => Endpoints,
   Playbacks: () => Playbacks,
@@ -709,11 +710,27 @@ var Asterisk = class {
   }
   /**
    * Manages a specific module in the Asterisk server.
+   *
+   * @param moduleName - The name of the module to manage.
+   * @param action - The action to perform on the module: "load", "unload", or "reload".
+   * @returns A promise that resolves when the action is completed successfully.
+   * @throws {Error} Throws an error if the HTTP method or action is invalid.
    */
   async manageModule(moduleName, action) {
-    return this.client.post(
-      `/asterisk/modules/${moduleName}?action=${encodeURIComponent(action)}`
-    );
+    const url = `/asterisk/modules/${moduleName}`;
+    switch (action) {
+      case "load":
+        await this.client.post(`${url}?action=load`);
+        break;
+      case "unload":
+        await this.client.delete(url);
+        break;
+      case "reload":
+        await this.client.put(url, {});
+        break;
+      default:
+        throw new Error(`A\xE7\xE3o inv\xE1lida: ${action}`);
+    }
   }
   /**
    * Retrieves all configured logging channels.
@@ -748,6 +765,95 @@ var Asterisk = class {
   }
 };
 
+// src/ari-client/resources/bridges.ts
+var Bridges = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Lists all active bridges.
+   */
+  async list() {
+    return this.client.get("/bridges");
+  }
+  /**
+   * Creates a new bridge.
+   */
+  async createBridge(request) {
+    return this.client.post("/bridges", request);
+  }
+  /**
+   * Retrieves details of a specific bridge.
+   */
+  async getDetails(bridgeId) {
+    return this.client.get(`/bridges/${bridgeId}`);
+  }
+  /**
+   * Destroys (deletes) a specific bridge.
+   */
+  async destroy(bridgeId) {
+    return this.client.delete(`/bridges/${bridgeId}`);
+  }
+  /**
+   * Adds a channel or multiple channels to a bridge.
+   */
+  async addChannels(bridgeId, request) {
+    const queryParams = new URLSearchParams({
+      channel: Array.isArray(request.channel) ? request.channel.join(",") : request.channel,
+      ...request.role && { role: request.role }
+    }).toString();
+    await this.client.post(
+      `/bridges/${bridgeId}/addChannel?${queryParams}`
+    );
+  }
+  /**
+   * Removes a channel or multiple channels from a bridge.
+   */
+  async removeChannels(bridgeId, request) {
+    const queryParams = new URLSearchParams({
+      channel: Array.isArray(request.channel) ? request.channel.join(",") : request.channel
+    }).toString();
+    await this.client.post(
+      `/bridges/${bridgeId}/removeChannel?${queryParams}`
+    );
+  }
+  /**
+   * Plays media to a bridge.
+   */
+  async playMedia(bridgeId, request) {
+    const queryParams = new URLSearchParams({
+      ...request.lang && { lang: request.lang },
+      ...request.offsetms && { offsetms: request.offsetms.toString() },
+      ...request.skipms && { skipms: request.skipms.toString() },
+      ...request.playbackId && { playbackId: request.playbackId }
+    }).toString();
+    return this.client.post(
+      `/bridges/${bridgeId}/play?${queryParams}`,
+      { media: request.media }
+    );
+  }
+  /**
+   * Stops media playback on a bridge.
+   */
+  async stopPlayback(bridgeId, playbackId) {
+    await this.client.delete(`/bridges/${bridgeId}/play/${playbackId}`);
+  }
+  /**
+   * Sets the video source for a bridge.
+   */
+  async setVideoSource(bridgeId, channelId) {
+    await this.client.post(
+      `/bridges/${bridgeId}/videoSource?channelId=${encodeURIComponent(channelId)}`
+    );
+  }
+  /**
+   * Clears the video source for a bridge.
+   */
+  async clearVideoSource(bridgeId) {
+    await this.client.delete(`/bridges/${bridgeId}/videoSource`);
+  }
+};
+
 // src/ari-client/resources/channels.ts
 function toQueryParams2(options) {
   return new URLSearchParams(
@@ -1109,17 +1215,22 @@ var Playbacks = class {
     return this.client.get(`/playbacks/${playbackId}`);
   }
   /**
-   * Controls a specific playback (e.g., pause, resume, rewind, forward, stop).
+   * Controls a specific playback by performing various operations such as pause, resume, restart, reverse, forward, or stop.
    *
    * @param playbackId - The unique identifier of the playback to control.
-   * @param controlRequest - The PlaybackControlRequest containing the control operation.
+   * @param operation - The operation to perform on the playback. Possible values are:
+   *                    - "pause": Pauses the playback.
+   *                    - "unpause": Resumes a paused playback.
+   *                    - "restart": Restarts the playback from the beginning.
+   *                    - "reverse": Reverses the playback direction.
+   *                    - "forward": Moves the playback forward.
+   *                    - "stop": Stops the playback.
    * @returns A promise that resolves when the control operation is successfully executed.
    */
-  async control(playbackId, controlRequest) {
-    await this.client.post(
-      `/playbacks/${playbackId}/control`,
-      controlRequest
-    );
+  async control(playbackId, operation) {
+    await this.client.post(`/playbacks/${playbackId}/control`, {
+      operation
+    });
   }
   /**
    * Stops a specific playback.
@@ -1265,6 +1376,7 @@ var AriClient = class {
     this.playbacks = new Playbacks(this.baseClient);
     this.sounds = new Sounds(this.baseClient);
     this.asterisk = new Asterisk(this.baseClient);
+    this.bridges = new Bridges(this.baseClient);
   }
   wsClient = null;
   baseClient;
@@ -1275,10 +1387,12 @@ var AriClient = class {
   playbacks;
   sounds;
   asterisk;
+  bridges;
   /**
    * Connects to the ARI WebSocket for a specific application.
    *
    * @param app - The application name to connect to.
+   * @param subscribedEvents
    * @returns {Promise<void>} Resolves when the WebSocket connects successfully.
    */
   async connectWebSocket(app, subscribedEvents) {
@@ -1785,14 +1899,23 @@ var AriClient = class {
     return this.playbacks.getDetails(playbackId);
   }
   /**
-   * Controls a specific playback in the Asterisk server.
-   *
-   * @param playbackId - The unique identifier of the playback to control.
-   * @param controlRequest - An object containing the control operation details.
-   * @returns A Promise that resolves when the control operation is successfully executed.
-   */
+  * Controls a specific playback in the Asterisk server.
+  * This function allows manipulation of an ongoing playback, such as pausing, resuming, or skipping.
+  *
+  * @param playbackId - The unique identifier of the playback to control.
+  *                     This should be a string that uniquely identifies the playback in the Asterisk system.
+  * @param controlRequest - An object containing the control operation details.
+  *                         This object should conform to the PlaybackControlRequest interface,
+  *                         which includes an 'operation' property specifying the control action to perform.
+  * @returns A Promise that resolves when the control operation is successfully executed.
+  *          The promise resolves to void, indicating no specific return value.
+  *          If an error occurs during the operation, the promise will be rejected with an error object.
+  * @throws Will throw an error if the playback control operation fails, e.g., if the playback doesn't exist
+  *         or the requested operation is invalid.
+  */
   async controlPlayback(playbackId, controlRequest) {
-    return this.playbacks.control(playbackId, controlRequest);
+    const { operation } = controlRequest;
+    return this.playbacks.control(playbackId, operation);
   }
   /**
    * Stops a specific playback in the Asterisk server.
@@ -1907,6 +2030,7 @@ var AriClient = class {
   Applications,
   AriClient,
   Asterisk,
+  Bridges,
   Channels,
   Endpoints,
   Playbacks,