feat: enhance post navigation resource and service with type annotations

Author: thuankg1752

src/Http/Resources/Post/PostNavigateResource.php

@@ -17,9 +17,12 @@ class PostNavigateResource extends JsonResource
      */
     public function toArray($request): array
     {
+        /** @var array{previous: object|null, next: object|null} $resource */
+        $resource = $this->resource;
+
         return [
-            'previous' => $this->resource['previous'] ? new PostNavigationResource($this->resource['previous']) : null,
-            'next' => $this->resource['next'] ? new PostNavigationResource($this->resource['next']) : null,
+            'previous' => $resource['previous'] ? new PostNavigationResource($resource['previous']) : null,
+            'next' => $resource['next'] ? new PostNavigationResource($resource['next']) : null,
         ];
     }
 }

src/Services/PostNavigationService.php

@@ -45,7 +45,7 @@ public function getNextPost(int|string $postId): ?object
      * Get both previous and next posts
      *
      * @param int|string $postId
-     * @return array
+     * @return array{previous: object|null, next: object|null}
      */
     public function getNavigatePosts(int|string $postId): array
     {