From 89db46e032d832447046d83d108e2c3ea7b93b71 Mon Sep 17 00:00:00 2001
From: Erfan Mola <hi@erfanxd.ir>
Date: Tue, 10 Oct 2023 13:50:17 +0330
Subject: [PATCH] Linting & Commenting

---
 webApp/src/App.vue            | 22 +++-------------------
 webApp/src/utils/index.js     | 25 +++++++++++--------------
 webApp/src/views/Badges.vue   |  1 +
 webApp/src/views/Home.vue     |  1 +
 webApp/src/views/Login.vue    |  2 ++
 webApp/src/views/Transfer.vue |  4 +++-
 webApp/src/views/Wallet.vue   |  2 ++
 7 files changed, 23 insertions(+), 34 deletions(-)

diff --git a/webApp/src/App.vue b/webApp/src/App.vue
index 86ba9ab..8e03609 100644
--- a/webApp/src/App.vue
+++ b/webApp/src/App.vue
@@ -1,6 +1,5 @@
 <script setup>
-    import { ref, onMounted } from 'vue';
-    import { useRouter } from 'vue-router';
+    import { onMounted } from 'vue';
 
     import WebApp from '@twa-dev/sdk';
 
@@ -10,35 +9,20 @@
     import { AppearanceProvider, LocaleProvider, AuthProvider } from '@erfanmola/televue';
     import '@erfanmola/televue/style.css';
 
-    // Check if we are in dev mode
-    const devMode = (import.meta.env.MODE === 'development') && true;
-
     // Retrive VITE_HEX_HMAC_SIGNATURE environment variable if available
     const hex_hmac_signature = import.meta.env.VITE_HEX_HMAC_SIGNATURE;
 
     // Try to retrieve the saved `locale` from LocalStorage if available
     const locale = localStorage.getItem('dpxwallet_locale');
 
-    const slideTransition = ref('slide-left');
-
-    const router = useRouter();
-
     onMounted(() => {
 
+        // Preload Audio files that we are going to use
         Utils.PreLoadAudio('Success.mp3');
         Utils.PreLoadAudio('Failed.mp3');
 
     });
 
-    router.afterEach((to, from) => {
-
-        const toPath = to.path.split('/').filter((item) => item.length).length;
-        const fromPath = from.path.split('/').filter((item) => item.length).length;
-
-        slideTransition.value = (toPath) < (fromPath) ? 'slide-right' : 'slide-left';
-
-    });
-
     WebApp.setHeaderColor('secondary_bg_color');
     WebApp.setBackgroundColor('secondary_bg_color');
     WebApp.expand();
@@ -57,7 +41,7 @@
             </LocaleProvider>
         </AppearanceProvider>
 
-        <template #unauthorized>
+        <template #unauthorized v-if="hex_hmac_signature">
             Your client is not authorized, please use this WebApp from a valid Telegram Client
         </template>
     </component>
diff --git a/webApp/src/utils/index.js b/webApp/src/utils/index.js
index 5a670a3..eb48798 100755
--- a/webApp/src/utils/index.js
+++ b/webApp/src/utils/index.js
@@ -5,10 +5,12 @@ let Audios = {};
 
 const Utils = {
     
+    // Wrapper for Toastify function
     Toast: (text, duration = 2000) => { 
         Toastify({text: text, duration: duration, gravity: 'top', position: 'left', style: {background: 'var(--tg-theme-text-color)', color: 'var(--tg-theme-bg-color)'}}).showToast(); 
     },
 
+    // Send request to DPX API & return reponse
     DPXSendRequest: async (endpoint = '/', data = [], method = 'POST', i18n = null) => {
 
         const FD = new FormData();
@@ -72,6 +74,7 @@ const Utils = {
 
     },
 
+    // Preload audio file
     PreLoadAudio: (name) => {
             
         if (Audios[name] === undefined) {
@@ -82,12 +85,14 @@ const Utils = {
 
     },
 
+    // Play an audio file
     PlayAudio: (name) => {
 
         Audios[name].play();
 
     },
 
+    // a prefered way of showing Telegram WebApp prompts and handling it's callback
     Prompt: (title = null, text, options) => {
 
         if (WebApp.isVersionAtLeast('6.2')) {
@@ -141,6 +146,7 @@ const Utils = {
 
     },
 
+    // Scan QRCode if supported
     ScanQRCode: (text, onReceive) => {
 
         if (WebApp.isVersionAtLeast('6.4')) {
@@ -172,22 +178,10 @@ const Utils = {
 
     },
 
-    readTextFromClipboard: (onPaste) => {
-
-        if (WebApp.isVersionAtLeast('6.4')) {
-
-            WebApp.readTextFromClipboard(onPaste);
-
-        }else{
-
-            Utils.Toast('Unsupported');
-
-        }
-
-    },
-
+    // Hide keyboard when user clicks enter
     hideKeyboardOnEnter: (event) => { if (event.keyCode === 13) { event.target.blur(); } },
 
+    // Copy text to clipboard
     copyTextToClipboard: (text) => {
 
         if (!navigator.clipboard) {
@@ -220,6 +214,7 @@ const Utils = {
     
     },
 
+    // Get wallet/secret from LocalStorage
     GetWallet(param = null) {
 
         let info = window.localStorage.getItem(`wallet_user_${ WebApp.initDataUnsafe.user.id }`);
@@ -244,6 +239,7 @@ const Utils = {
 
     },
 
+    // Set wallet/secret to LocalStorage
     SetWallet(wallet = null, secret = null) {
 
         if (wallet === null) {
@@ -263,6 +259,7 @@ const Utils = {
 
     },
 
+    // a hacky trick to fix mispositioning of UI elements when keyboard opens
     HandleInputFocus: () => {
 
         window.scrollTo(0, 0);
diff --git a/webApp/src/views/Badges.vue b/webApp/src/views/Badges.vue
index 975d215..2149933 100644
--- a/webApp/src/views/Badges.vue
+++ b/webApp/src/views/Badges.vue
@@ -173,4 +173,5 @@
 
         }
     }
+    
 </style>
\ No newline at end of file
diff --git a/webApp/src/views/Home.vue b/webApp/src/views/Home.vue
index 3e00deb..1ec1fe8 100644
--- a/webApp/src/views/Home.vue
+++ b/webApp/src/views/Home.vue
@@ -8,6 +8,7 @@
     import Utils from '../utils';
 
     import { useRankStore } from '../stores/useRanks';
+    
     import badge from '../components/badge.vue';
     import Header from '../components/Header.vue';
 
diff --git a/webApp/src/views/Login.vue b/webApp/src/views/Login.vue
index 764c615..ff7731a 100644
--- a/webApp/src/views/Login.vue
+++ b/webApp/src/views/Login.vue
@@ -94,6 +94,7 @@
 </template>
 
 <style lang="scss">
+
     #section-login {
         display: flex;
         flex-direction: column;
@@ -143,4 +144,5 @@
             }
         }
     }
+    
 </style>
\ No newline at end of file
diff --git a/webApp/src/views/Transfer.vue b/webApp/src/views/Transfer.vue
index d3b66e7..92848a0 100644
--- a/webApp/src/views/Transfer.vue
+++ b/webApp/src/views/Transfer.vue
@@ -1,5 +1,5 @@
 <script setup>
-    import { inject, ref, onMounted } from 'vue';
+    import { inject, ref } from 'vue';
     import { useI18n } from "vue-i18n";
     import { useRouter, useRoute } from 'vue-router';
 
@@ -160,6 +160,7 @@
 </template>
 
 <style lang="scss">
+
     #section-transfer {
         display: flex;
         flex-direction: column;
@@ -183,4 +184,5 @@
             }
         }
     }
+    
 </style>
\ No newline at end of file
diff --git a/webApp/src/views/Wallet.vue b/webApp/src/views/Wallet.vue
index 4354aa1..4f6df23 100755
--- a/webApp/src/views/Wallet.vue
+++ b/webApp/src/views/Wallet.vue
@@ -243,6 +243,7 @@
 </template>
 
 <style lang="scss">
+
     #section-wallet {
         display: flex;
         flex-direction: column;
@@ -272,4 +273,5 @@
             }
         }
     }
+    
 </style>
\ No newline at end of file