Per-Middleware Performance Benchmarks

[A6dulmalik]

Important: All implementation for this issue must be done exclusively in the middleware repository. No modifications should be made to the backend codebase.

#369 ## Description

Measure the latency overhead each middleware adds individually over the baseline. This gives contributors and users a clear cost reference before stacking middleware in production.

---

🛠 Implementation Hints

• Reuse the benchmark server from Implement UpdateUserService and Integrate into UsersService #21; mount each middleware independently per test run
• Run each benchmark for at least 10 seconds with a warmup period of 2 seconds to avoid cold-start noise
• Calculate overhead as (middleware_p99 - baseline_p99) and surface it clearly in output
• Automate across all middleware using a loop over exported middleware from src/index.ts
• Write results into docs/PERFORMANCE.md in a markdown table

---

Deliverables

• benchmarks/middleware/ — one benchmark file per middleware
• Overhead delta reported per middleware
• Results table in docs/PERFORMANCE.md

---

Acceptance Criteria

• Every core middleware (Setup NestJS Backend with PostgreSQL #1–Implement DeleteUserService and Integrate with UsersService #20) has a benchmark file
• Overhead delta clearly shown (e.g. +1.8ms p99)
• Results table committed to docs/PERFORMANCE.md

[drips-wave]

Congratulations, @samuella-code! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on March 30, 2026.

🧑‍💻 @samuella-code: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[gregemax]

@gregemax has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

I’d like to take on this task.

I’ll implement isolated benchmarks for each middleware using the existing benchmark server, ensuring accurate measurement of latency overhead against a baseline. Each middleware will be tested independently with a proper warmup phase to eliminate cold-start noise, and results will be calculated using p99 latency deltas.

I’ll automate the benchmarking process by iterating over all exported middleware from src/index.ts, generate consistent outputs, and document the results in a clear markdown table inside docs/PERFORMANCE.md.

The implementation will stay fully within the middleware repository, be reproducible, and provide meaningful performance insights for contributors

ℹ️ Repo Maintainers: To accept this application, review their application or assign @gregemax to this issue.

[OthmanImam]

@OthmanImam has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

Hi Maintainer,

I’m Usman Adamu, a full-stack developer, and I’d like to contribute to the task. I’ll implement it carefully and efficiently thoroughly understand requirements and edge cases
Communicate promptly about suggestions or improvements. And I will provide regular progress updates and address blockers
Align with project goals through feedback and clarification.

Thank you,

ℹ️ Repo Maintainers: To accept this application, review their application or assign @OthmanImam to this issue.

[drips-wave]

Congratulations, @OthmanImam! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on March 30, 2026.

🧑‍💻 @OthmanImam: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been completed by @OthmanImam as part of the Stellar Wave Program's 3rd Wave 🥳

😎 @OthmanImam: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.