feature/add-count-function

[cedricve]

Description

Motivation

The database abstraction was missing a first‑class way to count documents, forcing callers to either overuse Find/FindOne or reach into database‑specific APIs. This made common use cases (pagination, existence checks, metrics) more awkward and less testable.

Why this improves the project

• Completes the database interface by adding a Count operation that matches real application needs.
• Keeps the abstraction consistent: both the MongoDB implementation and the mock now support counting in the same way as other operations.
• Greatly improves testability with full mock support (queued responses, custom behavior, call tracking, and reset coverage).
• Enables cleaner, more expressive application code by avoiding workarounds for simple count queries.
• Minor CI/config cleanup ensures workflows remain up to date and configurable.

Overall, this makes the database layer more complete, easier to test, and more aligned with how it’s actually used.

[codecov]

Codecov Report

❌ Patch coverage is 76.47059% with 8 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
pkg/database/mongodb.go	0.00%	7 Missing ⚠️
pkg/database/mock.go	96.29%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!