src_hooks_useProfile.ts.html 8.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="width=device-width, initial-scale=1">
  6. <title> src/hooks/useProfile.ts</title>
  7. <script src="https://cdn.jsdelivr.net/gh/google/code-prettify@master/loader/run_prettify.js"></script>
  8. <script src="https://unpkg.com/@babel/standalone/babel.min.js"></script>
  9. <script src="./build/entry.js"></script>
  10. <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
  11. <!--[if lt IE 9]>
  12. <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
  13. <![endif]-->
  14. <link href="https://fonts.googleapis.com/css?family=Roboto:100,400,700|Inconsolata,700" rel="stylesheet">
  15. <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.6.3/css/all.css" integrity="sha384-UHRtZLI+pbxtHCWp1t77Bi1L4ZtiqrqD80Kn4Z8NTSRyMA2Fd33n5dQ8lWUE00s/" crossorigin="anonymous">
  16. <link type="text/css" rel="stylesheet" href="https://jmblog.github.io/color-themes-for-google-code-prettify/themes/tomorrow-night.min.css">
  17. <link type="text/css" rel="stylesheet" href="styles/app.min.css">
  18. <link type="text/css" rel="stylesheet" href="styles/iframe.css">
  19. <link type="text/css" rel="stylesheet" href="">
  20. <script async defer src="https://buttons.github.io/buttons.js"></script>
  21. </head>
  22. <body class="layout small-header">
  23. <div id="stickyNavbarOverlay"></div>
  24. <div class="top-nav">
  25. <div class="inner">
  26. <a id="hamburger" role="button" class="navbar-burger" aria-label="menu" aria-expanded="false">
  27. <span aria-hidden="true"></span>
  28. <span aria-hidden="true"></span>
  29. <span aria-hidden="true"></span>
  30. </a>
  31. <div class="logo">
  32. </div>
  33. <div class="menu">
  34. <div class="navigation">
  35. <a
  36. href="index.html"
  37. class="link"
  38. >
  39. API Documentation
  40. </a>
  41. </div>
  42. </div>
  43. </div>
  44. </div>
  45. <div id="main">
  46. <div
  47. class="sidebar "
  48. id="sidebarNav"
  49. >
  50. <nav>
  51. <h2><a href="index.html">Documentation</a></h2><div class="category"><h3>Interfaces</h3><ul><li><a href="AddLandmarkProps.html">AddLandmarkProps</a></li><li><a href="CommentProps.html">CommentProps</a></li><li><a href="IdToken.html">IdToken</a></li><li><a href="IntroProps.html">IntroProps</a></li><li><a href="Landmark.html">Landmark</a></li><li><a href="LandmarkDetailsProps.html">LandmarkDetailsProps</a></li><li><a href="LandmarkPinProps.html">LandmarkPinProps</a></li><li><a href="LMComment.html">LMComment</a></li><li><a href="ProfileProps.html">ProfileProps</a></li><li><a href="RegisterProps.html">RegisterProps</a></li><li><a href="UserProfile.html">UserProfile</a></li></ul><h3>Components</h3><ul><li><a href="App.html">App</a></li><li><a href="Atlas.html">Atlas</a></li><li><a href="Comment.html">Comment</a></li><li><a href="PrimaryButton.html">PrimaryButton</a></li><li><a href="Profile.html">Profile</a></li><li><a href="SecondaryButton.html">SecondaryButton</a></li></ul><h3>Global</h3><ul><li><a href="global.html#IconStrings">IconStrings</a></li></ul></div><div class="category"><h2>Hooks</h2><h3>Namespaces</h3><ul><li><a href="useAuth.html">useAuth</a></li><li><a href="useLandmarks.html">useLandmarks</a></li><li><a href="useProfile.html">useProfile</a></li></ul></div><div class="category"><h2>Map</h2><h3>Interfaces</h3><ul><li><a href="UserLocation.html">UserLocation</a></li></ul><h3>Components</h3><ul><li><a href="AddLandmark.html">AddLandmark</a></li><li><a href="LandmarkDetails.html">LandmarkDetails</a></li><li><a href="LandmarkPin.html">LandmarkPin</a></li><li><a href="Map.html">Map</a></li></ul></div><div class="category"><h2>Navigation</h2><h3>Components</h3><ul><li><a href="AuthorizedNavigator.html">AuthorizedNavigator</a></li><li><a href="UnauthorizedNavigator.html">UnauthorizedNavigator</a></li></ul><h3><a href="global.html">Global</a></h3></div><div class="category"><h2>Stores</h2><h3>Classes</h3><ul><li><a href="AuthStore.html">AuthStore</a></li></ul></div><div class="category"><h2>Unauthorized</h2><h3>Components</h3><ul><li><a href="Intro.html">Intro</a></li><li><a href="UnauthorizedLayout.html">UnauthorizedLayout</a></li></ul><h3>Components / Registration</h3><ul><li><a href="RegisterMain.html">RegisterMain</a></li></ul></div>
  52. </nav>
  53. </div>
  54. <div class="core" id="main-content-wrapper">
  55. <div class="content">
  56. <header class="page-title">
  57. <p>Source</p>
  58. <h1>src/hooks/useProfile.ts</h1>
  59. </header>
  60. <section>
  61. <article>
  62. <pre class="prettyprint source linenums"><code>// This file houses crud methods to interact with user profile data on the server. They are generally called by react query mutations.
  63. import axios, { AxiosRequestConfig } from "axios"
  64. import { QueryClient, useMutation, useQuery, useQueryClient } from "react-query";
  65. import { API_URL, reportAxiosError } from "../globals"
  66. import { authStore } from "../stores/AuthStore";
  67. import { useAuth } from "./useAuth";
  68. /**
  69. * Interface that contains data in a user's profile.
  70. */
  71. export interface UserProfile {
  72. /**
  73. * The user's id
  74. */
  75. id?: string
  76. /**
  77. * The user's username
  78. */
  79. username?: string
  80. /**
  81. * The user's email
  82. */
  83. email?: string
  84. /**
  85. * The user's base64 encoded profile picture.
  86. */
  87. picture?: string
  88. }
  89. /**
  90. * A custom hook containing [react-query]{@link https://react-query.tanstack.com/} queries and mutations and other logic related to interacting with {@link UserProfile} objects.
  91. * @category Hooks
  92. * @namespace useProfile
  93. */
  94. export const useProfile = (userId: string) => {
  95. /**
  96. * The local instance of the [react-query QueryClient]{@link https://react-query.tanstack.com/reference/QueryClient#_top}.
  97. * @memberOf useLandmarks
  98. */
  99. let queryClient: QueryClient;
  100. try {
  101. queryClient = useQueryClient()
  102. } catch (error) {
  103. console.log("Something went wrong when retrieving query client:")
  104. console.log(error)
  105. }
  106. const { refreshAccessToken } = useAuth();
  107. /**
  108. * The callback responsible for retrieving the {@link Profile} matching the given ID from the API , used by the [react-query useQuery]{@link https://react-query.tanstack.com/reference/useQuery#_top} hook.
  109. * * @memberOf useProfile
  110. */
  111. const getProfile = async (id: string) => {
  112. const config: AxiosRequestConfig = {
  113. method: 'GET',
  114. url: API_URL + `/api/user-profile/${id}/`,
  115. headers: { "Authorization": "Bearer " + authStore.accessToken, }
  116. }
  117. try {
  118. const response = await axios(config);
  119. return response.data;
  120. } catch (error) {
  121. if (error.response.status == 401) {
  122. try {
  123. await refreshAccessToken()
  124. const response = await axios({...config, headers: { "Authorization": "Bearer " + authStore.accessToken }});
  125. return response.data;
  126. } catch (error) {
  127. // refreshAccessToken will report errors
  128. }
  129. }
  130. reportAxiosError('Something went wrong when retrieving landmarks', error)
  131. throw new Error;
  132. }
  133. }
  134. // get query
  135. const { data: profile, status: getProfileStatus } = useQuery&lt;UserProfile, Error>(['getProfile', userId], async () => getProfile(userId))
  136. return { profile, getProfileStatus } //reading
  137. }
  138. </code></pre>
  139. </article>
  140. </section>
  141. </div>
  142. <footer class="footer">
  143. <div class="content has-text-centered">
  144. <p>Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.6.7</a></p>
  145. <p class="sidebar-created-by">
  146. <a href="https://github.com/SoftwareBrothers/better-docs" target="_blank">BetterDocs theme</a> provided with <i class="fas fa-heart"></i> by
  147. <a href="http://softwarebrothers.co" target="_blank">SoftwareBrothers - JavaScript Development Agency</a>
  148. </p>
  149. </div>
  150. </footer>
  151. </div>
  152. <div id="side-nav" class="side-nav">
  153. </div>
  154. </div>
  155. <script src="scripts/app.min.js"></script>
  156. <script>PR.prettyPrint();</script>
  157. <script src="scripts/linenumber.js"> </script>
  158. </body>
  159. </html>