feat: reviews query resolver (#2649)

## What's the purpose of this pull request?

To add reviews query resolver on graphQL

## How it works?

It defines a few new types and adds a new query resolver called:
`reviews` wich retrieves an array of reviews for a specific product.

For input we have:
- productId (`required`)
- after and first for pagination, (both are `optional`)
- sort (`optional`)
- rating (`optional`)(for filtering)

## How to test it?

run the api graphql server locally with the following command:
```bash
yarn dev:server
```
and make a query call

## References

[JIRA TASK: SFS-2094](https://vtex-dev.atlassian.net/browse/SFS-2094)


![image](https://github.com/user-attachments/assets/d07547af-329e-4dbe-8b83-75694ec18fbc)

![image](https://github.com/user-attachments/assets/f9bcef6d-359e-464e-893a-74f1ffc06464)

## Checklist

<em>You may erase this after checking them all 😉</em>

**PR Description**

- [ ] Adds graphQL `Reviews` types
- [ ] Creates a new query resolver for `Reviews`

Author: Guilera

packages/api/src/__generated__/schema.ts

@@ -26,12 +26,14 @@ export enum ProductReviewsInputOrderBy {
   locale = 'Locale',
 }
 
+export type ProductReviewsInputOrderWay = 'asc' | 'desc'
+
 export interface ProductReviewsInput {
   searchTerm?: string
   from?: number
   to?: number
   orderBy?: ProductReviewsInputOrderBy
-  orderWay?: 'asc' | 'desc'
+  orderWay?: ProductReviewsInputOrderWay
   status?: boolean
   productId?: string
   rating?: number

packages/api/src/platforms/vtex/clients/commerce/types/ProductReview.ts

@@ -21,11 +21,16 @@ import type {
   QuerySellersArgs,
   QueryShippingArgs,
   QueryRedirectArgs,
+  QueryReviewsArgs,
 } from '../../../__generated__/schema'
 import type { CategoryTree } from '../clients/commerce/types/CategoryTree'
 import type { Context } from '../index'
 import { isValidSkuId, pickBestSku } from '../utils/sku'
 import type { SearchArgs } from '../clients/search'
+import {
+  ProductReviewsInputOrderBy,
+  type ProductReviewsInputOrderWay,
+} from '../clients/commerce/types/ProductReview'
 
 export const Query = {
   product: async (_: unknown, { locator }: QueryProductArgs, ctx: Context) => {
@@ -335,4 +340,31 @@ export const Query = {
       sellers,
     }
   },
+  reviews: async (
+    _: unknown,
+    { productId, after, first, rating, sort }: QueryReviewsArgs,
+    ctx: Context
+  ) => {
+    const {
+      clients: { commerce },
+    } = ctx
+
+    const from = after ?? 0
+    const to = from + (first ?? 6)
+
+    const [orderByKey, orderWay] = sort?.split('_') as [
+      keyof typeof ProductReviewsInputOrderBy,
+      ProductReviewsInputOrderWay,
+    ]
+
+    return await commerce.reviews.list({
+      productId,
+      from,
+      to,
+      orderBy: ProductReviewsInputOrderBy[orderByKey],
+      orderWay,
+      status: true,
+      rating: rating ?? undefined,
+    })
+  },
 }

packages/api/src/platforms/vtex/resolvers/query.ts

@@ -0,0 +1,84 @@
+type StoreProductReview {
+  """
+  Review ID.
+  """
+  id: String!
+  """
+  Product ID.
+  """
+  productId: String!
+  """
+  Review rating.
+  """
+  rating: Int!
+  """
+  Review title.
+  """
+  title: String!
+  """
+  Review content.
+  """
+  text: String!
+  """
+  Review author name.
+  """
+  reviewerName: String
+  """
+  Review author ID.
+  """
+  shopperId: String!
+  """
+  Review creation date.
+  """
+  reviewDateTime: String!
+  """
+  Indicates if the review was made by a verified purchaser.
+  """
+  verifiedPurchaser: Boolean!
+  """
+  Indicates if the review was approved by the store owner.
+  """
+  approved: Boolean!
+}
+
+type StoreProductListReviewsRange {
+  """
+  Total number of reviews.
+  """
+  total: Int!
+  """
+  Index of the first review
+  """
+  from: Int!
+  """
+  Index of the last review
+  """
+  to: Int!
+}
+
+type StoreProductListReviewsResult {
+  """
+  Array of product reviews.
+  """
+  data: [StoreProductReview!]!
+  range: StoreProductListReviewsRange!
+}
+
+enum StoreProductListReviewsSort {
+  """
+  Sort by review creation date, from newest to oldest.
+  """
+  reviewDateTime_desc
+  """
+  Sort by review creation date, from oldest to newest.
+  """
+  reviewDateTime_asc
+  """
+  Sort by review rating, from highest to lowest.
+  """
+  rating_desc
+  """
+  Sort by review rating, from lowest to highest.
+  """
+  rating_asc
+}

packages/api/src/typeDefs/productReview.graphql

@@ -338,6 +338,33 @@ type Query {
     salesChannel: String
   ): SellersData
     @cacheControl(scope: "public", sMaxAge: 120, staleWhileRevalidate: 3600)
+
+  """
+  Returns a list of approved reviews for a specific product.
+  """
+  reviews(
+    """
+    Product Id
+    """
+    productId: String!
+    """
+    Reviews results sorting mode
+    """
+    sort: StoreProductListReviewsSort = reviewDateTime_desc
+    """
+    Reviews pagination argument, indicating how many items should be returned from the complete result list.
+    """
+    first: Int = 6
+    """
+    Reviews pagination argument, indicating the cursor corresponding with the item after which the items should be fetched.
+    """
+    after: Int = 0
+    """
+    Rating filter
+    """
+    rating: Int
+  ): StoreProductListReviewsResult
+    @cacheControl(scope: "public", sMaxAge: 120, staleWhileRevalidate: 3600)
 }
 
 """

packages/api/src/typeDefs/query.graphql

@@ -67,6 +67,7 @@ const QUERIES = [
   'shipping',
   'redirect',
   'sellers',
+  'reviews',
 ]
 
 const MUTATIONS = ['validateCart', 'validateSession', 'subscribeToNewsletter']

packages/api/test/schema.test.ts

@@ -71,6 +71,7 @@ const QUERIES = [
   'shipping',
   'redirect',
   'sellers',
+  'reviews',
 ]
 
 const MUTATIONS = ['validateCart', 'validateSession', 'subscribeToNewsletter']