Add a GET /api/admin/deprecations route listing all registered deprecated routes and their sunset dates

[Jagadeeshftw]

📌 Description

src/config/deprecations.ts defines a machine-readable routeDeprecations array but there is no admin endpoint that exposes it at runtime. Operators performing a deployment must read source code to find which routes are deprecated and when they sunset. A GET /api/admin/deprecations route (protected by adminAuth) should return the routeDeprecations array wrapped in the standard success envelope, enabling automated tooling to alert when a sunset date is approaching.

💡 Why it matters: An operator-accessible deprecation registry enables SRE dashboards to fire alerts N days before sunset, preventing surprise production breakage.

🧩 Requirements and context

• Add route GET /api/admin/deprecations to src/routes/admin.ts behind adminAuthMiddleware
• Return successResponse(res, routeDeprecations) with computed daysUntilSunset per entry
• Document in src/openapi/spec.ts with a typed response schema including route, sunsetDate, link, daysUntilSunset
• Add tests in tests/routes/admin.deprecations.test.ts
• Assert unauthenticated requests receive 401

Non-functional requirements

• Must be secure, tested, and documented.
• Should be efficient and easy to review.

🛠️ Suggested execution

1. Fork the repo and create a branch

git checkout -b feat/admin-deprecations-endpoint

2. Implement changes

• Write/modify the relevant source: src/routes/admin.ts, src/config/deprecations.ts
• Write comprehensive tests: tests/routes/admin.deprecations.test.ts
• Add documentation: OpenAPI schema for the deprecations list response
• Include TSDoc on the new route handler
• Validate security assumptions: response must not expose internal file paths or source locations

3. Test and commit

• Run tests:

npm test -- --testPathPattern=admin.deprecations

• Cover edge cases: empty deprecations list returns empty array, past-sunset entry has daysUntilSunset < 0
• Include test output and security notes in the PR description.

Example commit message

feat(admin): add GET /api/admin/deprecations listing registered deprecated routes with sunset dates

✅ Acceptance criteria

• GET /api/admin/deprecations returns 200 with deprecations list including daysUntilSunset
• Unauthenticated requests return 401
• Past-sunset entries have negative daysUntilSunset
• Endpoint documented in src/openapi/spec.ts
• CI passes with no type errors

🔒 Security notes

The response must not include internal file paths, source map references, or middleware stack details. Only the route path and sunset date should be exposed.

📋 Guidelines

• Minimum 95% test coverage
• Clear documentation
• Timeframe: 96 hours

[greatest0fallt1me]

Hello Maintainers 👋,
I’m interested in picking up this issue and contributing to the project.
I have solid experience working across both frontend and blockchain layers, including building user interfaces with Next.js and developing Stellar smart contracts using Rust (Soroban). I’m familiar with translating Figma designs into pixel-accurate UIs, handling wallet integrations, and writing efficient, well-tested contract logic.
I focus on writing clean, maintainable code, following repository standards, and keeping communication transparent throughout the development process. I can start immediately and complete the work within the expected timeframe.
Excited to collaborate and add value to the project 🚀
Thank you!

[grantfox-oss]

🦊 GrantFox — @greatest0fallt1me has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #581)
2. Your PR will be reviewed by the Fluxora-Org maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign campaign!

@greatest0fallt1me's PR #600 was approved and merged by @Jagadeeshftw.

🏆 @greatest0fallt1me: You earned 40 FoxPoints for this contribution! Your current tier: Builder (1,428 total points). Track your full progress on GrantFox.

👏 Great work, @greatest0fallt1me! Keep contributing to Fluxora-Org.