test : added unit tests for shared utils, cookie consent, modules map, step runner, and practice data

.env.example

@@ -0,0 +1,63 @@
+NEXT_PUBLIC_USE_SPRING_BOOT_API=true
+# Local Spring Boot (for testing changes locally):
+NEXT_PUBLIC_SPRING_BOOT_API_URL=http://localhost:8080
+
+# ──────────── Email (Nodemailer) ────────────
+EMAIL_USER=your-email@gmail.com
+EMAIL_PASSWORD=your-google-app-password
+REVIEW_INBOX_EMAIL=optional-inbox@gmail.com
+
+# Gemini AI — required for the chatbot feature
+# Get a free API key at https://aistudio.google.com/apikey
+GEMINI_API_KEY=gemini-api-key-here
+
+# ──────────── Supabase ────────────
+NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your-supabase-anon-key
+SUPABASE_SERVICE_KEY=your-supabase-service-key
+SUPABASE_JWT_SECRET=your-supabase-jwt-secret
+
+# ──────────── Cloudflare Turnstile Captcha ────────────
+NEXT_PUBLIC_TURNSTILE_SITE_KEY=1x00000000000000000000AA
+TURNSTILE_SECRET_KEY=your-turnstile-secret-key
+TURNSTILE_CONFIGURED=false
+TURNSTILE_BYPASS=true
+
+# ──────────── Google Analytics ────────────
+NEXT_PUBLIC_GA_ID=G-XXXXXXXXXX
+
+# ──────────── AI Chatbot & Complexity Analyzer ────────────
+GEMINI_API_KEY=your-gemini-api-key
+
+# ──────────── Rate Limiting (Upstash Redis) ────────────
+UPSTASH_REDIS_REST_URL=your-upstash-redis-rest-url
+UPSTASH_REDIS_REST_TOKEN=your-upstash-redis-rest-token
+RATE_LIMIT_MAX=10
+
+# ──────────── UI Flags ────────────
+NEXT_PUBLIC_SHOW_COMMUNITY_BADGE=true
+AUTO_CONFIRM_EMAIL=true
+
+# ──────────── Arena Socket Server & Java Backend Distributed Cache ────────────
+# Redis URL for the arena socket server (used for matchmaking queue and session state)
+# Note: Use "rediss://" prefix if SSL is required (e.g. for Upstash)
+REDIS_URL=redis://localhost:6379
+
+# Redis connection parameters for the Java backend's distributed cache
+# REDIS_HOST=localhost
+# REDIS_PORT=6379
+# REDIS_PASSWORD=
+# REDIS_SSL=false
+
+# URL of the arena socket server for match pair verification from the Java backend
+# SOCKET_SERVER_URL=http://localhost:4000
+
+# Debug endpoint configuration (arena-socket-server)
+# Set DEBUG_ENABLED=true only in non-production environments
+# DEBUG_ENABLED=true
+# DEBUG_KEY=your-secure-debug-key
+
+# ──────────── CSRF Security ────────────
+# Generate a secure random string (e.g., run `openssl rand -hex 32` in your terminal).
+CSRF_SECRET=your-csrf-secret-key
+

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,66 @@
+name: 🐞 Bug Report
+description: Report a bug or unexpected behavior to help us improve AlgoBuddy
+title: "[BUG] <Brief description of the bug>"
+labels: ["bug", "triage"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for taking the time to report a bug! Please fill out the form below to help us understand and resolve the issue as quickly as possible.
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: Tell us what went wrong...
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Please provide step-by-step instructions to reproduce the bug.
+      value: |
+        1. Go to '...'
+        2. Click on '...'
+        3. Scroll down to '...'
+        4. See error
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: A clear and concise description of what you expected to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: A clear and concise description of what actually happened.
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: Please provide information about your environment (OS, Browser version, Node.js version, etc.)
+      placeholder: e.g. Windows 11, Chrome 124, Node 20.x
+    validations:
+      required: true
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots or Logs
+      description: If applicable, add screenshots, video recordings, or error logs to help explain your problem.
+    validations:
+      required: false
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      options:
+        - label: I agree to follow this project's Code of Conduct
+          required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,45 @@
+name: ✨ Feature Request
+description: Suggest an idea or feature for AlgoBuddy
+title: "[FEATURE] <Brief description of the feature>"
+labels: ["enhancement", "triage"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for suggesting an idea to make AlgoBuddy better! Please fill out the form below to help us understand your feature request.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Is your feature request related to a problem? Please describe.
+      description: A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Describe the solution you'd like
+      description: A clear and concise description of what you want to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Describe alternatives you've considered
+      description: A clear and concise description of any alternative solutions or features you've considered.
+    validations:
+      required: false
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional context
+      description: Add any other context or screenshots about the feature request here.
+    validations:
+      required: false
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Code of Conduct
+      options:
+        - label: I agree to follow this project's Code of Conduct
+          required: true

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,40 @@
+## Summary
+
+A brief description of the changes in this Pull Request. Explain **what** was changed and **why**.
+
+## Type of Change
+
+Please check the relevant options:
+- [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
+- [ ] ✨ New feature (non-breaking change which adds functionality)
+- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] 📝 Documentation update (changes to README, contributing guidelines, etc.)
+- [ ] 🎨 Style/Refactor (code style formatting, restructuring without changing behavior)
+
+## Related Issues
+
+Closes #[Issue Number]
+
+## Changes Made
+
+- [Detail 1]
+- [Detail 2]
+
+## How to Verify
+
+Please describe how reviewers can test your changes. 
+- [ ] Test Step 1
+- [ ] Test Step 2
+
+## Screenshots (if applicable)
+
+*Before / After (or just a demo of the new feature)*
+
+## Checklist
+
+- [ ] My code follows the project style guidelines
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have updated the documentation accordingly
+- [ ] My changes generate no new warnings or errors
+- [ ] I have verified that these changes work correctly on multiple screen sizes (if UI-related)

.github/labeler.yml

@@ -0,0 +1,17 @@
+gssoc:approved:
+  - ".*"
+
+mentor:PankajSingh34:
+  - ".*"
+
+level:beginner:
+  - ".*beginner.*"
+
+type:bug:
+  - ".*bug.*"
+
+type:feature:
+  - ".*feature.*"
+
+type:docs:
+  - ".*docs.*"

.github/workflows/ai-issue-labeler.yml

@@ -0,0 +1,25 @@
+name: Smart Issue Labeler
+
+on:
+  issues:
+    types: [opened, edited]
+
+permissions:
+  issues: write
+  contents: read
+
+jobs:
+  label-issues:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repo        # ← ADD THIS
+        uses: actions/checkout@v4
+
+      - name: Label issues
+        uses: github/issue-labeler@v3.4
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          configuration-path: .github/labeler.yml
+          enable-versioned-regex: 0
+          include-title: 1

.github/workflows/auto-approve-on-status.yml

@@ -0,0 +1,96 @@
+name: Conditional Auto Approve
+
+on:
+  # जब भी किसी पीआर पर चेक्स (Status/Check Suite) पूरे हों
+  check_suite:
+    types: [completed]
+  status:
+
+jobs:
+  check-and-approve:
+    runs-on: ubuntu-latest
+    if: github.repository == 'PankajSingh34/AlgoBuddy'
+    steps:
+      - name: Check Statuses and Approve
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const { owner, repo } = context.repo;
+
+            // 1. इस इवेंट से जुड़े Pull Requests की लिस्ट निकालें
+            let pullRequests = [];
+            if (context.eventName === 'check_suite') {
+              pullRequests = context.payload.check_suite.pull_requests;
+            } else {
+              // status इवेंट के लिए SHA के ज़रिए PR ढूंढें
+              const sha = context.payload.sha;
+              const prs = await github.rest.pulls.list({ owner, repo, state: 'open' });
+              pullRequests = prs.data.filter(pr => pr.head.sha === sha);
+            }
+
+            if (pullRequests.length === 0) {
+              console.log("No open pull request found for this event.");
+              return;
+            }
+
+            const prNumber = pullRequests[0].number;
+            const prRef = pullRequests[0].head.sha;
+
+            // 2. इस Commit SHA के सारे कंबाइंड चेक्स/स्टेटस गेट करें
+            const statuses = await github.rest.repos.getCombinedStatusForRef({
+              owner,
+              repo,
+              ref: prRef,
+            });
+
+            const checkRuns = await github.rest.checks.listForRef({
+              owner,
+              repo,
+              ref: prRef,
+            });
+
+            // 3. फ़िल्टर लॉजिक: वर्सेल (Vercel) को छोड़कर बाकी चेक्स की जांच
+            let allOthersPassed = true;
+            let evaluatedChecksCount = 0;
+
+            // स्टेटस चेक करें (पुराने गिटहब स्टेटस के लिए)
+            for (const status of statuses.data.statuses) {
+              if (status.context.toLowerCase().includes('vercel')) {
+                continue; // Vercel को छोड़ दो
+              }
+              evaluatedChecksCount++;
+              if (status.state !== 'success') {
+                allOthersPassed = false;
+              }
+            }
+
+            // चेक रन्स देखें (GitHub Actions आदि के लिए)
+            for (const run of checkRuns.data.check_runs) {
+              if (run.name.toLowerCase().includes('vercel') || run.app?.slug?.toLowerCase().includes('vercel')) {
+                continue; // Vercel को छोड़ दो
+              }
+              // अगर कोई चेक अभी चल रहा है या पास नहीं हुआ है
+              if (run.status !== 'completed') {
+                allOthersPassed = false;
+              } else if (run.conclusion !== 'success' && run.conclusion !== 'neutral') {
+                allOthersPassed = false;
+              }
+              evaluatedChecksCount++;
+            }
+
+            console.log(`Evaluated ${evaluatedChecksCount} non-Vercel checks. Status: ${allOthersPassed}`);
+
+            // 4. अगर वर्सेल के अलावा बाकी सारे चेक्स पास हैं, तो APPROVE कर दो
+            if (allOthersPassed && evaluatedChecksCount > 0) {
+              await github.rest.pulls.createReview({
+                owner,
+                repo,
+                pull_number: prNumber,
+                event: 'APPROVE',
+                body: 'code looks good',
+              });
+              console.log(`PR #${prNumber} has been automatically approved with 'code looks good'!`);
+            } else {
+              console.log("Some non-Vercel checks are either pending or failed. Skipping auto-approval.");
+            }