feat: implement GitHub platform auto-discovery from GitHub API

[udaycodespace]

Summary

Implements GitHub Platform Auto-Discovery (#32).

This PR adds a new authenticated endpoint, GET /api/connect/github/autodiscover, which uses the user's connected GitHub account to discover platform links from their GitHub profile. The endpoint returns suggestions only and does not create any links automatically.

To reduce unnecessary GitHub API requests, discovery results are cached in Redis for one hour. The implementation also handles missing, expired, or revoked GitHub tokens gracefully.

Closes #32

---

Type of Change

• Bug fix
• New feature
• Refactor (no functional change)
• UI / Design change
• Tests only
• Documentation
• Infrastructure / DevOps
• Security

---

What Changed

• Added GET /api/connect/github/autodiscover.
• Reused the existing github_follow OAuth token flow to fetch GitHub profile data.
• Added platform suggestion mapping from GitHub profile metadata.
• Added Redis caching with a 1-hour TTL.
• Added tests covering successful discovery, caching, token failures, Redis failures, and URL-based platform inference.

---

How to Test

1. Connect a GitHub account using the existing GitHub connect flow.
2. Send an authenticated request to GET /api/connect/github/autodiscover.
3. Verify that platform suggestions are returned without creating any platform links.
4. Repeat the request and verify the cached response is returned.
5. Verify that revoked or invalid GitHub tokens return an appropriate error response.

---

Checklist

• My code follows the project's coding style (pnpm -r run lint passes).
• TypeScript compiles without errors (pnpm -r run typecheck).
• I have added or updated tests for the changes I made.
• All tests pass locally.
• I have updated documentation where necessary.
• No new console.log or debug statements left in the code.
• Breaking changes are documented in this PR description.

---

Additional Context

Discovery Mapping

• twitter_username → twitter (high confidence)
• dev.to URLs → devto (low confidence)
• hashnode URLs → hashnode (low confidence)
• npmjs URLs → npm (low confidence)
• Other blog URLs → portfolio (high confidence)

Caching

• Redis key: github:autodiscover:{userId}
• TTL: 3600 seconds

Tests Added

• Successful discovery response
• Cache hit behavior
• GitHub 401 handling
• Missing GitHub connection
• Redis failure fallback
• Blog URL platform inference

[vercel]

@udaycodespace is attempting to deploy a commit to the Prashantkumar Khatri's projects Team on Vercel.

A member of the Team first needs to authorize it.

[github-actions]

CI — All Checks Passed

Backend — PASS

Check	Result
Lint	PASS
Test	PASS
Typecheck	PASS

Mobile — SKIP

Check	Result
Lint	-
Test	-

Web — SKIP

Check	Result
Check	-
Build	-

---

Last updated: Fri, 12 Jun 2026 07:39:46 GMT

[udaycodespace]

Validated locally after the latest changes.

cd apps/backend
pnpm exec vitest run src/__tests__/connect.test.ts

Result: 12/12 tests passing.

The tests cover:

• Successful discovery response
• Redis cache hit behavior
• GitHub API 401 / revoked token handling
• Missing GitHub connection
• Redis failure fallback
• Platform inference from GitHub profile URLs

Attached screenshot of the local test run.

[udaycodespace]

@Harxhit Fixed and pushed.

1. I've restored the reply parameter in the route handler as requested.
2. Please take another look.

[udaycodespace]

Hi @Harxhit,

I noticed the backend CI is failing with:

'reply' is defined but never used. Allowed unused args must match /^_/u

The failure points to the line that was restored during the review:

async (request: FastifyRequest, reply: FastifyReply) => {

Would it be okay if I update it to:

async (request: FastifyRequest, _reply: FastifyReply) => {

This would keep the parameter in the handler signature while satisfying the lint rule.

[udaycodespace]

Hi @Harxhit,

Just following up on this PR. The requested change has been pushed and the review comment addressed. Could you please take another look when you get a chance?

Thanks!

[udaycodespace]

Hi @Harxhit,

The unused reply lint issue has been fixed in commit 2a46693, and the backend CI is now passing (lint, test, and typecheck).

Could you please take another look when you get a chance?

Thanks!

[Harxhit]

LGTM. Approving

[Harxhit]

Could you please address this?

[github-actions]

Congratulations @udaycodespace on getting PR #506 merged!

Thank you for your contribution to the project.

To receive the appropriate GSSoC labels and recognition, please mention @Harxhit in the #get-labels channel on our Discord server and share your merged PR link.