From 97f659905625d581145550e1e14c3b9a52fa87e5 Mon Sep 17 00:00:00 2001
From: Slawomir Koszewski <slawek@koszewscy.waw.pl>
Date: Sun, 8 Feb 2026 11:53:53 +0100
Subject: [PATCH] docs(jsdoc): fix async return and param annotations

---
 src/devops/index.js | 6 +++++-
 src/graph/app.js    | 2 +-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/devops/index.js b/src/devops/index.js
index 3b75dd1..5bf2101 100644
--- a/src/devops/index.js
+++ b/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) {
diff --git a/src/graph/app.js b/src/graph/app.js
index 0baa03a..0ba0d22 100644
--- a/src/graph/app.js
+++ b/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