@teez-sdk/teez-b2c-api 2.2.0 → 3.0.0

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 import * as z from "zod/mini";
+import { ZodMiniType, output } from "zod/mini";
 
 //#region src/common/constants.d.ts
 /**
@@ -33,6 +34,54 @@ type Language = (typeof LANGUAGES)[keyof typeof LANGUAGES] | (string & {});
  */
 type BaseParams = Record<string, unknown>;
 //#endregion
+//#region src/http/types.d.ts
+/**
+ * Type representing URL query parameters.
+ */
+type QueryParams = Record<string, unknown>;
+/**
+ * Type representing HTTP headers initialization.
+ */
+type HeadersInit = NonNullable<ConstructorParameters<typeof Headers>[0]>;
+/**
+ * Options for making a generic HTTP request.
+ */
+interface HttpRequestOptions extends Omit<RequestInit, "headers" | "signal" | "body"> {
+  /**
+   * Relative path to the resource.
+   */
+  path: string;
+  /**
+   * Query parameters to append to the URL.
+   */
+  params?: QueryParams;
+  /**
+   * Additional headers for this specific request.
+   */
+  headers?: HeadersInit;
+  /**
+   * Request body to send.
+   * It will be strictly serialized to JSON.
+   */
+  body?: unknown;
+}
+/**
+ * Options for making a GET request.
+ */
+type HttpGetOptions = Omit<HttpRequestOptions, "method" | "body">;
+/**
+ * Options for making a POST request.
+ */
+type HttpPostOptions = Omit<HttpRequestOptions, "method">;
+/**
+ * Options for making a PATCH request.
+ */
+type HttpPatchOptions = Omit<HttpRequestOptions, "method">;
+/**
+ * Options for making a DELETE request.
+ */
+type HttpDeleteOptions = Omit<HttpRequestOptions, "method">;
+//#endregion
 //#region src/config.d.ts
 /**
  * Configuration options for the Teez client.
@@ -65,7 +114,7 @@ interface TeezClientConfig {
   /**
    * Custom headers to include in all requests.
    */
-  headers?: Record<string, string>;
+  headers?: HeadersInit;
 }
 /**
  * Fully resolved configuration with defaults applied.
@@ -92,9 +141,9 @@ interface ResolvedTeezClientConfig {
    */
   readonly timeout: number;
   /**
-   * Custom headers included in requests.
+   * Resolved headers as Headers object for efficient manipulation.
    */
-  readonly headers: Readonly<Record<string, string>>;
+  readonly headers: Headers;
 }
 /**
  * Default configuration values.
@@ -111,90 +160,7 @@ declare function buildUserAgent(appVersion: string): string;
 /**
  * Builds the headers object for API requests based on configuration.
  */
-declare function buildHeaders(config: ResolvedTeezClientConfig): Record<string, string>;
-//#endregion
-//#region src/http/types.d.ts
-/**
- * Type representing URL query parameters.
- */
-type QueryParams = Record<string, unknown>;
-/**
- * Options for making a generic HTTP request.
- */
-interface HttpRequestOptions extends Omit<RequestInit, "headers" | "signal"> {
-  /**
-   * Full URL for the request.
-   */
-  url: string;
-  /**
-   * Additional headers for this specific request.
-   */
-  headers?: Record<string, string>;
-}
-/**
- * Options for making a GET request.
- */
-interface HttpGetOptions<T extends z.ZodMiniType> extends Omit<HttpRequestOptions, "url" | "method" | "body"> {
-  /**
-   * Relative path to the resource.
-   */
-  path: string;
-  /**
-   * Query parameters to append to the URL.
-   */
-  params?: QueryParams;
-  /**
-   * Zod schema to validate the response.
-   */
-  schema: T;
-}
-/**
- * Options for making a POST request.
- */
-interface HttpPostOptions extends Omit<HttpRequestOptions, "url" | "method" | "body"> {
-  /**
-   * Relative path to the resource.
-   */
-  path: string;
-  /**
-   * Request body to send (will be JSON-serialized).
-   */
-  body?: unknown;
-  /**
-   * Query parameters to append to the URL.
-   */
-  params?: QueryParams;
-}
-/**
- * Options for making a PATCH request.
- */
-interface HttpPatchOptions extends Omit<HttpRequestOptions, "url" | "method" | "body"> {
-  /**
-   * Relative path to the resource.
-   */
-  path: string;
-  /**
-   * Request body to send (will be JSON-serialized).
-   */
-  body?: unknown;
-  /**
-   * Query parameters to append to the URL.
-   */
-  params?: QueryParams;
-}
-/**
- * Options for making a DELETE request.
- */
-interface HttpDeleteOptions extends Omit<HttpRequestOptions, "url" | "method" | "body"> {
-  /**
-   * Relative path to the resource.
-   */
-  path: string;
-  /**
-   * Query parameters to append to the URL.
-   */
-  params?: QueryParams;
-}
+declare function buildHeaders(config: ResolvedTeezClientConfig): Headers;
 //#endregion
 //#region src/http/client.d.ts
 /**
@@ -211,32 +177,47 @@ declare class HttpClient {
   private readonly headers;
   /**
    * Initializes a new instance of the HttpClient.
-   *
-   * @param config Resolved client configuration.
    */
   constructor(config: ResolvedTeezClientConfig);
   /**
    * Performs a low-level HTTP request.
-   *
-   * @param options Request options.
    */
   request(options: HttpRequestOptions): Promise<unknown>;
   /**
-   * Performs a GET request and validates the response.
+   * Performs a low-level HTTP request with schema validation.
    */
-  get<T extends z.ZodMiniType>(options: HttpGetOptions<T>): Promise<z.output<T>>;
+  request<T extends ZodMiniType>(options: HttpRequestOptions, schema: T): Promise<output<T>>;
+  /**
+   * Performs a GET request.
+   */
+  get(options: HttpGetOptions): Promise<unknown>;
+  /**
+   * Performs a GET request with schema validation.
+   */
+  get<T extends ZodMiniType>(options: HttpGetOptions, schema: T): Promise<output<T>>;
   /**
    * Performs a POST request.
    */
-  post(options: HttpPostOptions): Promise<unknown>;
+  /**
+   * Performs a POST request with schema validation.
+   */
+  post<T extends ZodMiniType>(options: HttpPostOptions, schema: T): Promise<output<T>>;
   /**
    * Performs a PATCH request.
    */
   patch(options: HttpPatchOptions): Promise<unknown>;
+  /**
+   * Performs a PATCH request with schema validation.
+   */
+  patch<T extends ZodMiniType>(options: HttpPatchOptions, schema: T): Promise<output<T>>;
   /**
    * Performs a DELETE request.
    */
   delete(options: HttpDeleteOptions): Promise<unknown>;
+  /**
+   * Performs a DELETE request with schema validation.
+   */
+  delete<T extends ZodMiniType>(options: HttpDeleteOptions, schema: T): Promise<output<T>>;
 }
 //#endregion
 //#region src/api/auth/schema-types.d.ts
@@ -950,10 +931,6 @@ interface ProductsApiGetReviewsResponse {
  * Schema for a product badge.
  */
 interface ProductsApiBadge {
-  /**
-   * Background color code
-   */
-  backgroundColor: number;
   /**
    * Text label of the badge
    */
@@ -962,6 +939,10 @@ interface ProductsApiBadge {
    * Text color code
    */
   textColor: number;
+  /**
+   * Background color code
+   */
+  backgroundColor?: (number | null) | undefined;
 }
 /**
  * Type literal for products stock availability type
@@ -1043,7 +1024,7 @@ interface ProductsApiProductItem {
   /**
    * Name of the promotion
    */
-  promoName: string;
+  promoName?: (string | null) | undefined;
   /**
    * List of applicable promocodes
    */
@@ -1063,7 +1044,7 @@ interface ProductsApiProductItem {
   /**
    * Badge information for the product
    */
-  badge: ProductsApiBadge;
+  badge?: (ProductsApiBadge | null) | undefined;
   /**
    * Moderation status code
    */
@@ -1204,147 +1185,385 @@ declare class CollectionsApi {
   get(params: CollectionsApiGetParams): Promise<CollectionsApiGetResponse>;
 }
 //#endregion
-//#region src/api/feature-flags/schema-types.d.ts
+//#region src/api/favorites/schema-types.d.ts
 /**
  * ⚠️ This file is auto-generated. Do not edit manually.
  * Run `npm run generate:schema-types` to regenerate.
  * Generated from: schemas.ts
  */
 /**
- * Schema for a feature flag item.
+ * Schema for a product badge.
  */
-interface FeatureFlagsApiItem {
+interface FavoritesApiBadge {
   /**
-   * Name of the feature flag
+   * Text label of the badge
    */
-  name: string;
+  label: string;
   /**
-   * Indicates if the feature flag is currently active
+   * Background color code
    */
-  isActive: boolean;
+  backgroundColor?: (number | null) | undefined;
+  /**
+   * Text color code
+   */
+  textColor: number;
 }
 /**
- * Response schema for the list of feature flags.
- */
-type FeatureFlagsApiListResponse = FeatureFlagsApiItem[];
-//#endregion
-//#region src/api/feature-flags/types.d.ts
-/**
- * Parameters for fetching feature flags.
+ * Type literal for stock availability type
  */
-type FeatureFlagsApiListParams = BaseParams;
-//#endregion
-//#region src/api/feature-flags/api.d.ts
+type FavoritesStockAvailabilityType = "stock";
 /**
- * API for retrieving feature flags configuration.
+ * Schema for stock availability information.
  */
-declare class FeatureFlagsApi {
-  private http;
+interface FavoritesApiStockAvailability {
   /**
-   * Initializes a new instance of the FeatureFlagsApi.
-   *
-   * @param http HTTP client instance.
+   * Type of stock status (known value: "stock")
    */
-  constructor(http: HttpClient);
+  type: FavoritesStockAvailabilityType;
   /**
-   * Retrieves all active feature flags.
-   *
-   * @example
-   * const flags = await client.featureFlags.list();
+   * SVG icon representing stock status
    */
-  list(params?: FeatureFlagsApiListParams): Promise<FeatureFlagsApiListResponse>;
-}
-//#endregion
-//#region src/api/products/types.d.ts
-/**
- * Parameters for fetching product sort options.
- */
-interface ProductsApiGetSortOptionsParams extends BaseParams {
+  svg?: (string | null) | undefined;
   /**
-   * Indicates if the context is a search result
+   * Localized text describing stock status
    */
-  IsSearch?: boolean;
+  text: string;
   /**
-   * Indicates if the context is a promotional listing
+   * Maximum quantity available
    */
-  IsPromo?: boolean;
+  maxQty: number;
+  /**
+   * Localized reason text for quantity limit
+   */
+  maxQtyReason: string;
 }
 /**
- * Parameters for fetching product reviews.
+ * Schema for a favorited item (SKU).
  */
-interface ProductsApiGetReviewsParams extends BaseParams {
+interface FavoritesApiItem {
   /**
-   * Unique identifier of the product
+   * Unique product identifier
    */
   productId: number;
   /**
-   * Number of the page to retrieve
+   * Unique stock keeping unit identifier
    */
-  pageNumber?: number;
+  skuId: number;
   /**
-   * Number of reviews per page
+   * URL for the full-size image
    */
-  pageSize?: number;
-}
-/**
- * Parameters for fetching a filtered list of products.
- */
-interface ProductsApiListParams extends BaseParams {
+  imageUrl: string;
   /**
-   * Random seed for consistent pagination
+   * Full display name of the product
    */
-  seed?: number;
+  name: string;
   /**
-   * Number of the page to retrieve
+   * Brief description of the product
    */
-  pageNumber?: number;
+  shortDescription: string;
   /**
-   * Number of products per page
+   * URL for the small preview image
    */
-  pageSize?: number;
+  thumbnailUrl: string;
   /**
-   * Filter products by category ID
+   * Original price before discounts
    */
-  categoryId?: number;
+  originalPrice: number;
   /**
-   * Criteria to sort products by
+   * Current selling price
    */
-  sortBy?: ProductSortKey;
+  price: number;
   /**
-   * Filter products by brand ID
+   * Quantity available in stock
    */
-  brandIds?: number;
+  qty: number;
   /**
-   * Minimum price filter
+   * Stock availability details
    */
-  minPrice?: number;
+  stockAvailability?: (FavoritesApiStockAvailability | null) | undefined;
   /**
-   * Maximum price filter
+   * Indicates if the product is on promotion
    */
-  maxPrice?: number;
-}
-//#endregion
-//#region src/api/products/api.d.ts
-/**
- * API for retrieving product listings, details, and reviews.
- */
-declare class ProductsApi {
-  private http;
+  isPromo: boolean;
   /**
-   * Initializes a new instance of the ProductsApi.
-   *
-   * @param http HTTP client instance.
+   * Name of the promotion
    */
-  constructor(http: HttpClient);
+  promoName?: (string | null) | undefined;
   /**
-   * Retrieves available sorting options for product lists.
-   *
-   * @example
-   * const sortOptions = await client.products.getSortOptions();
+   * List of applicable promocodes
    */
-  getSortOptions(params?: ProductsApiGetSortOptionsParams): Promise<ProductsApiGetSortOptionsResponse>;
+  promocodes: string[];
   /**
-   * Retrieves a list of products with optional filtering and pagination.
+   * Popularity text indicating purchase frequency
+   */
+  qtyPurchasedInfo?: (string | null) | undefined;
+  /**
+   * Average rating score
+   */
+  rating?: (number | null) | undefined;
+  /**
+   * Total number of ratings
+   */
+  scoreQuantity?: (number | null) | undefined;
+  /**
+   * Badge information for the product
+   */
+  badge?: (FavoritesApiBadge | null) | undefined;
+  /**
+   * Moderation status code
+   */
+  moderationStatus: number;
+}
+/**
+ * Response schema for the favorites list.
+ */
+interface FavoritesApiListResponse {
+  /**
+   * List of favorited items
+   */
+  items: FavoritesApiItem[];
+}
+/**
+ * Response schema for retrieving favorite SKU IDs.
+ */
+interface FavoritesApiGetIdsResponse {
+  /**
+   * List of favorited SKU IDs
+   */
+  skuIds: number[];
+}
+/**
+ * Response schema for adding a SKU to favorites.
+ */
+type FavoritesApiAddResponse = (null | null) | undefined;
+/**
+ * Response schema for removing a SKU from favorites.
+ */
+type FavoritesApiRemoveResponse = (null | null) | undefined;
+//#endregion
+//#region src/api/favorites/types.d.ts
+/**
+ * Parameters for retrieving the favorites list.
+ */
+interface FavoritesApiListParams extends BaseParams {
+  /**
+   * Page number for pagination.
+   */
+  pageNumber?: number;
+  /**
+   * Number of items per page.
+   */
+  pageSize?: number;
+}
+/**
+ * Parameters for retrieving favorite SKU IDs.
+ */
+type FavoritesApiGetIdsParams = BaseParams;
+/**
+ * Parameters for adding items to favorites.
+ */
+interface FavoritesApiAddParams extends BaseParams {
+  /**
+   * Unique identifiers of the SKUs to add.
+   */
+  skuIds: number[];
+}
+/**
+ * Parameters for removing items from favorites.
+ */
+interface FavoritesApiRemoveParams extends BaseParams {
+  /**
+   * Unique identifiers of the SKUs to remove.
+   */
+  skuIds: number[];
+}
+//#endregion
+//#region src/api/favorites/api.d.ts
+/**
+ * API for managing user favorites.
+ */
+declare class FavoritesApi {
+  private http;
+  /**
+   * Initializes a new instance of the FavoritesApi.
+   *
+   * @param http HTTP client instance.
+   */
+  constructor(http: HttpClient);
+  /**
+   * Retrieves a paginated list of favorited items.
+   *
+   * @example
+   * const favorites = await client.favorites.list({
+   *   pageNumber: 1,
+   *   pageSize: 20
+   * });
+   */
+  list(params?: FavoritesApiListParams): Promise<FavoritesApiListResponse>;
+  /**
+   * Retrieves the list of IDs of favorited SKUs.
+   *
+   * @example
+   * const { skuIds } = await client.favorites.getIds();
+   */
+  getIds(params?: FavoritesApiGetIdsParams): Promise<FavoritesApiGetIdsResponse>;
+  /**
+   * Adds SKUs to favorites.
+   *
+   * @example
+   * await client.favorites.add({ skuIds: [12345, 67890] });
+   */
+  add(params: FavoritesApiAddParams): Promise<FavoritesApiAddResponse>;
+  /**
+   * Removes SKUs from favorites.
+   *
+   * @example
+   * await client.favorites.remove({ skuIds: [12345, 67890] });
+   */
+  remove(params: FavoritesApiRemoveParams): Promise<FavoritesApiRemoveResponse>;
+}
+//#endregion
+//#region src/api/feature-flags/schema-types.d.ts
+/**
+ * ⚠️ This file is auto-generated. Do not edit manually.
+ * Run `npm run generate:schema-types` to regenerate.
+ * Generated from: schemas.ts
+ */
+/**
+ * Schema for a feature flag item.
+ */
+interface FeatureFlagsApiItem {
+  /**
+   * Name of the feature flag
+   */
+  name: string;
+  /**
+   * Indicates if the feature flag is currently active
+   */
+  isActive: boolean;
+}
+/**
+ * Response schema for the list of feature flags.
+ */
+type FeatureFlagsApiListResponse = FeatureFlagsApiItem[];
+//#endregion
+//#region src/api/feature-flags/types.d.ts
+/**
+ * Parameters for fetching feature flags.
+ */
+type FeatureFlagsApiListParams = BaseParams;
+//#endregion
+//#region src/api/feature-flags/api.d.ts
+/**
+ * API for retrieving feature flags configuration.
+ */
+declare class FeatureFlagsApi {
+  private http;
+  /**
+   * Initializes a new instance of the FeatureFlagsApi.
+   *
+   * @param http HTTP client instance.
+   */
+  constructor(http: HttpClient);
+  /**
+   * Retrieves all active feature flags.
+   *
+   * @example
+   * const flags = await client.featureFlags.list();
+   */
+  list(params?: FeatureFlagsApiListParams): Promise<FeatureFlagsApiListResponse>;
+}
+//#endregion
+//#region src/api/products/types.d.ts
+/**
+ * Parameters for fetching product sort options.
+ */
+interface ProductsApiGetSortOptionsParams extends BaseParams {
+  /**
+   * Indicates if the context is a search result
+   */
+  IsSearch?: boolean;
+  /**
+   * Indicates if the context is a promotional listing
+   */
+  IsPromo?: boolean;
+}
+/**
+ * Parameters for fetching product reviews.
+ */
+interface ProductsApiGetReviewsParams extends BaseParams {
+  /**
+   * Unique identifier of the product
+   */
+  productId: number;
+  /**
+   * Number of the page to retrieve
+   */
+  pageNumber?: number;
+  /**
+   * Number of reviews per page
+   */
+  pageSize?: number;
+}
+/**
+ * Parameters for fetching a filtered list of products.
+ */
+interface ProductsApiListParams extends BaseParams {
+  /**
+   * Random seed for consistent pagination
+   */
+  seed?: number;
+  /**
+   * Number of the page to retrieve
+   */
+  pageNumber?: number;
+  /**
+   * Number of products per page
+   */
+  pageSize?: number;
+  /**
+   * Filter products by category ID
+   */
+  categoryId?: number;
+  /**
+   * Criteria to sort products by
+   */
+  sortBy?: ProductSortKey;
+  /**
+   * Filter products by brand ID
+   */
+  brandIds?: number;
+  /**
+   * Minimum price filter
+   */
+  minPrice?: number;
+  /**
+   * Maximum price filter
+   */
+  maxPrice?: number;
+}
+//#endregion
+//#region src/api/products/api.d.ts
+/**
+ * API for retrieving product listings, details, and reviews.
+ */
+declare class ProductsApi {
+  private http;
+  /**
+   * Initializes a new instance of the ProductsApi.
+   *
+   * @param http HTTP client instance.
+   */
+  constructor(http: HttpClient);
+  /**
+   * Retrieves available sorting options for product lists.
+   *
+   * @example
+   * const sortOptions = await client.products.getSortOptions();
+   */
+  getSortOptions(params?: ProductsApiGetSortOptionsParams): Promise<ProductsApiGetSortOptionsResponse>;
+  /**
+   * Retrieves a list of products with optional filtering and pagination.
    *
    * @example
    * const products = await client.products.list({
@@ -2508,6 +2727,10 @@ declare class TeezClient {
    * API for retrieving collections.
    */
   readonly collections: CollectionsApi;
+  /**
+   * API for managing user favorites.
+   */
+  readonly favorites: FavoritesApi;
   /**
    * API for retrieving feature flags.
    */
@@ -2560,7 +2783,7 @@ interface TeezApiErrorOptions extends ErrorOptions {
   /**
    * URL of the request that failed.
    */
-  url: string;
+  url: URL;
   /**
    * HTTP status code.
    */
@@ -2579,6 +2802,10 @@ interface TeezApiErrorOptions extends ErrorOptions {
  */
 declare class TeezApiError extends TeezError {
   name: string;
+  /**
+   * URL of the request that failed.
+   */
+  readonly url: URL;
   /**
    * HTTP status code.
    */
@@ -2587,10 +2814,6 @@ declare class TeezApiError extends TeezError {
    * HTTP status text.
    */
   readonly statusText: string;
-  /**
-   * URL of the request that failed.
-   */
-  readonly url: string;
   /**
    * Response body, if available.
    */
@@ -2624,7 +2847,7 @@ interface TeezNetworkErrorOptions extends ErrorOptions {
   /**
    * URL of the request that failed.
    */
-  url: string;
+  url: URL;
 }
 /**
  * Error thrown when a network request fails (e.g., DNS resolution, connection refused).
@@ -2634,7 +2857,7 @@ declare class TeezNetworkError extends TeezError {
   /**
    * URL of the request that failed.
    */
-  readonly url: string;
+  readonly url: URL;
   constructor(message: string, {
     url,
     ...errorOptions
@@ -2649,7 +2872,7 @@ interface TeezTimeoutErrorOptions extends ErrorOptions {
   /**
    * URL of the request that timed out.
    */
-  url: string;
+  url: URL;
   /**
    * Timeout duration in milliseconds.
    */
@@ -2663,7 +2886,7 @@ declare class TeezTimeoutError extends TeezError {
   /**
    * URL of the request that timed out.
    */
-  readonly url: string;
+  readonly url: URL;
   /**
    * Timeout duration in milliseconds.
    */
@@ -3385,26 +3608,318 @@ declare const CollectionsApiGetResponseSchema: z.ZodMiniObject<{
   priority: z.ZodMiniNumber<number>;
 }, z.core.$strip>;
 //#endregion
-//#region src/api/feature-flags/schemas.d.ts
+//#region src/api/favorites/schemas.d.ts
 /**
- * Schema for a feature flag item.
+ * Schema for a product badge.
  */
-declare const FeatureFlagsApiItemSchema: z.ZodMiniObject<{
+declare const FavoritesApiBadgeSchema: z.ZodMiniObject<{
   /**
-   * Name of the feature flag
+   * Text label of the badge
    */
-  name: z.ZodMiniString<string>;
+  label: z.ZodMiniString<string>;
   /**
-   * Indicates if the feature flag is currently active
+   * Background color code
    */
-  isActive: z.ZodMiniBoolean<boolean>;
+  backgroundColor: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumber<number>>>;
+  /**
+   * Text color code
+   */
+  textColor: z.ZodMiniNumber<number>;
 }, z.core.$strip>;
 /**
- * Response schema for the list of feature flags.
+ * Type literal for stock availability type
  */
-declare const FeatureFlagsApiListResponseSchema: z.ZodMiniArray<z.ZodMiniObject<{
+declare const FavoritesStockAvailabilityTypeSchema: z.ZodMiniLiteral<"stock">;
+/**
+ * Schema for stock availability information.
+ */
+declare const FavoritesApiStockAvailabilitySchema: z.ZodMiniObject<{
   /**
-   * Name of the feature flag
+   * Type of stock status (known value: "stock")
+   */
+  type: z.ZodMiniLiteral<"stock">;
+  /**
+   * SVG icon representing stock status
+   */
+  svg: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+  /**
+   * Localized text describing stock status
+   */
+  text: z.ZodMiniString<string>;
+  /**
+   * Maximum quantity available
+   */
+  maxQty: z.ZodMiniNumber<number>;
+  /**
+   * Localized reason text for quantity limit
+   */
+  maxQtyReason: z.ZodMiniString<string>;
+}, z.core.$strip>;
+/**
+ * Schema for a favorited item (SKU).
+ */
+declare const FavoritesApiItemSchema: z.ZodMiniObject<{
+  /**
+   * Unique product identifier
+   */
+  productId: z.ZodMiniNumber<number>;
+  /**
+   * Unique stock keeping unit identifier
+   */
+  skuId: z.ZodMiniNumber<number>;
+  /**
+   * URL for the full-size image
+   */
+  imageUrl: z.ZodMiniString<string>;
+  /**
+   * Full display name of the product
+   */
+  name: z.ZodMiniString<string>;
+  /**
+   * Brief description of the product
+   */
+  shortDescription: z.ZodMiniString<string>;
+  /**
+   * URL for the small preview image
+   */
+  thumbnailUrl: z.ZodMiniString<string>;
+  /**
+   * Original price before discounts
+   */
+  originalPrice: z.ZodMiniNumber<number>;
+  /**
+   * Current selling price
+   */
+  price: z.ZodMiniNumber<number>;
+  /**
+   * Quantity available in stock
+   */
+  qty: z.ZodMiniNumber<number>;
+  /**
+   * Stock availability details
+   */
+  stockAvailability: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+    /**
+     * Type of stock status (known value: "stock")
+     */
+    type: z.ZodMiniLiteral<"stock">;
+    /**
+     * SVG icon representing stock status
+     */
+    svg: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+    /**
+     * Localized text describing stock status
+     */
+    text: z.ZodMiniString<string>;
+    /**
+     * Maximum quantity available
+     */
+    maxQty: z.ZodMiniNumber<number>;
+    /**
+     * Localized reason text for quantity limit
+     */
+    maxQtyReason: z.ZodMiniString<string>;
+  }, z.core.$strip>>>;
+  /**
+   * Indicates if the product is on promotion
+   */
+  isPromo: z.ZodMiniBoolean<boolean>;
+  /**
+   * Name of the promotion
+   */
+  promoName: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+  /**
+   * List of applicable promocodes
+   */
+  promocodes: z.ZodMiniArray<z.ZodMiniString<string>>;
+  /**
+   * Popularity text indicating purchase frequency
+   */
+  qtyPurchasedInfo: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+  /**
+   * Average rating score
+   */
+  rating: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumber<number>>>;
+  /**
+   * Total number of ratings
+   */
+  scoreQuantity: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumber<number>>>;
+  /**
+   * Badge information for the product
+   */
+  badge: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+    /**
+     * Text label of the badge
+     */
+    label: z.ZodMiniString<string>;
+    /**
+     * Background color code
+     */
+    backgroundColor: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumber<number>>>;
+    /**
+     * Text color code
+     */
+    textColor: z.ZodMiniNumber<number>;
+  }, z.core.$strip>>>;
+  /**
+   * Moderation status code
+   */
+  moderationStatus: z.ZodMiniNumber<number>;
+}, z.core.$strip>;
+/**
+ * Response schema for the favorites list.
+ */
+declare const FavoritesApiListResponseSchema: z.ZodMiniObject<{
+  /**
+   * List of favorited items
+   */
+  items: z.ZodMiniArray<z.ZodMiniObject<{
+    /**
+     * Unique product identifier
+     */
+    productId: z.ZodMiniNumber<number>;
+    /**
+     * Unique stock keeping unit identifier
+     */
+    skuId: z.ZodMiniNumber<number>;
+    /**
+     * URL for the full-size image
+     */
+    imageUrl: z.ZodMiniString<string>;
+    /**
+     * Full display name of the product
+     */
+    name: z.ZodMiniString<string>;
+    /**
+     * Brief description of the product
+     */
+    shortDescription: z.ZodMiniString<string>;
+    /**
+     * URL for the small preview image
+     */
+    thumbnailUrl: z.ZodMiniString<string>;
+    /**
+     * Original price before discounts
+     */
+    originalPrice: z.ZodMiniNumber<number>;
+    /**
+     * Current selling price
+     */
+    price: z.ZodMiniNumber<number>;
+    /**
+     * Quantity available in stock
+     */
+    qty: z.ZodMiniNumber<number>;
+    /**
+     * Stock availability details
+     */
+    stockAvailability: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+      /**
+       * Type of stock status (known value: "stock")
+       */
+      type: z.ZodMiniLiteral<"stock">;
+      /**
+       * SVG icon representing stock status
+       */
+      svg: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+      /**
+       * Localized text describing stock status
+       */
+      text: z.ZodMiniString<string>;
+      /**
+       * Maximum quantity available
+       */
+      maxQty: z.ZodMiniNumber<number>;
+      /**
+       * Localized reason text for quantity limit
+       */
+      maxQtyReason: z.ZodMiniString<string>;
+    }, z.core.$strip>>>;
+    /**
+     * Indicates if the product is on promotion
+     */
+    isPromo: z.ZodMiniBoolean<boolean>;
+    /**
+     * Name of the promotion
+     */
+    promoName: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+    /**
+     * List of applicable promocodes
+     */
+    promocodes: z.ZodMiniArray<z.ZodMiniString<string>>;
+    /**
+     * Popularity text indicating purchase frequency
+     */
+    qtyPurchasedInfo: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+    /**
+     * Average rating score
+     */
+    rating: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumber<number>>>;
+    /**
+     * Total number of ratings
+     */
+    scoreQuantity: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumber<number>>>;
+    /**
+     * Badge information for the product
+     */
+    badge: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+      /**
+       * Text label of the badge
+       */
+      label: z.ZodMiniString<string>;
+      /**
+       * Background color code
+       */
+      backgroundColor: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumber<number>>>;
+      /**
+       * Text color code
+       */
+      textColor: z.ZodMiniNumber<number>;
+    }, z.core.$strip>>>;
+    /**
+     * Moderation status code
+     */
+    moderationStatus: z.ZodMiniNumber<number>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Response schema for retrieving favorite SKU IDs.
+ */
+declare const FavoritesApiGetIdsResponseSchema: z.ZodMiniObject<{
+  /**
+   * List of favorited SKU IDs
+   */
+  skuIds: z.ZodMiniArray<z.ZodMiniNumber<number>>;
+}, z.core.$strip>;
+/**
+ * Response schema for adding a SKU to favorites.
+ */
+declare const FavoritesApiAddResponseSchema: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNull>>;
+/**
+ * Response schema for removing a SKU from favorites.
+ */
+declare const FavoritesApiRemoveResponseSchema: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNull>>;
+//#endregion
+//#region src/api/feature-flags/schemas.d.ts
+/**
+ * Schema for a feature flag item.
+ */
+declare const FeatureFlagsApiItemSchema: z.ZodMiniObject<{
+  /**
+   * Name of the feature flag
+   */
+  name: z.ZodMiniString<string>;
+  /**
+   * Indicates if the feature flag is currently active
+   */
+  isActive: z.ZodMiniBoolean<boolean>;
+}, z.core.$strip>;
+/**
+ * Response schema for the list of feature flags.
+ */
+declare const FeatureFlagsApiListResponseSchema: z.ZodMiniArray<z.ZodMiniObject<{
+  /**
+   * Name of the feature flag
    */
   name: z.ZodMiniString<string>;
   /**
@@ -3523,10 +4038,6 @@ declare const ProductsApiGetReviewsResponseSchema: z.ZodMiniObject<{
  * Schema for a product badge.
  */
 declare const ProductsApiBadgeSchema: z.ZodMiniObject<{
-  /**
-   * Background color code
-   */
-  backgroundColor: z.ZodMiniNumber<number>;
   /**
    * Text label of the badge
    */
@@ -3535,6 +4046,10 @@ declare const ProductsApiBadgeSchema: z.ZodMiniObject<{
    * Text color code
    */
   textColor: z.ZodMiniNumber<number>;
+  /**
+   * Background color code
+   */
+  backgroundColor: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumber<number>>>;
 }, z.core.$strip>;
 /**
  * Type literal for products stock availability type
@@ -3637,7 +4152,7 @@ declare const ProductsApiProductItemSchema: z.ZodMiniObject<{
   /**
    * Name of the promotion
    */
-  promoName: z.ZodMiniString<string>;
+  promoName: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
   /**
    * List of applicable promocodes
    */
@@ -3657,11 +4172,7 @@ declare const ProductsApiProductItemSchema: z.ZodMiniObject<{
   /**
    * Badge information for the product
    */
-  badge: z.ZodMiniObject<{
-    /**
-     * Background color code
-     */
-    backgroundColor: z.ZodMiniNumber<number>;
+  badge: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
     /**
      * Text label of the badge
      */
@@ -3670,7 +4181,11 @@ declare const ProductsApiProductItemSchema: z.ZodMiniObject<{
      * Text color code
      */
     textColor: z.ZodMiniNumber<number>;
-  }, z.core.$strip>;
+    /**
+     * Background color code
+     */
+    backgroundColor: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumber<number>>>;
+  }, z.core.$strip>>>;
   /**
    * Moderation status code
    */
@@ -3772,7 +4287,7 @@ declare const ProductsApiListResponseSchema: z.ZodMiniObject<{
     /**
      * Name of the promotion
      */
-    promoName: z.ZodMiniString<string>;
+    promoName: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
     /**
      * List of applicable promocodes
      */
@@ -3792,11 +4307,7 @@ declare const ProductsApiListResponseSchema: z.ZodMiniObject<{
     /**
      * Badge information for the product
      */
-    badge: z.ZodMiniObject<{
-      /**
-       * Background color code
-       */
-      backgroundColor: z.ZodMiniNumber<number>;
+    badge: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
       /**
        * Text label of the badge
        */
@@ -3805,7 +4316,11 @@ declare const ProductsApiListResponseSchema: z.ZodMiniObject<{
        * Text color code
        */
       textColor: z.ZodMiniNumber<number>;
-    }, z.core.$strip>;
+      /**
+       * Background color code
+       */
+      backgroundColor: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumber<number>>>;
+    }, z.core.$strip>>>;
     /**
      * Moderation status code
      */
@@ -5052,5 +5567,5 @@ declare const UsersApiUpdateLanguageResponseSchema: z.ZodMiniObject<{
  */
 declare const UsersApiRegisterDeviceResponseSchema: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNull>>;
 //#endregion
-export { AuthApi, AuthApiCheckTokenParams, AuthApiCheckTokenResponse, AuthApiCheckTokenResponseSchema, AuthApiLoginParams, AuthApiLoginResponse, AuthApiLoginResponseSchema, AuthApiVerifyParams, AuthApiVerifyResponse, AuthApiVerifyResponseSchema, BASE_URL, BannerActionTypes, BannerActionTypesSchema, BannerImageType, BannerImageTypeSchema, BannersApi, BannersApiAction, BannersApiActionSchema, BannersApiBannerItem, BannersApiBannerItemSchema, BannersApiImage, BannersApiImageSchema, BannersApiListParams, BannersApiListResponse, BannersApiListResponseSchema, BaseParams, CategoriesApi, CategoriesApiGetParams, CategoriesApiGetParentsParams, CategoriesApiGetParentsResponse, CategoriesApiGetParentsResponseItem, CategoriesApiGetParentsResponseItemSchema, CategoriesApiGetParentsResponseSchema, CategoriesApiGetResponse, CategoriesApiGetResponseSchema, CategoriesApiListParams, CategoriesApiListResponse, CategoriesApiListResponseItem, CategoriesApiListResponseItemSchema, CategoriesApiListResponseSchema, CollectionType, CollectionTypeSchema, CollectionsApi, CollectionsApiGetParams, CollectionsApiGetResponse, CollectionsApiGetResponseSchema, CollectionsApiGetSkusParams, CollectionsApiGetSkusResponse, CollectionsApiGetSkusResponseSchema, CollectionsApiListItem, CollectionsApiListItemSchema, CollectionsApiListParams, CollectionsApiListResponse, CollectionsApiListResponseSchema, CollectionsApiSkuItem, CollectionsApiSkuItemSchema, CollectionsApiStockAvailability, CollectionsApiStockAvailabilitySchema, CollectionsStockAvailabilityType, CollectionsStockAvailabilityTypeSchema, DEFAULT_APP_VERSION, DEFAULT_CONFIG, FeatureFlagsApi, FeatureFlagsApiItem, FeatureFlagsApiItemSchema, FeatureFlagsApiListParams, FeatureFlagsApiListResponse, FeatureFlagsApiListResponseSchema, LANGUAGES, Language, ProductSortKey, ProductSortKeySchema, ProductsApi, ProductsApiBadge, ProductsApiBadgeSchema, ProductsApiGetReviewsParams, ProductsApiGetReviewsResponse, ProductsApiGetReviewsResponseSchema, ProductsApiGetSortOptionsParams, ProductsApiGetSortOptionsResponse, ProductsApiGetSortOptionsResponseSchema, ProductsApiListParams, ProductsApiListResponse, ProductsApiListResponseSchema, ProductsApiProductItem, ProductsApiProductItemSchema, ProductsApiReviewItem, ProductsApiReviewItemSchema, ProductsApiSortOption, ProductsApiSortOptionSchema, ProductsApiStockAvailability, ProductsApiStockAvailabilitySchema, ProductsStockAvailabilityType, ProductsStockAvailabilityTypeSchema, PromoApi, PromoApiItem, PromoApiItemSchema, PromoApiListParams, PromoApiListResponse, PromoApiListResponseSchema, ResolvedTeezClientConfig, ShopsApi, ShopsApiContactInfo, ShopsApiContactInfoSchema, ShopsApiGetMonobrandParams, ShopsApiGetMonobrandResponse, ShopsApiGetMonobrandResponseSchema, ShopsApiGetParams, ShopsApiGetProductsParams, ShopsApiGetProductsResponse, ShopsApiGetProductsResponseSchema, ShopsApiGetResponse, ShopsApiGetResponseSchema, ShopsApiProductItem, ShopsApiProductItemSchema, ShopsApiShopItem, ShopsApiShopItemSchema, ShopsApiStockAvailability, ShopsApiStockAvailabilitySchema, ShopsApiTag, ShopsApiTagSchema, ShopsStockAvailabilityType, ShopsStockAvailabilityTypeSchema, SkuApi, SkuApiAttribute, SkuApiAttributeProperty, SkuApiAttributePropertySchema, SkuApiAttributePropertyValue, SkuApiAttributePropertyValueSchema, SkuApiAttributeSchema, SkuApiBrand, SkuApiBrandSchema, SkuApiCategory, SkuApiCategorySchema, SkuApiCollectionItem, SkuApiCollectionItemSchema, SkuApiGetCollectionsParams, SkuApiGetCollectionsResponse, SkuApiGetCollectionsResponseSchema, SkuApiGetParams, SkuApiGetResponse, SkuApiGetResponseSchema, SkuApiGetReviewAvailableParams, SkuApiGetReviewAvailableResponse, SkuApiGetReviewAvailableResponseSchema, SkuApiGetSimilarParams, SkuApiGetSimilarResponse, SkuApiGetSimilarResponseSchema, SkuApiInstallment, SkuApiInstallmentSchema, SkuApiShop, SkuApiShopSchema, SkuApiSimilarItem, SkuApiSimilarItemSchema, SkuApiStockAvailability, SkuApiStockAvailabilitySchema, SkuApiTag, SkuApiTagSchema, SkuStockAvailabilityType, SkuStockAvailabilityTypeSchema, TeezApiError, TeezApiErrorOptions, TeezClient, TeezClientConfig, TeezError, TeezNetworkError, TeezNetworkErrorOptions, TeezTimeoutError, TeezTimeoutErrorOptions, TeezValidationError, TeezValidationErrorOptions, TeezValidationIssue, UsersApi, UsersApiDeviceIdentity, UsersApiDeviceSdkInformation, UsersApiLanguageEnum, UsersApiLanguageEnumSchema, UsersApiRegisterDeviceParams, UsersApiRegisterDeviceResponse, UsersApiRegisterDeviceResponseSchema, UsersApiUpdateLanguageParams, UsersApiUpdateLanguageResponse, UsersApiUpdateLanguageResponseSchema, buildHeaders, buildUserAgent, resolveConfig };
+export { AuthApi, AuthApiCheckTokenParams, AuthApiCheckTokenResponse, AuthApiCheckTokenResponseSchema, AuthApiLoginParams, AuthApiLoginResponse, AuthApiLoginResponseSchema, AuthApiVerifyParams, AuthApiVerifyResponse, AuthApiVerifyResponseSchema, BASE_URL, BannerActionTypes, BannerActionTypesSchema, BannerImageType, BannerImageTypeSchema, BannersApi, BannersApiAction, BannersApiActionSchema, BannersApiBannerItem, BannersApiBannerItemSchema, BannersApiImage, BannersApiImageSchema, BannersApiListParams, BannersApiListResponse, BannersApiListResponseSchema, BaseParams, CategoriesApi, CategoriesApiGetParams, CategoriesApiGetParentsParams, CategoriesApiGetParentsResponse, CategoriesApiGetParentsResponseItem, CategoriesApiGetParentsResponseItemSchema, CategoriesApiGetParentsResponseSchema, CategoriesApiGetResponse, CategoriesApiGetResponseSchema, CategoriesApiListParams, CategoriesApiListResponse, CategoriesApiListResponseItem, CategoriesApiListResponseItemSchema, CategoriesApiListResponseSchema, CollectionType, CollectionTypeSchema, CollectionsApi, CollectionsApiGetParams, CollectionsApiGetResponse, CollectionsApiGetResponseSchema, CollectionsApiGetSkusParams, CollectionsApiGetSkusResponse, CollectionsApiGetSkusResponseSchema, CollectionsApiListItem, CollectionsApiListItemSchema, CollectionsApiListParams, CollectionsApiListResponse, CollectionsApiListResponseSchema, CollectionsApiSkuItem, CollectionsApiSkuItemSchema, CollectionsApiStockAvailability, CollectionsApiStockAvailabilitySchema, CollectionsStockAvailabilityType, CollectionsStockAvailabilityTypeSchema, DEFAULT_APP_VERSION, DEFAULT_CONFIG, FavoritesApi, FavoritesApiAddParams, FavoritesApiAddResponse, FavoritesApiAddResponseSchema, FavoritesApiBadge, FavoritesApiBadgeSchema, FavoritesApiGetIdsParams, FavoritesApiGetIdsResponse, FavoritesApiGetIdsResponseSchema, FavoritesApiItem, FavoritesApiItemSchema, FavoritesApiListParams, FavoritesApiListResponse, FavoritesApiListResponseSchema, FavoritesApiRemoveParams, FavoritesApiRemoveResponse, FavoritesApiRemoveResponseSchema, FavoritesApiStockAvailability, FavoritesApiStockAvailabilitySchema, FavoritesStockAvailabilityType, FavoritesStockAvailabilityTypeSchema, FeatureFlagsApi, FeatureFlagsApiItem, FeatureFlagsApiItemSchema, FeatureFlagsApiListParams, FeatureFlagsApiListResponse, FeatureFlagsApiListResponseSchema, LANGUAGES, Language, ProductSortKey, ProductSortKeySchema, ProductsApi, ProductsApiBadge, ProductsApiBadgeSchema, ProductsApiGetReviewsParams, ProductsApiGetReviewsResponse, ProductsApiGetReviewsResponseSchema, ProductsApiGetSortOptionsParams, ProductsApiGetSortOptionsResponse, ProductsApiGetSortOptionsResponseSchema, ProductsApiListParams, ProductsApiListResponse, ProductsApiListResponseSchema, ProductsApiProductItem, ProductsApiProductItemSchema, ProductsApiReviewItem, ProductsApiReviewItemSchema, ProductsApiSortOption, ProductsApiSortOptionSchema, ProductsApiStockAvailability, ProductsApiStockAvailabilitySchema, ProductsStockAvailabilityType, ProductsStockAvailabilityTypeSchema, PromoApi, PromoApiItem, PromoApiItemSchema, PromoApiListParams, PromoApiListResponse, PromoApiListResponseSchema, ResolvedTeezClientConfig, ShopsApi, ShopsApiContactInfo, ShopsApiContactInfoSchema, ShopsApiGetMonobrandParams, ShopsApiGetMonobrandResponse, ShopsApiGetMonobrandResponseSchema, ShopsApiGetParams, ShopsApiGetProductsParams, ShopsApiGetProductsResponse, ShopsApiGetProductsResponseSchema, ShopsApiGetResponse, ShopsApiGetResponseSchema, ShopsApiProductItem, ShopsApiProductItemSchema, ShopsApiShopItem, ShopsApiShopItemSchema, ShopsApiStockAvailability, ShopsApiStockAvailabilitySchema, ShopsApiTag, ShopsApiTagSchema, ShopsStockAvailabilityType, ShopsStockAvailabilityTypeSchema, SkuApi, SkuApiAttribute, SkuApiAttributeProperty, SkuApiAttributePropertySchema, SkuApiAttributePropertyValue, SkuApiAttributePropertyValueSchema, SkuApiAttributeSchema, SkuApiBrand, SkuApiBrandSchema, SkuApiCategory, SkuApiCategorySchema, SkuApiCollectionItem, SkuApiCollectionItemSchema, SkuApiGetCollectionsParams, SkuApiGetCollectionsResponse, SkuApiGetCollectionsResponseSchema, SkuApiGetParams, SkuApiGetResponse, SkuApiGetResponseSchema, SkuApiGetReviewAvailableParams, SkuApiGetReviewAvailableResponse, SkuApiGetReviewAvailableResponseSchema, SkuApiGetSimilarParams, SkuApiGetSimilarResponse, SkuApiGetSimilarResponseSchema, SkuApiInstallment, SkuApiInstallmentSchema, SkuApiShop, SkuApiShopSchema, SkuApiSimilarItem, SkuApiSimilarItemSchema, SkuApiStockAvailability, SkuApiStockAvailabilitySchema, SkuApiTag, SkuApiTagSchema, SkuStockAvailabilityType, SkuStockAvailabilityTypeSchema, TeezApiError, TeezApiErrorOptions, TeezClient, TeezClientConfig, TeezError, TeezNetworkError, TeezNetworkErrorOptions, TeezTimeoutError, TeezTimeoutErrorOptions, TeezValidationError, TeezValidationErrorOptions, TeezValidationIssue, UsersApi, UsersApiDeviceIdentity, UsersApiDeviceSdkInformation, UsersApiLanguageEnum, UsersApiLanguageEnumSchema, UsersApiRegisterDeviceParams, UsersApiRegisterDeviceResponse, UsersApiRegisterDeviceResponseSchema, UsersApiUpdateLanguageParams, UsersApiUpdateLanguageResponse, UsersApiUpdateLanguageResponseSchema, buildHeaders, buildUserAgent, resolveConfig };
 //# sourceMappingURL=index.d.mts.map