feat(api): add monthly summary badge mode with view=monthly

[JhaSourav07]

🧩 Background

Current badge focuses on contribution grid + streak style output. Some users want a compact monthly summary view for clean READMEs.

🎯 Objective

Add a new badge mode that displays current month contribution totals and month-over-month delta.

💡 Example usage

/api/streak?user=octocat&view=monthly

📁 Files to check

• app/api/streak/route.ts
• lib/svg/generator.ts
• types/index.ts
• README.md
• lib/svg/generator.test.ts

🛠️ Implementation steps

• Parse optional view query param in route.
• Support values:
  • default (existing behavior)
  • monthly (new)
• In monthly mode:
  • compute current month total from contribution days.
  • compute previous month total.
  • show delta (+12%, -8%, etc.) or absolute diff if preferred.
• Render compact SVG layout for monthly mode (smaller and text-focused).
• Keep theme/color parameters compatible with both views.
• Add tests for mode routing + snapshot tests for monthly SVG.
• Add docs section with examples.

✅ Definition of done

• view=monthly renders a valid SVG summary.
• Existing default mode remains unchanged.
• Tests + README examples are added.

[harshgohel22]

i would like to work on this issue, please assign it to me under GGSoC

[JhaSourav07]

/assign @harshgohel22

[github-actions]

❌ @harshgohel22 already has an active assigned issue.
Please complete or unassign the current issue first.

📋 Active issue: #161 — feat(i18n): add language support for badge labels via lang query param

[flameKaiserX]

Please assign this issue to me

[Krithika1627]

Hi, I’d like to work on this issue.

My approach would be to first review the current streak badge generation flow, including how contribution data is processed and how SVG layouts are currently rendered. Then I’ll add support for the optional view query parameter and implement the new monthly mode while preserving the existing default behavior.

For the monthly view, I’ll calculate current and previous month contribution totals, generate a compact SVG summary layout with delta information, and ensure existing theme/color options remain compatible. I’ll also add tests for routing and SVG rendering behavior along with updated README examples/documentation for the new mode.

[flameKaiserX]

/claim

[github-actions]

✅ Successfully assigned issue to @dynamic-user054

💡 Please read CONTRIBUTING.md if you haven't already. Good luck! 🚀