@ecomiq/core 1.1.0 → 1.2.0

package/README.md

@@ -56,8 +56,22 @@ const data = await api.graphql(
 El cliente hace `POST /graphql`, envía `x-Store-Domain` y lanza
 `GraphQLResponseError` cuando la respuesta contiene `errors`. El schema disponible
 ofrece `store`, `products`, `product`, `relatedProducts`, `collections`,
-`collection`, `sellers`, `seller` y `productReviews`. Las demás lecturas siguen
-disponibles por REST.
+`collection`, `sellers`, `seller`, `productReviews`, `paymentMethods`,
+`storeReviews` y `articles`. Las demás lecturas siguen disponibles por REST.
+
+### Lecturas agrupadas
+
+`getProducts`, `getSellers`, `getPaymentMethods`, `listStoreReviews`,
+`listArticles` y los métodos de colecciones de abajo van por GraphQL. Las que se
+piden a la vez viajan en una sola consulta con alias. Un error en un campo solo
+rechaza esa lectura.
+
+- `getCollectionCovers({ limit, candidates })`: colecciones con
+  `imageCandidates`, las fotos de sus primeros productos para usar de portada.
+- `getCollectionsWithProducts({ limit, products, sort })`: colecciones con sus
+  primeros productos, en el orden de cada colección o en `sort`.
+- `getProductsWithReviews(params, { limit, sortBy, sortDirection })`: los mismos
+  productos que `getProducts(params)`, cada uno con sus primeras reseñas.
 
 Subpaths (opcional):
 

package/dist/client.cjs

@@ -1,21 +1,28 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_api = require("./api.cjs");
-const require_graphql = require("./libs/graphql-wJH7HaQU.cjs");
-const require_catalog_link_key = require("./libs/catalog-link-key-CZTHJBGD.cjs");
+const require_graphql = require("./libs/graphql-BICZrYlZ.cjs");
+const require_graphql_batch = require("./libs/graphql-batch-B0xSD6G2.cjs");
+const require_graphql_selection = require("./libs/graphql-selection-Cj51WkJn.cjs");
+const require_payment_methods = require("./models/payment-methods-CmK08zBM.cjs");
+const require_models_collections = require("./models/collections.cjs");
 const require_catalog_links = require("./models/catalog-links-c4LADGf_.cjs");
+const require_catalog_link_key = require("./libs/catalog-link-key-CZTHJBGD.cjs");
 const require_catalog_link_service = require("./services/catalog-link.service-DiB-OVjn.cjs");
-const require_layout_service = require("./services/layout.service-BkvLzl1g.cjs");
+const require_layout_service = require("./services/layout.service-C6zG6zY7.cjs");
+const require_articles = require("./models/articles-xHCXLKDK.cjs");
 const require_models_products = require("./models/products.cjs");
 const require_bounded_read_cache = require("./libs/bounded-read-cache-D4644LJo.cjs");
+const require_models_storefront_reviews = require("./models/storefront-reviews.cjs");
+const require_models_sellers = require("./models/sellers.cjs");
 const require_customer_registration_service = require("./services/customer-registration.service-C3BNyCHP.cjs");
 const require_customer_session_service = require("./services/customer-session.service-Bd8pLC2v.cjs");
 const require_order_status_service = require("./services/order-status.service-Cn7dsaJo.cjs");
-const require_order_draft_service = require("./services/order-draft.service-Dlu6eEkV.cjs");
+const require_order_draft_service = require("./services/order-draft.service-CdJbIUT6.cjs");
 const require_complaint_book_service = require("./services/complaint-book.service-C7TxltQe.cjs");
 const require_models_settings = require("./models/settings.cjs");
 const require_product_service = require("./services/product.service-B7OFZWB1.cjs");
 const require_search_service = require("./services/search.service-Bx1zbTHJ.cjs");
-const require_review_service = require("./services/review.service-CO2icjpu.cjs");
+const require_review_service = require("./services/review.service-BgRGfq4t.cjs");
 const require_cart_service = require("./services/cart.service-B0D8s6jI.cjs");
 const require_collection_service = require("./services/collection.service-DHGN3rhs.cjs");
 const require_page_service = require("./services/page.service-DmCSeMiR.cjs");
@@ -28,9 +35,36 @@ const require_customer_address_service = require("./services/customer-address.se
 const require_customer_service = require("./services/customer.service-BM0NrOxP.cjs");
 const require_customer_order_service = require("./services/customer-order.service-DLGgT0xa.cjs");
 const require_seller_service = require("./services/seller.service-D11WHhbC.cjs");
-const require_payment_method_service = require("./services/payment-method.service-CEt_nB4R.cjs");
+let zod = require("zod");
 // src/client.ts
 const DEFAULT_SETTINGS_CACHE_TTL_MS = 3e4;
+const PRODUCTS_SELECTION = require_graphql_selection.graphQLSelection(require_models_products.ProductsResponseSchema);
+const PAYMENT_METHOD_SELECTION = require_graphql_selection.graphQLSelection(require_payment_methods.StorefrontPaymentMethodSchema);
+const ARTICLE_SELECTION = require_graphql_selection.graphQLSelection(require_articles.ArticleSummarySchema);
+const STORE_REVIEW_SELECTION = require_graphql_selection.graphQLSelection(require_models_storefront_reviews.StorefrontStoreReviewSchema);
+const SELLER_SELECTION = require_graphql_selection.graphQLSelection(require_models_sellers.SellerSummarySchema);
+const REVIEW_SELECTION = require_graphql_selection.graphQLSelection(require_models_storefront_reviews.StorefrontReviewSchema);
+const ProductsWithReviewsSchema = zod.z.object({ products: zod.z.array(require_models_storefront_reviews.ProductWithReviewsSchema) });
+const MAX_PRODUCT_REVIEWS = 10;
+const COLLECTION_SELECTION = require_graphql_selection.graphQLSelection(require_models_collections.CollectionSchema);
+const PRODUCT_SUMMARY_SELECTION = require_graphql_selection.graphQLSelection(require_models_products.ProductSummarySchema);
+const CollectionCoverRowsSchema = zod.z.array(require_models_collections.CollectionSchema.extend({ products: zod.z.array(require_models_products.ProductSummarySchema.pick({ imageUrl: true })) })).nullable();
+const CollectionProductRowsSchema = zod.z.array(require_models_collections.CollectionWithProductsSchema).nullable();
+const MAX_COLLECTIONS = 100;
+const MAX_COLLECTION_PRODUCTS = 24;
+function boundedCount(value, fallback, max) {
+	if (!Number.isFinite(value)) return fallback;
+	return Math.min(max, Math.max(1, Math.trunc(value)));
+}
+function graphQLProductsInput(input) {
+	const { categoryId: _categoryId, sellers, sort, productTypes, ...rest } = input;
+	return {
+		...rest,
+		sellerSlugs: sellers,
+		sort: sort?.toUpperCase(),
+		productTypes: productTypes?.map((type) => type.toUpperCase())
+	};
+}
 const PRODUCT_READ_CACHE_TTL_MS = 3e4;
 const COLLECTION_READ_CACHE_TTL_MS = 6e4;
 const CATEGORY_READ_CACHE_TTL_MS = 3e4;
@@ -57,6 +91,7 @@ function createClient(options) {
 	function graphql(document, dataSchema, variables, requestOptions = {}) {
 		return require_graphql.executeGraphQL(graphQLApi, domain, document, dataSchema, variables, requestOptions);
 	}
+	const batcher = require_graphql_batch.createGraphQLBatcher((document, variables, options) => require_graphql.sendGraphQL(graphQLApi, domain, document, variables, options));
 	const apiClient = async () => {
 		const storeId = await getStoreId();
 		return require_api.createApi({
@@ -73,6 +108,9 @@ function createClient(options) {
 	const productsCache = new require_bounded_read_cache.BoundedReadCache(32);
 	const productCache = new require_bounded_read_cache.BoundedReadCache(100);
 	const collectionsCache = new require_bounded_read_cache.BoundedReadCache(1);
+	const collectionCoversCache = new require_bounded_read_cache.BoundedReadCache(8);
+	const collectionProductsCache = new require_bounded_read_cache.BoundedReadCache(8);
+	const productReviewsCache = new require_bounded_read_cache.BoundedReadCache(16);
 	const collectionCache = new require_bounded_read_cache.BoundedReadCache(50);
 	const categoryCache = new require_bounded_read_cache.BoundedReadCache(50);
 	const urlCache = new require_bounded_read_cache.BoundedReadCache(200);
@@ -85,6 +123,9 @@ function createClient(options) {
 		productsCache.clear();
 		productCache.clear();
 		collectionsCache.clear();
+		collectionCoversCache.clear();
+		collectionProductsCache.clear();
+		productReviewsCache.clear();
 		collectionCache.clear();
 		categoryCache.clear();
 		urlCache.clear();
@@ -115,6 +156,7 @@ function createClient(options) {
 		const key = JSON.stringify(links);
 		if (layoutRead?.key === key && layoutRead.expiresAt > Date.now()) return layoutRead.data;
 		const read = require_layout_service.getLayout({
+			batcher,
 			graphql,
 			links
 		}).catch(async (error) => {
@@ -156,9 +198,47 @@ function createClient(options) {
 			return require_collection_service.getCollections(client);
 		});
 	}
-	async function getPaymentMethods$1() {
-		const client = await apiClient();
-		return require_payment_method_service.getPaymentMethods(client);
+	function collectionLimitArgument(limit) {
+		return {
+			name: "limit",
+			type: "Int",
+			value: limit === void 0 ? void 0 : boundedCount(limit, MAX_COLLECTIONS, MAX_COLLECTIONS)
+		};
+	}
+	async function getCollectionCovers(options = {}) {
+		const limit = collectionLimitArgument(options.limit);
+		const candidates = boundedCount(options.candidates ?? 8, 8, MAX_COLLECTION_PRODUCTS);
+		return collectionCoversCache.read(`${cacheDomain}\u0000${limit.value ?? ""}\u0000${candidates}`, COLLECTION_READ_CACHE_TTL_MS, async () => {
+			return (await batcher.request({
+				field: "collections",
+				arguments: [limit],
+				selection: `${COLLECTION_SELECTION} products(limit: ${candidates}) { imageUrl }`,
+				schema: CollectionCoverRowsSchema
+			}) ?? []).map(({ products, ...collection }) => ({
+				...collection,
+				imageCandidates: products.map((product) => product.imageUrl).filter((image) => image !== "")
+			}));
+		});
+	}
+	async function getCollectionsWithProducts(options) {
+		const limit = collectionLimitArgument(options.limit);
+		const products = boundedCount(options.products, 8, MAX_COLLECTION_PRODUCTS);
+		const sort = options.sort === void 0 ? "" : `, sort: ${require_models_products.ProductSortSchema.parse(options.sort).toUpperCase()}`;
+		return collectionProductsCache.read(`${cacheDomain}\u0000${limit.value ?? ""}\u0000${products}\u0000${sort}`, PRODUCT_READ_CACHE_TTL_MS, async () => {
+			return await batcher.request({
+				field: "collections",
+				arguments: [limit],
+				selection: `${COLLECTION_SELECTION} products(limit: ${products}${sort}) { ${PRODUCT_SUMMARY_SELECTION} }`,
+				schema: CollectionProductRowsSchema
+			}) ?? [];
+		});
+	}
+	async function getPaymentMethods() {
+		return batcher.request({
+			field: "paymentMethods",
+			selection: PAYMENT_METHOD_SELECTION,
+			schema: require_payment_methods.StorefrontPaymentMethodsSchema
+		}, { allowStale: false });
 	}
 	async function getCollectionBySlug$1(collectionSlug) {
 		return collectionCache.read(`${cacheDomain}\u0000${collectionSlug}`, COLLECTION_READ_CACHE_TTL_MS, async () => {
@@ -209,17 +289,46 @@ function createClient(options) {
 		await Promise.all(batches);
 		return input.map((link) => resolved.get(require_catalog_link_key.catalogLinkKey(link)) ?? link);
 	}
-	async function listArticles$1(params = {}) {
-		const client = await apiClient();
-		return require_article_service.listArticles(client, params);
+	async function listArticles(params = {}) {
+		const input = require_articles.ListArticlesParamsSchema.parse(params);
+		return batcher.request({
+			field: "articles",
+			arguments: [
+				{
+					name: "search",
+					type: "String",
+					value: input.search
+				},
+				{
+					name: "folder",
+					type: "String",
+					value: input.folder
+				},
+				{
+					name: "tag",
+					type: "String",
+					value: input.tag
+				},
+				{
+					name: "limit",
+					type: "Int",
+					value: input.limit
+				}
+			],
+			selection: ARTICLE_SELECTION,
+			schema: require_articles.ArticlesSchema
+		});
 	}
 	async function getArticleBySlug$1(articleSlug) {
 		const client = await apiClient();
 		return require_article_service.getArticleBySlug(client, articleSlug);
 	}
-	async function getSellers$1() {
-		const client = await apiClient();
-		return require_seller_service.getSellers(client);
+	async function getSellers() {
+		return batcher.request({
+			field: "sellers",
+			selection: SELLER_SELECTION,
+			schema: require_models_sellers.SellersSchema
+		});
 	}
 	async function getSellerBySlug$1(sellerSlug) {
 		const client = await apiClient();
@@ -228,8 +337,40 @@ function createClient(options) {
 	async function getProducts$1(params = {}) {
 		const input = require_models_products.ProductsParamsSchema.parse(params);
 		return productsCache.read(`${cacheDomain}\u0000${JSON.stringify(input)}`, PRODUCT_READ_CACHE_TTL_MS, async () => {
-			const client = await apiClient();
-			return require_product_service.getProducts(client, input);
+			if (input.categoryId !== void 0) {
+				const client = await apiClient();
+				return require_product_service.getProducts(client, input);
+			}
+			return batcher.request({
+				field: "products",
+				arguments: [{
+					name: "input",
+					type: "StorefrontProductsInput",
+					value: graphQLProductsInput(input)
+				}],
+				selection: PRODUCTS_SELECTION,
+				schema: require_models_products.ProductsResponseSchema
+			});
+		});
+	}
+	async function getProductsWithReviews(params, reviews = {}) {
+		const input = require_models_products.ProductsParamsSchema.parse(params);
+		if (input.categoryId !== void 0) throw new Error("getProductsWithReviews filtra por categories, no por categoryId");
+		const limit = boundedCount(reviews.limit ?? 3, 3, MAX_PRODUCT_REVIEWS);
+		const sortBy = reviews.sortBy === void 0 ? "" : `, sortBy: ${JSON.stringify(require_models_storefront_reviews.ProductReviewSortSchema.parse(reviews.sortBy))}`;
+		const sortDirection = reviews.sortDirection === void 0 ? "" : `, sortDirection: ${require_models_storefront_reviews.ProductReviewDirectionSchema.parse(reviews.sortDirection).toUpperCase()}`;
+		const selection = `products { ${PRODUCT_SUMMARY_SELECTION} reviews(limit: ${limit}${sortBy}${sortDirection}) { ${REVIEW_SELECTION} } }`;
+		return productReviewsCache.read(`${cacheDomain}\u0000${JSON.stringify(input)}\u0000${selection}`, PRODUCT_READ_CACHE_TTL_MS, async () => {
+			return (await batcher.request({
+				field: "products",
+				arguments: [{
+					name: "input",
+					type: "StorefrontProductsInput",
+					value: graphQLProductsInput(input)
+				}],
+				selection,
+				schema: ProductsWithReviewsSchema
+			})).products;
 		});
 	}
 	async function getProductBySlug$1(productSlug, options = {}) {
@@ -254,9 +395,22 @@ function createClient(options) {
 		const client = await apiClient();
 		return require_review_service.listProductReviews(client, params);
 	}
-	async function listStoreReviews$1(params) {
-		const client = await apiClient();
-		return require_review_service.listStoreReviews(client, params);
+	async function listStoreReviews(params = {}) {
+		const input = require_models_storefront_reviews.ListStoreReviewsParamsSchema.parse(params);
+		return batcher.request({
+			field: "storeReviews",
+			arguments: [{
+				name: "limit",
+				type: "Int",
+				value: input.limit
+			}, {
+				name: "minRating",
+				type: "Int",
+				value: input.minRating
+			}],
+			selection: STORE_REVIEW_SELECTION,
+			schema: require_models_storefront_reviews.StorefrontStoreReviewSchema.array()
+		});
 	}
 	async function createProductReview$1(params) {
 		const client = await apiClient();
@@ -435,24 +589,27 @@ function createClient(options) {
 		getLayout: getLayout$1,
 		getStoreId,
 		getCollections: getCollections$1,
-		getPaymentMethods: getPaymentMethods$1,
+		getCollectionCovers,
+		getCollectionsWithProducts,
+		getPaymentMethods,
 		getCollectionBySlug: getCollectionBySlug$1,
 		getPageBySlug: getPageBySlug$1,
 		getCategoryBySlug: getCategoryBySlug$1,
 		resolveUrl: resolveUrl$1,
 		getLinks: getLinks$1,
 		getSitemap: getSitemap$1,
-		listArticles: listArticles$1,
+		listArticles,
 		getArticleBySlug: getArticleBySlug$1,
 		clearCache,
-		getSellers: getSellers$1,
+		getSellers,
 		getSellerBySlug: getSellerBySlug$1,
 		getProducts: getProducts$1,
+		getProductsWithReviews,
 		getProductBySlug: getProductBySlug$1,
 		getRelatedProducts: getRelatedProducts$1,
 		autocompleteProducts: autocompleteProducts$1,
 		listProductReviews: listProductReviews$1,
-		listStoreReviews: listStoreReviews$1,
+		listStoreReviews,
 		createProductReview: createProductReview$1,
 		createCustomerProductReview: createCustomerProductReview$1,
 		createCart: createCart$1,

package/dist/client.d.cts

@@ -2,7 +2,7 @@ import { AuthenticateOrderPaymentInput, OrderPaymentStart, OrderStatusView } fro
 import { Api, CreateApiOptions } from "./api.cjs";
 import { GraphQLRequestOptions, GraphQLVariables } from "./libs/graphql.cjs";
 import { StorefrontPaymentMethods } from "./models/payment-methods.cjs";
-import { Collection, Collections } from "./models/collections.cjs";
+import { Collection, CollectionCoversOptions, CollectionWithCovers, CollectionWithProducts, Collections, CollectionsWithProductsOptions } from "./models/collections.cjs";
 import { CategoryDetail } from "./models/categories.cjs";
 import { SitemapPage, UrlResolution, UrlResolutionOptions } from "./models/urls.cjs";
 import { CatalogLink } from "./models/catalog-links.cjs";
@@ -10,7 +10,7 @@ import { StorefrontLayout } from "./services/layout.service.cjs";
 import { Article, ArticleSummary, ListArticlesParams } from "./models/articles.cjs";
 import { ProductBySlugOptions, ProductDetail, ProductSummary, ProductsParamsInput, ProductsResponse, RelatedProductsParams } from "./models/products.cjs";
 import { ProductAutocompleteParams, ProductSuggestion } from "./models/search.cjs";
-import { CreateCustomerProductReviewParams, CreateProductReviewParams, ListProductReviewsParams, ListStoreReviewsParams, StorefrontReview, StorefrontReviews, StorefrontStoreReview } from "./models/storefront-reviews.cjs";
+import { CreateCustomerProductReviewParams, CreateProductReviewParams, ListProductReviewsParams, ListStoreReviewsParams, ProductReviewsOptions, ProductWithReviews, StorefrontReview, StorefrontReviews, StorefrontStoreReview } from "./models/storefront-reviews.cjs";
 import { AddCartItemParams, CreateCartParams, GetCartParams, RemoveCartItemParams, StorefrontCart, UpdateCartItemQuantityParams } from "./models/storefront-cart.cjs";
 import { CartAddressesParams, CartBuyerParams, CartCheckoutParams, CartCheckoutReadParams, CartCheckoutReadResponse, CartCheckoutResponse, CartPaymentReceiptResponse, CartPromotionCodeParams, GetShippingOptionsParams, PutCartPaymentMethodParams, PutShippingMethodParams, ShippingOptionsResponse, UploadPaymentReceiptParams } from "./models/storefront-checkout.cjs";
 import { Countries, Departments, Districts, GetDepartmentsParams, GetDistrictsParams, GetProvincesParams, Provinces } from "./models/geo.cjs";
@@ -48,6 +48,10 @@ export interface StorefrontClient extends Api {
   getStoreId(): Promise<string>;
   /** GET /v1/collections */
   getCollections(): Promise<Collections>;
+  /** Colecciones con fotos de sus productos para usar de portada, en la misma consulta. */
+  getCollectionCovers(options?: CollectionCoversOptions): Promise<CollectionWithCovers[]>;
+  /** Colecciones con sus primeros productos, en la misma consulta. */
+  getCollectionsWithProducts(options: CollectionsWithProductsOptions): Promise<CollectionWithProducts[]>;
   /** GET /v1/payments/methods */
   getPaymentMethods(): Promise<StorefrontPaymentMethods>;
   /** GET /v1/collections/by-slug/:slug */
@@ -65,6 +69,8 @@ export interface StorefrontClient extends Api {
   getSellers(): Promise<Sellers>;
   getSellerBySlug(slug: string): Promise<SellerProfile>;
   getProducts(params?: ProductsParamsInput): Promise<ProductsResponse>;
+  /** Productos con sus primeras reseñas, en la misma consulta. */
+  getProductsWithReviews(params: ProductsParamsInput, reviews?: ProductReviewsOptions): Promise<ProductWithReviews[]>;
   /** GET product by slug con x-Store-Id. */
   getProductBySlug(slug: string, options?: ProductBySlugOptions): Promise<ProductDetail>;
   getRelatedProducts(params: RelatedProductsParams): Promise<ProductSummary[]>;

package/dist/client.d.ts

@@ -2,7 +2,7 @@ import { AuthenticateOrderPaymentInput, OrderPaymentStart, OrderStatusView } fro
 import { Api, CreateApiOptions } from "./api.js";
 import { GraphQLRequestOptions, GraphQLVariables } from "./libs/graphql.js";
 import { StorefrontPaymentMethods } from "./models/payment-methods.js";
-import { Collection, Collections } from "./models/collections.js";
+import { Collection, CollectionCoversOptions, CollectionWithCovers, CollectionWithProducts, Collections, CollectionsWithProductsOptions } from "./models/collections.js";
 import { CategoryDetail } from "./models/categories.js";
 import { SitemapPage, UrlResolution, UrlResolutionOptions } from "./models/urls.js";
 import { CatalogLink } from "./models/catalog-links.js";
@@ -10,7 +10,7 @@ import { StorefrontLayout } from "./services/layout.service.js";
 import { Article, ArticleSummary, ListArticlesParams } from "./models/articles.js";
 import { ProductBySlugOptions, ProductDetail, ProductSummary, ProductsParamsInput, ProductsResponse, RelatedProductsParams } from "./models/products.js";
 import { ProductAutocompleteParams, ProductSuggestion } from "./models/search.js";
-import { CreateCustomerProductReviewParams, CreateProductReviewParams, ListProductReviewsParams, ListStoreReviewsParams, StorefrontReview, StorefrontReviews, StorefrontStoreReview } from "./models/storefront-reviews.js";
+import { CreateCustomerProductReviewParams, CreateProductReviewParams, ListProductReviewsParams, ListStoreReviewsParams, ProductReviewsOptions, ProductWithReviews, StorefrontReview, StorefrontReviews, StorefrontStoreReview } from "./models/storefront-reviews.js";
 import { AddCartItemParams, CreateCartParams, GetCartParams, RemoveCartItemParams, StorefrontCart, UpdateCartItemQuantityParams } from "./models/storefront-cart.js";
 import { CartAddressesParams, CartBuyerParams, CartCheckoutParams, CartCheckoutReadParams, CartCheckoutReadResponse, CartCheckoutResponse, CartPaymentReceiptResponse, CartPromotionCodeParams, GetShippingOptionsParams, PutCartPaymentMethodParams, PutShippingMethodParams, ShippingOptionsResponse, UploadPaymentReceiptParams } from "./models/storefront-checkout.js";
 import { Countries, Departments, Districts, GetDepartmentsParams, GetDistrictsParams, GetProvincesParams, Provinces } from "./models/geo.js";
@@ -48,6 +48,10 @@ export interface StorefrontClient extends Api {
   getStoreId(): Promise<string>;
   /** GET /v1/collections */
   getCollections(): Promise<Collections>;
+  /** Colecciones con fotos de sus productos para usar de portada, en la misma consulta. */
+  getCollectionCovers(options?: CollectionCoversOptions): Promise<CollectionWithCovers[]>;
+  /** Colecciones con sus primeros productos, en la misma consulta. */
+  getCollectionsWithProducts(options: CollectionsWithProductsOptions): Promise<CollectionWithProducts[]>;
   /** GET /v1/payments/methods */
   getPaymentMethods(): Promise<StorefrontPaymentMethods>;
   /** GET /v1/collections/by-slug/:slug */
@@ -65,6 +69,8 @@ export interface StorefrontClient extends Api {
   getSellers(): Promise<Sellers>;
   getSellerBySlug(slug: string): Promise<SellerProfile>;
   getProducts(params?: ProductsParamsInput): Promise<ProductsResponse>;
+  /** Productos con sus primeras reseñas, en la misma consulta. */
+  getProductsWithReviews(params: ProductsParamsInput, reviews?: ProductReviewsOptions): Promise<ProductWithReviews[]>;
   /** GET product by slug con x-Store-Id. */
   getProductBySlug(slug: string, options?: ProductBySlugOptions): Promise<ProductDetail>;
   getRelatedProducts(params: RelatedProductsParams): Promise<ProductSummary[]>;