@zyratalk1/zyra-twilio-wrapper 1.2.9 → 1.3.0

package/dist/index.d.mts

@@ -79,6 +79,11 @@ interface WelcomeConfigResult {
     welcomeType: WelcomeType;
     routingConfigId: number;
 }
+interface HoldMusicUrlConfigResult {
+    success: boolean;
+    message: string;
+    routingConfigId: number;
+}
 /**
  * Routing Config
  */
@@ -366,6 +371,10 @@ declare class ReactNativeVoipSdk {
     deregisterWebhook(): Promise<CallResponse<null>>;
     isWebhookConfigured(): Promise<CallResponse<WebhookConfigResult>>;
     welcomeMessageConfig(welcomeType: "audio" | "tts", welcomeMessage: string): Promise<CallResponse<WelcomeConfigResult>>;
+    /**
+     * Set hold music audio URL (MP3 or WAV HTTPS URL, e.g. from upload-audio).
+     */
+    holdMusicUrlConfig(audioUrl: string): Promise<CallResponse<HoldMusicUrlConfigResult>>;
     destroy(): void;
     private ensureAuthenticated;
 }

package/dist/index.d.ts

@@ -79,6 +79,11 @@ interface WelcomeConfigResult {
     welcomeType: WelcomeType;
     routingConfigId: number;
 }
+interface HoldMusicUrlConfigResult {
+    success: boolean;
+    message: string;
+    routingConfigId: number;
+}
 /**
  * Routing Config
  */
@@ -366,6 +371,10 @@ declare class ReactNativeVoipSdk {
     deregisterWebhook(): Promise<CallResponse<null>>;
     isWebhookConfigured(): Promise<CallResponse<WebhookConfigResult>>;
     welcomeMessageConfig(welcomeType: "audio" | "tts", welcomeMessage: string): Promise<CallResponse<WelcomeConfigResult>>;
+    /**
+     * Set hold music audio URL (MP3 or WAV HTTPS URL, e.g. from upload-audio).
+     */
+    holdMusicUrlConfig(audioUrl: string): Promise<CallResponse<HoldMusicUrlConfigResult>>;
     destroy(): void;
     private ensureAuthenticated;
 }

package/dist/index.js

@@ -1383,7 +1383,77 @@ async function isWebhookConfigured(deps) {
   }
 }
 
+// src/holdMusicUrlConfig.ts
+function isHttpUrl(value) {
+  try {
+    const url = new URL(value);
+    return url.protocol === "http:" || url.protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function validateHoldMusicUrlConfigInput(input) {
+  const audioUrl = input.audioUrl?.trim() ?? "";
+  if (!audioUrl) {
+    throw new Error("audioUrl is required.");
+  }
+  if (!isHttpUrl(audioUrl)) {
+    throw new Error(
+      "audioUrl must be a valid URL (e.g. S3 URL from upload-audio with purpose hold)."
+    );
+  }
+  try {
+    const pathname = new URL(audioUrl).pathname;
+    const ext = pathname.replace(/^.*\./, "").toLowerCase();
+    if (ext !== "mp3" && ext !== "wav") {
+      throw new Error(
+        "Audio URL must point to an .mp3 or .wav file. Only MP3 and WAV formats are accepted."
+      );
+    }
+  } catch (err) {
+    if (err instanceof Error && err.message.startsWith("Audio URL")) throw err;
+    throw new Error("audioUrl must be a valid URL with .mp3 or .wav file.");
+  }
+  return { audioUrl };
+}
+async function holdMusicUrlConfig(deps, input) {
+  deps.ensureAuthenticated();
+  try {
+    const payload = validateHoldMusicUrlConfigInput(input);
+    const res = await deps.axiosInstance.post(
+      `${deps.serverUrl}/voipSdk.holdMusicUrlConfig`,
+      payload,
+      {
+        headers: {
+          Authorization: `Bearer ${deps.sdkToken}`
+        }
+      }
+    );
+    const data = res?.data?.result ?? res?.data ?? null;
+    if (!data) {
+      throw new Error("Invalid response from server");
+    }
+    return createSuccessResult(data.message || "Hold music URL updated successfully", {
+      success: data.success,
+      message: data.message,
+      routingConfigId: data.routingConfigId
+    });
+  } catch (error) {
+    return createErrorResult(
+      error instanceof Error ? error : "Failed to upsert hold music configuration"
+    );
+  }
+}
+
 // src/welcomeMessageConfig.ts
+var MAX_AUDIO_SIZE_BYTES = 2 * 1024 * 1024;
+var ALLOWED_AUDIO_EXTENSIONS = ["mp3", "wav"];
+var ALLOWED_AUDIO_MIME_TYPES = [
+  "audio/mpeg",
+  "audio/mp3",
+  "audio/wav",
+  "audio/x-wav"
+];
 function isUrl(value) {
   try {
     const url = new URL(value);
@@ -1395,7 +1465,28 @@ function isUrl(value) {
 function isAudioLikeInput(value) {
   return value.startsWith("http://") || value.startsWith("https://") || value.startsWith("data:audio/");
 }
+function validateAudioFile(file) {
+  const ext = file.name.split(".").pop()?.toLowerCase() ?? "";
+  const mime = (file.type ?? "").toLowerCase();
+  const extOk = ALLOWED_AUDIO_EXTENSIONS.includes(ext);
+  const mimeOk = ALLOWED_AUDIO_MIME_TYPES.includes(mime) || extOk;
+  if (!mimeOk) {
+    return "Only .mp3 and .wav audio files are accepted.";
+  }
+  if (file.size !== void 0 && file.size > MAX_AUDIO_SIZE_BYTES) {
+    const mb = (file.size / (1024 * 1024)).toFixed(1);
+    return `File size is ${mb} MB \u2014 maximum allowed is 2 MB.`;
+  }
+  return null;
+}
 function validateWelcomeConfigInput(input) {
+  if (input.audioFile) {
+    const audioError = validateAudioFile(input.audioFile);
+    if (audioError) {
+      throw new Error(audioError);
+    }
+    return input;
+  }
   const welcomeMessage = input.welcomeMessage?.trim();
   if (!welcomeMessage) {
     throw new Error("Payload is missing or empty. welcomeMessage is required.");
@@ -1419,10 +1510,50 @@ function validateWelcomeConfigInput(input) {
     welcomeMessage
   };
 }
+async function uploadAudioFile(deps, file, currentAudioUrl) {
+  let uploadBase;
+  try {
+    uploadBase = new URL(deps.serverUrl).origin;
+  } catch {
+    uploadBase = deps.serverUrl.replace(/\/voipSdk.*$/, "").replace(/\/$/, "");
+  }
+  const uploadUrl = `${uploadBase}/api/voip/upload-audio`;
+  const formData = new FormData();
+  formData.append("file", {
+    uri: file.uri,
+    name: file.name,
+    type: file.type || "audio/mpeg"
+  });
+  if (currentAudioUrl) {
+    formData.append("currentUrl", currentAudioUrl);
+  }
+  const response = await fetch(uploadUrl, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${deps.sdkToken}`
+    },
+    body: formData
+  });
+  const json = await response.json();
+  if (!response.ok || !json.success) {
+    throw new Error(json.message ?? `Audio upload failed with status ${response.status}`);
+  }
+  if (!json.url) {
+    throw new Error("Server did not return an audio URL after upload.");
+  }
+  return json.url;
+}
 async function welcomeMessageConfig(deps, input) {
   deps.ensureAuthenticated();
   try {
-    const payload = validateWelcomeConfigInput(input);
+    validateWelcomeConfigInput(input);
+    let welcomeType = input.welcomeType;
+    let welcomeMessage = input.welcomeMessage?.trim() ?? "";
+    if (input.audioFile) {
+      welcomeMessage = await uploadAudioFile(deps, input.audioFile);
+      welcomeType = "audio";
+    }
+    const payload = { welcomeType, welcomeMessage };
     const res = await deps.axiosInstance.post(
       `${deps.serverUrl}/voipSdk.welcomeMessageConfig`,
       payload,
@@ -1483,8 +1614,11 @@ var ConfigService = class {
   async isWebhookConfigured() {
     return isWebhookConfigured(this.withDeps());
   }
-  async welcomeMessageConfig(welcomeType, welcomeMessage) {
-    return welcomeMessageConfig(this.withDeps(), { welcomeType, welcomeMessage });
+  async welcomeMessageConfig(welcomeType, welcomeMessage, audioFile) {
+    return welcomeMessageConfig(this.withDeps(), { welcomeType, welcomeMessage, audioFile });
+  }
+  async holdMusicUrlConfig(audioUrl) {
+    return holdMusicUrlConfig(this.withDeps(), { audioUrl });
   }
   async getVoipProviderConfigStatus() {
     return getVoipProviderConfigStatus(this.withDeps());
@@ -2124,6 +2258,12 @@ var ReactNativeVoipSdk = class {
   async welcomeMessageConfig(welcomeType, welcomeMessage) {
     return this.configService.welcomeMessageConfig(welcomeType, welcomeMessage);
   }
+  /**
+   * Set hold music audio URL (MP3 or WAV HTTPS URL, e.g. from upload-audio).
+   */
+  async holdMusicUrlConfig(audioUrl) {
+    return this.configService.holdMusicUrlConfig(audioUrl);
+  }
   destroy() {
     logVoipDebug("destroy() invoked");
     this.authManager.destroy();