#2970:autodoc-generate

.eslintrc.json

@@ -1,4 +1,4 @@
 {
   "env": {
     "browser": true,
     "node": true,
@@ -152,6 +152,7 @@
     "docs/docusaurus.config.ts",
     "docs/sidebars.ts",
     "docs/src/**",
-    "docs/blog/**"
+    "docs/blog/**",
+    "docs/docs/**"
   ]
 }

.github/workflows/pull-request.yml

@@ -1,4 +1,4 @@
 ##############################################################################
 ##############################################################################
 #
 # NOTE!
@@ -449,3 +449,139 @@
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           PR_NUMBER: ${{ github.event.pull_request.number }}
           GITHUB_REPOSITORY: ${{ github.repository }}
+
+  Merge-Conflict-Check:
+    name: Check for Merge Conflicts
+    runs-on: ubuntu-latest
+    if: github.actor != 'dependabot[bot]'
+    needs: [Code-Quality-Checks]
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Check Mergeable Status via API
+        run: |  
+          PR_NUMBER=${{ github.event.pull_request.number }}
+          max_retries=3
+          retry_delay=5
+
+          for ((i=1; i<=max_retries; i++)); do
+            echo "Attempt $i of $max_retries"
+
+            response=$(curl -s -f -H "Authorization: Bearer ${{ secrets.GITHUB_TOKEN }}" \
+              "https://api.github.com/repos/${{ github.repository }}/pulls/$PR_NUMBER")
+
+            if [ $? -ne 0 ]; then
+              echo "Failed to call GitHub API"
+              if [ $i -eq $max_retries ]; then
+                exit 1
+              fi
+              sleep $retry_delay
+              continue
+            fi
+
+            mergeable=$(echo "$response" | jq -r '.mergeable')
+            if [ "$mergeable" == "true" ]; then
+              echo "No conflicts detected."
+              exit 0
+            elif [ "$mergeable" == "false" ]; then
+              echo "Merge conflicts detected."
+              exit 1
+            else
+              echo "Mergeable status unknown."
+              if [ $i -eq $max_retries ]; then
+                exit 1
+              fi
+              sleep $retry_delay
+            fi
+          done
+
+  generate-docs:
+    name: Generate Auto Documentation
+    runs-on: ubuntu-latest
+    needs: [Code-Quality-Checks, Test-Application, Start-App-Without-Docker, Docker-Start-Check]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Required for getting full git history
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22.x'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: |
+          npm ci
+          npm install -g typedoc typedoc-plugin-markdown
+
+      - name: Create documentation directory
+        run: |
+          mkdir -p docs/docs/auto-docs
+          mkdir -p docs/docs/user-guide
+          mkdir -p docs/docs/developer-guide/reference
+
+      - name: Generate Documentation
+        run: |
+          # Generate the documentation
+          typedoc \
+            --out docs/docs/auto-docs \
+            --plugin typedoc-plugin-markdown \
+            --theme markdown \
+            --tsconfig tsconfig.json \
+            --excludePrivate \
+            --excludeProtected \
+            --excludeExternals \
+            --hideGenerator \
+            --categorizeByGroup true \
+            --entryPointStrategy expand \
+            --entryPoints "src/**/*.ts" "src/**/*.tsx" \
+            --exclude "**/*.{test,spec,stories}.{ts,tsx}" \
+            --exclude "**/__tests__/**" \
+            --exclude "**/__mocks__/**" \
+            --exclude "**/node_modules/**" \
+            --cleanOutputDir true
+
+      - name: Create placeholder documentation
+        run: |
+          # Create User Guide placeholder
+          echo "# User Guide
+
+          This section contains the user guide for Talawa Admin.
+          " > docs/docs/user-guide/intro.md
+
+          # Create Developer Guide placeholder
+          echo "# Developer Guide
+
+          This section contains the developer guide for Talawa Admin.
+          " > docs/docs/developer-guide/intro.md
+
+          # Create Reference placeholder
+          echo "# API Reference
+
+          This section contains the auto-generated API documentation for Talawa Admin.
+          " > docs/docs/developer-guide/reference/README.md
+
+      - name: Setup Git Config
+        run: |
+          git config user.name "GitHub Actions Bot"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+      - name: Check and Commit Documentation
+        run: |
+          # Check if there are any changes
+          if [[ -n "$(git status --porcelain)" ]]; then
+            # Add all changes
+            git add docs/docs/auto-docs
+            git add docs/docs/user-guide
+            git add docs/docs/developer-guide
+
+            # Commit changes
+            git commit -m "docs: update auto-generated documentation [skip ci]"
+
+            # Push changes
+            git push
+          else
+            echo "No changes to commit"
+          fi

src/components/CheckIn/TableRow.tsx

@@ -72,13 +72,12 @@
       }
       inputs.push({ name: data.name.trim() });
       const pdf = await generate({ template: tagTemplate, inputs });
-      // istanbul ignore next
-      const blob = new Blob([pdf.buffer], { type: 'application/pdf' });
-      // istanbul ignore next
+
+      // Convert ArrayBuffer to Uint8Array before creating Blob
+      const uint8Array = new Uint8Array(pdf.buffer);
+      const blob = new Blob([uint8Array], { type: 'application/pdf' });
       const url = URL.createObjectURL(blob);
-      // istanbul ignore next
       window.open(url);
-      // istanbul ignore next
       toast.success('PDF generated successfully!');
     } catch (error: unknown) {
       const errorMessage =