NotValra · cornusandu · Mar 12, 2026 · Mar 12, 2026 · Mar 12, 2026 · Mar 13, 2026
diff --git a/src/background/background.js b/src/background/background.js
@@ -1,4 +1,5 @@
 import { SETTINGS_CONFIG } from '../content/core/settings/settingConfig.js';
+import { log, logLevel} from '../content/core/logging.js';
 
 // --- Constants & State ---
 
@@ -66,9 +67,9 @@ function initializeSettings(reason) {
         if (needsUpdate) {
             chrome.storage.local.set(settingsToUpdate, () => {
                 if (chrome.runtime.lastError) {
-                    console.error('RoValra: Failed to sync settings.', chrome.runtime.lastError);
+                    log(logLevel.ERROR, 'RoValra: Failed to sync settings.', chrome.runtime.lastError);
                 } else {
-                    console.log(`RoValra: Synced/Fixed ${Object.keys(settingsToUpdate).length} settings (Trigger: ${reason}).`);
+                    log(logLevel.DEBUG, `RoValra: Synced/Fixed ${Object.keys(settingsToUpdate).length} settings (Trigger: ${reason}).`);
                 }
             });
         }
@@ -205,7 +206,7 @@ async function getUniverseIdFromPlaceId(placeId) {
         }
         return null;
     } catch (e) {
-        console.error('RoValra: Error fetching universe ID from place ID', e);
+        log(logLevel.ERROR, 'RoValra: Error fetching universe ID from place ID', e);
         return null;
     }
 }
@@ -265,7 +266,7 @@ async function wearOutfit(outfitData) {
     try {
         const outfitId = (typeof outfitData === 'object' && outfitData !== null) ? outfitData.itemId : outfitData;
         if (!outfitId) {
-            console.error('RoValra: wearOutfit called with invalid outfitData', outfitData);
+            log(logLevel.ERROR, 'RoValra: wearOutfit called with invalid outfitData', outfitData);
             return { ok: false };
         }
 
@@ -288,7 +289,7 @@ async function wearOutfit(outfitData) {
         const results = await Promise.all(promises);
         return { ok: results.every(r => r && r.ok) };
     } catch (e) {
-        console.error('RoValra: Error wearing outfit', e);
+        log(logLevel.ERROR, 'RoValra: Error wearing outfit', e);
         return { ok: false };
     }
 }

diff --git a/src/content/core/api.js b/src/content/core/api.js
@@ -3,6 +3,7 @@
 import { getCsrfToken } from './utils.js';
 import { getAuthenticatedUserId } from './user.js';
 import { getValidAccessToken } from './oauth/oauth.js';
+import { log, logLevel } from './logging.js';
 
 import { updateUserLocationIfChanged } from './utils/location.js';
 const activeRequests = new Map();
@@ -244,7 +245,7 @@ export async function callRobloxApi(options) {
                                 let storedVerification = allVerifications[authedUserId];
 
                                 if (storedVerification) {
-                                    console.log("RoValra API: New token received from header. Updating storage.");
+                                    log(logLevel.DEBUG, "RoValra API: New token received from header. Updating storage.");
                                     storedVerification.accessToken = newAccessToken;
                                     storedVerification.timestamp = Date.now();
 
@@ -260,13 +261,13 @@ export async function callRobloxApi(options) {
                                 }
                             }
                         } catch (e) {
-                            console.error("RoValra API: Failed to update new access token.", e);
+                            log(logLevel.ERROR, "RoValra API: Failed to update new access token.", e);
                         }
                     }
 
 
                     if (lastResponse.status === 401 && endpoint && endpoint.includes('/v1/auth') && !skipAutoAuth && !authRetried) {
-                        console.log("RoValra API: 401 Unauthorized, attempting token refresh...");
+                        log(logLevel.ERROR, "RoValra API: 401 Unauthorized, attempting token refresh...");
                         authRetried = true;
                         const newToken = await getValidAccessToken(true);
                         if (newToken) {
@@ -282,7 +283,7 @@ export async function callRobloxApi(options) {
                     if (endpoint && endpoint.includes('/v1/auth')) break;
                 } catch (error) {
                     if (attempt === 3 || (endpoint && endpoint.includes('/v1/auth'))) {
-                        console.error(`RoValra API: Request to ${fullUrl} failed${attempt === 3 ? ' after multiple retries' : ''}.`, error);
+                        log(logLevel.ERROR, `RoValra API: Request to ${fullUrl} failed${attempt === 3 ? ' after multiple retries' : ''}.`, error);
                         throw error;
                     }
                 }
@@ -291,7 +292,7 @@ export async function callRobloxApi(options) {
                 }
             }
             if (!lastResponse.ok) {
-                console.error(`RoValra API: Request to ${fullUrl} failed with status ${lastResponse.status} after multiple retries.`);
+                log(logLevel.ERROR, `RoValra API: Request to ${fullUrl} failed with status ${lastResponse.status} after multiple retries.`);
             }
             return lastResponse;
         }
@@ -330,7 +331,7 @@ export async function callRobloxApi(options) {
         }
 
         if (!response.ok) {
-            console.error(`RoValra API: Request to ${fullUrl} failed with status ${response.status}.`);
+            log(logLevel.ERROR, `RoValra API: Request to ${fullUrl} failed with status ${response.status}.`);
         }
 
         return response;

diff --git a/src/content/core/configs/userIds.js b/src/content/core/configs/userIds.js
@@ -10,7 +10,8 @@ export const CONTRIBUTOR_USER_IDS = [
     '546872490', //Kanibal02
     '48255812', //aliceenight
     '7982684834', //qborder
-    '126448532' //steinann
+    '126448532', //steinann
+    '1564574922', // cornusandu
 ];
 
 export const RAT_BADGE_USER_ID = '477516666'; // rat

diff --git a/src/content/core/games/servers/serverstats.js b/src/content/core/games/servers/serverstats.js
@@ -4,6 +4,7 @@ import { callRobloxApi } from '../../api.js';
 import { addTooltip } from '../../ui/tooltip.js';
 import DOMPurify from 'dompurify';
 import { observeElement, startObserving } from '../../observer.js';
+import { log, logLevel } from '../../logging.js';
 
 
 let versionDataCache = null;
@@ -40,7 +41,7 @@ async function fetchLatestPlaceVersion(placeId) {
 
         return null;
     } catch (error) {
-        console.error('RoValra Server Stats: Failed to fetch latest place version from Roblox.', error);
+        log(logLevel.ERROR, 'RoValra Server Stats: Failed to fetch latest place version from Roblox.', error);
         return null;
     }
 }
@@ -78,7 +79,7 @@ export async function fetchServerStats(placeId) {
 
         return data.counts;
     } catch (error) {
-        console.error('RoValra Server Stats: Failed to fetch server statistics.', error);
+        log(logLevel.ERROR, 'RoValra Server Stats: Failed to fetch server statistics.', error);
         return null;
     }
 }
@@ -129,7 +130,7 @@ async function createStatsBarUI(serverListContainer) {
             });
         });
     } catch (error) {
-        console.error('RoValra Server Stats: Failed to fetch settings.', error);
+        log(logLevel.ERROR, 'RoValra Server Stats: Failed to fetch settings.', error);
         return;
     }
 
@@ -238,7 +239,7 @@ export async function initGlobalStatsBar() {
             }
         }
     } catch (error) {
-        console.error('RoValra Server Stats: Failed to initialize stats bar.', error);
+        log(logLevel.ERROR, 'RoValra Server Stats: Failed to initialize stats bar.', error);
     }
 }
 

diff --git a/src/content/core/logging.js b/src/content/core/logging.js
@@ -0,0 +1,85 @@
+export const logLevel = Object.freeze({
+    DEBUG: 0,
+    INFO: 1,
+    WARNING: 2,
+    ERROR: 3,
+    CRITICAL: 4
+});
+
+const logLevelStr = {
+    [logLevel.DEBUG]: 'DEBUG',
+    [logLevel.INFO]: 'INFO',
+    [logLevel.WARNING]: 'WARNING',
+    [logLevel.ERROR]: 'ERROR',
+    [logLevel.CRITICAL]: 'CRITICAL'
+};
+
+const maxLogLevelLength = 8;
+
+// Minimum Log Level
+const minLogLevel = logLevel.DEBUG;
+
+// Whether to call alert() on logLevel.CRITICAL
+const criticalAsAlert = true;
+
+// Logging functions
+const logfn = {
+    [logLevel.DEBUG]:   () => console.debug,
+    [logLevel.INFO]:    () => console.info,
+    [logLevel.WARNING]: () => console.warn,
+    [logLevel.ERROR]:   () => console.error,
+    [logLevel.CRITICAL]:() => (criticalAsAlert ? formatAndAlert : console.error)
+};
+
+
+function format(msg, ...args) {
+    let i = 0;
+
+    const str = String(msg).replace(/%[sdihf%]/g, token => {
+        if (token === "%%") return "%";
+        const arg = args[i++];
+
+        switch (token) {
+            case "%s": return String(arg);
+            case "%d":
+            case "%i": return Number.parseInt(arg, 10);
+            case "%h": return "0x" + Number.parseInt(arg, 10).toString(16);
+            case "%f": return Number.parseFloat(arg);
+            default:
+                return token;
+        }
+    });
+
+    if (i < args.length) {
+        return str + " " + args.slice(i).join(" ");  // concatenate remaining arguments to the formatted string (if any; seperated by spaces)
+    }
+
+    return str;
+}
+
+function formatAndAlert(msg, ...args) {
+    const formatted = format(msg, ...args);
+    log(logLevel.ERROR, msg, ...args);  // for debugging purposes
+    alert(formatted);
+}
+
+function timestamp() {
+    const now = new Date();
+    return `${String(now.getHours()).padStart(2,'0')}:` +
+           `${String(now.getMinutes()).padStart(2,'0')}:` +
+           `${String(now.getSeconds()).padStart(2,'0')}.` +
+           `${String(now.getMilliseconds()).padStart(3,'0')}`;
+}
+
+function padLevel(msg) {
+    return msg.padEnd(maxLogLevelLength);
+}
+
+export function log(level, message, ...args) {
+    if (level < minLogLevel) {
+        return;
+    }
+
+    const msg = `${timestamp()}  [${padLevel(logLevelStr[level])}]    ${message}`;
+    logfn[level]()(msg, ...args);
+}
diff --git a/src/content/core/oauth/oauth.js b/src/content/core/oauth/oauth.js
@@ -1,28 +1,27 @@
-// TODO Remove console logs
-
 const STORAGE_KEY = "rovalra_oauth_verification";
 const TOKEN_EXPIRATION_BUFFER_MS = 5 * 60 * 1000; 
 import { callRobloxApi } from '../api.js';
 import { getAuthenticatedUserId } from '../user.js';
+import { log, logLevel } from '../logging.js';
 
 const existenceCache = new Map();
 const prefixCache = new Map();
 let activeOAuthPromise = null;
 
 export async function init() {
     try {
-        console.log("RoValra: Script loaded. Syncing session...");
+        log(logLevel.DEBUG, "RoValra: Script loaded. Syncing session...");
 
 
         const token = await getValidAccessToken(true);
 
         if (token) {
-            console.log("RoValra: Session synchronized successfully.");
+            log(logLevel.INFO, "RoValra: Session synchronized successfully.");
         } else {
-            console.log("RoValra: No active session or re-auth required.");
+            log(logLevel.INFO, "RoValra: No active session or re-auth required.");
         }
     } catch (error) {
-        console.error("RoValra: Error during script initialization", error);
+        log(logLevel.ERROR, "RoValra: Error during script initialization", error);
     }
 }
 export async function getValidAccessToken(forceRefresh = false) {
@@ -82,7 +81,7 @@ export async function getValidAccessToken(forceRefresh = false) {
         return updatedStorage[STORAGE_KEY]?.[userId]?.accessToken || storedVerification.accessToken;
 
     } catch (error) {
-        console.error("RoValra: Network error during token sync:", error);
+        log(logLevel.ERROR, "RoValra: Network error during token sync:", error);
         return storedVerification.accessToken; 
     }
 }
@@ -130,7 +129,7 @@ async function checkUserExistence(userId) {
             return exists;
         }
     } catch (error) {
-        console.error("RoValra: Error checking user existence", error);
+        log(logLevel.ERROR, "RoValra: Error checking user existence", error);
     }
     return false;
 }
@@ -167,7 +166,7 @@ async function startOAuthFlow(silent = false) {
                 }
 
                 if (age < 13) {
-                    console.log("RoValra: User is under 13. Skipping OAuth.");
+                    log(logLevel.WARNING, "RoValra: User is under 13. Skipping OAuth.");
                     return false;
                 }
             }
@@ -181,7 +180,7 @@ async function startOAuthFlow(silent = false) {
         }
 
         try {
-            console.log("RoValra: Attempting direct OAuth authorization POST request...");
+            log(logLevel.DEBUG, "RoValra: Attempting direct OAuth authorization POST request...");
 
             const response = await callRobloxApi({
                 subdomain: 'apis', 
@@ -207,11 +206,11 @@ async function startOAuthFlow(silent = false) {
                 const locationUrl = authResponse.location;
 
                 if (!locationUrl) {
-                    console.error("RoValra: OAuth authorization response did not contain a location URL.", authResponse);
+                    log(logLevel.ERROR, "RoValra: OAuth authorization response did not contain a location URL.", authResponse);
                     return false;
                 }
 
-                console.log("RoValra: Got authorization code. Fetching token from callback URL...");
+                log(logLevel.INFO, "RoValra: Got authorization code. Fetching token from callback URL...");
 
                 const tokenResponse = await callRobloxApi({
                     fullUrl: locationUrl,
@@ -220,14 +219,14 @@ async function startOAuthFlow(silent = false) {
                 });
 
                 if (!tokenResponse.ok) {
-                    console.error("RoValra: Failed to get token from callback URL.", await tokenResponse.text());
+                    log(logLevel.ERROR, "RoValra: Failed to get token from callback URL.", await tokenResponse.text());
                     return false;
                 }
 
                 const tokenData = await tokenResponse.json();
 
                 if (tokenData.status === 'success' && tokenData.access_token && tokenData.user_id && tokenData.username) {
-                    console.log("RoValra: OAuth Successful!", tokenData);
+                    log(logLevel.INFO, "RoValra: OAuth Successful!", tokenData);
 
                     const expiresAt = tokenData.expires_at ? tokenData.expires_at * 1000 : null;
 
@@ -246,16 +245,16 @@ async function startOAuthFlow(silent = false) {
                     await chrome.storage.local.set({ [STORAGE_KEY]: allVerifications });
                     return true;
                 } else {
-                    console.error("RoValra: Invalid token data received from backend.", tokenData);
+                    log(logLevel.ERROR, "RoValra: Invalid token data received from backend.", tokenData);
                     return false;
                 }
             } else {
-                console.error("RoValra: OAuth authorization POST request failed with status " + response.status, await response.text());
+                log(logLevel.ERROR, "RoValra: OAuth authorization POST request failed with status " + response.status, await response.text());
                 return false;
             }
 
         } catch (error) {
-            console.error("RoValra: Error during direct OAuth authorization request.", error);
+            log(logLevel.ERROR, "RoValra: Error during direct OAuth authorization request.", error);
             return false;
         }
     })();

diff --git a/src/content/core/regionFinder/ClosestServer.js b/src/content/core/regionFinder/ClosestServer.js
@@ -4,6 +4,7 @@ import { launchGame } from '../utils/launcher.js';
 import { showReviewPopup } from '../review/review.js';
 import { hideLoadingOverlay } from '../ui/startModal/gamelaunchmodal.js';
 import { getStateCodeFromRegion } from '../regions.js';
+import { log, logLevel } from '../logging.js';
 
 export let REGIONS = {};
 export let serverIpMap = {};
@@ -293,9 +294,9 @@ async function getRankedRegions(placeId, preferredRegionId) {
     }
 
     if (FINDER_CONFIG.logScores) {
-        console.log(`[RoValra] Region Scores for Place ${placeId}:`);
+        log(logLevel.DEBUG, `[RoValra] Region Scores for Place ${placeId}:`);
         ranked.forEach(r => {
-            console.log(` - ${getRegionName(r.region.id)}: Score ${r.score} (${Math.round(r.distance)} km)`);
+            log(logLevel.DEBUG, ` - ${getRegionName(r.region.id)}: Score ${r.score} (${Math.round(r.distance)} km)`);
         });
     }