@faststore/api 1.12.48 → 1.12.51

package/dist/index.d.ts

@@ -73,7 +73,7 @@ export declare const getResolvers: (options: Options) => {
         attachmentsValues?: import("./platforms/vtex/clients/commerce/types/OrderForm").Attachment[] | undefined;
     }, unknown, any>>;
     StoreSearchResult: Record<string, import("./platforms/vtex").Resolver<{
-        searchArgs: Pick<import("./platforms/vtex/clients/search").SearchArgs, "sort" | "selectedFacets" | "hideUnavailableItems" | "query" | "page" | "count" | "fuzzy">;
+        searchArgs: Pick<import("./platforms/vtex/clients/search").SearchArgs, "sort" | "selectedFacets" | "hideUnavailableItems" | "query" | "page" | "count" | "fuzzy" | "showInvisibleItems" | "regionId">;
         productSearchPromise: Promise<import("./platforms/vtex/clients/search/types/ProductSearchResult").ProductSearchResult>;
     }, unknown, any>>;
     StorePropertyValue: Record<string, import("./platforms/vtex").Resolver<import("./__generated__/schema").IStorePropertyValue, unknown, any>>;
@@ -93,7 +93,7 @@ export declare const getResolvers: (options: Options) => {
         product: (_: unknown, { locator }: import("./__generated__/schema").QueryProductArgs, ctx: import("./platforms/vtex").Context) => Promise<import("./platforms/vtex/utils/enhanceSku").EnhancedSku>;
         collection: (_: unknown, { slug }: import("./__generated__/schema").QueryCollectionArgs, ctx: import("./platforms/vtex").Context) => Promise<import("./platforms/vtex/clients/commerce/types/Portal").CollectionPageType>;
         search: (_: unknown, { first, after: maybeAfter, sort, term, selectedFacets }: import("./__generated__/schema").QuerySearchArgs, ctx: import("./platforms/vtex").Context) => Promise<{
-            searchArgs: Pick<import("./platforms/vtex/clients/search").SearchArgs, "sort" | "selectedFacets" | "hideUnavailableItems" | "query" | "page" | "count" | "fuzzy">;
+            searchArgs: Pick<import("./platforms/vtex/clients/search").SearchArgs, "sort" | "selectedFacets" | "hideUnavailableItems" | "query" | "page" | "count" | "fuzzy" | "showInvisibleItems" | "regionId">;
             productSearchPromise: Promise<import("./platforms/vtex/clients/search/types/ProductSearchResult").ProductSearchResult>;
         }>;
         allProducts: (_: unknown, { first, after: maybeAfter }: import("./__generated__/schema").QueryAllProductsArgs, ctx: import("./platforms/vtex").Context) => Promise<{

package/dist/platforms/vtex/clients/fetch.d.ts

@@ -1 +1,5 @@
-export declare const fetchAPI: (info: RequestInfo, init?: RequestInit | undefined) => Promise<any>;
+interface FetchAPIOptions {
+    storeCookies?: (headers: Headers) => void;
+}
+export declare const fetchAPI: (info: RequestInfo, init?: RequestInit | undefined, options?: FetchAPIOptions | undefined) => Promise<any>;
+export {};

package/dist/platforms/vtex/clients/index.d.ts

@@ -2,9 +2,9 @@ import type { Context, Options } from '..';
 export declare type Clients = ReturnType<typeof getClients>;
 export declare const getClients: (options: Options, ctx: Context) => {
     search: {
-        facets: (args: Pick<import("./search").SearchArgs, "hideUnavailableItems" | "query" | "page" | "count" | "sort" | "selectedFacets" | "fuzzy">) => Promise<import("./search/types/FacetSearchResult").FacetSearchResult>;
-        products: (args: Pick<import("./search").SearchArgs, "hideUnavailableItems" | "query" | "page" | "count" | "sort" | "selectedFacets" | "fuzzy">) => Promise<import("./search/types/ProductSearchResult").ProductSearchResult>;
-        suggestedTerms: (args: Pick<import("./search").SearchArgs, "hideUnavailableItems" | "query" | "page" | "count" | "sort" | "selectedFacets" | "fuzzy">) => Promise<import("./search/types/ProductSearchResult").Suggestion>;
+        facets: (args: Pick<import("./search").SearchArgs, "hideUnavailableItems" | "query" | "page" | "count" | "sort" | "selectedFacets" | "fuzzy" | "showInvisibleItems" | "regionId">) => Promise<import("./search/types/FacetSearchResult").FacetSearchResult>;
+        products: (args: Pick<import("./search").SearchArgs, "hideUnavailableItems" | "query" | "page" | "count" | "sort" | "selectedFacets" | "fuzzy" | "showInvisibleItems" | "regionId">) => Promise<import("./search/types/ProductSearchResult").ProductSearchResult>;
+        suggestedTerms: (args: Pick<import("./search").SearchArgs, "hideUnavailableItems" | "query" | "page" | "count" | "sort" | "selectedFacets" | "fuzzy" | "showInvisibleItems" | "regionId">) => Promise<import("./search/types/ProductSearchResult").Suggestion>;
         topSearches: () => Promise<import("./search/types/ProductSearchResult").Suggestion>;
     };
     commerce: {

package/dist/platforms/vtex/clients/search/index.d.ts

@@ -12,6 +12,8 @@ export interface SearchArgs {
     selectedFacets?: SelectedFacet[];
     fuzzy?: '0' | '1' | 'auto';
     hideUnavailableItems?: boolean;
+    showInvisibleItems?: boolean;
+    regionId?: string;
 }
 export interface ProductLocator {
     field: 'id' | 'slug';

package/dist/platforms/vtex/index.d.ts

@@ -28,6 +28,11 @@ export interface Context {
         locale: string;
         flags: FeatureFlags;
         searchArgs?: Omit<SearchArgs, 'type'>;
+        /**
+         * Checkout cookies received while resolving this request, keyed by cookie
+         * name. The GraphQL handler forwards `setCookie` values to the browser.
+         */
+        cookies: Map<string, Record<string, string>>;
     };
     headers: Record<string, string>;
 }
@@ -100,7 +105,7 @@ export declare const getResolvers: (_: Options) => {
         attachmentsValues?: import("./clients/commerce/types/OrderForm").Attachment[] | undefined;
     }, unknown, any>>;
     StoreSearchResult: Record<string, Resolver<{
-        searchArgs: Pick<SearchArgs, "hideUnavailableItems" | "query" | "page" | "count" | "sort" | "selectedFacets" | "fuzzy">;
+        searchArgs: Pick<SearchArgs, "hideUnavailableItems" | "query" | "page" | "count" | "sort" | "selectedFacets" | "fuzzy" | "showInvisibleItems" | "regionId">;
         productSearchPromise: Promise<import("./clients/search/types/ProductSearchResult").ProductSearchResult>;
     }, unknown, any>>;
     StorePropertyValue: Record<string, Resolver<import("../..").IStorePropertyValue, unknown, any>>;
@@ -120,7 +125,7 @@ export declare const getResolvers: (_: Options) => {
         product: (_: unknown, { locator }: import("../..").QueryProductArgs, ctx: Context) => Promise<import("./utils/enhanceSku").EnhancedSku>;
         collection: (_: unknown, { slug }: import("../..").QueryCollectionArgs, ctx: Context) => Promise<import("./clients/commerce/types/Portal").CollectionPageType>;
         search: (_: unknown, { first, after: maybeAfter, sort, term, selectedFacets }: import("../..").QuerySearchArgs, ctx: Context) => Promise<{
-            searchArgs: Pick<SearchArgs, "hideUnavailableItems" | "query" | "page" | "count" | "sort" | "selectedFacets" | "fuzzy">;
+            searchArgs: Pick<SearchArgs, "hideUnavailableItems" | "query" | "page" | "count" | "sort" | "selectedFacets" | "fuzzy" | "showInvisibleItems" | "regionId">;
             productSearchPromise: Promise<import("./clients/search/types/ProductSearchResult").ProductSearchResult>;
         }>;
         allProducts: (_: unknown, { first, after: maybeAfter }: import("../..").QueryAllProductsArgs, ctx: Context) => Promise<{

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

@@ -6,7 +6,7 @@ export declare const Query: {
     product: (_: unknown, { locator }: QueryProductArgs, ctx: Context) => Promise<import("../utils/enhanceSku").EnhancedSku>;
     collection: (_: unknown, { slug }: QueryCollectionArgs, ctx: Context) => Promise<import("../clients/commerce/types/Portal").CollectionPageType>;
     search: (_: unknown, { first, after: maybeAfter, sort, term, selectedFacets }: QuerySearchArgs, ctx: Context) => Promise<{
-        searchArgs: Pick<SearchArgs, "sort" | "selectedFacets" | "hideUnavailableItems" | "query" | "page" | "count" | "fuzzy">;
+        searchArgs: Pick<SearchArgs, "sort" | "selectedFacets" | "hideUnavailableItems" | "query" | "page" | "count" | "fuzzy" | "showInvisibleItems" | "regionId">;
         productSearchPromise: Promise<import("../clients/search/types/ProductSearchResult").ProductSearchResult>;
     }>;
     allProducts: (_: unknown, { first, after: maybeAfter }: QueryAllProductsArgs, ctx: Context) => Promise<{

package/dist/platforms/vtex/utils/cookies.d.ts

@@ -0,0 +1,52 @@
+import type { Context } from '../index';
+export interface ContextForCookies {
+    headers: Context['headers'];
+    storage: Pick<Context['storage'], 'cookies'>;
+}
+/**
+ * Returns every `set-cookie` value of a fetch response.
+ *
+ * `Headers.getSetCookie()` only exists on Node >= 18.14 (undici). FastStore v1
+ * stores may still run on Node 16, where isomorphic-unfetch falls back to
+ * node-fetch v2, which exposes repeated headers through `raw()` instead.
+ */
+export declare const getSetCookies: (headers: Headers) => string[];
+/**
+ * This function updates the ctx.storage.cookies, that is used in each request.
+ *
+ * ctx.storage.cookies is a Map<string[1], Record<string, string>[2]> where,
+ * [1] cookie key
+ * [2] {
+ *       value: cookie value,
+ *       setCookie: setCookie used in browser response
+ *     }
+ */
+export declare const updatesContextStorageCookies: (ctx: Pick<Context, 'storage'>, setCookieValue: string) => void;
+export declare const setCookie: (ctx: Pick<Context, 'storage'>, headers: Headers) => void;
+export declare const getStoreCookie: (ctx: Pick<Context, 'storage'>) => (headers: Headers) => void;
+/**
+ * This function returns a modified copy of the original cookie header (ctx.headers.cookie from the first request)
+ * with the cookie values that comes in each request (ctx.storage.cookies).
+ * If there is no cookies in storage, the ctx.headers?.cookie is used
+ *
+ * ctx.storage.cookies is a Map<string[1], Record<string, string>[2]> where,
+ * [1] cookie key
+ * [2] {
+ *       value: cookie value,
+ *       setCookie: setCookie used in browser response
+ *     }
+ */
+export declare const getUpdatedCookie: (ctx: ContextForCookies) => string | null;
+export declare const getWithCookie: (ctx: ContextForCookies) => <T extends Record<string, any>>(headers: T) => T | (T & {
+    cookie: string;
+});
+/**
+ * This function updates the cookie value based on its key
+ *
+ * const existingCookies = 'key=value1; key2=; key3=value3';
+ * const storageCookieKey = 'key2';
+ * const storageCookieValue = 'value2'
+ *
+ * updatesCookieValueByKey(existingCookies, storageCookieKey, storageCookieValue) returns 'key=value1; key2=value2; key3=value3';
+ */
+export declare const updatesCookieValueByKey: (existingCookies: string, storageCookieKey: string, storageCookieValue: string) => string;

package/dist/platforms/vtex/utils/facets.d.ts

@@ -32,3 +32,4 @@ export declare const findSlug: (facets?: SelectedFacet[] | null | undefined) =>
 export declare const findSkuId: (facets?: SelectedFacet[] | null | undefined) => string | null;
 export declare const findLocale: (facets?: SelectedFacet[] | null | undefined) => string | null;
 export declare const findChannel: (facets?: SelectedFacet[] | null | undefined) => string | null;
+export declare const findRegionId: (facets?: SelectedFacet[] | null | undefined) => string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faststore/api",
-  "version": "1.12.48",
+  "version": "1.12.51",
   "license": "MIT",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
@@ -53,5 +53,5 @@
     "@envelop/core": "^1 || ^2",
     "graphql": "^15.6.0"
   },
-  "gitHead": "9a273837d3afc05e1ef2c03d8aaee7eb90df1299"
+  "gitHead": "6f9ba2786d82b074125318339deac2ea456fb3d9"
 }

package/src/platforms/vtex/clients/commerce/index.ts

@@ -19,6 +19,7 @@ import type { SalesChannel } from './types/SalesChannel'
 import { MasterDataResponse } from './types/Newsletter'
 import type { Address, AddressInput } from './types/Address'
 import { ShippingDataBody } from './types/ShippingData'
+import { getStoreCookie, getWithCookie } from '../../utils/cookies'
 
 type ValueOf<T> = T extends Record<string, infer K> ? K : never
 
@@ -29,11 +30,43 @@ const BASE_INIT = {
   },
 }
 
+const getHeader = (headers: Context['headers'] | undefined, name: string) => {
+  const value: string | string[] | undefined = (headers as any)?.[name]
+
+  return Array.isArray(value) ? value[0] : value
+}
+
+/**
+ * Host the Checkout API uses as the domain of the cookies it sets. Checkout
+ * only honors it for hosts registered in the account, so a forged value is
+ * ignored there.
+ */
+const getForwardedHost = (headers: Context['headers'] | undefined) => {
+  // Proxies may append values: "client, proxy". Only the first one is the store host.
+  const host =
+    getHeader(headers, 'x-forwarded-host')?.split(',')[0].trim() ||
+    getHeader(headers, 'host') ||
+    ''
+
+  return host.trim().replace(/^www\./, '')
+}
+
 export const VtexCommerce = (
   { account, environment }: Options,
   ctx: Context
 ) => {
   const base = `https://${account}.${environment}.com.br`
+  const storeCookies = getStoreCookie(ctx)
+  const withCookie = getWithCookie(ctx)
+  const forwardedHost = getForwardedHost(ctx.headers)
+
+  // Checkout calls forward the shopper cookies and keep the cookies Checkout
+  // sets (e.g. CheckoutOrderFormOwnership) so they can reach the browser.
+  const checkoutHeaders = () =>
+    withCookie({
+      'content-type': 'application/json',
+      'X-FORWARDED-HOST': forwardedHost,
+    })
 
   return {
     catalog: {
@@ -107,8 +140,10 @@ export const VtexCommerce = (
           `${base}/api/checkout/pub/orderForm/${id}/attachments/shippingData`,
           {
             ...BASE_INIT,
+            headers: checkoutHeaders(),
             body: JSON.stringify(body),
-          }
+          },
+          { storeCookies }
         )
       },
       orderForm: ({
@@ -128,7 +163,11 @@ export const VtexCommerce = (
 
         return fetchAPI(
           `${base}/api/checkout/pub/orderForm/${id}?${params.toString()}`,
-          BASE_INIT
+          {
+            ...BASE_INIT,
+            headers: checkoutHeaders(),
+          },
+          { storeCookies }
         )
       },
       updateOrderFormItems: ({
@@ -153,12 +192,14 @@ export const VtexCommerce = (
           `${base}/api/checkout/pub/orderForm/${id}/items?${params}`,
           {
             ...BASE_INIT,
+            headers: checkoutHeaders(),
             body: JSON.stringify({
               orderItems,
               noSplitItem: !shouldSplitItem,
             }),
             method: 'PATCH',
-          }
+          },
+          { storeCookies }
         )
       },
       setCustomData: ({
@@ -176,9 +217,11 @@ export const VtexCommerce = (
           `${base}/api/checkout/pub/orderForm/${id}/customData/${appId}/${key}`,
           {
             ...BASE_INIT,
+            headers: checkoutHeaders(),
             body: JSON.stringify({ value }),
             method: 'PUT',
-          }
+          },
+          { storeCookies }
         )
       },
       region: async ({

package/src/platforms/vtex/clients/fetch.ts

@@ -3,7 +3,15 @@ import packageJson from '../../../../package.json'
 
 const USER_AGENT = `${packageJson.name}@${packageJson.version}`
 
-export const fetchAPI = async (info: RequestInfo, init?: RequestInit) => {
+interface FetchAPIOptions {
+  storeCookies?: (headers: Headers) => void
+}
+
+export const fetchAPI = async (
+  info: RequestInfo,
+  init?: RequestInit,
+  options?: FetchAPIOptions
+) => {
   const response = await fetch(info, {
     ...init,
     headers: {
@@ -13,6 +21,10 @@ export const fetchAPI = async (info: RequestInfo, init?: RequestInit) => {
   })
 
   if (response.ok) {
+    if (options?.storeCookies) {
+      options.storeCookies(response.headers)
+    }
+
     return response.status !== 204 ? response.json() : undefined
   }
 

package/src/platforms/vtex/clients/search/index.ts

@@ -31,6 +31,8 @@ export interface SearchArgs {
   selectedFacets?: SelectedFacet[]
   fuzzy?: '0' | '1' | 'auto'
   hideUnavailableItems?: boolean
+  showInvisibleItems?: boolean
+  regionId?: string
 }
 
 export interface ProductLocator {
@@ -65,27 +67,28 @@ export const IntelligentSearch = (
     }
   }
 
-  const getRegionFacet = (): IStoreSelectedFacet | null => {
+  const getRegionFacet = (regionIdFromQuery?: string): IStoreSelectedFacet | null => {
     const { regionId } = ctx.storage.channel
+    const facet = regionIdFromQuery ?? regionId
 
-    if (!regionId) {
+    if (!facet) {
       return null
     }
 
     return {
       key: REGION_KEY,
-      value: regionId,
+      value: facet,
     }
   }
 
-  const addDefaultFacets = (facets: SelectedFacet[]) => {
+  const addDefaultFacets = (facets: SelectedFacet[], regionIdFromQuery?: string) => {
     const withDefaltFacets = facets.filter(({ key }) => !CHANNEL_KEYS.has(key))
 
     const policyFacet =
       facets.find(({ key }) => key === POLICY_KEY) ?? getPolicyFacet()
 
     const regionFacet =
-      facets.find(({ key }) => key === REGION_KEY) ?? getRegionFacet()
+      facets.find(({ key }) => key === REGION_KEY) ?? getRegionFacet(regionIdFromQuery)
 
     if (policyFacet !== null) {
       withDefaltFacets.push(policyFacet)
@@ -106,6 +109,8 @@ export const IntelligentSearch = (
     selectedFacets = [],
     type,
     fuzzy = 'auto',
+    showInvisibleItems,
+    regionId,
   }: SearchArgs): Promise<T> => {
     const params = new URLSearchParams({
       page: (page + 1).toString(),
@@ -116,11 +121,15 @@ export const IntelligentSearch = (
       locale: ctx.storage.locale,
     })
 
+    if (showInvisibleItems) {
+      params.append('show-invisible-items', 'true')
+    }
+
     if (hideUnavailableItems !== undefined) {
       params.append('hideUnavailableItems', hideUnavailableItems.toString())
     }
 
-    const pathname = addDefaultFacets(selectedFacets)
+    const pathname = addDefaultFacets(selectedFacets, regionId)
       .map(({ key, value }) => `${key}/${value}`)
       .join('/')
 

package/src/platforms/vtex/index.ts

@@ -56,6 +56,11 @@ export interface Context {
     locale: string
     flags: FeatureFlags
     searchArgs?: Omit<SearchArgs, 'type'>
+    /**
+     * Checkout cookies received while resolving this request, keyed by cookie
+     * name. The GraphQL handler forwards `setCookie` values to the browser.
+     */
+    cookies: Map<string, Record<string, string>>
   }
   headers: Record<string, string>
 }
@@ -96,6 +101,7 @@ export const getContextFactory =
       channel: ChannelMarshal.parse(options.channel),
       flags: options.flags ?? {},
       locale: options.locale,
+      cookies: new Map<string, Record<string, string>>(),
     }
     ctx.clients = getClients(options, ctx)
     ctx.loaders = getLoaders(options, ctx)

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

@@ -7,11 +7,15 @@ import type { Options } from '..'
 import type { Clients } from '../clients'
 
 export const getSkuLoader = (_: Options, clients: Clients) => {
-  const loader = async (skuIds: readonly string[]) => {
+  const loader = async (keys: readonly string[]) => {
+    const skuIds = keys.map((key) => key.split('-')[0]);
+    const showInvisibleItems = keys.some((key) => key.split('-')[1] === 'invisibleItems')
+
     const { products } = await clients.search.products({
       query: `sku:${skuIds.join(';')}`,
       page: 0,
       count: skuIds.length,
+      showInvisibleItems
     })
 
     const skuBySkuId = products.reduce((acc, product) => {

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

@@ -9,6 +9,7 @@ import {
   findSkuId,
   findSlug,
   transformSelectedFacet,
+  findRegionId,
 } from "../utils/facets"
 import { SORT_MAP } from "../utils/sort"
 import { StoreCollection } from "./collection"
@@ -31,6 +32,7 @@ export const Query = {
     // Insert channel in context for later usage
     const channel = findChannel(locator)
     const locale = findLocale(locator)
+    const regionId = findRegionId(locator)
     const id = findSkuId(locator)
     const slug = findSlug(locator)
 
@@ -90,6 +92,7 @@ export const Query = {
         page: 0,
         count: 1,
         query: `product:${route.id}`,
+        regionId,
       })
 
       if (!product) {

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

@@ -145,7 +145,7 @@ const orderFormToCart = async (
       orderNumber: form.orderFormId,
       acceptedOffer: form.items.map(async (item) => ({
         ...item,
-        product: await skuLoader.load(item.id),
+        product: await skuLoader.load(`${item.id}-invisibleItems`),
       })),
     },
     messages: form.messages.map(({ text, status }) => ({

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

@@ -0,0 +1,157 @@
+import type { Context } from '../index'
+
+export interface ContextForCookies {
+  headers: Context['headers']
+  storage: Pick<Context['storage'], 'cookies'>
+}
+
+const MATCH_FIRST_SET_COOKIE_KEY_VALUE = /^([^=]+)=([^;]*)/
+
+/**
+ * Splits a combined `set-cookie` header value (cookies joined by `, `) into
+ * individual cookies. Commas inside `expires=...` dates are kept.
+ */
+const splitSetCookieHeader = (value: string) =>
+  value.split(/,(?=\s*[^;,=\s]+=)/).map((setCookie) => setCookie.trim())
+
+/**
+ * Returns every `set-cookie` value of a fetch response.
+ *
+ * `Headers.getSetCookie()` only exists on Node >= 18.14 (undici). FastStore v1
+ * stores may still run on Node 16, where isomorphic-unfetch falls back to
+ * node-fetch v2, which exposes repeated headers through `raw()` instead.
+ */
+export const getSetCookies = (headers: Headers): string[] => {
+  const maybeHeaders = headers as Headers & {
+    getSetCookie?: () => string[]
+    raw?: () => Record<string, string[]>
+  }
+
+  if (typeof maybeHeaders.getSetCookie === 'function') {
+    return maybeHeaders.getSetCookie()
+  }
+
+  if (typeof maybeHeaders.raw === 'function') {
+    return maybeHeaders.raw()['set-cookie'] ?? []
+  }
+
+  const setCookie = headers.get('set-cookie')
+
+  return setCookie ? splitSetCookieHeader(setCookie) : []
+}
+
+/**
+ * This function updates the ctx.storage.cookies, that is used in each request.
+ *
+ * ctx.storage.cookies is a Map<string[1], Record<string, string>[2]> where,
+ * [1] cookie key
+ * [2] {
+ *       value: cookie value,
+ *       setCookie: setCookie used in browser response
+ *     }
+ */
+export const updatesContextStorageCookies = (
+  ctx: Pick<Context, 'storage'>,
+  setCookieValue: string
+) => {
+  const matchCookie = setCookieValue.match(MATCH_FIRST_SET_COOKIE_KEY_VALUE)
+
+  if (matchCookie) {
+    const cookieKey = matchCookie[1]
+    const cookieValue = matchCookie[2]
+
+    ctx.storage.cookies.set(cookieKey, {
+      value: cookieValue,
+      setCookie: setCookieValue,
+    })
+  }
+}
+
+export const setCookie = (ctx: Pick<Context, 'storage'>, headers: Headers) => {
+  getSetCookies(headers).forEach((setCookieValue) =>
+    updatesContextStorageCookies(ctx, setCookieValue)
+  )
+}
+
+export const getStoreCookie =
+  (ctx: Pick<Context, 'storage'>) => (headers: Headers) =>
+    setCookie(ctx, headers)
+
+/**
+ * This function returns a modified copy of the original cookie header (ctx.headers.cookie from the first request)
+ * with the cookie values that comes in each request (ctx.storage.cookies).
+ * If there is no cookies in storage, the ctx.headers?.cookie is used
+ *
+ * ctx.storage.cookies is a Map<string[1], Record<string, string>[2]> where,
+ * [1] cookie key
+ * [2] {
+ *       value: cookie value,
+ *       setCookie: setCookie used in browser response
+ *     }
+ */
+export const getUpdatedCookie = (ctx: ContextForCookies) => {
+  if (!ctx.headers?.cookie) {
+    return null
+  }
+
+  const contextStorageCookies = Array.from(ctx.storage.cookies.entries())
+
+  if (contextStorageCookies.length === 0) {
+    return ctx.headers.cookie
+  }
+
+  return contextStorageCookies.reduce(
+    (existingCookies, [storageCookieKey, { value: storageCookieValue }]) =>
+      updatesCookieValueByKey(
+        existingCookies,
+        storageCookieKey,
+        storageCookieValue
+      ),
+    ctx.headers.cookie
+  )
+}
+
+export const getWithCookie = (ctx: ContextForCookies) =>
+  function withCookie<T extends Record<string, any>>(
+    headers: T
+  ): T | (T & { cookie: string }) {
+    const updatedCookie = getUpdatedCookie(ctx)
+
+    if (!updatedCookie) {
+      return headers
+    }
+
+    return {
+      ...headers,
+      cookie: updatedCookie,
+    }
+  }
+
+/**
+ * This function updates the cookie value based on its key
+ *
+ * const existingCookies = 'key=value1; key2=; key3=value3';
+ * const storageCookieKey = 'key2';
+ * const storageCookieValue = 'value2'
+ *
+ * updatesCookieValueByKey(existingCookies, storageCookieKey, storageCookieValue) returns 'key=value1; key2=value2; key3=value3';
+ */
+export const updatesCookieValueByKey = (
+  existingCookies: string,
+  storageCookieKey: string,
+  storageCookieValue: string
+) => {
+  const MATCH_COOKIE_KEY_VALUE = new RegExp(`(${storageCookieKey})=([^;]*)`)
+  const cookieParts = existingCookies.match(MATCH_COOKIE_KEY_VALUE)
+
+  // replaces original cookie with the one coming from storage
+  if (cookieParts) {
+    return existingCookies.replace(
+      cookieParts[0],
+      `${cookieParts[1]}=${storageCookieValue}`
+    )
+  }
+
+  // add new storage cookie to the original list of cookies
+  return `${existingCookies};${storageCookieKey}=${storageCookieValue}`
+}

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

@@ -104,3 +104,6 @@ export const findLocale = (facets?: Maybe<SelectedFacet[]>) =>
 
 export const findChannel = (facets?: Maybe<SelectedFacet[]>) =>
   facets?.find((facet) => facet.key === 'channel')?.value ?? null
+
+export const findRegionId = (facets?: Maybe<SelectedFacet[]>) =>
+  facets?.find((facet) => facet.key === 'regionId')?.value ?? undefined