@faststore/api 1.9.6 → 1.9.9

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

@@ -1,10 +1,10 @@
 import type { Resolver } from '..'
 
-type Root = { title?: string; description?: string }
+type Root = { title?: string; description?: string; canonical?: string }
 
 export const StoreSeo: Record<string, Resolver<Root>> = {
   title: ({ title }) => title ?? '',
   description: ({ description }) => description ?? '',
+  canonical: ({ canonical }) => canonical ?? '',
   titleTemplate: () => '',
-  canonical: () => '',
 }

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

@@ -96,16 +96,16 @@ const equals = (storeOrder: IStoreOrder, orderForm: OrderForm) => {
   return isSameOrder && orderItemsAreSync
 }
 
-const orderFormToCart = (
+const orderFormToCart = async (
   form: OrderForm,
   skuLoader: Context['loaders']['skuLoader']
 ) => {
   return {
     order: {
       orderNumber: form.orderFormId,
-      acceptedOffer: form.items.map((item) => ({
+      acceptedOffer: form.items.map(async (item) => ({
         ...item,
-        product: skuLoader.load([{ key: 'id', value: item.id }]), // TODO: add channel
+        product: await skuLoader.load(item.id), // TODO: add channel
       })),
     },
     messages: form.messages.map(({ text, status }) => ({

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

@@ -0,0 +1,3 @@
+import type { Product } from '../clients/search/types/ProductSearchResult'
+
+export const canonicalFromProduct = ({ linkText }: Product) => `/${linkText}/p`

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

@@ -34,6 +34,12 @@ export const transformSelectedFacet = ({ key, value }: SelectedFacet) => {
   }
 }
 
+export const findSlug = (facets?: Maybe<SelectedFacet[]>) =>
+  facets?.find((x) => x.key === 'slug')?.value ?? null
+
+export const findSkuId = (facets?: Maybe<SelectedFacet[]>) =>
+  facets?.find((x) => x.key === 'id')?.value ?? null
+
 export const findLocale = (facets?: Maybe<SelectedFacet[]>) =>
   facets?.find((x) => x.key === 'locale')?.value ?? null
 

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

@@ -0,0 +1,16 @@
+/**
+ * More info at: https://en.wikipedia.org/wiki/Order_statistic
+ */
+
+// O(n) search to find the max of an array
+export const min = <T>(array: T[], cmp: (a: T, b: T) => number) => {
+  let best = 0
+
+  for (let curr = 1; curr < array.length; curr++) {
+    if (cmp(array[best], array[curr]) > 0) {
+      best = curr
+    }
+  }
+
+  return array[best]
+}

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

@@ -0,0 +1,26 @@
+import { min } from './orderStatistics'
+import { bestOfferFirst } from './productStock'
+import type { Item } from '../clients/search/types/ProductSearchResult'
+
+/**
+ * This function implements Portal heuristics for returning the best sku for a product.
+ *
+ * The best sku is the one with the best (cheapest available) offer
+ * */
+export const pickBestSku = (skus: Item[]) => {
+  const offersBySku = skus.flatMap((sku) =>
+    sku.sellers.map((seller) => ({
+      offer: seller.commertialOffer,
+      sku,
+    }))
+  )
+
+  const best = min(offersBySku, ({ offer: o1 }, { offer: o2 }) =>
+    bestOfferFirst(o1, o2)
+  )
+
+  return best.sku
+}
+
+export const isValidSkuId = (skuId: string) =>
+  skuId !== '' && !Number.isNaN(Number(skuId))

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/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