From cd8a0490c4648a1161afb105cbaa076a045bec9e Mon Sep 17 00:00:00 2001
From: Rafi Arrafif <rafiarrafif05@gmail.com>
Date: Mon, 8 Sep 2025 22:53:10 +0700
Subject: [PATCH] :bulb: (docs-code) add code documentation

---
 src/modules/auth/services/http/githubCallback.service.ts | 7 +++++++
 src/modules/auth/services/http/googleCallback.service.ts | 2 ++
 2 files changed, 9 insertions(+)

diff --git a/src/modules/auth/services/http/githubCallback.service.ts b/src/modules/auth/services/http/githubCallback.service.ts
index 2b4a41f..cb17987 100644
--- a/src/modules/auth/services/http/githubCallback.service.ts
+++ b/src/modules/auth/services/http/githubCallback.service.ts
@@ -9,9 +9,14 @@ export const githubCallbackService = async (
   userHeaderInfo: UserHeaderInformation
 ) => {
   try {
+    // Initialize GitHub provider
     const github = githubProvider(query.callbackURI);
+
+    // Validate the authorization code and get tokens
     const tokens = await github.validateAuthorizationCode(query.code);
     const accessToken = tokens.accessToken();
+
+    // Fetch user data and email from GitHub API
     const userdata = await fetch("https://api.github.com/user", {
       headers: {
         Authorization: `Bearer ${accessToken}`,
@@ -23,11 +28,13 @@ export const githubCallbackService = async (
       },
     });
 
+    // Parse the user data and email responses into JSON, then combine them into a single payload
     const userPayload: GithubCallbackUserData = {
       user_data: await userdata.json(),
       user_email: await useremail.json(),
     };
 
+    // Provision or authenticate the user in the system
     return await OAuthUserProvisionService(
       {
         provider: "github",
diff --git a/src/modules/auth/services/http/googleCallback.service.ts b/src/modules/auth/services/http/googleCallback.service.ts
index 5b3ef35..d018568 100644
--- a/src/modules/auth/services/http/googleCallback.service.ts
+++ b/src/modules/auth/services/http/googleCallback.service.ts
@@ -43,8 +43,10 @@ export const googleCallbackService = async (
       }
     );
 
+    // parse the user data response
     const userData = (await response.json()) as GoogleCallbackUserData;
 
+    // Provision or authenticate the user in the system
     return await OAuthUserProvisionService(
       {
         provider: "google",