docs(jsdoc): fix async return and param annotations

src/devops/index.js

@@ -9,6 +9,10 @@ const AZURE_DEVOPS_SCOPES = ["https://app.vssps.visualstudio.com/.default"];
 
 /**
  * Get Azure DevOps API token.
+ *
+ * @param { string } tenantId - The Azure AD tenant ID
+ * @param { string } clientId - The Azure AD client ID
+ * @returns { Promise<string> } Azure DevOps API access token
  */
 
 export async function getDevOpsApiToken(tenantId, clientId) {
@@ -33,7 +37,7 @@ export async function getDevOpsApiToken(tenantId, clientId) {
  * @param { string } orgUrl - The Azure DevOps organization URL
  * @param { string } tenantId - The Azure AD tenant ID
  * @param { string } clientId - The Azure AD client ID
- * @returns 
+ * @returns { Promise<{ coreClient: Object, gitClient: Object }> }
  */
 
 export async function getDevOpsClients(orgUrl, tenantId, clientId) {

src/graph/app.js

@@ -3,7 +3,7 @@
  *
  * @param { Object } client 
  * @param { string } displayName 
- * @returns 
+ * @returns { Promise<Object|null> }
  */
 export async function getApp(client, displayName) {
   const result = await client