From 7ec46aa8f9eeffd71b745ff3a378f68d44cb2df2 Mon Sep 17 00:00:00 2001
From: yisroel <tech@bhbsdventures.com>
Date: Wed, 6 May 2026 15:24:15 +0300
Subject: [PATCH] implement ListRecentPosts use case

validates limit > 0 (zero or negative -> BadRequest), then
delegates to PostRepository->findRecent. 49 tests pass.
---
 .../ListRecentPosts/ListRecentPosts.php       | 28 +++++++++++++++++++
 .../ListRecentPostsRequest.php                | 10 +++++++
 2 files changed, 38 insertions(+)
 create mode 100644 backend/app/Post/UseCases/ListRecentPosts/ListRecentPosts.php
 create mode 100644 backend/app/Post/UseCases/ListRecentPosts/ListRecentPostsRequest.php

diff --git a/backend/app/Post/UseCases/ListRecentPosts/ListRecentPosts.php b/backend/app/Post/UseCases/ListRecentPosts/ListRecentPosts.php
new file mode 100644
index 0000000..f559d27
--- /dev/null
+++ b/backend/app/Post/UseCases/ListRecentPosts/ListRecentPosts.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Post\UseCases\ListRecentPosts;
+
+use App\Exceptions\BadRequestException;
+use App\Post\Post;
+use App\Post\PostRepository;
+
+class ListRecentPosts
+{
+    public function __construct(
+        private PostRepository $postRepo,
+    ) {}
+
+    /**
+     * @return Post[]
+     *
+     * @throws BadRequestException
+     */
+    public function execute(ListRecentPostsRequest $request): array
+    {
+        if ($request->limit <= 0) {
+            throw new BadRequestException('limit must be positive');
+        }
+
+        return $this->postRepo->findRecent($request->limit);
+    }
+}
diff --git a/backend/app/Post/UseCases/ListRecentPosts/ListRecentPostsRequest.php b/backend/app/Post/UseCases/ListRecentPosts/ListRecentPostsRequest.php
new file mode 100644
index 0000000..10089e6
--- /dev/null
+++ b/backend/app/Post/UseCases/ListRecentPosts/ListRecentPostsRequest.php
@@ -0,0 +1,10 @@
+<?php
+
+namespace App\Post\UseCases\ListRecentPosts;
+
+class ListRecentPostsRequest
+{
+    public function __construct(
+        public int $limit,
+    ) {}
+}