refactor(app): Merge pull request #65 from dev as a stable checkpoint

Dev

Author: MarioRaafat

.github/reviewer-map.json

@@ -0,0 +1,8 @@
+{
+  "MarioRaafat": ["AmiraKhalid04", "MoBahgat010"],
+  "MoBahgat010": ["Alyaa242", "MarioRaafat"],
+  "shady-2004": ["AmiraKhalid04", "MarioRaafat"],
+  "Alyaa242": ["shady-2004", "MarioRaafat"],
+  "AmiraKhalid04": ["MoBahgat010", "MarioRaafat"],
+  "default": ["MarioRaafat"]
+}

.github/workflows/auto-assign-reviewers.yml

@@ -0,0 +1,54 @@
+name: Auto Assign Reviewers
+
+on:
+    pull_request:
+        types: [opened, reopened, ready_for_review]
+
+permissions:
+    pull-requests: write
+    contents: read
+
+jobs:
+    assign_reviewers:
+        runs-on: ubuntu-latest
+        if: github.event.pull_request.draft == false
+
+        steps:
+            - name: checkout repo
+              uses: actions/checkout@v4
+
+            - name: Load reviewers map
+              id: reviewers
+              run: |
+                echo "map=$(cat .github/reviewer-map.json | jq -c .)" >> $GITHUB_OUTPUT
+
+            - name: Assign reviewers based on PR author
+              uses: actions/github-script@v7
+              with:
+                github-token: ${{ secrets.GITHUB_TOKEN }}
+                script: |
+                    const author = context.payload.pull_request.user.login;
+                    const map = JSON.parse(process.env.MAP);
+
+                    let reviewers = map[author];
+                    if (!reviewers) {
+                        core.info(`⚠️ No reviewers defined for ${author}, Default assignment will be applied`)
+                        reviewers = map["default"];
+                    }
+
+                    if (!reviewers || reviewers.length === 0) {
+                        core.warning(`❌ No default reviewers found in map. Skipping assignment.`);
+                        return;
+                    }
+
+                    core.info(`Assigning reviewers: ${reviewers.join(', ')} for PR by ${author}`);
+
+                    await github.rest.pulls.requestReviewers({
+                        owner: context.repo.owner,
+                        repo: context.repo.repo,
+                        pull_number: context.payload.pull_request.number,
+                        reviewers
+                    });
+              env:
+                  MAP: ${{ steps.reviewers.outputs.map }}
+

.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [ main, dev ]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  checks:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      # skip for now, until fixing all lintings, unit tests
+
+      # - name: Run ESLint
+      #   run: npm run lint
+
+      - name: Check Prettier format
+        run: npx prettier --write "src/**/*.ts"
+
+      # - name: Run unit tests
+      #   run: npm run test:cov
+
+      - name: Upload coverage to PR
+        uses: romeovs/lcov-reporter-action@v0.3.1
+        with:
+          lcov-file: ./coverage/lcov.info
+

.github/workflows/deploy-dev.yml

@@ -0,0 +1,131 @@
+name: Build, Tag & Deploy to Dev
+
+on:
+  push:
+    branches:
+      - dev
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Get latest tag from Docker Hub
+        id: get_tag
+        run: |
+          # Fetch tags from Docker Hub
+          REPO="${{ secrets.DOCKER_USERNAME }}/api-yapper-backend"
+          
+          echo "🔍 Fetching tags from Docker Hub for $REPO..."
+          
+          # Get Docker Hub token for authenticated API access
+          TOKEN=$(curl -s -H "Content-Type: application/json" -X POST \
+            -d '{"username": "${{ secrets.DOCKER_USERNAME }}", "password": "${{ secrets.DOCKER_PASSWORD }}"}' \
+            https://hub.docker.com/v2/users/login/ | jq -r .token)
+          
+          if [ "$TOKEN" = "null" ] || [ -z "$TOKEN" ]; then
+            echo "❌ Failed to authenticate with Docker Hub"
+            exit 1
+          fi
+          
+          # Get all tags from Docker Hub API
+          TAGS=$(curl -s -H "Authorization: JWT ${TOKEN}" \
+                 "https://hub.docker.com/v2/repositories/$REPO/tags/?page_size=100" | \
+                 jq -r '.results[].name' | \
+                 grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | \
+                 sort -V | \
+                 tail -1)
+          
+          # If no tags found, start with v0.0.0
+          if [ -z "$TAGS" ]; then
+            LATEST_TAG="v0.0.0"
+            echo "⚠️ No version tags found on Docker Hub, starting from v0.0.0"
+          else
+            LATEST_TAG="$TAGS"
+            echo "📦 Latest tag found on Docker Hub: $LATEST_TAG"
+          fi
+          
+          echo "latest_tag=$LATEST_TAG" >> $GITHUB_OUTPUT
+          
+          # Parse version components
+          VERSION=${LATEST_TAG#v}
+          IFS='.' read -r MAJOR MINOR PATCH <<< "$VERSION"
+          
+          # Increment patch version
+          PATCH=$((PATCH + 1))
+          NEW_TAG="v${MAJOR}.${MINOR}.${PATCH}"
+          
+          echo "new_tag=$NEW_TAG" >> $GITHUB_OUTPUT
+          echo "🚀 New version: $NEW_TAG"
+
+      - name: Log in to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: ./docker/Dockerfile
+
+          push: true
+          tags: |
+            ${{ secrets.DOCKER_USERNAME }}/api-yapper-backend:${{ steps.get_tag.outputs.new_tag }}
+            ${{ secrets.DOCKER_USERNAME }}/api-yapper-backend:dev
+
+      - name: Confirm image push
+        run: |
+          echo "✅ Image pushed: ${{ secrets.DOCKER_USERNAME }}/api-yapper-backend:${{ steps.get_tag.outputs.new_tag }}"
+          echo "✅ Image tagged: ${{ secrets.DOCKER_USERNAME }}/api-yapper-backend:dev"
+
+      - name: SSH into Dev VM and deploy
+        uses: appleboy/ssh-action@v1.0.0
+        env:
+          IMG_TAG: ${{ steps.get_tag.outputs.new_tag }}
+        with:
+          host: ${{ secrets.DEV_SERVER_HOST }}
+          username: ${{ secrets.DEV_SERVER_USER }}
+          key: ${{ secrets.DEV_SERVER_SSH_KEY }}
+          envs: IMG_TAG
+          script: |
+            set -e
+            cd ~/yapper  # path to your app on VM
+
+            echo "🧭 Getting current running image tag..."
+            CURRENT_TAG=$(IMG_TAG="" docker compose ps -q api | xargs docker inspect -f '{{ index .Config.Labels "com.docker.compose.image" }}' | cut -d':' -f2 || echo "unknown")
+
+            echo "🐳 Setting new image tag for deployment..."
+            echo "Deploying version: $IMG_TAG"
+
+            echo "🔄 Pulling new image and restarting app container..."
+            IMG_TAG=$IMG_TAG docker compose pull api api-local
+            IMG_TAG=$IMG_TAG docker compose up -d api api-local
+
+            echo "⏳ Waiting for health check..."
+            sleep 10
+
+            HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" ${{ secrets.DEV_HEALTHCHECK_URL }})
+            
+            if [ "$HTTP_CODE" = "200" ]; then
+              echo "✅ Dev deployment successful for version $IMG_TAG"
+            else
+              echo "❌ Health check failed (HTTP $HTTP_CODE)! Rolling back app container..."
+              if [ "$CURRENT_TAG" != "unknown" ]; then
+                IMG_TAG=$CURRENT_TAG docker compose up -d api api-local
+                echo "🔙 Rolled back to $CURRENT_TAG"
+              fi
+              exit 1
+            fi
+
+      - name: Deployment summary
+        if: success()
+        run: |
+          echo "🎉 Deployment Complete!"
+          echo "Version: ${{ steps.get_tag.outputs.new_tag }}"
+          echo "Branch: dev"
+          echo "Commit: ${{ github.sha }}"

.gitignore

@@ -56,3 +56,5 @@ pids
 
 # Diagnostic reports (https://nodejs.org/api/report.html)
 report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+dist

.husky/commit-msg

@@ -0,0 +1,9 @@
+msg_file=$1
+msg=$(cat "$msg_file")
+
+# Conventional commits rule
+if ! echo "$msg" | grep -Eq "^(feat|fix|chore|docs|refactor|test|style|perf|ci)\(.+\): .+"; then
+  echo "❌ Invalid commit message format!"
+  echo "👉 Example: feat(auth): add login endpoint"
+  exit 1
+fi

.husky/pre-commit

@@ -0,0 +1,2 @@
+echo "🔍 Running pre-commit checks..."
+npx lint-staged

.husky/pre-push

@@ -0,0 +1,10 @@
+#!/bin/sh
+
+branch_name=$(git symbolic-ref --short HEAD)
+
+echo "$branch_name" | grep -Eq '^(feat|fix|chore|hotfix|docs|ci|test)/[a-z0-9._-]+$'
+if [ $? -ne 0 ]; then
+  echo "❌ Invalid branch name: $branch_name"
+  echo "👉 Branch name must start with feat/, fix/, chore/, docs/, ci/, test/ or hotfix/ (e.g. feat/signup-page)"
+  exit 1
+fi

.prettierrc

@@ -1,4 +1,12 @@
 {
+  "semi": true,
+  "trailingComma": "es5",
   "singleQuote": true,
-  "trailingComma": "all"
-}
+  "printWidth": 100,
+  "tabWidth": 4,
+  "useTabs": false,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "bracketSpacing": true,
+  "bracketSameLine": false
+}