@faststore/api 1.9.7 → 1.9.11

package/src/platforms/vtex/resolvers/offer.ts

@@ -87,7 +87,7 @@ export const StoreOffer: Record<string, Resolver<Root>> = {
   },
   listPrice: (root) => {
     if (isSearchItem(root)) {
-      return root.ListPrice
+      return root.ListPrice ?? 0
     }
 
     if (isOrderFormItem(root)) {

package/src/platforms/vtex/resolvers/searchResult.ts

@@ -1,11 +1,11 @@
+import { enhanceSku } from '../utils/enhanceSku'
 import type { Resolver } from '..'
 import type { SearchArgs } from '../clients/search'
 import type { Facet } from '../clients/search/types/FacetSearchResult'
-import { enhanceSku } from '../utils/enhanceSku'
 
 type Root = Omit<SearchArgs, 'type'>
 
-const REMOVED_FACETS_FROM_COLLECTION_PAGE = ['departamento', 'Departamento']
+const isRootFacet = (facet: Facet) => facet.key === 'category-1'
 
 export const StoreSearchResult: Record<string, Resolver<Root>> = {
   suggestions: async (searchArgs, _, ctx) => {
@@ -90,33 +90,16 @@ export const StoreSearchResult: Record<string, Resolver<Root>> = {
       clients: { search: is },
     } = ctx
 
-    const { facets } = await is.facets(searchArgs)
-
-    const isCollectionPage = !searchArgs.query
-    const filteredFacets = facets?.reduce((acc, currentFacet) => {
-      const shouldFilterFacet = REMOVED_FACETS_FROM_COLLECTION_PAGE.includes(
-        currentFacet.name
-      )
-
-      const shouldRemoveFacetFromCollectionPage =
-        isCollectionPage && shouldFilterFacet
+    ctx.storage.searchArgs = searchArgs
 
-      if (shouldRemoveFacetFromCollectionPage) {
-        return acc
-      }
-
-      currentFacet.values.sort((a, b) => {
-        const firstItemLabel = a.name ?? ''
-        const secondItemLabel = b.name ?? ''
+    const { facets = [] } = await is.facets(searchArgs)
 
-        return firstItemLabel.localeCompare(secondItemLabel)
-      })
-
-      acc.push(currentFacet)
+    const isCollectionPage = !searchArgs.query
 
-      return acc
-    }, [] as Facet[])
+    const filteredFacets = facets
+      // Remove root facet on category pages
+      .filter((facet) => !isCollectionPage || !isRootFacet(facet))
 
-    return filteredFacets ?? []
+    return filteredFacets
   },
 }

package/src/platforms/vtex/utils/facets.ts

@@ -29,11 +29,29 @@ export const transformSelectedFacet = ({ key, value }: SelectedFacet) => {
       return [] // remove this facet from search
     }
 
+    case 'price': {
+      return { key, value: value.replace('-to-', ':') }
+    }
+
     default:
       return { key, value }
   }
 }
 
+export const parseRange = (range: string): [number, number] | null => {
+  const splitted = range.split(':').map(Number)
+
+  if (
+    splitted.length !== 2 ||
+    Number.isNaN(splitted[0]) ||
+    Number.isNaN(splitted[1])
+  ) {
+    return null
+  }
+
+  return splitted as [number, number]
+}
+
 export const findSlug = (facets?: Maybe<SelectedFacet[]>) =>
   facets?.find((x) => x.key === 'slug')?.value ?? null
 

package/src/typeDefs/cart.graphql

@@ -7,7 +7,7 @@ type StoreCartMessage {
   """
   text: String!
   """
-  Shopping cart message status, which can be `INFO`, `WARNING` OR `ERROR`.
+  Shopping cart message status, which can be `INFO`, `WARNING` or `ERROR`.
   """
   status: StoreStatus!
 }

package/src/typeDefs/collection.graphql

@@ -2,9 +2,21 @@
 Product collection type. Possible values are `Department`, `Category`, `Brand` or `Cluster`.
 """
 enum StoreCollectionType {
+  """
+  First level of product categorization.
+  """
   Department
+  """
+  Second level of product categorization.
+  """
   Category
+  """
+  Product brand.
+  """
   Brand
+  """
+  Product cluster.
+  """
   Cluster
 }
 

package/src/typeDefs/facet.graphql

@@ -1,7 +1,9 @@
+union StoreFacet = StoreFacetRange | StoreFacetBoolean
+
 """
-Search facet information.
+Search facet range information.
 """
-type StoreFacet {
+type StoreFacetRange {
   """
   Facet key.
   """
@@ -13,17 +15,37 @@ type StoreFacet {
   """
   Array with information on each facet value.
   """
-  values: [StoreFacetValue!]!
+  min: StoreFacetValueRange!
+  max: StoreFacetValueRange!
+}
+
+"""
+Search facet boolean information.
+"""
+type StoreFacetBoolean {
+  """
+  Facet key.
+  """
+  key: String!
+  """
+  Facet label.
+  """
+  label: String!
   """
-  Facet type. Possible values are `BOOLEAN` and `RANGE`.
+  Array with information on each facet value.
   """
-  type: StoreFacetType!
+  values: [StoreFacetValueBoolean!]!
+}
+
+type StoreFacetValueRange {
+  absolute: Float!
+  selected: Float!
 }
 
 """
 Information of a specific facet value.
 """
-type StoreFacetValue {
+type StoreFacetValueBoolean {
   """
   Facet value.
   """

package/src/typeDefs/mutation.graphql

@@ -1,10 +1,10 @@
 type Mutation {
   """
-  Returns the order if anything has changed in it, or `null` if the order is valid.
+  Checks for changes between the cart presented in the UI and the cart stored in the ecommerce platform. If changes are detected, it returns the cart stored on the platform. Otherwise, it returns `null`.
   """
   validateCart(cart: IStoreCart!): StoreCart
   """
-  Validate session information.
+  Updates a web session with the specified values.
   """
   validateSession(session: IStoreSession!, search: String!): StoreSession
 }

package/src/typeDefs/order.graphql

@@ -13,7 +13,7 @@ type StoreOrder {
 }
 
 """
-Offer input.
+Order input.
 """
 input IStoreOrder {
   """

package/src/typeDefs/pageInfo.graphql

@@ -1,21 +1,21 @@
 """
-Page information.
+Whenever you make a query that allows for pagination, such as `allProducts` or `allCollections`, you can check `StorePageInfo` to learn more about the complete set of items and use it to paginate your queries.
 """
 type StorePageInfo {
   """
-  Indicates whether next page exists.
+  Indicates whether there is at least one more page with items after the ones returned in the current query.
   """
   hasNextPage: Boolean!
   """
-  Indicates whether previous page exists.
+  Indicates whether there is at least one more page with items before the ones returned in the current query.
   """
   hasPreviousPage: Boolean!
   """
-  Page cursor start.
+  Cursor corresponding to the first possible item.
   """
   startCursor: String!
   """
-  Page cursor end.
+  Cursor corresponding to the last possible item.
   """
   endCursor: String!
   """

package/src/typeDefs/query.graphql

@@ -1,78 +1,108 @@
 """
-Product pagination edge.
+Each product edge contains a `node`, with product information, and a `cursor`, that can be used as a reference for pagination.
 """
 type StoreProductEdge {
   """
-  Product pagination node.
+  Each product node contains the information of a product returned by the query.
   """
   node: StoreProduct!
   """
-  Product pagination cursor.
+  Product cursor. Used as pagination reference.
   """
   cursor: String!
 }
 
 """
-Product connection pagination information.
+Product connections, including pagination information and products returned by the query.
 """
 type StoreProductConnection {
   """
-  Product connection page information.
+  Product pagination information.
   """
   pageInfo: StorePageInfo!
   """
-  Array with product connection page edges.
+  Array with product connection edges, each containing a product and a corresponding cursor.
   """
   edges: [StoreProductEdge!]!
 }
 
 """
-Collection pagination edge.
+Each collection edge contains a `node`, with product collection information, and a `cursor`, that can be used as a reference for pagination.
 """
 type StoreCollectionEdge {
   """
-  Collection pagination node.
+  Each collection node contains the information of a product collection returned by the query.
   """
   node: StoreCollection!
   """
-  Collection pagination cursor.
+  Collection cursor. Used as pagination reference.
   """
   cursor: String!
 }
 
 """
-Collection connection pagination information.
+Collection connections, including pagination information and collections returned by the query.
 """
 type StoreCollectionConnection {
   """
-  Collection connection page information.
+  Collection pagination information.
   """
   pageInfo: StorePageInfo!
   """
-  Array with collection connection page edges.
+  Array with collection connection page edges, each containing a collection and a corresponding cursor..
   """
   edges: [StoreCollectionEdge!]!
 }
 
 """
-Product sorting options used in search.
+Product search results sorting options.
 """
 enum StoreSort {
+  """
+  Sort by price, from highest to lowest.
+  """
   price_desc
+  """
+  Sort by price, from lowest to highest.
+  """
   price_asc
+  """
+  Sort by orders, from highest to lowest.
+  """
   orders_desc
+  """
+  Sort by name, in reverse alphabetical order.
+  """
   name_desc
+  """
+  Sort by name, in alphabetical order.
+  """
   name_asc
+  """
+  Sort by release date, from  highest to lowest.
+  """
   release_desc
+  """
+  Sort by discount value, from highest to lowest.
+  """
   discount_desc
+  """
+  Sort by product score, from highest to lowest.
+  """
   score_desc
 }
 
 """
-Selected facet input.
+Selected search facet input.
 """
 input IStoreSelectedFacet {
+  """
+  Selected search facet key.
+  """
   key: String!
+  """
+  Selected search facet value.
+  """
   value: String!
 }
 
@@ -80,7 +110,13 @@ input IStoreSelectedFacet {
 Search facet type.
 """
 enum StoreFacetType {
+  """
+  Indicates boolean search facet.
+  """
   BOOLEAN
+  """
+  Indicates range type search facet.
+  """
   RANGE
 }
 
@@ -132,17 +168,17 @@ type StoreSearchResult {
 
 type Query {
   """
-  Product query.
+  Returns the details of a product based on the specified locator.
   """
   product(
     """
-    Product query locator, which receives an array of selected search facets.
+    An array of selected search facets.
     """
     locator: [IStoreSelectedFacet!]!
   ): StoreProduct!
 
   """
-  Collection query.
+  Returns the details of a collection based on the collection slug.
   """
   collection(
     """
@@ -152,7 +188,7 @@ type Query {
   ): StoreCollection!
 
   """
-  Search query.
+  Returns the result of a product, facet, or suggestion search.
   """
   search(
     """
@@ -160,7 +196,7 @@ type Query {
     """
     first: Int!
     """
-    Search pagination argument, indicating the item after which the results should be fetched.
+    Search pagination argument, indicating the cursor corresponding with the item after which the results should be fetched.
     """
     after: String
     """
@@ -178,7 +214,7 @@ type Query {
   ): StoreSearchResult!
 
   """
-  All products query.
+  Returns information about all products.
   """
   allProducts(
     """
@@ -186,13 +222,13 @@ type Query {
     """
     first: Int!,
     """
-    Product pagination argument, indicating the item after which the items should be fetched.
+    Product pagination argument, indicating the cursor corresponding with the item after which the items should be fetched.
     """
     after: String
   ): StoreProductConnection!
 
   """
-  All collections query.
+  Returns information about all collections.
   """
   allCollections(
     """
@@ -200,7 +236,7 @@ type Query {
     """
     first: Int!,
     """
-    Collection pagination argument, indicating the item after which the items should be fetched.
+    Collection pagination argument, indicating the cursor corresponding with the item after which the items should be fetched.
     """
     after: String
   ): StoreCollectionConnection!

package/src/typeDefs/session.graphql

@@ -3,22 +3,22 @@ Currency information.
 """
 type StoreCurrency {
   """
-  Currency code, e.g: USD
+  Currency code (e.g: USD).
   """
   code: String!
   """
-  Currency symbol, e.g: $
+  Currency symbol (e.g: $).
   """
   symbol: String!
 }
 
 input IStoreCurrency {
   """
-  Currency code, e.g: USD
+  Currency code (e.g: USD).
   """
   code: String!
   """
-  Currency symbol, e.g: $
+  Currency symbol (e.g: $).
   """
   symbol: String!
 }

package/src/typeDefs/status.graphql

@@ -1,5 +1,5 @@
 """
-Status used to indicate type of message. For instance, in shopping cart messages.
+Status used to indicate a message type. For instance, a shopping cart informative or error message.
 """
 enum StoreStatus {
   INFO

package/dist/platforms/vtex/resolvers/facetValue.d.ts

@@ -1,5 +0,0 @@
-import type { Resolver } from '..';
-import type { FacetValue } from '../clients/search/types/FacetSearchResult';
-declare type Root = FacetValue;
-export declare const StoreFacetValue: Record<string, Resolver<Root>>;
-export {};

package/src/platforms/vtex/resolvers/facetValue.ts

@@ -1,12 +0,0 @@
-import type { Resolver } from '..'
-import type { FacetValue } from '../clients/search/types/FacetSearchResult'
-
-type Root = FacetValue
-
-export const StoreFacetValue: Record<string, Resolver<Root>> = {
-  value: ({ value, range }) =>
-    value ?? `${range?.from ?? ''}-to-${range?.to ?? ''}`,
-  label: ({ name }) => name || 'unknown',
-  selected: ({ selected }) => selected,
-  quantity: ({ quantity }) => quantity,
-}