esewa-ui-library 1.10.5 → 1.10.7

package/README.md

@@ -1623,6 +1623,8 @@ This library provides a set of services that allow interaction between the merch
   - [Media Access Request](#media-access-request)
   - [Validate Payment](#validate-payment)
   - [Request Payment](#request-payment)
+  - [Close App](#close-app)
+  - [Request File Download](#request-file-download)
 - [Error Handling](#error-handling)
 
 ## Initialization
@@ -1864,6 +1866,106 @@ const onRequestPaymentClick = () => {
 };
 ```
 
+#### Close App
+
+Pass the following to close the app.
+
+```tsx
+const onCloseRequestClick = () => {
+    const obj: REQUEST_DATA_TYPE = {
+      requestType: REQUEST_TYPE_ENUM.CLOSE_APP,
+      callbackKey: CALLBACK_TYPE_ENUM.CLOSE_APP_CALLBACK
+    }
+
+    requestFromMiniApp(
+      obj
+    )
+  }
+```
+
+#### Request File Download
+
+Pass the following to request file download.
+
+**1. Link Type file download request**
+
+    const onPdfDownloadRequestClick = () => {
+        const obj: REQUEST_DATA_TYPE = {
+          requestType: REQUEST_TYPE_ENUM.FILE_DOWNLOAD,
+          callbackKey: CALLBACK_TYPE_ENUM.FILE_DOWNLOAD_CALLBACK,
+          data: {
+            fileName: 'Statement-2025.pdf',
+            type: 'url',
+            content: 'https://www.aeee.in/wp-content/uploads/2020/08/Sample-pdf.pdf' //pass file url
+          }
+        }
+
+        const fileDownloadCallBack: any = (data: any) => {
+          try{
+            if (!data) {
+              throw new Error('Received null or undefined response')
+            }
+            const res = data
+            if (res?.error_message) { //fail case
+              throw new Error('Error res', res.error_message)
+            }
+            else{
+              console.log(res.message) //success case
+            }
+          }
+          catch (error) {
+            console.error('Error parsing response:', error)
+          }
+        }
+
+        requestFromMiniApp(
+          obj,
+          fileDownloadCallBack
+        )
+      }
+
+**2. Base64 Encoded Type file download request**
+
+    const onPdfDownloadRequestClick = () => {
+        const response = await fetch('/base64.txt');
+        const content = await response.text(); //encoded pdf content/response from api
+        let base64Content = content.includes(',')
+            ? content
+            : `data:application/pdf;base64,${content}`;
+        const obj: REQUEST_DATA_TYPE = {
+          requestType: REQUEST_TYPE_ENUM.FILE_DOWNLOAD,
+          callbackKey: CALLBACK_TYPE_ENUM.FILE_DOWNLOAD_CALLBACK,
+          data: {
+            fileName: 'Statement-base64-2025.pdf',
+            type: 'base64',
+            content: base64Content
+          }
+        }
+
+        const fileDownloadCallBack: any = (data: any) => {
+          try{
+            if (!data) {
+              throw new Error('Received null or undefined response')
+            }
+            const res = data
+            if (res?.error_message) { //fail case
+              throw new Error('Error res', res.error_message)
+            }
+            else{
+              console.log(res.message) //success case
+            }
+          }
+          catch (error) {
+            console.error('Error parsing response:', error)
+          }
+        }
+
+        requestFromMiniApp(
+          obj,
+          fileDownloadCallBack
+        )
+      }
+
 ## Error Handling
 
 Errors are returned as JSON responses with an `error_message` field.
@@ -1910,7 +2012,9 @@ enum REQUEST_TYPE_ENUM {
   USER_DETAIL_ACCESS = 'USER_DETAIL_ACCESS',
   MEDIA_ACCESS = 'MEDIA_ACCESS',
   LOCATION_ACCESS = 'LOCATION_ACCESS',
-  VALIDATE_TRANSACTION = 'VALIDATE_TRANSACTION'
+  VALIDATE_TRANSACTION = 'VALIDATE_TRANSACTION',
+  CLOSE_APP = 'CLOSE_APP',
+  FILE_DOWNLOAD = 'FILE_DOWNLOAD'
 }
 ```
 
@@ -1927,7 +2031,9 @@ enum CALLBACK_TYPE_ENUM{
   USER_DETAIL_ACCESS_CALLBACK = 'USER_DETAIL_ACCESS_CALLBACK',
   MEDIA_ACCESS_CALLBACK = 'MEDIA_ACCESS_CALLBACK',
   LOCATION_ACCESS_CALLBACK = 'LOCATION_ACCESS_CALLBACK',
-  VALIDATE_TRANSACTION_CALLBACK = 'VALIDATE_TRANSACTION_CALLBACK'
+  VALIDATE_TRANSACTION_CALLBACK = 'VALIDATE_TRANSACTION_CALLBACK',
+  CLOSE_APP_CALLBACK = 'CLOSE_APP_CALLBACK',
+  FILE_DOWNLOAD_CALLBACK = 'FILE_DOWNLOAD_CALLBACK'
 }
 ```
 

package/dist/@types/index.d.ts

@@ -4,7 +4,9 @@ export declare enum REQUEST_TYPE_ENUM {
     USER_DETAIL_ACCESS = "USER_DETAIL_ACCESS",
     MEDIA_ACCESS = "MEDIA_ACCESS",
     LOCATION_ACCESS = "LOCATION_ACCESS",
-    VALIDATE_TRANSACTION = "VALIDATE_TRANSACTION"
+    VALIDATE_TRANSACTION = "VALIDATE_TRANSACTION",
+    CLOSE_APP = "CLOSE_APP",
+    FILE_DOWNLOAD = "FILE_DOWNLOAD"
 }
 export declare enum CALLBACK_TYPE_ENUM {
     INIT_APP_CALLBACK = "INIT_APP_CALLBACK",
@@ -12,7 +14,9 @@ export declare enum CALLBACK_TYPE_ENUM {
     USER_DETAIL_ACCESS_CALLBACK = "USER_DETAIL_ACCESS_CALLBACK",
     MEDIA_ACCESS_CALLBACK = "MEDIA_ACCESS_CALLBACK",
     LOCATION_ACCESS_CALLBACK = "LOCATION_ACCESS_CALLBACK",
-    VALIDATE_TRANSACTION_CALLBACK = "VALIDATE_TRANSACTION_CALLBACK"
+    VALIDATE_TRANSACTION_CALLBACK = "VALIDATE_TRANSACTION_CALLBACK",
+    CLOSE_APP_CALLBACK = "CLOSE_APP_CALLBACK",
+    FILE_DOWNLOAD_CALLBACK = "FILE_DOWNLOAD_CALLBACK"
 }
 export interface MINI_APP_RESPONSE_TYPE {
     requestType: string;
@@ -24,7 +28,7 @@ export interface REQUEST_DATA_TYPE {
     device_unique_id?: string;
     merchant_identifier?: string;
     vendorIdentifier?: any;
-    requestType: REQUEST_TYPE_ENUM;
+    requestType?: REQUEST_TYPE_ENUM;
     method?: 'GET' | 'POST';
     data?: any;
     callbackKey?: string;
@@ -44,6 +48,8 @@ declare global {
             MEDIA_ACCESS_CALLBACK?: Callback | null;
             LOCATION_ACCESS_CALLBACK?: Callback | null;
             VALIDATE_TRANSACTION_CALLBACK?: Callback | null;
+            CLOSE_APP_CALLBACK?: Callback | null;
+            FILE_DOWNLOAD_CALLBACK?: Callback | null;
         };
         iOSNative: {
             INIT_APP_CALLBACK?: Callback | null;
@@ -52,6 +58,8 @@ declare global {
             MEDIA_ACCESS_CALLBACK?: Callback | null;
             LOCATION_ACCESS_CALLBACK?: Callback | null;
             VALIDATE_TRANSACTION_CALLBACK?: Callback | null;
+            CLOSE_APP_CALLBACK?: Callback | null;
+            FILE_DOWNLOAD_CALLBACK?: Callback | null;
         };
         webkit: {
             messageHandlers: {

package/dist/index.js

@@ -7749,15 +7749,17 @@ var CONNECT_APP = function CONNECT_APP(data) {
 };
 var requestFromMiniApp = function requestFromMiniApp(data, callbackFn) {
   var callbackKey = data.callbackKey;
-  if (!callbackKey) {
+  if (callbackFn && !callbackKey) {
     throw new Error('Callback key is missing in request data');
   }
-  if (isAndroid) {
-    window.Android = window.Android || {};
-    window.Android[callbackKey] = callbackFn;
-  } else if (isiOS) {
-    window.iOSNative = window.iOSNative || {};
-    window.iOSNative[callbackKey] = callbackFn;
+  if (callbackFn) {
+    if (isAndroid) {
+      window.Android = window.Android || {};
+      window.Android[callbackKey] = callbackFn;
+    } else if (isiOS) {
+      window.iOSNative = window.iOSNative || {};
+      window.iOSNative[callbackKey] = callbackFn;
+    }
   }
   CONNECT_APP(JSON.stringify(data));
 };
@@ -7811,6 +7813,8 @@ var reverseSnakeCase = function reverseSnakeCase(str) {
   REQUEST_TYPE_ENUM["MEDIA_ACCESS"] = "MEDIA_ACCESS";
   REQUEST_TYPE_ENUM["LOCATION_ACCESS"] = "LOCATION_ACCESS";
   REQUEST_TYPE_ENUM["VALIDATE_TRANSACTION"] = "VALIDATE_TRANSACTION";
+  REQUEST_TYPE_ENUM["CLOSE_APP"] = "CLOSE_APP";
+  REQUEST_TYPE_ENUM["FILE_DOWNLOAD"] = "FILE_DOWNLOAD";
 })(exports.REQUEST_TYPE_ENUM || (exports.REQUEST_TYPE_ENUM = {}));
 (function (CALLBACK_TYPE_ENUM) {
   CALLBACK_TYPE_ENUM["INIT_APP_CALLBACK"] = "INIT_APP_CALLBACK";
@@ -7819,6 +7823,8 @@ var reverseSnakeCase = function reverseSnakeCase(str) {
   CALLBACK_TYPE_ENUM["MEDIA_ACCESS_CALLBACK"] = "MEDIA_ACCESS_CALLBACK";
   CALLBACK_TYPE_ENUM["LOCATION_ACCESS_CALLBACK"] = "LOCATION_ACCESS_CALLBACK";
   CALLBACK_TYPE_ENUM["VALIDATE_TRANSACTION_CALLBACK"] = "VALIDATE_TRANSACTION_CALLBACK";
+  CALLBACK_TYPE_ENUM["CLOSE_APP_CALLBACK"] = "CLOSE_APP_CALLBACK";
+  CALLBACK_TYPE_ENUM["FILE_DOWNLOAD_CALLBACK"] = "FILE_DOWNLOAD_CALLBACK";
 })(exports.CALLBACK_TYPE_ENUM || (exports.CALLBACK_TYPE_ENUM = {}));
 
 var _templateObject$o;