feat: add the ability to hide the Visitor Code alert

Andrii-Horishnii-Glia · Andrii-Horishnii-Glia · commit 657e37b9344f · 2025-10-22T16:48:15.000+03:00
MOB-4818
diff --git a/android/src/main/java/com/glia/widgets/ionic/GliaSdk.java b/android/src/main/java/com/glia/widgets/ionic/GliaSdk.java
@@ -131,13 +131,21 @@ public void presentEntryWidget(PluginCall call, Activity activity) {
     }
 
     public void showEntryWidget(PluginCall call, Activity activity) {
-        JSArray queueIds = call.getArray("queueIds", new JSArray());
-        entryWidget = GliaWidgets.getEntryWidget(jsArrayToArrayList(queueIds));
-        entryWidget.show(activity);
-        call.resolve();
+        try {
+            JSArray queueIds = call.getArray("queueIds", new JSArray());
+            entryWidget = GliaWidgets.getEntryWidget(jsArrayToArrayList(queueIds));
+            entryWidget.show(activity);
+            call.resolve();
+        } catch (Exception e) {
+            call.reject("Could not show entry widget. Error='" + e.getMessage() + "'");
+        }
     }
 
     public void hideEntryWidget(PluginCall call) {
+        if (entryWidget == null) {
+            call.reject("Entry widget is not presented.");
+            return;
+        }
         entryWidget.hide();
         call.resolve();
     }
@@ -296,8 +304,21 @@ public void getQueues(PluginCall call) {
     }
 
     public void showVisitorCode(PluginCall call) {
-        GliaWidgets.getCallVisualizer().showVisitorCodeDialog();
-        call.resolve();
+        try {
+            GliaWidgets.getCallVisualizer().showVisitorCodeDialog();
+            call.resolve();
+        } catch (Exception e) {
+            call.reject("Could not show visitor code. Error='" + e.getMessage() + "'");
+        }
+    }
+
+    public void hideVisitorCode(PluginCall call) {
+        try {
+            GliaWidgets.getCallVisualizer().hideVisitorCodeDialog();
+            call.resolve();
+        } catch (Exception e) {
+            call.reject("Could not hide visitor code. Error='" + e.getMessage() + "'");
+        }
     }
 
     public void authenticate(PluginCall call) {
diff --git a/android/src/main/java/com/glia/widgets/ionic/GliaSdkPlugin.java b/android/src/main/java/com/glia/widgets/ionic/GliaSdkPlugin.java
@@ -94,6 +94,11 @@ public void showVisitorCode(PluginCall call) {
         implementation.showVisitorCode(call);
     }
 
+    @PluginMethod
+    public void hideVisitorCode(PluginCall call) {
+        implementation.hideVisitorCode(call);
+    }
+
     @PluginMethod
     public void authenticate(PluginCall call) {
         implementation.authenticate(call);
diff --git a/dist/docs.json b/dist/docs.json
@@ -216,7 +216,7 @@
         "tags": [
           {
             "name": "deprecated",
-            "text": "Use showVisitorCode() instead.\nPresents GliaWidgets UI with a visitor code for sharing with operator to start an engagement."
+            "text": "Use showVisitorCode() instead.\nPresents a GliaWidgets alert with a visitor code to share with an operator to start an engagement."
           }
         ],
         "docs": "",
@@ -229,10 +229,20 @@
         "parameters": [],
         "returns": "Promise<void>",
         "tags": [],
-        "docs": "Presents GliaWidgets UI with a visitor code for sharing with operator to start an engagement.",
+        "docs": "Presents a GliaWidgets alert with a visitor code to share with an operator to start an engagement.",
         "complexTypes": [],
         "slug": "showvisitorcode"
       },
+      {
+        "name": "hideVisitorCode",
+        "signature": "() => Promise<void>",
+        "parameters": [],
+        "returns": "Promise<void>",
+        "tags": [],
+        "docs": "Closes a GliaWidgets alert with a visitor code if it is currently visible.",
+        "complexTypes": [],
+        "slug": "hidevisitorcode"
+      },
       {
         "name": "authenticate",
         "signature": "(options: { behavior: AuthenticationBehavior; idToken: string; accessToken?: string; }) => Promise<void>",
diff --git a/dist/esm/definitions.d.ts b/dist/esm/definitions.d.ts
@@ -408,13 +408,17 @@ export interface GliaSdk {
     getQueues(): Promise<Queues>;
     /**
      * @deprecated Use showVisitorCode() instead.
-     * Presents GliaWidgets UI with a visitor code for sharing with operator to start an engagement.
+     * Presents a GliaWidgets alert with a visitor code to share with an operator to start an engagement.
      */
     showVisitorCodeViewController(): Promise<void>;
     /**
-     * Presents GliaWidgets UI with a visitor code for sharing with operator to start an engagement.
+     * Presents a GliaWidgets alert with a visitor code to share with an operator to start an engagement.
      */
     showVisitorCode(): Promise<void>;
+    /**
+    * Closes a GliaWidgets alert with a visitor code if it is currently visible.
+    */
+    hideVisitorCode(): Promise<void>;
     /**
      * Authenticates the visitor.
      * @param options - Provides options for authentication such as behavior, idToken, and accessToken.
diff --git a/dist/esm/definitions.js.map b/dist/esm/definitions.js.map
diff --git a/dist/plugin.cjs.js b/dist/plugin.cjs.js
diff --git a/dist/plugin.cjs.js.map b/dist/plugin.cjs.js.map
diff --git a/dist/plugin.js b/dist/plugin.js
diff --git a/dist/plugin.js.map b/dist/plugin.js.map
diff --git a/example-app/ios/App/Podfile.lock b/example-app/ios/App/Podfile.lock
@@ -18,7 +18,7 @@ PODS:
   - GliaOpenTelemetry (1.0.5)
   - GliaWidgets (3.3.0):
     - GliaCoreSDK (= 2.3.0)
-  - GliaWidgetsIonic (3.2.2):
+  - GliaWidgetsIonic (3.3.1):
     - Capacitor
     - GliaWidgets (= 3.3.0)
   - PhoenixChannelsClient (1.0.1)
@@ -58,16 +58,16 @@ EXTERNAL SOURCES:
     :path: "../../.."
 
 SPEC CHECKSUMS:
-  Capacitor: 1e0d0e7330dea9f983b50da737d8918abcf273f8
-  CapacitorCamera: 9052bd3f464f135ba983feccd8ac1266272f0549
+  Capacitor: c95400d761e376be9da6be5a05f226c0e865cebf
+  CapacitorCamera: 9bc7b005d0e6f1d5f525b8137045b60cffffce79
   CapacitorCordova: 8d93e14982f440181be7304aa9559ca631d77fff
-  CapacitorPushNotifications: 1fc22ae360214a0ac0625c348d3aea217085163d
-  CapacitorSplashScreen: 68893659d77b5f82d753b3a70475082845e3039c
+  CapacitorPushNotifications: b3f20973cb167cb8fee622e309ec521134798241
+  CapacitorSplashScreen: fd8bf1bf9081d9aa8817b7cd37d740d1bdaf2fb2
   GliaCoreDependency: bf99fc5a6fe66348b58123caded985506a8cf762
   GliaCoreSDK: adda44248cb9e4f8dc43ce07349d9b1f1a71ae68
   GliaOpenTelemetry: 68e17e91ffd098b435129d56d1b1f2d263efea0d
   GliaWidgets: c394d75d38b199b96db7578116a16f45beef7886
-  GliaWidgetsIonic: 62d1af273a05bbcbf45b28d07c8dcb04bfeaf53e
+  GliaWidgetsIonic: 0910af88c33b9e6de93830839757c90b2f29cf8f
   PhoenixChannelsClient: 74cf91ecd76471e5fb262745256733dce7ee3cb6
   TwilioVoice: 9563c9ad71b9ab7bbad0b59b67cfe4be96c75d23
   WebRTC-lib: 4e9a17058f880cd658e88383c1ac8f1119af3700
diff --git a/example-app/src/index.html b/example-app/src/index.html
@@ -70,6 +70,7 @@ <h3>Start Engagement (new methods)</h3>
     <p>
       <h3>Visitor Code</h3>
       <button onclick="showVisitorCodeViewController()">Show Visitor Code</button>
+      <button onclick="hideVisitorCode()">Hide Visitor Code</button>
     </p>
       <p>
         <button onclick="endEngagement()">End Engagement</button>
diff --git a/example-app/src/js/example.js b/example-app/src/js/example.js
@@ -248,6 +248,10 @@ window.showVisitorCodeViewController = () => {
     GliaSdk.showVisitorCodeViewController()
 }
 
+window.hideVisitorCode = () => {
+    GliaSdk.hideVisitorCode()
+}
+
 window.startSecureConversation = () => {
     GliaSdk.startSecureConversation()
 }
diff --git a/ios/Sources/GliaSdkPlugin/GliaSdk.swift b/ios/Sources/GliaSdkPlugin/GliaSdk.swift
@@ -338,6 +338,13 @@ import GliaOpenTelemetry
         }
     }
 
+    @objc public func hideVisitorCode(_ call: CAPPluginCall) {
+        DispatchQueue.main.async {
+            Glia.sharedInstance.callVisualizer.hideVisitorCodeViewController()
+            call.resolve()
+        }
+    }
+
     @objc public func startSecureMessaging(_ call: CAPPluginCall) {
         var queueIds = configureQueueIds
         let useOptions = call.getBool("useOptions", false)
diff --git a/ios/Sources/GliaSdkPlugin/GliaSdkPlugin.swift b/ios/Sources/GliaSdkPlugin/GliaSdkPlugin.swift
@@ -24,6 +24,7 @@ public class GliaSdkPlugin: CAPPlugin, CAPBridgedPlugin {
         CAPPluginMethod(name: "refreshAuthentication", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "showVisitorCodeViewController", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "showVisitorCode", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "hideVisitorCode", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "startSecureConversation", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "startSecureMessaging", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "pauseLiveObservation", returnType: CAPPluginReturnPromise),
@@ -109,6 +110,10 @@ public class GliaSdkPlugin: CAPPlugin, CAPBridgedPlugin {
         implementation.showVisitorCode(call)
     }
 
+    @objc func hideVisitorCode(_ call: CAPPluginCall) {
+        implementation.hideVisitorCode(call)
+    }
+
     @objc func startSecureConversation(_ call: CAPPluginCall) {
         implementation.startSecureMessaging(call)
     }
diff --git a/src/definitions.ts b/src/definitions.ts
@@ -474,15 +474,20 @@ export interface GliaSdk {
 
     /**
      * @deprecated Use showVisitorCode() instead.
-     * Presents GliaWidgets UI with a visitor code for sharing with operator to start an engagement.
+     * Presents a GliaWidgets alert with a visitor code to share with an operator to start an engagement.
      */
     showVisitorCodeViewController(): Promise<void>;
 
     /**
-     * Presents GliaWidgets UI with a visitor code for sharing with operator to start an engagement.
+     * Presents a GliaWidgets alert with a visitor code to share with an operator to start an engagement.
      */
     showVisitorCode(): Promise<void>;
 
+    /**
+    * Closes a GliaWidgets alert with a visitor code if it is currently visible.
+    */
+    hideVisitorCode(): Promise<void>;
+
     /**
      * Authenticates the visitor.
      * @param options - Provides options for authentication such as behavior, idToken, and accessToken.
diff --git a/src/glia-sdk.ts b/src/glia-sdk.ts
@@ -117,6 +117,10 @@ export class GliaSdkImpl implements GliaSdk {
         return GliaSdkIonicPlugin.showVisitorCode();
     }
 
+    async hideVisitorCode(): Promise<void> {
+        return GliaSdkIonicPlugin.hideVisitorCode();
+    }
+
     async authenticate(options: {
         behavior: AuthenticationBehavior;
         idToken: string;
