ce-storefront 0.20.1 → 0.21.0

package/src/models/operations/searchmarketplaceproducts.ts

@@ -0,0 +1,142 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as components from "../components/index.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type SearchMarketplaceProductsRequest = {
+  /**
+   * This param is used to determine product pricing, promotions, and subscription rates.  If a valid customer group id is provided, pricing details will be retrieved accordingly.  If no matching data is found for the specified customer group id, the system will fall back to the default customer group id.  If no data is found for the default group either, the highest applicable price will be returned.
+   */
+  xCustomerGroupId?: string | undefined;
+  searchProduct: components.SearchProduct;
+};
+
+export type FacetStats = {
+  min: number;
+  max: number;
+};
+
+export type SearchMarketplaceProductsContent = {
+  skus: Array<components.Item>;
+  facetDistribution: { [k: string]: { [k: string]: number } };
+  facetStats: { [k: string]: FacetStats };
+  /**
+   * pagination metadata structure
+   */
+  pagination: components.Pagination;
+};
+
+/**
+ * Success response
+ */
+export type SearchMarketplaceProductsResponseBody = {
+  message: string;
+  success: boolean;
+  content: SearchMarketplaceProductsContent;
+};
+
+/** @internal */
+export type SearchMarketplaceProductsRequest$Outbound = {
+  "x-customer-group-id"?: string | undefined;
+  SearchProduct: components.SearchProduct$Outbound;
+};
+
+/** @internal */
+export const SearchMarketplaceProductsRequest$outboundSchema: z.ZodType<
+  SearchMarketplaceProductsRequest$Outbound,
+  z.ZodTypeDef,
+  SearchMarketplaceProductsRequest
+> = z.object({
+  xCustomerGroupId: z.string().optional(),
+  searchProduct: components.SearchProduct$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    xCustomerGroupId: "x-customer-group-id",
+    searchProduct: "SearchProduct",
+  });
+});
+
+export function searchMarketplaceProductsRequestToJSON(
+  searchMarketplaceProductsRequest: SearchMarketplaceProductsRequest,
+): string {
+  return JSON.stringify(
+    SearchMarketplaceProductsRequest$outboundSchema.parse(
+      searchMarketplaceProductsRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const FacetStats$inboundSchema: z.ZodType<
+  FacetStats,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  min: z.number(),
+  max: z.number(),
+});
+
+export function facetStatsFromJSON(
+  jsonString: string,
+): SafeParseResult<FacetStats, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => FacetStats$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'FacetStats' from JSON`,
+  );
+}
+
+/** @internal */
+export const SearchMarketplaceProductsContent$inboundSchema: z.ZodType<
+  SearchMarketplaceProductsContent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  skus: z.array(components.Item$inboundSchema),
+  facet_distribution: z.record(z.record(z.number().int())),
+  facet_stats: z.record(z.lazy(() => FacetStats$inboundSchema)),
+  pagination: components.Pagination$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "facet_distribution": "facetDistribution",
+    "facet_stats": "facetStats",
+  });
+});
+
+export function searchMarketplaceProductsContentFromJSON(
+  jsonString: string,
+): SafeParseResult<SearchMarketplaceProductsContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => SearchMarketplaceProductsContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SearchMarketplaceProductsContent' from JSON`,
+  );
+}
+
+/** @internal */
+export const SearchMarketplaceProductsResponseBody$inboundSchema: z.ZodType<
+  SearchMarketplaceProductsResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  message: z.string(),
+  success: z.boolean(),
+  content: z.lazy(() => SearchMarketplaceProductsContent$inboundSchema),
+});
+
+export function searchMarketplaceProductsResponseBodyFromJSON(
+  jsonString: string,
+): SafeParseResult<SearchMarketplaceProductsResponseBody, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      SearchMarketplaceProductsResponseBody$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SearchMarketplaceProductsResponseBody' from JSON`,
+  );
+}

package/src/models/operations/searchproducts.ts

@@ -17,7 +17,7 @@ export type SearchProductsRequest = {
   searchProduct: components.SearchProduct;
 };
 
-export type FacetStats = {
+export type SearchProductsFacetStats = {
   min: number;
   max: number;
 };
@@ -25,7 +25,7 @@ export type FacetStats = {
 export type SearchProductsContent = {
   skus: Array<components.Item>;
   facetDistribution: { [k: string]: { [k: string]: number } };
-  facetStats: { [k: string]: FacetStats };
+  facetStats: { [k: string]: SearchProductsFacetStats };
   /**
    * pagination metadata structure
    */
@@ -71,8 +71,8 @@ export function searchProductsRequestToJSON(
 }
 
 /** @internal */
-export const FacetStats$inboundSchema: z.ZodType<
-  FacetStats,
+export const SearchProductsFacetStats$inboundSchema: z.ZodType<
+  SearchProductsFacetStats,
   z.ZodTypeDef,
   unknown
 > = z.object({
@@ -80,13 +80,13 @@ export const FacetStats$inboundSchema: z.ZodType<
   max: z.number(),
 });
 
-export function facetStatsFromJSON(
+export function searchProductsFacetStatsFromJSON(
   jsonString: string,
-): SafeParseResult<FacetStats, SDKValidationError> {
+): SafeParseResult<SearchProductsFacetStats, SDKValidationError> {
   return safeParse(
     jsonString,
-    (x) => FacetStats$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'FacetStats' from JSON`,
+    (x) => SearchProductsFacetStats$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'SearchProductsFacetStats' from JSON`,
   );
 }
 
@@ -98,7 +98,7 @@ export const SearchProductsContent$inboundSchema: z.ZodType<
 > = z.object({
   skus: z.array(components.Item$inboundSchema),
   facet_distribution: z.record(z.record(z.number().int())),
-  facet_stats: z.record(z.lazy(() => FacetStats$inboundSchema)),
+  facet_stats: z.record(z.lazy(() => SearchProductsFacetStats$inboundSchema)),
   pagination: components.Pagination$inboundSchema,
 }).transform((v) => {
   return remap$(v, {

package/src/models/operations/updateaddressdetail.ts

@@ -38,7 +38,7 @@ export type UpdateAddressDetailRequestBody = {
   pincode: string;
   city: string;
   state: string;
-  country?: "India" | undefined;
+  country: "India";
   /**
    * Tax Identification Number (TIN/VAT/GSTIN) specific to the country of operation.
    */

package/src/sdk/marketplace.ts

@@ -0,0 +1,229 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { marketplaceGetProductDetail } from "../funcs/marketplaceGetProductDetail.js";
+import { marketplaceGetVariantDetail } from "../funcs/marketplaceGetVariantDetail.js";
+import { marketplaceListCategories } from "../funcs/marketplaceListCategories.js";
+import { marketplaceListCrosssellProducts } from "../funcs/marketplaceListCrosssellProducts.js";
+import { marketplaceListProductReviews } from "../funcs/marketplaceListProductReviews.js";
+import { marketplaceListProducts } from "../funcs/marketplaceListProducts.js";
+import { marketplaceListProductVariants } from "../funcs/marketplaceListProductVariants.js";
+import { marketplaceListSimilarProducts } from "../funcs/marketplaceListSimilarProducts.js";
+import { marketplaceListSkus } from "../funcs/marketplaceListSkus.js";
+import { marketplaceListUpsellProducts } from "../funcs/marketplaceListUpsellProducts.js";
+import { marketplaceSearchProducts } from "../funcs/marketplaceSearchProducts.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Marketplace extends ClientSDK {
+  /**
+   * List all categories
+   *
+   * @remarks
+   * Returns a list of your product categories. The categories are returned sorted by creation date, with the most recently created categories appearing first.
+   *
+   * @see {@link https://llm-docs.commercengine.io/storefront/operations/list-marketplace-categories} - API reference for the list-marketplace-categories operation
+   */
+  async listCategories(
+    request: operations.ListMarketplaceCategoriesRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ListMarketplaceCategoriesResponseBody> {
+    return unwrapAsync(marketplaceListCategories(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List all products
+   *
+   * @remarks
+   * Returns a list of your products. The products are returned sorted by creation date, with the most recently created products appearing first.
+   *
+   * @see {@link https://llm-docs.commercengine.io/storefront/operations/list-marketplace-products} - API reference for the list-marketplace-products operation
+   */
+  async listProducts(
+    request: operations.ListMarketplaceProductsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ListMarketplaceProductsResponseBody> {
+    return unwrapAsync(marketplaceListProducts(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Retrieve cross-sell products
+   *
+   * @remarks
+   * Retrieves a list of products specified for cross selling. The cross-sell products are returned based on product ids specified in request param.
+   *
+   * @see {@link https://llm-docs.commercengine.io/storefront/operations/list-marketplace-crosssell-products} - API reference for the list-marketplace-crosssell-products operation
+   */
+  async listCrosssellProducts(
+    request: operations.ListMarketplaceCrosssellProductsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ListMarketplaceCrosssellProductsResponseBody> {
+    return unwrapAsync(marketplaceListCrosssellProducts(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Search products
+   *
+   * @remarks
+   * Search for products matching a specific words or characters given.
+   *
+   * @see {@link https://llm-docs.commercengine.io/storefront/operations/search-marketplace-products} - API reference for the search-marketplace-products operation
+   */
+  async searchProducts(
+    request: operations.SearchMarketplaceProductsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.SearchMarketplaceProductsResponseBody> {
+    return unwrapAsync(marketplaceSearchProducts(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Retrieve similar products
+   *
+   * @remarks
+   * Retrieves a list of products similar to a specified product based on their attributes and category. The similar products are returned sorted by relevance, with the most closely matching products appearing first. Useful for providing product recommendations to your customers.
+   *
+   * @see {@link https://llm-docs.commercengine.io/storefront/operations/list-marketplace-similar-products} - API reference for the list-marketplace-similar-products operation
+   */
+  async listSimilarProducts(
+    request: operations.ListMarketplaceSimilarProductsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ListMarketplaceSimilarProductsResponseBody> {
+    return unwrapAsync(marketplaceListSimilarProducts(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Retrieve up-sell products
+   *
+   * @remarks
+   * Retrieves a list of products specified for upsell. The upsell products are returned based on product ids specified in request param.
+   *
+   * @see {@link https://llm-docs.commercengine.io/storefront/operations/list-marketplace-upsell-products} - API reference for the list-marketplace-upsell-products operation
+   */
+  async listUpsellProducts(
+    request: operations.ListMarketplaceUpsellProductsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ListMarketplaceUpsellProductsResponseBody> {
+    return unwrapAsync(marketplaceListUpsellProducts(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Retrieve a product detail
+   *
+   * @remarks
+   * Retrieves the details of an existing product. Supply either the unique product ID or the unique slug, and Commerce Engine will return the corresponding product information.
+   *
+   * @see {@link https://llm-docs.commercengine.io/storefront/operations/get-marketplace-product-detail} - API reference for the get-marketplace-product-detail operation
+   */
+  async getProductDetail(
+    request: operations.GetMarketplaceProductDetailRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetMarketplaceProductDetailResponseBody> {
+    return unwrapAsync(marketplaceGetProductDetail(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List all product reviews
+   *
+   * @remarks
+   * List of reviews for a specified product. The reviews are returned sorted by submission date, with the most recent reviews appearing first. You can filter the reviews by rating, reviewer, or date for more detailed analysis.
+   *
+   * @see {@link https://llm-docs.commercengine.io/storefront/operations/list-marketplace-product-reviews} - API reference for the list-marketplace-product-reviews operation
+   */
+  async listProductReviews(
+    request: operations.ListMarketplaceProductReviewsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ListMarketplaceProductReviewsResponseBody> {
+    return unwrapAsync(marketplaceListProductReviews(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Retrieve product variants
+   *
+   * @remarks
+   * Retrieves the variants of an existing product. Supply the unique product ID, and Commerce Engine will return the corresponding product variants information.
+   *
+   * @see {@link https://llm-docs.commercengine.io/storefront/operations/list-marketplace-product-variants} - API reference for the list-marketplace-product-variants operation
+   */
+  async listProductVariants(
+    request: operations.ListMarketplaceProductVariantsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ListMarketplaceProductVariantsResponseBody> {
+    return unwrapAsync(marketplaceListProductVariants(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Retrieve variant detail
+   *
+   * @remarks
+   * Retrieves the details of a particular variant. Supply the unique product ID, and variant ID.
+   *
+   * @see {@link https://llm-docs.commercengine.io/storefront/operations/get-marketplace-variant-detail} - API reference for the get-marketplace-variant-detail operation
+   */
+  async getVariantDetail(
+    request: operations.GetMarketplaceVariantDetailRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetMarketplaceVariantDetailResponseBody> {
+    return unwrapAsync(marketplaceGetVariantDetail(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * List all SKUs
+   *
+   * @remarks
+   * Returns a list of SKUs. The SKUs are returned sorted by creation date, with the most recently created SKUs appearing first.
+   *
+   * @see {@link https://llm-docs.commercengine.io/storefront/operations/list-marketplace-skus} - API reference for the list-marketplace-skus operation
+   */
+  async listSkus(
+    request: operations.ListMarketplaceSkusRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ListMarketplaceSkusResponseBody> {
+    return unwrapAsync(marketplaceListSkus(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/sdk.ts

@@ -8,6 +8,7 @@ import { Carts } from "./carts.js";
 import { Catalog } from "./catalog.js";
 import { Common } from "./common.js";
 import { Customers } from "./customers.js";
+import { Marketplace } from "./marketplace.js";
 import { Orders } from "./orders.js";
 import { Shipping } from "./shipping.js";
 
@@ -27,6 +28,11 @@ export class CeStorefront extends ClientSDK {
     return (this._catalog ??= new Catalog(this._options));
   }
 
+  private _marketplace?: Marketplace;
+  get marketplace(): Marketplace {
+    return (this._marketplace ??= new Marketplace(this._options));
+  }
+
   private _common?: Common;
   get common(): Common {
     return (this._common ??= new Common(this._options));

package/src/types/enums.ts

@@ -2,15 +2,44 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-declare const __brand: unique symbol;
-export type Unrecognized<T> = T & { [__brand]: "unrecognized" };
+import * as z from "zod/v3";
+import { Unrecognized, unrecognized } from "./unrecognized.js";
 
-export function catchUnrecognizedEnum<T>(value: T): Unrecognized<T> {
-  return value as Unrecognized<T>;
+export type ClosedEnum<T extends Readonly<Record<string, string | number>>> =
+  T[keyof T];
+export type OpenEnum<T extends Readonly<Record<string, string | number>>> =
+  | T[keyof T]
+  | Unrecognized<T[keyof T] extends number ? number : string>;
+
+export function inboundSchema<T extends Record<string, string>>(
+  enumObj: T,
+): z.ZodType<OpenEnum<T>, z.ZodTypeDef, unknown> {
+  const options = Object.values(enumObj);
+  return z.union([
+    ...options.map(x => z.literal(x)),
+    z.string().transform(x => unrecognized(x)),
+  ] as any);
 }
 
-type Prettify<T> = { [K in keyof T]: T[K] } & {};
-export type ClosedEnum<T> = T[keyof T];
-export type OpenEnum<T> =
-  | Prettify<T[keyof T]>
-  | Unrecognized<T[keyof T] extends number ? number : string>;
+export function inboundSchemaInt<T extends Record<string, number | string>>(
+  enumObj: T,
+): z.ZodType<OpenEnum<T>, z.ZodTypeDef, unknown> {
+  // For numeric enums, Object.values returns both numbers and string keys
+  const options = Object.values(enumObj).filter(v => typeof v === "number");
+  return z.union([
+    ...options.map(x => z.literal(x)),
+    z.number().int().transform(x => unrecognized(x)),
+  ] as any);
+}
+
+export function outboundSchema<T extends Record<string, string>>(
+  _: T,
+): z.ZodType<string, z.ZodTypeDef, OpenEnum<T>> {
+  return z.string() as any;
+}
+
+export function outboundSchemaInt<T extends Record<string, number | string>>(
+  _: T,
+): z.ZodType<number, z.ZodTypeDef, OpenEnum<T>> {
+  return z.number().int() as any;
+}

package/src/types/index.ts

@@ -3,9 +3,9 @@
  */
 
 export { blobLikeSchema, isBlobLike } from "./blobs.js";
-export { catchUnrecognizedEnum } from "./enums.js";
-export type { ClosedEnum, OpenEnum, Unrecognized } from "./enums.js";
+export type { ClosedEnum, OpenEnum } from "./enums.js";
 export type { Result } from "./fp.js";
 export type { PageIterator, Paginator } from "./operations.js";
 export { createPageIterator } from "./operations.js";
 export { RFCDate } from "./rfcdate.js";
+export * from "./unrecognized.js";

package/src/types/unrecognized.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+declare const __brand: unique symbol;
+export type Unrecognized<T> = T & { [__brand]: "unrecognized" };
+
+function unrecognized<T>(value: T): Unrecognized<T> {
+  globalCount++;
+  return value as Unrecognized<T>;
+}
+
+let globalCount = 0;
+let refCount = 0;
+export function startCountingUnrecognized() {
+  refCount++;
+  const start = globalCount;
+  return {
+    /**
+     * Ends counting and returns the delta.
+     * @param delta - If provided, only this amount is added to the parent counter
+     *   (used for nested unions where we only want to record the winning option's count).
+     *   If not provided, records all counts since start().
+     */
+    end: (delta?: number) => {
+      const count = globalCount - start;
+      // Reset globalCount back to start, then add only the specified delta
+      globalCount = start + (delta ?? count);
+      if (--refCount === 0) globalCount = 0;
+      return count;
+    },
+  };
+}
+
+export { unrecognized };

package/tsconfig.json

@@ -1,7 +1,6 @@
 {
   "compilerOptions": {
-    "incremental": true,
-    "tsBuildInfoFile": ".tsbuildinfo",
+    "incremental": false,
     "target": "ES2020",
     "lib": ["ES2022", "DOM", "DOM.Iterable"],
     "jsx": "react-jsx",