@grabjs/superapp-sdk 1.7.4 → 1.7.6

package/dist/index.js

@@ -1 +1 @@
-!function(e,n){"object"==typeof exports&&"undefined"!=typeof module?n(exports):"function"==typeof define&&define.amd?define(["exports"],n):n((e=e||self).SuperAppSDK={})}(this,function(e){"use strict";function n(e,n){if(!(e instanceof n))throw new TypeError("Cannot call a class as a function")}function t(e,n){for(var o=0;o<n.length;o++){var t=n[o];t.enumerable=t.enumerable||!1,t.configurable=!0,"value"in t&&(t.writable=!0),Object.defineProperty(e,t.key,t)}}function o(e,n,o){return n&&t(e.prototype,n),o&&t(e,o),e}"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self&&self;var r,u,i=(function(e,n){function a(e){for(var n=[],o=1;o<arguments.length;o++)n[o-1]=arguments[o];if(!e)return!1;var t=function(e){return Object.keys(e).concat(Object.getOwnPropertyNames(Object.getPrototypeOf(e)))}(e);return n.every(function(e){return 0<=t.indexOf(e)})}function d(r,e){var u=e.callbackNameFunc,i=e.funcToWrap;return function(e){return{subscribe:e,then:function(t,r){return new Promise(function(){try{var n=null,o=!1;n=e({next:function(e){t&&t(e),n&&n.unsubscribe(),o=!0}}),o&&n&&n.unsubscribe()}catch(e){r&&r(e)}})}}}(function(o){var n,t=u();return r[t]=function(e){if(a(e,"status_code"))if(a(e.result,"event"))switch(e.result.event){case l.StreamEvent.STREAM_TERMINATED:n.unsubscribe()}else o&&o.next&&o.next(e)},i(t),n=function(e){var n=!1;return{isUnsubscribed:function(){return n},unsubscribe:function(){n||(delete r[t],o&&o.complete&&o.complete(),n=!0)}}}()})}var l;((l=n).StreamEvent||(l.StreamEvent={})).STREAM_TERMINATED="STREAM_TERMINATED",l.wrapModule=function(u,i){u[function(e){return"Wrapped"+e}(i)]=function(e,t,n){var r={};return{invoke:function(n,o){return function(e,n){return n.funcNameToWrap,d(e,function(e,n){var o={};for(var t in e)Object.prototype.hasOwnProperty.call(e,t)&&n.indexOf(t)<0&&(o[t]=e[t]);if(null!=e&&"function"==typeof Object.getOwnPropertySymbols){var r=0;for(t=Object.getOwnPropertySymbols(e);r<t.length;r++)n.indexOf(t[r])<0&&(o[t[r]]=e[t[r]])}return o}(n,["funcNameToWrap"]))}(e,{funcNameToWrap:n,callbackNameFunc:function(){var e=r[n]||0;return r[n]=e+1,function(e){var n=e.moduleName,o=e.funcName,t=e.requestID;return n+"_"+o+"Callback"+(null!==t?"_"+t:"")}({moduleName:t,requestID:e,funcName:n})},funcToWrap:function(e){return function(e){if(u[i])u[i][e.method](JSON.stringify(e));else{if(!(u.webkit&&u.webkit.messageHandlers&&u.webkit.messageHandlers[i]))throw new Error("Unexpected method '"+e.method+"' for module '"+i+"'");u.webkit.messageHandlers[i].postMessage(e)}}({callback:e,method:n,module:t,parameters:null!=o?o:{}})}})}}}(u,i)},Object.defineProperty(l,"__esModule",{value:!0})}(r={exports:{}},r.exports),r.exports),a=(u=i)&&u.__esModule&&Object.prototype.hasOwnProperty.call(u,"default")?u.default:u,d=function(){function e(){n(this,e),a.wrapModule(window,"CheckoutModule")}return o(e,[{key:"triggerCheckout",value:function(e){return window.WrappedCheckoutModule.invoke("triggerCheckout",e)}}]),e}(),l=require("@grabjs/mobile-kit-bridge-sdk"),c=function(){function e(){n(this,e),l.wrapModule(window,"ContainerModule")}return o(e,[{key:"setBackgroundColor",value:function(e){return window.WrappedContainerModule.invoke("setBackgroundColor",{backgroundColor:e})}},{key:"setTitle",value:function(e){return window.WrappedContainerModule.invoke("setTitle",{title:e})}},{key:"hideBackButton",value:function(){return window.WrappedContainerModule.invoke("hideBackButton")}},{key:"showBackButton",value:function(){return window.WrappedContainerModule.invoke("showBackButton")}},{key:"hideRefreshButton",value:function(){return window.WrappedContainerModule.invoke("hideRefreshButton")}},{key:"showRefreshButton",value:function(){return window.WrappedContainerModule.invoke("showRefreshButton")}},{key:"hideLoader",value:function(){return window.WrappedContainerModule.invoke("hideLoader")}},{key:"close",value:function(){return window.WrappedContainerModule.invoke("close")}}]),e}(),f=function(){function e(){n(this,e),a.wrapModule(window,"LocaleModule")}return o(e,[{key:"getLanguageLocaleIdentifier",value:function(){return window.WrappedLocaleModule.invoke("getLanguageLocaleIdentifier")}}]),e}(),s=function(){function e(){n(this,e),a.wrapModule(window,"LocationModule")}return o(e,[{key:"getCoordinate",value:function(){return window.WrappedLocationModule.invoke("getCoordinate")}},{key:"observeLocationChange",value:function(){return window.WrappedLocationModule.invoke("observeLocationChange")}}]),e}(),p=function(){function e(){n(this,e),a.wrapModule(window,"MediaModule")}return o(e,[{key:"playDRMContent",value:function(e){return window.WrappedMediaModule.invoke("playDRMContent",{data:e})}}]),e}(),w=require("@grabjs/mobile-kit-bridge-sdk"),k=function(){function e(){n(this,e),w.wrapModule(window,"PlatformModule")}return o(e,[{key:"back",value:function(){return window.WrappedPlatformModule.invoke("back")}}]),e}(),v=function(){function e(){n(this,e),a.wrapModule(window,"ScopeModule")}return o(e,[{key:"hasAccessTo",value:function(e,n){return window.WrappedScopeModule.invoke("hasAccessTo",{module:e,method:n})}},{key:"reloadScopes",value:function(){return window.WrappedScopeModule.invoke("reloadScopes")}}]),e}(),y=require("@grabjs/mobile-kit-bridge-sdk"),M=function(){function e(){n(this,e),y.wrapModule(window,"StorageModule")}return o(e,[{key:"setBoolean",value:function(e,n){return window.WrappedStorageModule.invoke("setBoolean",{key:e,value:n})}},{key:"getBoolean",value:function(e){return window.WrappedStorageModule.invoke("getBoolean",{key:e})}},{key:"setInt",value:function(e,n){return window.WrappedStorageModule.invoke("setInt",{key:e,value:n})}},{key:"getInt",value:function(e){return window.WrappedStorageModule.invoke("getInt",{key:e})}},{key:"setString",value:function(e,n){return window.WrappedStorageModule.invoke("setString",{key:e,value:n})}},{key:"getString",value:function(e){return window.WrappedStorageModule.invoke("getString",{key:e})}},{key:"setDouble",value:function(e,n){return window.WrappedStorageModule.invoke("setDouble",{key:e,value:n})}},{key:"getDouble",value:function(e){return window.WrappedStorageModule.invoke("getDouble",{key:e})}},{key:"remove",value:function(e){return window.WrappedStorageModule.invoke("remove",{key:e})}},{key:"removeAll",value:function(){return window.WrappedStorageModule.invoke("removeAll")}}]),e}(),b=function(){function e(){n(this,e),a.wrapModule(window,"SystemWebViewKitModule")}return o(e,[{key:"redirectToSystemWebView",value:function(e){var n=e.parameters,o=JSON.stringify({method:"redirectToSystemWebView",parameters:n});return window.WrappedSystemWebViewKitModule.invoke("redirectToSystemWebView",o)}}]),e}();e.CheckoutModule=d,e.ContainerModule=c,e.LocaleModule=f,e.LocationModule=s,e.MediaModule=p,e.PlatformModule=k,e.ScopeModule=v,e.StorageModule=M,e.SystemWebViewKitModule=b,Object.defineProperty(e,"__esModule",{value:!0})});
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e=e||self).SuperAppSDK={})}(this,function(e){"use strict";function l(e){return(l="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(e){return typeof e}:function(e){return e&&"function"==typeof Symbol&&e.constructor===Symbol&&e!==Symbol.prototype?"symbol":typeof e})(e)}function t(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function r(e,t){for(var n=0;n<t.length;n++){var r=t[n];r.enumerable=r.enumerable||!1,r.configurable=!0,"value"in r&&(r.writable=!0),Object.defineProperty(e,r.key,r)}}function n(e,t,n){return t&&r(e.prototype,t),n&&r(e,n),e}"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self&&self;var o,a,i=(function(e,t){function u(e){for(var t=[],n=1;n<arguments.length;n++)t[n-1]=arguments[n];if(!e)return!1;var r=function(e){return Object.keys(e).concat(Object.getOwnPropertyNames(Object.getPrototypeOf(e)))}(e);return t.every(function(e){return 0<=r.indexOf(e)})}function c(o,e){var a=e.callbackNameFunc,i=e.funcToWrap;return function(e){return{subscribe:e,then:function(r,o){return new Promise(function(){try{var t=null,n=!1;t=e({next:function(e){r&&r(e),t&&t.unsubscribe(),n=!0}}),n&&t&&t.unsubscribe()}catch(e){o&&o(e)}})}}}(function(n){var t,r=a();return o[r]=function(e){if(u(e,"status_code"))if(u(e.result,"event"))switch(e.result.event){case s.StreamEvent.STREAM_TERMINATED:t.unsubscribe()}else n&&n.next&&n.next(e)},i(r),t=function(e){var t=!1;return{isUnsubscribed:function(){return t},unsubscribe:function(){t||(delete o[r],n&&n.complete&&n.complete(),t=!0)}}}()})}var s;((s=t).StreamEvent||(s.StreamEvent={})).STREAM_TERMINATED="STREAM_TERMINATED",s.wrapModule=function(a,i){a[function(e){return"Wrapped"+e}(i)]=function(e,r,t){var o={};return{invoke:function(t,n){return function(e,t){return t.funcNameToWrap,c(e,function(e,t){var n={};for(var r in e)Object.prototype.hasOwnProperty.call(e,r)&&t.indexOf(r)<0&&(n[r]=e[r]);if(null!=e&&"function"==typeof Object.getOwnPropertySymbols){var o=0;for(r=Object.getOwnPropertySymbols(e);o<r.length;o++)t.indexOf(r[o])<0&&(n[r[o]]=e[r[o]])}return n}(t,["funcNameToWrap"]))}(e,{funcNameToWrap:t,callbackNameFunc:function(){var e=o[t]||0;return o[t]=e+1,function(e){var t=e.moduleName,n=e.funcName,r=e.requestID;return t+"_"+n+"Callback"+(null!==r?"_"+r:"")}({moduleName:r,requestID:e,funcName:t})},funcToWrap:function(e){return function(e){if(a[i])a[i][e.method](JSON.stringify(e));else{if(!(a.webkit&&a.webkit.messageHandlers&&a.webkit.messageHandlers[i]))throw new Error("Unexpected method '"+e.method+"' for module '"+i+"'");a.webkit.messageHandlers[i].postMessage(e)}}({callback:e,method:t,module:r,parameters:null!=n?n:{}})}})}}}(a,i)},Object.defineProperty(s,"__esModule",{value:!0})}(o={exports:{}},o.exports),o.exports),u=(a=i)&&a.__esModule&&Object.prototype.hasOwnProperty.call(a,"default")?a.default:a,c=function(){function e(){t(this,e),u.wrapModule(window,"CheckoutModule")}return n(e,[{key:"triggerCheckout",value:function(e){return window.WrappedCheckoutModule.invoke("triggerCheckout",e)}}]),e}(),s=require("@grabjs/mobile-kit-bridge-sdk"),v={STARTED:"STARTED",PAYMENT_STATUS_UPDATED:"PAYMENT_STATUS_UPDATED",ERROR_OCCURRED:"ERROR_OCCURRED",CUSTOM:"CUSTOM"},d={WARNING:"WARNING",ERROR:"ERROR",CRITICAL:"CRITICAL"},f={SUCCESS:"SUCCESS",FAILURE:"FAILURE",CANCEL:"CANCEL",PROCESSING:"PROCESSING"},p=function(){function e(){t(this,e),s.wrapModule(window,"ContainerModule")}return n(e,[{key:"setBackgroundColor",value:function(e){return window.WrappedContainerModule.invoke("setBackgroundColor",{backgroundColor:e})}},{key:"setTitle",value:function(e){return window.WrappedContainerModule.invoke("setTitle",{title:e})}},{key:"hideBackButton",value:function(){return window.WrappedContainerModule.invoke("hideBackButton")}},{key:"showBackButton",value:function(){return window.WrappedContainerModule.invoke("showBackButton")}},{key:"hideRefreshButton",value:function(){return window.WrappedContainerModule.invoke("hideRefreshButton")}},{key:"showRefreshButton",value:function(){return window.WrappedContainerModule.invoke("showRefreshButton")}},{key:"close",value:function(){return window.WrappedContainerModule.invoke("close")}},{key:"sendAnalyticsEvent",value:function(e){var t=this._validateAnalyticsEvent(e);return t?{then:function(e){return e({result:null,error:t})}}:window.WrappedContainerModule.invoke("sendAnalyticsEvent",{url:e.url,sessionId:e.sessionId,viewName:e.viewName,eventName:e.eventName,eventData:JSON.stringify(e.eventData)})}},{key:"_validateAnalyticsEvent",value:function(e){for(var t=0,n=["eventName"];t<n.length;t++){var r=n[t];if(!e[r])return"Missing required field: ".concat(r)}if(e.url&&"string"!=typeof e.url)return"url must be a string";if(e.sessionId&&"string"!=typeof e.sessionId)return"sessionId must be a string";if(e.viewName&&"string"!=typeof e.viewName)return"viewName must be a string";var o=Object.values(v);if(!o.includes(e.eventName))return"Invalid eventName. Must be one of: ".concat(o.join(", "));switch(e.eventName){case v.STARTED:return this._validateStartedEvent(e.eventData);case v.PAYMENT_STATUS_UPDATED:return this._validatePaymentStatusUpdatedEvent(e.eventData);case v.ERROR_OCCURRED:return this._validateErrorOccurredEvent(e.eventData);case v.CUSTOM:return this._validateCustomEvent(e.eventData)}return null}},{key:"_validateStartedEvent",value:function(e){return null!=e?"".concat(v.STARTED," event should have empty eventData"):null}},{key:"_validatePaymentStatusUpdatedEvent",value:function(e){if(!e)return"".concat(v.PAYMENT_STATUS_UPDATED," event requires eventData");if("object"!==l(e)||Array.isArray(e))return"".concat(v.PAYMENT_STATUS_UPDATED," event requires eventData to be an object");var t=["transactionId","statusCode","statusMessage","products","amount","currency","promoCodes"],n=Object.keys(e).filter(function(e){return!t.includes(e)});if(0<n.length)return"".concat(v.PAYMENT_STATUS_UPDATED," event does not allow additional fields in eventData: ").concat(n.join(", "));if(e.transactionId&&"string"!=typeof e.transactionId)return"".concat(v.PAYMENT_STATUS_UPDATED," event requires transactionId in eventData to be a string");if(!e.statusCode)return"".concat(v.PAYMENT_STATUS_UPDATED," event requires statusCode in eventData to be defined");if("string"!=typeof e.statusCode)return"".concat(v.PAYMENT_STATUS_UPDATED," event requires statusCode in eventData to be a string");var r=Object.values(f);if(!r.includes(e.statusCode))return"".concat(v.PAYMENT_STATUS_UPDATED," event requires statusCode in eventData to be one of: ").concat(r.join(", "));if(e.statusMessage&&"string"!=typeof e.statusMessage)return"".concat(v.PAYMENT_STATUS_UPDATED," event requires statusMessage in eventData to be a string");if(e.products){if(!Array.isArray(e.products))return"".concat(v.PAYMENT_STATUS_UPDATED," event requires products in eventData to be an array");var o=!0,a=!1,i=void 0;try{for(var u,c=function(){var e=u.value,t=["id","quantity"],n=Object.keys(e).filter(function(e){return!t.includes(e)});return 0<n.length?{v:"".concat(v.PAYMENT_STATUS_UPDATED," event does not allow additional fields in eventData.products item: ").concat(n.join(", "))}:e.id?"string"!=typeof e.id?{v:"".concat(v.PAYMENT_STATUS_UPDATED," event requires id in eventData.products item to be a string")}:e.quantity&&"number"!=typeof e.quantity?{v:"".concat(v.PAYMENT_STATUS_UPDATED," event requires quantity in eventData.products item to be a number")}:void 0:{v:"".concat(v.PAYMENT_STATUS_UPDATED," event requires id in eventData.products item to be defined")}},s=e.products[Symbol.iterator]();!(o=(u=s.next()).done);o=!0){var d=c();if("object"===l(d))return d.v}}catch(e){a=!0,i=e}finally{try{o||null==s.return||s.return()}finally{if(a)throw i}}}return e.amount&&"number"!=typeof e.amount?"".concat(v.PAYMENT_STATUS_UPDATED," event requires amount in eventData to be a number"):e.currency&&"string"!=typeof e.currency?"".concat(v.PAYMENT_STATUS_UPDATED," event requires currency in eventData to be a string"):!e.promoCodes||Array.isArray(e.promoCodes)&&e.promoCodes.every(function(e){return"string"==typeof e})?null:"".concat(v.PAYMENT_STATUS_UPDATED," event requires promoCodes in eventData to be an array of strings")}},{key:"_validateErrorOccurredEvent",value:function(e){if(!e)return"".concat(v.ERROR_OCCURRED," event requires eventData");if("object"!==l(e)||Array.isArray(e))return"".concat(v.ERROR_OCCURRED," event requires eventData to be an object");var t=["errorCode","errorMessage","errorSeverity"],n=Object.keys(e).filter(function(e){return!t.includes(e)});return 0<n.length?"".concat(v.ERROR_OCCURRED," event does not allow additional fields in eventData: ").concat(n.join(", ")):e.errorCode?"string"!=typeof e.errorCode?"".concat(v.ERROR_OCCURRED," event requires errorCode in eventData to be a string"):e.errorMessage&&"string"!=typeof e.errorMessage?"".concat(v.ERROR_OCCURRED," event requires errorMessage in eventData to be a string"):e.errorSeverity&&!Object.values(d).includes(e.errorSeverity)?"".concat(v.ERROR_OCCURRED," event requires errorSeverity in eventData to be one of: ").concat(Object.values(d).join(", ")):null:"".concat(v.ERROR_OCCURRED," event requires errorCode in eventData to be defined")}},{key:"_validateCustomEvent",value:function(e){if(!e)return"".concat(v.CUSTOM," event requires eventData");if("object"!==l(e)||Array.isArray(e))return"".concat(v.CUSTOM," event requires eventData to be an object");var t=["customEventName","customEventData"],n=Object.keys(e).filter(function(e){return!t.includes(e)});return 0<n.length?"".concat(v.CUSTOM," event does not allow additional fields in eventData: ").concat(n.join(", ")):e.customEventName?"string"!=typeof e.customEventName?"".concat(v.CUSTOM," event requires customEventName in eventData to be a string"):null:"".concat(v.CUSTOM," event requires customEventName in eventData to be defined")}}]),e}(),y=function(){function e(){t(this,e),u.wrapModule(window,"LocaleModule")}return n(e,[{key:"getLanguageLocaleIdentifier",value:function(){return window.WrappedLocaleModule.invoke("getLanguageLocaleIdentifier")}}]),e}(),w=function(){function e(){t(this,e),u.wrapModule(window,"LocationModule")}return n(e,[{key:"getCoordinate",value:function(){return window.WrappedLocationModule.invoke("getCoordinate")}},{key:"observeLocationChange",value:function(){return window.WrappedLocationModule.invoke("observeLocationChange")}}]),e}(),T=function(){function e(){t(this,e),u.wrapModule(window,"MediaModule")}return n(e,[{key:"playDRMContent",value:function(e){return window.WrappedMediaModule.invoke("playDRMContent",{data:e})}}]),e}(),b=require("@grabjs/mobile-kit-bridge-sdk"),S=function(){function e(){t(this,e),b.wrapModule(window,"PlatformModule")}return n(e,[{key:"back",value:function(){return window.WrappedPlatformModule.invoke("back")}}]),e}(),M=function(){function e(){t(this,e),u.wrapModule(window,"ScopeModule")}return n(e,[{key:"hasAccessTo",value:function(e,t){return window.WrappedScopeModule.invoke("hasAccessTo",{module:e,method:t})}},{key:"reloadScopes",value:function(){return window.WrappedScopeModule.invoke("reloadScopes")}}]),e}(),m=require("@grabjs/mobile-kit-bridge-sdk"),E=function(){function e(){t(this,e),m.wrapModule(window,"StorageModule")}return n(e,[{key:"setBoolean",value:function(e,t){return window.WrappedStorageModule.invoke("setBoolean",{key:e,value:t})}},{key:"getBoolean",value:function(e){return window.WrappedStorageModule.invoke("getBoolean",{key:e})}},{key:"setInt",value:function(e,t){return window.WrappedStorageModule.invoke("setInt",{key:e,value:t})}},{key:"getInt",value:function(e){return window.WrappedStorageModule.invoke("getInt",{key:e})}},{key:"setString",value:function(e,t){return window.WrappedStorageModule.invoke("setString",{key:e,value:t})}},{key:"getString",value:function(e){return window.WrappedStorageModule.invoke("getString",{key:e})}},{key:"setDouble",value:function(e,t){return window.WrappedStorageModule.invoke("setDouble",{key:e,value:t})}},{key:"getDouble",value:function(e){return window.WrappedStorageModule.invoke("getDouble",{key:e})}},{key:"remove",value:function(e){return window.WrappedStorageModule.invoke("remove",{key:e})}},{key:"removeAll",value:function(){return window.WrappedStorageModule.invoke("removeAll")}}]),e}(),g=function(){function e(){t(this,e),u.wrapModule(window,"SystemWebViewKitModule")}return n(e,[{key:"redirectToSystemWebView",value:function(e){return window.WrappedSystemWebViewKitModule.invoke("redirectToSystemWebView",e)}}]),e}();e.CheckoutModule=c,e.ContainerModule=p,e.LocaleModule=y,e.LocationModule=w,e.MediaModule=T,e.PlatformModule=S,e.ScopeModule=M,e.StorageModule=E,e.SystemWebViewKitModule=g,Object.defineProperty(e,"__esModule",{value:!0})});

package/docs/ContainerModule.md

@@ -2,7 +2,7 @@
 
 ## Description
 
-Provides APIs to interract with the webview container.
+Provides APIs to interact with the webview container.
 
 ## Methods
 
@@ -12,9 +12,9 @@ Provides APIs to interract with the webview container.
 
 **Arguments**
 
-| Name            | Type   | Description             |
-| --------------- | ------ | ----------------------- |
-| backgroundColor | String | Hexadecimal color value |
+| Name            | Type   | Required | Description             |
+| --------------- | ------ | -------- | ----------------------- |
+| backgroundColor | String | Yes      | Hexadecimal color value |
 
 **Return type**
 
@@ -28,15 +28,11 @@ import { ContainerModule } from "@grabjs/superapp-sdk";
 // Ideally, initialize this only one and reuse across app.
 const containerModule = new ContainerModule();
 
-containerModule
-  .setBackgroundColor("#ffffff")
-  .then(({ result, error }) => {
-    if (result) {
-      // There is a valid result.
-    } else if (error) {
-      // Some error happened.
-    }
-  });
+containerModule.setBackgroundColor("#ffffff").then(({ result, error }) => {
+  if (error) {
+    // Some error happened.
+  }
+});
 ```
 
 ### 2. Set title
@@ -45,9 +41,9 @@ containerModule
 
 **Arguments**
 
-| Name  | Type   | Description       |
-| ----- | ------ | ----------------- |
-| title | String | Title of the page |
+| Name  | Type   | Required | Description       |
+| ----- | ------ | -------- | ----------------- |
+| title | String | Yes      | Title of the page |
 
 **Return type**
 
@@ -62,9 +58,7 @@ import { ContainerModule } from "@grabjs/superapp-sdk";
 const containerModule = new ContainerModule();
 
 containerModule.setTitle("Home").then(({ result, error }) => {
-  if (result) {
-    // There is a valid result.
-  } else if (error) {
+  if (error) {
     // Some error happened.
   }
 });
@@ -91,9 +85,7 @@ import { ContainerModule } from "@grabjs/superapp-sdk";
 const containerModule = new ContainerModule();
 
 containerModule.hideBackButton().then(({ result, error }) => {
-  if (result) {
-    // There is a valid result.
-  } else if (error) {
+  if (error) {
     // Some error happened.
   }
 });
@@ -120,9 +112,7 @@ import { ContainerModule } from "@grabjs/superapp-sdk";
 const containerModule = new ContainerModule();
 
 containerModule.showBackButton().then(({ result, error }) => {
-  if (result) {
-    // There is a valid result.
-  } else if (error) {
+  if (error) {
     // Some error happened.
   }
 });
@@ -186,9 +176,9 @@ containerModule.showRefreshButton().then(({ result, error }) => {
 });
 ```
 
-### 7. Hide loader
+### 7. Close
 
-**Method name**: `hideLoader`
+**Method name**: `close`
 
 **Arguments**
 
@@ -206,7 +196,7 @@ import { ContainerModule } from "@grabjs/superapp-sdk";
 // Ideally, initialize this only one and reuse across app.
 const containerModule = new ContainerModule();
 
-containerModule.hideLoader().then(({ result, error }) => {
+containerModule.close().then(({ result, error }) => {
   if (result) {
     // There is a valid result.
   } else if (error) {
@@ -215,31 +205,165 @@ containerModule.hideLoader().then(({ result, error }) => {
 });
 ```
 
-### 8. Close
+### 8. Send analytics event
 
-**Method name**: `close`
+**Method name**: `sendAnalyticsEvent`
 
 **Arguments**
 
-`None`
+An object, containing the following properties:
+
+| Name        | Type   | Required | Description                                                    |
+| ----------- | ------ | -------- | -------------------------------------------------------------- |
+| `url`       | String | No       | The URL associated with the event                              |
+| `sessionId` | String | No       | A unique identifier for the user's session                     |
+| `viewName`  | String | No       | The name of the page or screen displayed when the event occurs |
+| `eventName` | String | Yes      | Name of the event                                              |
+| `eventData` | Any    | No       | The event data (can be any type)                               |
+
+**Events**
+
+The following events are available:
+
+- `STARTED`
+
+  - **Description**: Triggered when the MiniApp is initialized.
+  - **Requirements for eventData**:
+    - Must be empty
+
+- `PAYMENT_STATUS_UPDATED`
+
+  - **Description**: Triggered when a payment status is updated.
+  - **Requirements for eventData**:
+    - `transactionId` (String, optional): The transaction identifier provided by the GrabPay SDK
+    - `statusCode` (String, required): The status of the payment. Must be one of: 'SUCCESS', 'FAILURE', 'CANCEL', 'PROCESSING' (case-sensitive)
+    - `statusMessage` (String, optional): A message describing the status update
+    - `products` (Array of objects, optional): The products that are being purchased
+      - Each product must have:
+        - `id` (String, required): The product's unique identifier
+        - `quantity` (Number, optional): The quantity of the product
+    - `amount` (Number, optional): The total amount of the transaction
+    - `currency` (String, optional): The currency used for the transaction
+    - `promoCodes` (Array of string, optional): Any promo codes applied to this transaction
+
+- `ERROR_OCCURRED`
+
+  - **Description**: Triggered when an error occurs within the MiniApp.
+  - **Requirements for eventData**:
+    - `errorCode` (String, required): A code or type identifying the error
+    - `errorMessage` (String, optional): A message describing the error
+    - `errorSeverity` (String, optional): The severity level of the error. Must be one of: 'WARNING', 'ERROR', 'CRITICAL' (case-sensitive)
+
+- `CUSTOM`
+  - **Description**: Triggered when a custom event should be tracked within the MiniApp.
+  - **Requirements for eventData**:
+    - `customEventName` (String, required): The name of the custom event
+    - `customEventData` (Any, optional): An object containing the custom event data
 
 **Return type**
 
 `None`
 
+**Validation**
+
+The SDK performs strict validation on all events:
+
+- All required fields must be present
+- Field types must match their specifications exactly
+- No additional fields are allowed beyond those specified
+- Validation errors will be returned in the `error` field of the response
+
 **Code example**
 
 ```javascript
-import { ContainerModule } from "@grabjs/superapp-sdk";
+import {
+  ContainerModule,
+  AnalyticsEventName,
+  PaymentStatusCode,
+  ErrorSeverity,
+} from "@grabjs/superapp-sdk";
 
 // Ideally, initialize this only one and reuse across app.
 const containerModule = new ContainerModule();
 
-containerModule.close().then(({ result, error }) => {
-  if (result) {
-    // There is a valid result.
-  } else if (error) {
-    // Some error happened.
-  }
-});
+// Example for STARTED event
+containerModule
+  .sendAnalyticsEvent({
+    url: "https://www.grab.com/sg/",
+    sessionId: "e48553f4-625a-431d-adae-56d7801c083c",
+    viewName: "Home",
+    eventName: AnalyticsEventName.STARTED,
+    eventData: null,
+  })
+  .then(({ result, error }) => {
+    if (error) {
+      // Some error happened.
+    }
+  });
+
+// Example for PAYMENT_STATUS_UPDATED event
+containerModule
+  .sendAnalyticsEvent({
+    url: "https://www.grab.com/sg/",
+    sessionId: "e48553f4-625a-431d-adae-56d7801c083c",
+    viewName: "Payment",
+    eventName: AnalyticsEventName.PAYMENT_STATUS_UPDATED,
+    eventData: {
+      transactionId: "txn_123456",
+      statusCode: PaymentStatusCode.SUCCESS,
+      statusMessage: "Payment completed successfully",
+      products: [
+        { id: "product_1", quantity: 2 },
+        { id: "product_2", quantity: 1 },
+      ],
+      amount: 100.5,
+      currency: "SGD",
+      promoCodes: ["10%OFF"],
+    },
+  })
+  .then(({ result, error }) => {
+    if (error) {
+      // Some error happened.
+    }
+  });
+
+// Example for ERROR_OCCURRED event
+containerModule
+  .sendAnalyticsEvent({
+    url: "https://www.grab.com/sg/",
+    sessionId: "e48553f4-625a-431d-adae-56d7801c083c",
+    viewName: "Payment",
+    eventName: AnalyticsEventName.ERROR_OCCURRED,
+    eventData: {
+      errorCode: "PAYMENT_FAILED",
+      errorMessage: "Failed to process payment due to insufficient funds",
+      errorSeverity: ErrorSeverity.ERROR,
+    },
+  })
+  .then(({ result, error }) => {
+    if (error) {
+      // Some error happened.
+    }
+  });
+
+// Example for CUSTOM event
+containerModule
+  .sendAnalyticsEvent({
+    url: "https://www.grab.com/sg/",
+    sessionId: "e48553f4-625a-431d-adae-56d7801c083c",
+    viewName: "Home",
+    eventName: AnalyticsEventName.CUSTOM,
+    eventData: {
+      customEventName: "USER_ACTION",
+      customEventData: {
+        action: "button_click",
+        buttonId: "submit_order",
+      },
+    },
+  })
+  .then(({ result, error }) => {
+    if (error) {
+      // Some error happened.
+    }
+  });
 ```

package/docs/SystemWebViewKitModule.md

@@ -30,9 +30,8 @@ import { SystemWebViewKitModule } from '@grab/superapp-sdk';
 const systemWebViewKitModule = new SystemWebViewKitModule();
 
 // open the system webview
-systemWebViewKitModule.redirectToSystemWebView({
-    parameters: { url: 'https://example.com' }
-  }).then({ result, error }) => {
+systemWebViewKitModule.redirectToSystemWebView({ url: 'http://wwww.example.com' })
+  .then({ result, error }) => {
     if (!!result) {
       // There is a valid result.
     } else if (!!error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grabjs/superapp-sdk",
-  "version": "1.7.4",
+  "version": "1.7.6",
   "description": "SDK for Grab SuperApp WebView.",
   "main": "dist/index.js",
   "scripts": {