@wix/auto_sdk_suppliers-hub_products 1.0.0

package/build/cjs/suppliershub-marketplace-product-v1-product-products.universal-DInaBID7.d.ts

@@ -0,0 +1,2721 @@
+import * as _wix_sdk_types from '@wix/sdk-types';
+import { QuerySpec, SearchSpec, Query, Search, NonNullablePaths } from '@wix/sdk-types';
+
+/**
+ * A product provided by a business partner and displayed in the Wix Marketplace.
+ *
+ * Products can be of type DROPSHIPPING, WHOLESALE, or both.
+ * Wix users can discover and add these products to their stores.
+ */
+interface Product {
+    /**
+     * Product ID.
+     * @format GUID
+     * @readonly
+     */
+    _id?: string | null;
+    /**
+     * Date and time the product was created.
+     * @readonly
+     */
+    _createdDate?: Date | null;
+    /**
+     * Date and time the product was updated.
+     * @readonly
+     */
+    _updatedDate?: Date | null;
+    /** Information about the business partner providing this product. */
+    providerInfo?: ProviderInfo;
+    /**
+     * Product name.
+     * @minLength 1
+     * @maxLength 100
+     */
+    name?: string | null;
+    /**
+     * Product description.
+     * @maxLength 64000
+     */
+    description?: string | null;
+    /**
+     * Whether the product is visible in the Marketplace.
+     *
+     * Default: `true`
+     */
+    visible?: boolean | null;
+    /** Product media. */
+    media?: Media;
+    /**
+     * Business model types this product supports.
+     * @minSize 1
+     * @maxSize 2
+     */
+    types?: ProductTypeWithLiterals[];
+    /**
+     * Product options that customers can choose from.
+     *
+     * Options display available product variations like size and color to help buyers make purchase decisions.
+     * Currently, options are informational only and don't create separate inventory items or variants.
+     *
+     * There are 2 predefined option types you can use:
+     * - `color`: Color choices for the product. Values should be standard color names. For example, `"Black"`, `"White"`, `"Yellow"`.
+     * - `size`: Size choices for the product. Values should be standard size labels. For example, `"S"`, `"M"`, `"L"`, `"XL"`.
+     * @maxSize 6
+     */
+    options?: ProductOption[];
+    /**
+     * Promotional ribbon text displayed on the product.
+     *
+     * For example, `"New Arrival"` or `"Bestseller"`.
+     * @minLength 1
+     * @maxLength 30
+     */
+    ribbonName?: string | null;
+    /**
+     * Brand name.
+     * @minLength 1
+     * @maxLength 50
+     */
+    brand?: string | null;
+    /** Time required to process orders before shipping. */
+    orderProcessingTime?: TimeInterval;
+    /**
+     * Countries and regions where this product can be shipped, with location-specific pricing and timing.
+     * @maxSize 100
+     */
+    shippingDestinations?: ShippingDestination[];
+    /**
+     * Minimum price, in USD.
+     * @decimalValue options { gte:0, lte:999999999, maxScale:2 }
+     */
+    minimumPrice?: string | null;
+    /**
+     * Country where the product is manufactured or originates from, in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
+     * @format COUNTRY
+     */
+    productOrigin?: string | null;
+    /**
+     * List of categories that directly contain this product.
+     *
+     * Each category's namespace must match at least one of the product's types.
+     * For example, if a product has type `DROPSHIPPING`, its categories must use `DROPSHIPPING_NAMESPACE`.
+     * Products with both `DROPSHIPPING` and `WHOLESALE` types can have categories from both namespaces.
+     * @maxSize 50
+     */
+    directCategories?: ProductCategory[];
+    /**
+     * List of categories that directly contain this product, as well as their parent categories.
+     * @readonly
+     * @maxSize 2000
+     */
+    allCategories?: ProductCategory[];
+    /**
+     * Wholesale-specific configuration including tiered pricing and minimum order quantities.
+     *
+     * Required when `types` includes `WHOLESALE`.
+     */
+    wholesaleOptions?: WholesaleOptions;
+    /** Information about the supplier including name, rating, and trust status. */
+    supplierInfo?: SupplierInfo;
+    /**
+     * Print-on-demand-specific configuration including supported print technologies and mockup assets.
+     *
+     * Required when `types` include `PRINT_ON_DEMAND`.
+     */
+    printOnDemandOptions?: PrintOnDemandOptions;
+    /**
+     * Information about the product sizing
+     * @maxSize 5
+     */
+    sizeGuides?: SizeGuide[];
+    /** Product tags for organization and filtering. */
+    tags?: Tags;
+}
+/**
+ * Information about the business partner providing the product.
+ *
+ * Provider information is immutable after product creation.
+ */
+interface ProviderInfo {
+    /**
+     * Provider application ID.
+     * @format GUID
+     * @readonly
+     */
+    appId?: string | null;
+    /**
+     * Unique product identifier on the provider's platform.
+     *
+     * This field serves as the external system's primary key for synchronization and prevents
+     * duplicate products from being created. Once set, you can't change this field.
+     * @minLength 1
+     * @maxLength 36
+     * @immutable
+     */
+    productId?: string | null;
+    /**
+     * Date and time the product was created on the provider's platform.
+     *
+     * This field helps maintain the connection to the original product source.
+     * Once set, you can't change this field.
+     * @immutable
+     */
+    productCreatedDate?: Date | null;
+    /**
+     * Product URL on the provider's platform.
+     * @format WEB_URL
+     */
+    url?: string | null;
+}
+/**
+ * Product media.
+ *
+ * The first image in the `items` array becomes the main image.
+ */
+interface Media {
+    /**
+     * Primary product image, automatically set from the first item in the `items` array.
+     * @readonly
+     */
+    main?: string;
+    /**
+     * Product images. The first image becomes the main image.
+     * @maxSize 15
+     */
+    items?: string[];
+}
+interface FocalPoint {
+    /** X-coordinate of the focal point. */
+    x?: number;
+    /** Y-coordinate of the focal point. */
+    y?: number;
+    /** crop by height */
+    height?: number | null;
+    /** crop by width */
+    width?: number | null;
+}
+/** Business model types that products can support. */
+declare enum ProductType {
+    /** Product is fulfilled by the supplier without inventory management by the store owner. */
+    DROPSHIPPING = "DROPSHIPPING",
+    /** Product is sold in bulk quantities with tiered pricing. */
+    WHOLESALE = "WHOLESALE",
+    /** Product is manufactured after purchase; no pre‑held inventory. */
+    PRINT_ON_DEMAND = "PRINT_ON_DEMAND"
+}
+/** @enumType */
+type ProductTypeWithLiterals = ProductType | 'DROPSHIPPING' | 'WHOLESALE' | 'PRINT_ON_DEMAND';
+/**
+ * Product option like size, color, or material.
+ *
+ * Each option can have multiple values that customers can choose from.
+ */
+interface ProductOption {
+    /**
+     * Option name.
+     *
+     * There are 2 predefined options you can use:
+     * - `color`: Represents color choices for the product. Values should be standard color names. For example, `"Black"`, `"White"`, `"Yellow"`.
+     * - `size`: Represents size choices for the product. Values should be standard size labels. For example, `"S"`, `"M"`, `"L"`, `"XL"`.
+     * @minLength 1
+     * @maxLength 50
+     */
+    name?: string;
+    /**
+     * Optional description explaining the option.
+     * @maxLength 200
+     */
+    description?: string | null;
+    /**
+     * Available values for this option.
+     * @maxSize 100
+     */
+    values?: OptionValue[];
+}
+/** A single value for a product option. */
+interface OptionValue extends OptionValueValueOneOf {
+    /**
+     * Simple text value.
+     *
+     * For example, `"L"` for size or `"Cotton"` for material.
+     * @minLength 1
+     * @maxLength 50
+     */
+    simpleValue?: string;
+    /** Color option with name and hex code. */
+    color?: ColorOption;
+}
+/** @oneof */
+interface OptionValueValueOneOf {
+    /**
+     * Simple text value.
+     *
+     * For example, `"L"` for size or `"Cotton"` for material.
+     * @minLength 1
+     * @maxLength 50
+     */
+    simpleValue?: string;
+    /** Color option with name and hex code. */
+    color?: ColorOption;
+}
+/** Color option with display name and hex color code. */
+interface ColorOption {
+    /**
+     * Color name.
+     *
+     * For example, `"Black"` or `"Navy Blue"`.
+     * Use 'Multicolor' for mixed colors. When using 'Multicolor', do not provide a hex value.
+     * @minLength 1
+     * @maxLength 50
+     */
+    name?: string;
+    /**
+     * Hex color code.
+     *
+     * For example, `"#000000"` for black. Omit for 'Multicolor'.
+     * @format COLOR_HEX
+     */
+    hex?: string | null;
+}
+/**
+ * Time range with minimum and maximum values.
+ *
+ * Used for processing times, shipping times, and other duration ranges.
+ */
+interface TimeInterval {
+    /** Minimum time in the range. */
+    min?: TimeValue;
+    /** Maximum time in the range. */
+    max?: TimeValue;
+}
+/** Time duration with numeric value and unit. */
+interface TimeValue {
+    /**
+     * Numeric time value. For example, `2` for "2 days".
+     * @min 1
+     */
+    value?: number;
+    /** Time unit for the value. */
+    unit?: TimeUnitWithLiterals;
+}
+/** Units of time for duration values. */
+declare enum TimeUnit {
+    /** Days. */
+    DAY = "DAY",
+    /** Weeks. */
+    WEEK = "WEEK",
+    /** Months. */
+    MONTH = "MONTH"
+}
+/** @enumType */
+type TimeUnitWithLiterals = TimeUnit | 'DAY' | 'WEEK' | 'MONTH';
+/**
+ * Shipping information for a specific destination or region.
+ *
+ * Defines where a product can be shipped and the associated costs and timing.
+ */
+interface ShippingDestination extends ShippingDestinationCountriesOptionsOneOf {
+    /**
+     * Specific countries.
+     *
+     * Used when `countrySelections` is `SPECIFIC_COUNTRY`.
+     */
+    specificCountrySelections?: Countries;
+    /** Indicates if shipping applies to selected countries or to all other regions. */
+    countrySelections?: CountrySelectionsWithLiterals;
+    /**
+     * Minimum shipping cost to this destination in USD.
+     * @decimalValue options { gte:0, lte:999999999, maxScale:3 }
+     */
+    minimumShippingCost?: string;
+    /** Expected shipping time to this destination. */
+    shippingTime?: TimeInterval;
+    /**
+     * Minimum Product Cost to the Shipping Location
+     * @decimalValue options { gte:0, lte:999999999, maxScale:3 }
+     */
+    minimumProductCost?: string | null;
+}
+/** @oneof */
+interface ShippingDestinationCountriesOptionsOneOf {
+    /**
+     * Specific countries.
+     *
+     * Used when `countrySelections` is `SPECIFIC_COUNTRY`.
+     */
+    specificCountrySelections?: Countries;
+}
+/** Shipping destination selection type. */
+declare enum CountrySelections {
+    /** All countries not specifically listed elsewhere. */
+    REST_OF_THE_WORLD = "REST_OF_THE_WORLD",
+    /** Specific countries listed in the `countries` field. */
+    SPECIFIC_COUNTRY = "SPECIFIC_COUNTRY"
+}
+/** @enumType */
+type CountrySelectionsWithLiterals = CountrySelections | 'REST_OF_THE_WORLD' | 'SPECIFIC_COUNTRY';
+interface Countries {
+    /**
+     * Country codes, in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1) format.
+     * @format COUNTRY
+     * @minSize 1
+     * @maxSize 100
+     */
+    countries?: string[] | null;
+}
+/** Inventory information for a product including count tier and quantity. */
+interface Inventory {
+    /**
+     * Abstracted inventory level calculated from quantity.
+     * @readonly
+     */
+    tier?: InventoryTierWithLiterals;
+    /**
+     * Exact inventory quantity.
+     *
+     * Always returned when tier is `LOW` for [Get Product](https://dev.wix.com/docs/api-reference/business-solutions/suppliers-hub/products/get-product).
+     * Returned as request parameter when tier is not `LOW` for [Get Product](https://dev.wix.com/docs/api-reference/business-solutions/suppliers-hub/products/get-product).
+     * Not returned for [Search Products](https://dev.wix.com/docs/api-reference/business-solutions/suppliers-hub/products/search-products).
+     */
+    quantity?: number | null;
+}
+/** Abstracted inventory levels. */
+declare enum InventoryTier {
+    /** No inventory available. */
+    EMPTY = "EMPTY",
+    /** Low inventory level. */
+    LOW = "LOW",
+    /** Medium inventory level. */
+    MEDIUM = "MEDIUM",
+    /** High inventory level. */
+    HIGH = "HIGH"
+}
+/** @enumType */
+type InventoryTierWithLiterals = InventoryTier | 'EMPTY' | 'LOW' | 'MEDIUM' | 'HIGH';
+/** Category assignment information for a product. */
+interface ProductCategory {
+    /**
+     * Category ID.
+     * @format GUID
+     */
+    _id?: string;
+    /**
+     * Product's position within this category.
+     * @max 200
+     * @readonly
+     */
+    index?: number | null;
+    /** The namespace of the category tree this assignment belongs to. */
+    namespace?: CategoryNamespaceWithLiterals;
+}
+/** Defines the available category trees namespaces. */
+declare enum CategoryNamespace {
+    /** Namespace for the dropshipping category tree. */
+    DROPSHIPPING_NAMESPACE = "DROPSHIPPING_NAMESPACE",
+    /** Namespace for the wholesale category tree. */
+    WHOLESALE_NAMESPACE = "WHOLESALE_NAMESPACE",
+    /** Namespace for the print on demand category tree. */
+    PRINT_ON_DEMAND_NAMESPACE = "PRINT_ON_DEMAND_NAMESPACE"
+}
+/** @enumType */
+type CategoryNamespaceWithLiterals = CategoryNamespace | 'DROPSHIPPING_NAMESPACE' | 'WHOLESALE_NAMESPACE' | 'PRINT_ON_DEMAND_NAMESPACE';
+/**
+ * Configuration for wholesale products including tiered pricing.
+ *
+ * Required when product types include `WHOLESALE`.
+ */
+interface WholesaleOptions {
+    /**
+     * Tiered pricing based on order quantity ranges.
+     *
+     * Price tiers must be continuous with no gaps in quantity ranges.
+     * For example, if tier 1 covers quantities 1-100, tier 2 must start at 101.
+     * The system validates tier continuity when creating or updating products.
+     * @maxSize 5
+     */
+    priceTiers?: PriceTier[];
+    /**
+     * Minimum quantity required for wholesale orders.
+     * @min 1
+     */
+    minimumOrderQuantity?: number | null;
+}
+/**
+ * Price tier with quantity range and corresponding pricing.
+ *
+ * Defines pricing for a specific quantity range in wholesale orders.
+ */
+interface PriceTier {
+    /**
+     * Minimum price for this quantity tier in USD.
+     *
+     * If `priceTo` isn't specified, this price applies to all quantities in the tier.
+     * @decimalValue options { gte:0, lte:999999999, maxScale:3 }
+     */
+    priceFrom?: string;
+    /**
+     * Maximum price for this quantity tier in USD.
+     *
+     * Optional for fixed-price tiers.
+     * @decimalValue options { gte:0, lte:999999999, maxScale:3 }
+     */
+    priceTo?: string | null;
+    /**
+     * Minimum quantity for this price tier, inclusive.
+     * @min 1
+     */
+    countFrom?: number | null;
+    /**
+     * Maximum quantity for this price tier, inclusive.
+     *
+     * If not specified, this tier applies to all quantities greater or equal to `countFrom`.
+     * @min 1
+     */
+    countTo?: number | null;
+}
+interface SupplierInfo {
+    /**
+     * Supplier ID.
+     *
+     * When provided, references a supplier in the Marketplace Supplier service.
+     * The system automatically retrieves and populates the supplier's name, rating, and verification status.
+     * @format GUID
+     */
+    _id?: string | null;
+    /**
+     * Supplier name.
+     *
+     * Automatically populated from the Supplier service when `id` is provided.
+     * @minLength 1
+     * @maxLength 200
+     * @readonly
+     */
+    name?: string | null;
+    /**
+     * Supplier rating from 1.00 to 5.00.
+     *
+     * Automatically populated from the Supplier service when `id` is provided.
+     * @decimalValue options { gte:1, lte:5, maxScale:2 }
+     * @readonly
+     */
+    rating?: string | null;
+    /**
+     * Whether the supplier has been verified by the Marketplace.
+     *
+     * Verified suppliers have completed the Marketplace verification process.
+     * Automatically populated from the Supplier service when `id` is provided.
+     *
+     * Default: `false`
+     * @readonly
+     */
+    verified?: boolean;
+}
+interface PrintOnDemandOptions {
+    /**
+     * Set of possible print technologies for the Product
+     * @minSize 1
+     * @maxSize 3
+     */
+    printTechnologies?: PrintTechnologyWithLiterals[];
+    /**
+     * Mockup image of the product with 'Your Image Here' text.
+     * @readonly
+     */
+    mockupImage?: string;
+}
+declare enum PrintTechnology {
+    /** Transfers printed on film and heat-pressed onto fabric. */
+    DIRECT_TO_FILM = "DIRECT_TO_FILM",
+    /** Ink directly onto garment. */
+    DIRECT_TO_GARMENT = "DIRECT_TO_GARMENT",
+    /** Panels are printed first, then sewn. All‑over coverage with precise placements. */
+    CUT_SEW_SUBLIMATION = "CUT_SEW_SUBLIMATION",
+    /** Non‑DTG digital methods (e.g., roll‑to‑roll). */
+    DIGITAL_PRINTING = "DIGITAL_PRINTING",
+    /** Stitched threads, premium look. */
+    EMBROIDERY = "EMBROIDERY",
+    /** Dye infused into polyester/poly‑coated substrates. */
+    SUBLIMATION = "SUBLIMATION",
+    /** Cures ink with UV light on rigid or treated surfaces. */
+    UV_PRINTING = "UV_PRINTING",
+    /** Pattern/design is knitted, not printed. */
+    KNITWEAR = "KNITWEAR",
+    /** Designs are printed directly onto rolls of fabric, which are then cut and sewn into the final product. */
+    DIRECT_TO_FABRIC = "DIRECT_TO_FABRIC"
+}
+/** @enumType */
+type PrintTechnologyWithLiterals = PrintTechnology | 'DIRECT_TO_FILM' | 'DIRECT_TO_GARMENT' | 'CUT_SEW_SUBLIMATION' | 'DIGITAL_PRINTING' | 'EMBROIDERY' | 'SUBLIMATION' | 'UV_PRINTING' | 'KNITWEAR' | 'DIRECT_TO_FABRIC';
+interface SizeGuide {
+    /** Sizes units (inches or cm) */
+    measurementUnit?: MeasurementUnitWithLiterals;
+    /**
+     * Text description of the size guide
+     * @maxLength 8000
+     */
+    description?: string | null;
+    /**
+     * Image for the size guide
+     * @format WEB_URL
+     */
+    imageUrl?: string | null;
+    /**
+     * Text description of the image content
+     * @maxLength 8000
+     */
+    imageDescription?: string | null;
+    /**
+     * Sizes specifications
+     * @maxSize 10
+     */
+    specifications?: Specification[];
+}
+declare enum MeasurementUnit {
+    CM = "CM",
+    INCHES = "INCHES"
+}
+/** @enumType */
+type MeasurementUnitWithLiterals = MeasurementUnit | 'CM' | 'INCHES';
+interface Specification {
+    /**
+     * What is measured, e.g. chest, waist, sleeve
+     * @maxLength 50
+     */
+    category?: string;
+    /**
+     * Measurements for different sizes
+     * @minSize 1
+     * @maxSize 50
+     */
+    measurements?: Measurement[];
+}
+interface Measurement extends MeasurementValueOneOf {
+    /**
+     * The value of the size in case of single value
+     * @minLength 1
+     * @maxLength 50
+     */
+    singleValue?: string;
+    /** The value of the size in case of range (min/max) */
+    range?: MeasurementValueRange;
+    /**
+     * Product size, e.g. S, M, L
+     * @maxLength 50
+     */
+    sizeLabel?: string;
+}
+/** @oneof */
+interface MeasurementValueOneOf {
+    /**
+     * The value of the size in case of single value
+     * @minLength 1
+     * @maxLength 50
+     */
+    singleValue?: string;
+    /** The value of the size in case of range (min/max) */
+    range?: MeasurementValueRange;
+}
+interface MeasurementValueRange {
+    /**
+     * Minimum value
+     * @minLength 1
+     * @maxLength 50
+     */
+    minimum?: string;
+    /**
+     * Maximum value
+     * @minLength 1
+     * @maxLength 50
+     */
+    maximum?: string;
+}
+/**
+ * Common object for tags.
+ * Should be use as in this example:
+ * message Foo {
+ * option (.wix.api.decomposite_of) = "wix.commons.v2.tags.Foo";
+ * string id = 1;
+ * ...
+ * Tags tags = 5
+ * }
+ *
+ * example of taggable entity
+ * {
+ * id: "123"
+ * tags: {
+ * public_tags: {
+ * tag_ids:["11","22"]
+ * },
+ * private_tags: {
+ * tag_ids: ["33", "44"]
+ * }
+ * }
+ * }
+ */
+interface Tags {
+    /** Tags that require an additional permission in order to access them, normally not given to site members or visitors. */
+    privateTags?: TagList;
+    /** Tags that are exposed to anyone who has access to the labeled entity itself, including site members and visitors. */
+    publicTags?: TagList;
+}
+interface TagList {
+    /**
+     * List of tag IDs.
+     * @maxSize 100
+     * @maxLength 5
+     */
+    tagIds?: string[];
+}
+/**
+ * Event payload for product tag modifications.
+ *
+ * Triggered when product tags are updated via bulk tag operations.
+ */
+interface TagsModified {
+    /** Product with updated tags. */
+    product?: Product;
+    /** Tags that were added to the product. */
+    assignedTags?: Tags;
+    /** Tags that were removed from the product. */
+    unassignedTags?: Tags;
+}
+interface CreateProductRequest {
+    /** Product to create. Must include all required fields for the specified product types. */
+    product: Product;
+}
+interface CreateProductResponse {
+    /** Created product with assigned ID and read-only fields populated. */
+    product?: Product;
+}
+interface GetProductRequest {
+    /**
+     * Product ID.
+     * @format GUID
+     */
+    productId: string;
+}
+/** Additional fields that can be requested in API responses. */
+declare enum RequestedField {
+    /** Include exact inventory quantity in the response. */
+    INVENTORY_QUANTITY = "INVENTORY_QUANTITY"
+}
+/** @enumType */
+type RequestedFieldWithLiterals = RequestedField | 'INVENTORY_QUANTITY';
+interface GetProductResponse {
+    /** Retrieved product. */
+    product?: Product;
+}
+interface UpdateProductRequest {
+    /** Product to update. May be partial - only fields to be updated need to be provided. */
+    product: Product;
+}
+interface UpdateProductResponse {
+    /** Updated product. */
+    product?: Product;
+}
+interface DeleteProductRequest {
+    /**
+     * Product ID.
+     * @format GUID
+     */
+    productId: string;
+}
+interface DeleteProductResponse {
+}
+interface BulkCreateProductsRequest {
+    /**
+     * Products to create. Each must include all required fields for the specified product types.
+     * @minSize 1
+     * @maxSize 100
+     */
+    products: Product[];
+    /**
+     * Whether to return the created products in the response.
+     *
+     * Default: `false`
+     */
+    returnEntity?: boolean;
+}
+interface BulkCreateProductsResponse {
+    /**
+     * Results of the bulk create operation, one per input product.
+     * @minSize 1
+     * @maxSize 100
+     */
+    results?: BulkProductResult[];
+    /** Metadata about the bulk operation including success and failure counts. */
+    bulkActionMetadata?: BulkActionMetadata;
+}
+interface ItemMetadata {
+    /**
+     * Item ID. Should always be available, unless it's impossible. For example, when failing to create an item.
+     * @format GUID
+     */
+    _id?: string | null;
+    /** Index of the item within the request array. Allows for correlation between request and response items. */
+    originalIndex?: number;
+    /** Whether the requested action was successful for this item. When `false`, the `error` field is populated. */
+    success?: boolean;
+    /** Details about the error in case of failure. */
+    error?: ApplicationError;
+}
+interface ApplicationError {
+    /** Error code. */
+    code?: string;
+    /** Description of the error. */
+    description?: string;
+    /** Data related to the error. */
+    data?: Record<string, any> | null;
+}
+interface BulkProductResult {
+    /** Metadata regarding the specific single create operation */
+    itemMetadata?: ItemMetadata;
+    /** Only exists if `returnEntity` was set to true in the request */
+    item?: Product;
+}
+interface BulkActionMetadata {
+    /** Number of items that were successfully processed. */
+    totalSuccesses?: number;
+    /** Number of items that couldn't be processed. */
+    totalFailures?: number;
+    /** Number of failures without details because detailed failure threshold was exceeded. */
+    undetailedFailures?: number;
+}
+interface BulkUpdateProductsRequest {
+    /**
+     * Products to update. Each can be partial based on its field mask.
+     * @minSize 1
+     * @maxSize 100
+     */
+    products: MaskedProduct[];
+    /**
+     * Whether to return the updated products in the response.
+     *
+     * Default: `false`
+     */
+    returnEntity?: boolean;
+}
+interface MaskedProduct {
+    /** Product to update. May be partial - only fields to be updated need to be provided. */
+    product?: Product;
+}
+interface BulkUpdateProductsResponse {
+    /**
+     * Results
+     * @minSize 1
+     * @maxSize 100
+     */
+    results?: BulkUpdateProductsResponseBulkProductResult[];
+    /** Metadata regarding the bulk update operation */
+    bulkActionMetadata?: BulkActionMetadata;
+}
+interface BulkUpdateProductsResponseBulkProductResult {
+    /** Metadata regarding the specific single update operation */
+    itemMetadata?: ItemMetadata;
+    /** Only exists if `returnEntity` was set to true in the request */
+    item?: Product;
+}
+interface BulkDeleteProductsRequest {
+    /**
+     * Product IDs to delete.
+     * @minSize 1
+     * @maxSize 100
+     * @format GUID
+     */
+    productIds: string[];
+}
+interface BulkDeleteProductsResponse {
+    /**
+     * Results
+     * @minSize 1
+     * @maxSize 100
+     */
+    results?: BulkDeleteProductsResponseBulkProductResult[];
+    /** Metadata regarding the bulk delete operation */
+    bulkActionMetadata?: BulkActionMetadata;
+}
+interface BulkDeleteProductsResponseBulkProductResult {
+    /** Metadata regarding the specific single delete operation */
+    itemMetadata?: ItemMetadata;
+}
+interface QueryProductsRequest {
+    /** Query parameters including filter, sort, and paging options. */
+    query?: CommonCursorQuery;
+}
+interface CommonCursorQuery extends CommonCursorQueryPagingMethodOneOf {
+    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    cursorPaging?: CommonCursorPaging;
+    /**
+     * Filter object in the following format:
+     * `"filter" : {
+     * "fieldName1": "value1",
+     * "fieldName2":{"$operator":"value2"}
+     * }`
+     * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
+     */
+    filter?: Record<string, any> | null;
+    /**
+     * Sort object in the following format:
+     * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
+     * @maxSize 5
+     */
+    sort?: CommonSorting[];
+}
+/** @oneof */
+interface CommonCursorQueryPagingMethodOneOf {
+    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    cursorPaging?: CommonCursorPaging;
+}
+interface CommonSorting {
+    /**
+     * Name of the field to sort by.
+     * @maxLength 512
+     */
+    fieldName?: string;
+    /** Sort order. */
+    order?: CommonSortOrderWithLiterals;
+    /**
+     * Filters to specify which element to use for sorting when `fieldName` refers to a repeated field marked as `MATCH_ITEMS`.
+     *
+     * These filters ensure the correct element is selected from the collection for sorting. Multiple filters are combined using the `AND` operator.
+     *
+     * For example, for a document like `{"id": "1", "nestedField": [{"price": 10, "region": "EU"}, {"price": 20, "region": "US"}]}`,
+     * if `nestedField` is marked as `MATCH_ITEMS`, sorting by price in the US region requires:
+     * `{fieldName: "nestedField.price", "selectItemsBy": [{"nestedField.region": "US"}]}`.
+     * @maxSize 10
+     */
+    selectItemsBy?: Record<string, any>[] | null;
+}
+declare enum CommonSortOrder {
+    ASC = "ASC",
+    DESC = "DESC"
+}
+/** @enumType */
+type CommonSortOrderWithLiterals = CommonSortOrder | 'ASC' | 'DESC';
+interface CommonCursorPaging {
+    /**
+     * Maximum number of items to return in the results.
+     * @max 100
+     */
+    limit?: number | null;
+    /**
+     * Pointer to the next or previous page in the list of results.
+     *
+     * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
+     * Not relevant for the first request.
+     * @maxLength 16000
+     */
+    cursor?: string | null;
+}
+interface QueryProductsResponse {
+    /** Products matching the query. */
+    products?: Product[];
+    /** Paging information for retrieving additional results. */
+    pagingMetadata?: CommonCursorPagingMetadata;
+}
+interface CommonCursorPagingMetadata {
+    /** Number of items returned in the response. */
+    count?: number | null;
+    /** Cursor strings that point to the next page, previous page, or both. */
+    cursors?: CommonCursors;
+    /**
+     * Whether there are more pages to retrieve following the current page.
+     *
+     * + `true`: Another page of results can be retrieved.
+     * + `false`: This is the last page.
+     */
+    hasNext?: boolean | null;
+}
+interface CommonCursors {
+    /**
+     * Cursor string pointing to the next page in the list of results.
+     * @maxLength 16000
+     */
+    next?: string | null;
+    /**
+     * Cursor pointing to the previous page in the list of results.
+     * @maxLength 16000
+     */
+    prev?: string | null;
+}
+interface SearchProductsRequest {
+    /** Search parameters including filter, sort, full-text search, and aggregations. */
+    search?: CursorSearch;
+}
+interface CursorSearch extends CursorSearchPagingMethodOneOf {
+    /**
+     * Cursor pointing to page of results.
+     * When requesting 'cursor_paging.cursor', no `filter`, `sort` or `search` can be provided.
+     */
+    cursorPaging?: CommonCursorPaging;
+    /** A filter object. See documentation [here](https://bo.wix.com/wix-docs/rnd/platformization-guidelines/api-query-language#platformization-guidelines_api-query-language_defining-in-protobuf) */
+    filter?: Record<string, any> | null;
+    /**
+     * Sort object in the form [{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]
+     * @maxSize 10
+     */
+    sort?: CommonSorting[];
+    /**
+     * Aggregations | Faceted search: refers to a way to explore large amounts of data by displaying summaries about various partitions of the data and later allowing to narrow the navigation to a specific partition.
+     * @maxSize 10
+     */
+    aggregations?: Aggregation[];
+    /** Free text to match in searchable fields */
+    search?: SearchDetails;
+    /**
+     * UTC offset or IANA time zone. Valid values are
+     * ISO 8601 UTC offsets, such as +02:00 or -06:00,
+     * and IANA time zone IDs, such as Europe/Rome
+     *
+     * Affects all filters and aggregations returned values.
+     * You may override this behavior in a specific filter by providing
+     * timestamps including time zone. e.g. `"2023-12-20T10:52:34.795Z"`
+     * @maxLength 50
+     */
+    timeZone?: string | null;
+}
+/** @oneof */
+interface CursorSearchPagingMethodOneOf {
+    /**
+     * Cursor pointing to page of results.
+     * When requesting 'cursor_paging.cursor', no `filter`, `sort` or `search` can be provided.
+     */
+    cursorPaging?: CommonCursorPaging;
+}
+interface Aggregation extends AggregationKindOneOf {
+    /** Value aggregation */
+    value?: ValueAggregation;
+    /** Range aggregation */
+    range?: RangeAggregation;
+    /** Scalar aggregation */
+    scalar?: ScalarAggregation;
+    /** Date histogram aggregation */
+    dateHistogram?: DateHistogramAggregation;
+    /** Nested aggregation */
+    nested?: NestedAggregation;
+    /**
+     * User-defined name of aggregation, should be unique, will appear in aggregation results
+     * @maxLength 100
+     */
+    name?: string | null;
+    /** Type of aggregation, client must provide matching aggregation field below */
+    type?: AggregationTypeWithLiterals;
+    /**
+     * Field to aggregate by, use dot notation to specify json path
+     * @maxLength 200
+     */
+    fieldPath?: string;
+}
+/** @oneof */
+interface AggregationKindOneOf {
+    /** Value aggregation */
+    value?: ValueAggregation;
+    /** Range aggregation */
+    range?: RangeAggregation;
+    /** Scalar aggregation */
+    scalar?: ScalarAggregation;
+    /** Date histogram aggregation */
+    dateHistogram?: DateHistogramAggregation;
+    /** Nested aggregation */
+    nested?: NestedAggregation;
+}
+interface RangeBucket {
+    /** Inclusive lower bound of the range. Required if to is not given */
+    from?: number | null;
+    /** Exclusive upper bound of the range. Required if from is not given */
+    to?: number | null;
+}
+declare enum SortType {
+    /** Should sort by number of matches */
+    COUNT = "COUNT",
+    /** Should sort by value of the field alphabetically */
+    VALUE = "VALUE"
+}
+/** @enumType */
+type SortTypeWithLiterals = SortType | 'COUNT' | 'VALUE';
+declare enum SortDirection {
+    /** Should sort in descending order */
+    DESC = "DESC",
+    /** Should sort in ascending order */
+    ASC = "ASC"
+}
+/** @enumType */
+type SortDirectionWithLiterals = SortDirection | 'DESC' | 'ASC';
+declare enum MissingValues {
+    /** Should missing values be excluded from the aggregation results */
+    EXCLUDE = "EXCLUDE",
+    /** Should missing values be included in the aggregation results */
+    INCLUDE = "INCLUDE"
+}
+/** @enumType */
+type MissingValuesWithLiterals = MissingValues | 'EXCLUDE' | 'INCLUDE';
+interface IncludeMissingValuesOptions {
+    /**
+     * Can specify custom bucket name. Defaults are [string -> "N/A"], [int -> "0"], [bool -> "false"] ...
+     * @maxLength 20
+     */
+    addToBucket?: string;
+}
+declare enum ScalarType {
+    /** Count of distinct values */
+    COUNT_DISTINCT = "COUNT_DISTINCT",
+    /** Minimum value */
+    MIN = "MIN",
+    /** Maximum value */
+    MAX = "MAX"
+}
+/** @enumType */
+type ScalarTypeWithLiterals = ScalarType | 'COUNT_DISTINCT' | 'MIN' | 'MAX';
+interface ValueAggregation extends ValueAggregationOptionsOneOf {
+    /** Options for including missing values */
+    includeOptions?: IncludeMissingValuesOptions;
+    /** Should sort by number of matches or value of the field */
+    sortType?: SortTypeWithLiterals;
+    /** Should sort in ascending or descending order */
+    sortDirection?: SortDirectionWithLiterals;
+    /** How many aggregations would you like to return? Can be between 1 and 250. 10 is the default. */
+    limit?: number | null;
+    /** Should missing values be included or excluded from the aggregation results. Default is EXCLUDE */
+    missingValues?: MissingValuesWithLiterals;
+}
+/** @oneof */
+interface ValueAggregationOptionsOneOf {
+    /** Options for including missing values */
+    includeOptions?: IncludeMissingValuesOptions;
+}
+declare enum NestedAggregationType {
+    /** An aggregation where result buckets are dynamically built - one per unique value */
+    VALUE = "VALUE",
+    /** An aggregation, where user can define set of ranges - each representing a bucket */
+    RANGE = "RANGE",
+    /** A single-value metric aggregation - e.g. min, max, sum, avg */
+    SCALAR = "SCALAR",
+    /** An aggregation, where result buckets are dynamically built - one per time interval (hour, day, week, etc.) */
+    DATE_HISTOGRAM = "DATE_HISTOGRAM"
+}
+/** @enumType */
+type NestedAggregationTypeWithLiterals = NestedAggregationType | 'VALUE' | 'RANGE' | 'SCALAR' | 'DATE_HISTOGRAM';
+interface RangeAggregation {
+    /**
+     * List of range buckets, where during aggregation each entity will be placed in the first bucket where its value falls into based on provided range bounds
+     * @maxSize 50
+     */
+    buckets?: RangeBucket[];
+}
+interface ScalarAggregation {
+    /** Define the operator for the scalar aggregation */
+    type?: ScalarTypeWithLiterals;
+}
+interface DateHistogramAggregation {
+    /** Interval for date histogram aggregation */
+    interval?: IntervalWithLiterals;
+}
+declare enum Interval {
+    /** Yearly interval */
+    YEAR = "YEAR",
+    /** Monthly interval */
+    MONTH = "MONTH",
+    /** Weekly interval */
+    WEEK = "WEEK",
+    /** Daily interval */
+    DAY = "DAY",
+    /** Hourly interval */
+    HOUR = "HOUR",
+    /** Minute interval */
+    MINUTE = "MINUTE",
+    /** Second interval */
+    SECOND = "SECOND"
+}
+/** @enumType */
+type IntervalWithLiterals = Interval | 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND';
+interface NestedAggregationItem extends NestedAggregationItemKindOneOf {
+    /** Value aggregation */
+    value?: ValueAggregation;
+    /** Range aggregation */
+    range?: RangeAggregation;
+    /** Scalar aggregation */
+    scalar?: ScalarAggregation;
+    /** Date histogram aggregation */
+    dateHistogram?: DateHistogramAggregation;
+    /**
+     * User-defined name of aggregation, should be unique, will appear in aggregation results
+     * @maxLength 100
+     */
+    name?: string | null;
+    /** Type of aggregation, client must provide matching aggregation field below */
+    type?: NestedAggregationTypeWithLiterals;
+    /**
+     * Field to aggregate by, use dont notation to specify json path
+     * @maxLength 200
+     */
+    fieldPath?: string;
+}
+/** @oneof */
+interface NestedAggregationItemKindOneOf {
+    /** Value aggregation */
+    value?: ValueAggregation;
+    /** Range aggregation */
+    range?: RangeAggregation;
+    /** Scalar aggregation */
+    scalar?: ScalarAggregation;
+    /** Date histogram aggregation */
+    dateHistogram?: DateHistogramAggregation;
+}
+declare enum AggregationType {
+    /** An aggregation where result buckets are dynamically built - one per unique value */
+    VALUE = "VALUE",
+    /** An aggregation, where user can define set of ranges - each representing a bucket */
+    RANGE = "RANGE",
+    /** A single-value metric aggregation - e.g. min, max, sum, avg */
+    SCALAR = "SCALAR",
+    /** An aggregation, where result buckets are dynamically built - one per time interval (hour, day, week, etc.) */
+    DATE_HISTOGRAM = "DATE_HISTOGRAM",
+    /** Multi-level aggregation, where each next aggregation is nested within previous one */
+    NESTED = "NESTED"
+}
+/** @enumType */
+type AggregationTypeWithLiterals = AggregationType | 'VALUE' | 'RANGE' | 'SCALAR' | 'DATE_HISTOGRAM' | 'NESTED';
+/** Nested aggregation expressed through a list of aggregation where each next aggregation is nested within previous one */
+interface NestedAggregation {
+    /**
+     * Flattened list of aggregations, where each next aggregation is nested within previous one
+     * @minSize 2
+     * @maxSize 3
+     */
+    nestedAggregations?: NestedAggregationItem[];
+}
+interface SearchDetails {
+    /**
+     * Search term or expression
+     * @maxLength 100
+     */
+    expression?: string | null;
+}
+declare enum Mode {
+    /** Any of the search terms must be present */
+    OR = "OR",
+    /** All search terms must be present */
+    AND = "AND"
+}
+/** @enumType */
+type ModeWithLiterals = Mode | 'OR' | 'AND';
+interface SearchProductsResponse {
+    /** Products matching the search criteria. */
+    products?: Product[];
+    /** Paging information for retrieving additional results. */
+    pagingMetadata?: CommonCursorPagingMetadata;
+    /** Aggregation results for faceted search. */
+    aggregationData?: AggregationData;
+}
+interface AggregationData {
+    /**
+     * key = aggregation name (as derived from search request)
+     * @maxSize 10000
+     */
+    results?: AggregationResults[];
+}
+interface ValueAggregationResult {
+    /**
+     * Value of the field
+     * @maxLength 100
+     */
+    value?: string;
+    /** Count of entities with this value */
+    count?: number;
+}
+interface RangeAggregationResult {
+    /** Inclusive lower bound of the range */
+    from?: number | null;
+    /** Exclusive upper bound of the range */
+    to?: number | null;
+    /** Count of entities in this range */
+    count?: number;
+}
+interface NestedAggregationResults extends NestedAggregationResultsResultOneOf {
+    /** Value aggregation results */
+    values?: ValueResults;
+    /** Range aggregation results */
+    ranges?: RangeResults;
+    /** Scalar aggregation results */
+    scalar?: AggregationResultsScalarResult;
+    /**
+     * User-defined name of aggregation, matches the one provided in request
+     * @maxLength 100
+     */
+    name?: string;
+    /** Type of aggregation that matches result */
+    type?: AggregationTypeWithLiterals;
+    /**
+     * Field to aggregate by, matches the one provided in request
+     * @maxLength 200
+     */
+    fieldPath?: string;
+}
+/** @oneof */
+interface NestedAggregationResultsResultOneOf {
+    /** Value aggregation results */
+    values?: ValueResults;
+    /** Range aggregation results */
+    ranges?: RangeResults;
+    /** Scalar aggregation results */
+    scalar?: AggregationResultsScalarResult;
+}
+interface ValueResults {
+    /**
+     * List of value aggregations
+     * @maxSize 250
+     */
+    results?: ValueAggregationResult[];
+}
+interface RangeResults {
+    /**
+     * List of ranges returned in same order as requested
+     * @maxSize 50
+     */
+    results?: RangeAggregationResult[];
+}
+interface AggregationResultsScalarResult {
+    /** Type of scalar aggregation */
+    type?: ScalarTypeWithLiterals;
+    /** Value of the scalar aggregation */
+    value?: number;
+}
+interface NestedValueAggregationResult {
+    /**
+     * Value of the field
+     * @maxLength 1000
+     */
+    value?: string;
+    /** Nested aggregations */
+    nestedResults?: NestedAggregationResults;
+}
+interface ValueResult {
+    /**
+     * Value of the field
+     * @maxLength 1000
+     */
+    value?: string;
+    /** Count of entities with this value */
+    count?: number | null;
+}
+interface RangeResult {
+    /** Inclusive lower bound of the range */
+    from?: number | null;
+    /** Exclusive upper bound of the range */
+    to?: number | null;
+    /** Count of entities in this range */
+    count?: number | null;
+}
+interface ScalarResult {
+    /** Value of the scalar aggregation */
+    value?: number;
+}
+interface NestedResultValue extends NestedResultValueResultOneOf {
+    /** Value aggregation result */
+    value?: ValueResult;
+    /** Range aggregation result */
+    range?: RangeResult;
+    /** Scalar aggregation result */
+    scalar?: ScalarResult;
+    /** Date histogram aggregation result */
+    dateHistogram?: ValueResult;
+}
+/** @oneof */
+interface NestedResultValueResultOneOf {
+    /** Value aggregation result */
+    value?: ValueResult;
+    /** Range aggregation result */
+    range?: RangeResult;
+    /** Scalar aggregation result */
+    scalar?: ScalarResult;
+    /** Date histogram aggregation result */
+    dateHistogram?: ValueResult;
+}
+interface Results {
+    /** List of nested aggregations */
+    results?: Record<string, NestedResultValue>;
+}
+interface DateHistogramResult {
+    /**
+     * Date in ISO 8601 format
+     * @maxLength 100
+     */
+    value?: string;
+    /** Count of documents in the bucket */
+    count?: number;
+}
+interface GroupByValueResults {
+    /**
+     * List of value aggregations
+     * @maxSize 1000
+     */
+    results?: NestedValueAggregationResult[];
+}
+interface DateHistogramResults {
+    /**
+     * List of date histogram aggregations
+     * @maxSize 200
+     */
+    results?: DateHistogramResult[];
+}
+/**
+ * Results of `NESTED` aggregation type in a flattened form
+ * aggregations in resulting array are keyed by requested aggregation `name`.
+ */
+interface NestedResults {
+    /**
+     * List of nested aggregations
+     * @maxSize 1000
+     */
+    results?: Results[];
+}
+interface AggregationResults extends AggregationResultsResultOneOf {
+    /** Value aggregation results */
+    values?: ValueResults;
+    /** Range aggregation results */
+    ranges?: RangeResults;
+    /** Scalar aggregation results */
+    scalar?: AggregationResultsScalarResult;
+    /** Group by value aggregation results */
+    groupedByValue?: GroupByValueResults;
+    /** Date histogram aggregation results */
+    dateHistogram?: DateHistogramResults;
+    /** Nested aggregation results */
+    nested?: NestedResults;
+    /**
+     * User-defined name of aggregation as derived from search request
+     * @maxLength 100
+     */
+    name?: string;
+    /** Type of aggregation that must match provided kind as derived from search request */
+    type?: AggregationTypeWithLiterals;
+    /**
+     * Field to aggregate by as derived from search request
+     * @maxLength 200
+     */
+    fieldPath?: string;
+}
+/** @oneof */
+interface AggregationResultsResultOneOf {
+    /** Value aggregation results */
+    values?: ValueResults;
+    /** Range aggregation results */
+    ranges?: RangeResults;
+    /** Scalar aggregation results */
+    scalar?: AggregationResultsScalarResult;
+    /** Group by value aggregation results */
+    groupedByValue?: GroupByValueResults;
+    /** Date histogram aggregation results */
+    dateHistogram?: DateHistogramResults;
+    /** Nested aggregation results */
+    nested?: NestedResults;
+}
+interface BulkUpdateProductTagsRequest {
+    /**
+     * Product IDs to update tags for.
+     * @minSize 1
+     * @maxSize 100
+     * @format GUID
+     */
+    productIds: string[];
+    /** Tags to assign to the products. */
+    assignTags?: Tags;
+    /** Tags to remove from the products. */
+    unassignTags?: Tags;
+}
+interface BulkUpdateProductTagsResponse {
+    /**
+     * Results
+     * @minSize 1
+     * @maxSize 100
+     */
+    results?: BulkUpdateProductTagsResult[];
+    /** Metadata regarding the bulk update operation */
+    bulkActionMetadata?: BulkActionMetadata;
+}
+interface BulkUpdateProductTagsResult {
+    /** Metadata regarding the specific single update operation */
+    itemMetadata?: ItemMetadata;
+}
+interface BulkUpdateProductTagsByFilterRequest {
+    /** Filter to select products for tag updates. Empty filter updates all products. */
+    filter: Record<string, any> | null;
+    /** Tags to assign to matching products. */
+    assignTags?: Tags;
+    /** Tags to remove from matching products. */
+    unassignTags?: Tags;
+}
+interface BulkUpdateProductTagsByFilterResponse {
+    /**
+     * Job ID for tracking the asynchronous tag update operation.
+     * @format GUID
+     */
+    jobId?: string;
+}
+interface QueryCategoriesRequest {
+    /** Query parameters including filter, sort, and paging options. */
+    query?: CursorQuery;
+    /** The namespace this category belongs to. */
+    namespace: CategoryNamespaceWithLiterals;
+    /** Whether non visible categories should be included in the response. Default is `false`. */
+    returnNonVisibleCategories?: boolean;
+}
+interface CursorQuery extends CursorQueryPagingMethodOneOf {
+    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    cursorPaging?: CursorPaging;
+    /**
+     * Filter object in the following format:
+     * `"filter" : {
+     * "fieldName1": "value1",
+     * "fieldName2":{"$operator":"value2"}
+     * }`
+     * Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
+     */
+    filter?: Record<string, any> | null;
+    /**
+     * Sort object in the following format:
+     * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
+     * @maxSize 5
+     */
+    sort?: Sorting[];
+}
+/** @oneof */
+interface CursorQueryPagingMethodOneOf {
+    /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
+    cursorPaging?: CursorPaging;
+}
+interface Sorting {
+    /**
+     * Name of the field to sort by.
+     * @maxLength 512
+     */
+    fieldName?: string;
+    /** Sort order. */
+    order?: SortOrderWithLiterals;
+    /**
+     * Filters to specify which element to use for sorting when `fieldName` refers to a repeated field marked as `MATCH_ITEMS`.
+     *
+     * These filters ensure the correct element is selected from the collection for sorting. Multiple filters are combined using the `AND` operator.
+     *
+     * For example, for a document like `{"id": "1", "nestedField": [{"price": 10, "region": "EU"}, {"price": 20, "region": "US"}]}`,
+     * if `nestedField` is marked as `MATCH_ITEMS`, sorting by price in the US region requires:
+     * `{fieldName: "nestedField.price", "selectItemsBy": [{"nestedField.region": "US"}]}`.
+     * @maxSize 10
+     */
+    selectItemsBy?: Record<string, any>[] | null;
+}
+declare enum SortOrder {
+    ASC = "ASC",
+    DESC = "DESC"
+}
+/** @enumType */
+type SortOrderWithLiterals = SortOrder | 'ASC' | 'DESC';
+interface CursorPaging {
+    /**
+     * Maximum number of items to return in the results.
+     * @max 1000
+     */
+    limit?: number | null;
+    /**
+     * Pointer to the next or previous page in the list of results.
+     *
+     * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
+     * Not relevant for the first request.
+     * @maxLength 16000
+     */
+    cursor?: string | null;
+}
+interface QueryCategoriesResponse {
+    /** Categories matching the query. */
+    categories?: Category[];
+    /** Paging information for retrieving additional results. */
+    pagingMetadata?: CursorPagingMetadata;
+}
+/**
+ * A category for organizing Marketplace products.
+ *
+ * Categories form a hierarchical structure to help store owners discover relevant products.
+ */
+interface Category {
+    /**
+     * Category ID.
+     * @format GUID
+     * @readonly
+     */
+    _id?: string | null;
+    /**
+     * Category name.
+     * @minLength 1
+     * @maxLength 80
+     */
+    name?: string | null;
+    /**
+     * Category description.
+     * @minLength 1
+     * @maxLength 600
+     */
+    description?: string | null;
+    /**
+     * Number of items in this category.
+     * @readonly
+     */
+    itemCount?: number;
+    /**
+     * Navigation path from root to this category.
+     *
+     * The current category isn't included in the list.
+     * @readonly
+     * @maxSize 5
+     */
+    breadcrumbs?: Breadcrumb[];
+    /**
+     * Parent category information in the hierarchy.
+     * @immutable
+     */
+    parentCategory?: ParentCategory;
+    /**
+     * URL-friendly category identifier.
+     * @format URL_SLUG
+     */
+    slug?: string | null;
+    /**
+     * Whether the category is visible in the Marketplace.
+     *
+     * Default: `true`
+     */
+    visible?: boolean | null;
+}
+interface Breadcrumb {
+    /**
+     * Ancestor category ID.
+     * @format GUID
+     */
+    categoryId?: string;
+    /**
+     * Ancestor category name.
+     * @minLength 1
+     * @maxLength 80
+     */
+    categoryName?: string;
+    /**
+     * Ancestor category slug.
+     * @minLength 1
+     * @maxLength 100
+     */
+    categorySlug?: string;
+}
+/** Information about a category's parent in the hierarchy. */
+interface ParentCategory {
+    /**
+     * Parent category ID.
+     * @format GUID
+     */
+    _id?: string | null;
+    /**
+     * Index position of the category within the parent category.
+     * @readonly
+     */
+    index?: number | null;
+}
+interface CursorPagingMetadata {
+    /** Number of items returned in the response. */
+    count?: number | null;
+    /** Cursor strings that point to the next page, previous page, or both. */
+    cursors?: Cursors;
+    /**
+     * Whether there are more pages to retrieve following the current page.
+     *
+     * + `true`: Another page of results can be retrieved.
+     * + `false`: This is the last page.
+     */
+    hasNext?: boolean | null;
+}
+interface Cursors {
+    /**
+     * Cursor string pointing to the next page in the list of results.
+     * @maxLength 16000
+     */
+    next?: string | null;
+    /**
+     * Cursor pointing to the previous page in the list of results.
+     * @maxLength 16000
+     */
+    prev?: string | null;
+}
+interface BulkAddProductsToStoreRequest {
+    /**
+     * Products to add to the user's store.
+     * @minSize 1
+     * @maxSize 50
+     */
+    productReferences?: ProductReference[];
+}
+interface ProductReference {
+    /**
+     * Product ID.
+     * @format GUID
+     */
+    productId?: string;
+    /**
+     * Provider app ID.
+     * @format GUID
+     * @readonly
+     */
+    appId?: string;
+    /**
+     * Additional metadata for the product reference.
+     *
+     * For example, internal identifiers on the provider's platform.
+     */
+    options?: Record<string, any> | null;
+    /**
+     * Whether the product is visible in the store.
+     *
+     * Default: `false`
+     */
+    visibleInStore?: boolean;
+}
+interface BulkAddProductsToStoreResponse {
+    /**
+     * Results of adding products to the store, one per input product.
+     * @minSize 1
+     * @maxSize 50
+     */
+    results?: BulkAddProductToStoreResult[];
+    /** Metadata about the bulk operation including success and failure counts. */
+    bulkActionMetadata?: BulkActionMetadata;
+}
+interface BulkAddProductToStoreResult {
+    /** Metadata regarding the specific single operation */
+    itemMetadata?: ItemMetadata;
+    /** Product added to the user's store */
+    item?: ProductReference;
+}
+interface DomainEvent extends DomainEventBodyOneOf {
+    createdEvent?: EntityCreatedEvent;
+    updatedEvent?: EntityUpdatedEvent;
+    deletedEvent?: EntityDeletedEvent;
+    actionEvent?: ActionEvent;
+    /** Event ID. With this ID you can easily spot duplicated events and ignore them. */
+    _id?: string;
+    /**
+     * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
+     * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
+     */
+    entityFqdn?: string;
+    /**
+     * Event action name, placed at the top level to make it easier for users to dispatch messages.
+     * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
+     */
+    slug?: string;
+    /** ID of the entity associated with the event. */
+    entityId?: string;
+    /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
+    eventTime?: Date | null;
+    /**
+     * Whether the event was triggered as a result of a privacy regulation application
+     * (for example, GDPR).
+     */
+    triggeredByAnonymizeRequest?: boolean | null;
+    /** If present, indicates the action that triggered the event. */
+    originatedFrom?: string | null;
+    /**
+     * A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number.
+     * You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
+     */
+    entityEventSequence?: string | null;
+}
+/** @oneof */
+interface DomainEventBodyOneOf {
+    createdEvent?: EntityCreatedEvent;
+    updatedEvent?: EntityUpdatedEvent;
+    deletedEvent?: EntityDeletedEvent;
+    actionEvent?: ActionEvent;
+}
+interface EntityCreatedEvent {
+    entity?: string;
+}
+interface RestoreInfo {
+    deletedDate?: Date | null;
+}
+interface EntityUpdatedEvent {
+    /**
+     * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
+     * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
+     * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
+     */
+    currentEntity?: string;
+}
+interface EntityDeletedEvent {
+    /** Entity that was deleted. */
+    deletedEntity?: string | null;
+}
+interface ActionEvent {
+    body?: string;
+}
+interface Empty {
+}
+interface MessageEnvelope {
+    /**
+     * App instance ID.
+     * @format GUID
+     */
+    instanceId?: string | null;
+    /**
+     * Event type.
+     * @maxLength 150
+     */
+    eventType?: string;
+    /** The identification type and identity data. */
+    identity?: IdentificationData;
+    /** Stringify payload. */
+    data?: string;
+    /** Details related to the account */
+    accountInfo?: AccountInfo;
+}
+interface IdentificationData extends IdentificationDataIdOneOf {
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
+    anonymousVisitorId?: string;
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
+    memberId?: string;
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
+    wixUserId?: string;
+    /**
+     * ID of an app.
+     * @format GUID
+     */
+    appId?: string;
+    /** @readonly */
+    identityType?: WebhookIdentityTypeWithLiterals;
+}
+/** @oneof */
+interface IdentificationDataIdOneOf {
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
+    anonymousVisitorId?: string;
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
+    memberId?: string;
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
+    wixUserId?: string;
+    /**
+     * ID of an app.
+     * @format GUID
+     */
+    appId?: string;
+}
+declare enum WebhookIdentityType {
+    UNKNOWN = "UNKNOWN",
+    ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
+    MEMBER = "MEMBER",
+    WIX_USER = "WIX_USER",
+    APP = "APP"
+}
+/** @enumType */
+type WebhookIdentityTypeWithLiterals = WebhookIdentityType | 'UNKNOWN' | 'ANONYMOUS_VISITOR' | 'MEMBER' | 'WIX_USER' | 'APP';
+interface AccountInfo {
+    /**
+     * ID of the Wix account associated with the event.
+     * @format GUID
+     */
+    accountId?: string | null;
+    /**
+     * ID of the parent Wix account. Only included when accountId belongs to a child account.
+     * @format GUID
+     */
+    parentAccountId?: string | null;
+    /**
+     * ID of the Wix site associated with the event. Only included when the event is tied to a specific site.
+     * @format GUID
+     */
+    siteId?: string | null;
+}
+/** @docsIgnore */
+type BulkUpdateProductTagsApplicationErrors = {
+    code?: 'EMPTY_ASSIGN_AND_UNASSIGN_LISTS';
+    description?: string;
+    data?: Record<string, any>;
+};
+/** @docsIgnore */
+type BulkUpdateProductTagsByFilterApplicationErrors = {
+    code?: 'EMPTY_ASSIGN_AND_UNASSIGN_LISTS';
+    description?: string;
+    data?: Record<string, any>;
+};
+interface BaseEventMetadata {
+    /**
+     * App instance ID.
+     * @format GUID
+     */
+    instanceId?: string | null;
+    /**
+     * Event type.
+     * @maxLength 150
+     */
+    eventType?: string;
+    /** The identification type and identity data. */
+    identity?: IdentificationData;
+    /** Details related to the account */
+    accountInfo?: AccountInfo;
+}
+interface EventMetadata extends BaseEventMetadata {
+    /** Event ID. With this ID you can easily spot duplicated events and ignore them. */
+    _id?: string;
+    /**
+     * Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities.
+     * For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
+     */
+    entityFqdn?: string;
+    /**
+     * Event action name, placed at the top level to make it easier for users to dispatch messages.
+     * For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
+     */
+    slug?: string;
+    /** ID of the entity associated with the event. */
+    entityId?: string;
+    /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. */
+    eventTime?: Date | null;
+    /**
+     * Whether the event was triggered as a result of a privacy regulation application
+     * (for example, GDPR).
+     */
+    triggeredByAnonymizeRequest?: boolean | null;
+    /** If present, indicates the action that triggered the event. */
+    originatedFrom?: string | null;
+    /**
+     * A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number.
+     * You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
+     */
+    entityEventSequence?: string | null;
+    accountInfo?: AccountInfoMetadata;
+}
+interface AccountInfoMetadata {
+    /** ID of the Wix account associated with the event */
+    accountId: string;
+    /** ID of the Wix site associated with the event. Only included when the event is tied to a specific site. */
+    siteId?: string;
+    /** ID of the parent Wix account. Only included when 'accountId' belongs to a child account. */
+    parentAccountId?: string;
+}
+interface ProductCreatedEnvelope {
+    entity: Product;
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when a product is created.
+ * @permissionScope Wix Multilingual - Nile Wrapper Domain Events Read
+ * @permissionScopeId SCOPE.MULTILINGUAL.NILE_WRAPPER_DOMAIN_EVENTS_READ
+ * @permissionScope Read Marketplace
+ * @permissionScopeId SCOPE.SUPPLIERS_HUB.READ_MARKETPLACE
+ * @permissionId SUPPLIERS_HUB.PRODUCT_READ
+ * @webhook
+ * @eventType wix.suppliershub.marketplace_product.v1.product_created
+ * @slug created
+ * @documentationMaturity preview
+ */
+declare function onProductCreated(handler: (event: ProductCreatedEnvelope) => void | Promise<void>): void;
+interface ProductDeletedEnvelope {
+    entity: Product;
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when a product is deleted.
+ * @permissionScope Wix Multilingual - Nile Wrapper Domain Events Read
+ * @permissionScopeId SCOPE.MULTILINGUAL.NILE_WRAPPER_DOMAIN_EVENTS_READ
+ * @permissionScope Read Marketplace
+ * @permissionScopeId SCOPE.SUPPLIERS_HUB.READ_MARKETPLACE
+ * @permissionId SUPPLIERS_HUB.PRODUCT_READ
+ * @webhook
+ * @eventType wix.suppliershub.marketplace_product.v1.product_deleted
+ * @slug deleted
+ * @documentationMaturity preview
+ */
+declare function onProductDeleted(handler: (event: ProductDeletedEnvelope) => void | Promise<void>): void;
+interface ProductTagsModifiedEnvelope {
+    data: TagsModified;
+    metadata: EventMetadata;
+}
+/**
+ * Triggered when product tags are modified.
+ * @permissionScope Wix Multilingual - Nile Wrapper Domain Events Read
+ * @permissionScopeId SCOPE.MULTILINGUAL.NILE_WRAPPER_DOMAIN_EVENTS_READ
+ * @permissionScope Read Marketplace
+ * @permissionScopeId SCOPE.SUPPLIERS_HUB.READ_MARKETPLACE
+ * @permissionId SUPPLIERS_HUB.PRODUCT_READ
+ * @webhook
+ * @eventType wix.suppliershub.marketplace_product.v1.product_tags_modified
+ * @slug tags_modified
+ * @documentationMaturity preview
+ */
+declare function onProductTagsModified(handler: (event: ProductTagsModifiedEnvelope) => void | Promise<void>): void;
+interface ProductUpdatedEnvelope {
+    entity: Product;
+    metadata: EventMetadata;
+    /** @hidden */
+    modifiedFields: Record<string, any>;
+}
+/**
+ * Triggered when a product is updated.
+ * @permissionScope Wix Multilingual - Nile Wrapper Domain Events Read
+ * @permissionScopeId SCOPE.MULTILINGUAL.NILE_WRAPPER_DOMAIN_EVENTS_READ
+ * @permissionScope Read Marketplace
+ * @permissionScopeId SCOPE.SUPPLIERS_HUB.READ_MARKETPLACE
+ * @permissionId SUPPLIERS_HUB.PRODUCT_READ
+ * @webhook
+ * @eventType wix.suppliershub.marketplace_product.v1.product_updated
+ * @slug updated
+ * @documentationMaturity preview
+ */
+declare function onProductUpdated(handler: (event: ProductUpdatedEnvelope) => void | Promise<void>): void;
+/**
+ * Creates a product in the Marketplace.
+ *
+ * Products must include all required fields for the specified types.
+ * The first image in `media.items` becomes the main image.
+ * @param product - Product to create. Must include all required fields for the specified product types.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField product
+ * @requiredField product.directCategories._id
+ * @requiredField product.directCategories.namespace
+ * @requiredField product.media
+ * @requiredField product.minimumPrice
+ * @requiredField product.name
+ * @requiredField product.options.name
+ * @requiredField product.options.values
+ * @requiredField product.providerInfo
+ * @requiredField product.providerInfo.productId
+ * @requiredField product.shippingDestinations.minimumShippingCost
+ * @requiredField product.types
+ * @requiredField product.wholesaleOptions.priceTiers.countFrom
+ * @requiredField product.wholesaleOptions.priceTiers.priceFrom
+ * @permissionId SUPPLIERS_HUB.PRODUCT_CREATE
+ * @applicableIdentity APP
+ * @returns Created product with assigned ID and read-only fields populated.
+ * @fqn wix.suppliershub.marketplace.product.v1.MarketplaceProduct.CreateProduct
+ */
+declare function createProduct(product: NonNullablePaths<Product, `directCategories.${number}._id` | `directCategories.${number}.namespace` | `media` | `minimumPrice` | `name` | `options.${number}.name` | `options.${number}.values` | `providerInfo` | `providerInfo.productId` | `shippingDestinations.${number}.minimumShippingCost` | `types` | `wholesaleOptions.priceTiers.${number}.countFrom` | `wholesaleOptions.priceTiers.${number}.priceFrom`, 5>): Promise<NonNullablePaths<Product, `media.items` | `types` | `options` | `options.${number}.name` | `orderProcessingTime.min.value` | `orderProcessingTime.min.unit` | `shippingDestinations` | `shippingDestinations.${number}.countrySelections` | `shippingDestinations.${number}.minimumShippingCost` | `directCategories` | `directCategories.${number}._id` | `directCategories.${number}.namespace` | `allCategories` | `wholesaleOptions.priceTiers` | `wholesaleOptions.priceTiers.${number}.priceFrom` | `supplierInfo.verified` | `printOnDemandOptions.printTechnologies` | `sizeGuides` | `sizeGuides.${number}.measurementUnit` | `tags.privateTags.tagIds`, 5>>;
+/**
+ * Retrieves a product by ID.
+ * @param productId - Product ID.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField productId
+ * @permissionId SUPPLIERS_HUB.PRODUCT_READ
+ * @applicableIdentity APP
+ * @returns Retrieved product.
+ * @fqn wix.suppliershub.marketplace.product.v1.MarketplaceProduct.GetProduct
+ */
+declare function getProduct(productId: string): Promise<NonNullablePaths<Product, `media.items` | `types` | `options` | `options.${number}.name` | `orderProcessingTime.min.value` | `orderProcessingTime.min.unit` | `shippingDestinations` | `shippingDestinations.${number}.countrySelections` | `shippingDestinations.${number}.minimumShippingCost` | `directCategories` | `directCategories.${number}._id` | `directCategories.${number}.namespace` | `allCategories` | `wholesaleOptions.priceTiers` | `wholesaleOptions.priceTiers.${number}.priceFrom` | `supplierInfo.verified` | `printOnDemandOptions.printTechnologies` | `sizeGuides` | `sizeGuides.${number}.measurementUnit` | `tags.privateTags.tagIds`, 5>>;
+/**
+ * Updates a product. Supports partial updates.
+ *
+ * Provider info fields (`providerInfo.productId` and `providerInfo.productCreatedDate`) are immutable and cannot be
+ * changed after creation.
+ * @param _id - Product ID.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField _id
+ * @requiredField product
+ * @requiredField product.directCategories._id
+ * @requiredField product.directCategories.namespace
+ * @permissionId SUPPLIERS_HUB.PRODUCT_UPDATE
+ * @applicableIdentity APP
+ * @returns Updated product.
+ * @fqn wix.suppliershub.marketplace.product.v1.MarketplaceProduct.UpdateProduct
+ */
+declare function updateProduct(_id: string, product: NonNullablePaths<UpdateProduct, `directCategories.${number}._id` | `directCategories.${number}.namespace`, 4>): Promise<NonNullablePaths<Product, `media.items` | `types` | `options` | `options.${number}.name` | `orderProcessingTime.min.value` | `orderProcessingTime.min.unit` | `shippingDestinations` | `shippingDestinations.${number}.countrySelections` | `shippingDestinations.${number}.minimumShippingCost` | `directCategories` | `directCategories.${number}._id` | `directCategories.${number}.namespace` | `allCategories` | `wholesaleOptions.priceTiers` | `wholesaleOptions.priceTiers.${number}.priceFrom` | `supplierInfo.verified` | `printOnDemandOptions.printTechnologies` | `sizeGuides` | `sizeGuides.${number}.measurementUnit` | `tags.privateTags.tagIds`, 5>>;
+interface UpdateProduct {
+    /**
+     * Product ID.
+     * @format GUID
+     * @readonly
+     */
+    _id?: string | null;
+    /**
+     * Date and time the product was created.
+     * @readonly
+     */
+    _createdDate?: Date | null;
+    /**
+     * Date and time the product was updated.
+     * @readonly
+     */
+    _updatedDate?: Date | null;
+    /** Information about the business partner providing this product. */
+    providerInfo?: ProviderInfo;
+    /**
+     * Product name.
+     * @minLength 1
+     * @maxLength 100
+     */
+    name?: string | null;
+    /**
+     * Product description.
+     * @maxLength 64000
+     */
+    description?: string | null;
+    /**
+     * Whether the product is visible in the Marketplace.
+     *
+     * Default: `true`
+     */
+    visible?: boolean | null;
+    /** Product media. */
+    media?: Media;
+    /**
+     * Business model types this product supports.
+     * @minSize 1
+     * @maxSize 2
+     */
+    types?: ProductTypeWithLiterals[];
+    /**
+     * Product options that customers can choose from.
+     *
+     * Options display available product variations like size and color to help buyers make purchase decisions.
+     * Currently, options are informational only and don't create separate inventory items or variants.
+     *
+     * There are 2 predefined option types you can use:
+     * - `color`: Color choices for the product. Values should be standard color names. For example, `"Black"`, `"White"`, `"Yellow"`.
+     * - `size`: Size choices for the product. Values should be standard size labels. For example, `"S"`, `"M"`, `"L"`, `"XL"`.
+     * @maxSize 6
+     */
+    options?: ProductOption[];
+    /**
+     * Promotional ribbon text displayed on the product.
+     *
+     * For example, `"New Arrival"` or `"Bestseller"`.
+     * @minLength 1
+     * @maxLength 30
+     */
+    ribbonName?: string | null;
+    /**
+     * Brand name.
+     * @minLength 1
+     * @maxLength 50
+     */
+    brand?: string | null;
+    /** Time required to process orders before shipping. */
+    orderProcessingTime?: TimeInterval;
+    /**
+     * Countries and regions where this product can be shipped, with location-specific pricing and timing.
+     * @maxSize 100
+     */
+    shippingDestinations?: ShippingDestination[];
+    /**
+     * Minimum price, in USD.
+     * @decimalValue options { gte:0, lte:999999999, maxScale:2 }
+     */
+    minimumPrice?: string | null;
+    /**
+     * Country where the product is manufactured or originates from, in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
+     * @format COUNTRY
+     */
+    productOrigin?: string | null;
+    /**
+     * List of categories that directly contain this product.
+     *
+     * Each category's namespace must match at least one of the product's types.
+     * For example, if a product has type `DROPSHIPPING`, its categories must use `DROPSHIPPING_NAMESPACE`.
+     * Products with both `DROPSHIPPING` and `WHOLESALE` types can have categories from both namespaces.
+     * @maxSize 50
+     */
+    directCategories?: ProductCategory[];
+    /**
+     * List of categories that directly contain this product, as well as their parent categories.
+     * @readonly
+     * @maxSize 2000
+     */
+    allCategories?: ProductCategory[];
+    /**
+     * Wholesale-specific configuration including tiered pricing and minimum order quantities.
+     *
+     * Required when `types` includes `WHOLESALE`.
+     */
+    wholesaleOptions?: WholesaleOptions;
+    /** Information about the supplier including name, rating, and trust status. */
+    supplierInfo?: SupplierInfo;
+    /**
+     * Print-on-demand-specific configuration including supported print technologies and mockup assets.
+     *
+     * Required when `types` include `PRINT_ON_DEMAND`.
+     */
+    printOnDemandOptions?: PrintOnDemandOptions;
+    /**
+     * Information about the product sizing
+     * @maxSize 5
+     */
+    sizeGuides?: SizeGuide[];
+    /** Product tags for organization and filtering. */
+    tags?: Tags;
+}
+/**
+ * Deletes a product permanently from the Marketplace.
+ *
+ * This action cannot be undone. The product will no longer be available for store owners to add to their stores.
+ * @param productId - Product ID.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField productId
+ * @permissionId SUPPLIERS_HUB.PRODUCT_DELETE
+ * @applicableIdentity APP
+ * @fqn wix.suppliershub.marketplace.product.v1.MarketplaceProduct.DeleteProduct
+ */
+declare function deleteProduct(productId: string): Promise<void>;
+/**
+ * Creates multiple products in a single request.
+ *
+ * Supports partial success - some products may be created successfully while others fail.
+ * Each result includes an `itemMetadata` object indicating success or failure with error details.
+ *
+ * When handling failures, distinguish between validation errors which shouldn't be retried,
+ * and transient errors which can be retried. Only retry failed items, not the entire batch.
+ * @param products - Products to create. Each must include all required fields for the specified product types.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField products
+ * @requiredField products.directCategories._id
+ * @requiredField products.directCategories.namespace
+ * @requiredField products.media
+ * @requiredField products.minimumPrice
+ * @requiredField products.name
+ * @requiredField products.options.name
+ * @requiredField products.options.values
+ * @requiredField products.providerInfo
+ * @requiredField products.providerInfo.productId
+ * @requiredField products.shippingDestinations.minimumShippingCost
+ * @requiredField products.types
+ * @requiredField products.wholesaleOptions.priceTiers.countFrom
+ * @requiredField products.wholesaleOptions.priceTiers.priceFrom
+ * @permissionId SUPPLIERS_HUB.PRODUCT_CREATE
+ * @applicableIdentity APP
+ * @fqn wix.suppliershub.marketplace.product.v1.MarketplaceProduct.BulkCreateProducts
+ */
+declare function bulkCreateProducts(products: NonNullablePaths<Product, `directCategories.${number}._id` | `directCategories.${number}.namespace` | `media` | `minimumPrice` | `name` | `options.${number}.name` | `options.${number}.values` | `providerInfo` | `providerInfo.productId` | `shippingDestinations.${number}.minimumShippingCost` | `types` | `wholesaleOptions.priceTiers.${number}.countFrom` | `wholesaleOptions.priceTiers.${number}.priceFrom`, 5>[], options?: BulkCreateProductsOptions): Promise<NonNullablePaths<BulkCreateProductsResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.supplierInfo.verified` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
+interface BulkCreateProductsOptions {
+    /**
+     * Whether to return the created products in the response.
+     *
+     * Default: `false`
+     */
+    returnEntity?: boolean;
+}
+/**
+ * Updates multiple products in a single request.
+ *
+ * Supports partial success and partial field updates. Each result includes an `itemMetadata` object indicating success or failure with error details.
+ *
+ * When handling failures, distinguish between validation errors which shouldn't be retried,
+ * and transient errors which can be retried. Only retry failed items, not the entire batch.
+ * @param products - Products to update. Each can be partial based on its field mask.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField products
+ * @requiredField products.product._id
+ * @requiredField products.product.directCategories._id
+ * @requiredField products.product.directCategories.namespace
+ * @permissionId SUPPLIERS_HUB.PRODUCT_UPDATE
+ * @applicableIdentity APP
+ * @fqn wix.suppliershub.marketplace.product.v1.MarketplaceProduct.BulkUpdateProducts
+ */
+declare function bulkUpdateProducts(products: NonNullablePaths<MaskedProduct, `product._id` | `product.directCategories.${number}._id` | `product.directCategories.${number}.namespace`, 5>[], options?: BulkUpdateProductsOptions): Promise<NonNullablePaths<BulkUpdateProductsResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `results.${number}.item.supplierInfo.verified` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
+interface BulkUpdateProductsOptions {
+    /**
+     * Whether to return the updated products in the response.
+     *
+     * Default: `false`
+     */
+    returnEntity?: boolean;
+}
+/**
+ * Deletes multiple products permanently in a single request. Supports partial success.
+ *
+ * Each result includes an `itemMetadata` object indicating success or failure with error details.
+ * When handling failures, distinguish between validation errors which shouldn't be retried,
+ * and transient errors which can be retried. Only retry failed items, not the entire batch.
+ * @param productIds - Product IDs to delete.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField productIds
+ * @permissionId SUPPLIERS_HUB.PRODUCT_DELETE
+ * @applicableIdentity APP
+ * @fqn wix.suppliershub.marketplace.product.v1.MarketplaceProduct.BulkDeleteProducts
+ */
+declare function bulkDeleteProducts(productIds: string[]): Promise<NonNullablePaths<BulkDeleteProductsResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6>>;
+/**
+ * Retrieves a list of products with filtering, sorting, and cursor-based pagination.
+ *
+ * Provides real-time, strongly consistent results with filtering, sorting, and pagination.
+ *
+ * Use Query Products when you need accurate, up-to-date data such as for operational tasks or inventory checks.
+ * For product discovery and browsing with full-text search capabilities, use [Search Products](https://dev.wix.com/docs/api-reference/business-solutions/suppliers-hub/products/search-products) instead.
+ * @public
+ * @documentationMaturity preview
+ * @permissionId SUPPLIERS_HUB.PRODUCT_READ
+ * @applicableIdentity APP
+ * @fqn wix.suppliershub.marketplace.product.v1.MarketplaceProduct.QueryProducts
+ */
+declare function queryProducts(): ProductsQueryBuilder;
+interface QueryCursorResult {
+    cursors: CommonCursors;
+    hasNext: () => boolean;
+    hasPrev: () => boolean;
+    length: number;
+    pageSize: number;
+}
+interface ProductsQueryResult extends QueryCursorResult {
+    items: Product[];
+    query: ProductsQueryBuilder;
+    next: () => Promise<ProductsQueryResult>;
+    prev: () => Promise<ProductsQueryResult>;
+}
+interface ProductsQueryBuilder {
+    /** @param propertyName - Property whose value is compared with `value`.
+     * @param value - Value to compare against.
+     * @documentationMaturity preview
+     */
+    eq: (propertyName: '_id' | '_createdDate' | 'providerInfo.appId' | 'providerInfo.productId' | 'name' | 'visible' | 'brand' | 'minimumPrice' | 'inventory.tier' | 'productOrigin' | 'directCategories.id' | 'directCategories.index' | 'allCategories.id' | 'allCategories.index' | 'wholesaleOptions.minimumOrderQuantity' | 'supplierInfo.id' | 'supplierInfo.rating' | 'supplierInfo.verified', value: any) => ProductsQueryBuilder;
+    /** @param propertyName - Property whose value is compared with `value`.
+     * @param value - Value to compare against.
+     * @documentationMaturity preview
+     */
+    ne: (propertyName: '_id' | '_createdDate' | 'providerInfo.appId' | 'providerInfo.productId' | 'name' | 'visible' | 'brand' | 'minimumPrice' | 'inventory.tier' | 'productOrigin' | 'directCategories.id' | 'directCategories.index' | 'allCategories.id' | 'allCategories.index' | 'wholesaleOptions.minimumOrderQuantity' | 'supplierInfo.id' | 'supplierInfo.rating' | 'supplierInfo.verified', value: any) => ProductsQueryBuilder;
+    /** @param propertyName - Property whose value is compared with `value`.
+     * @param value - Value to compare against.
+     * @documentationMaturity preview
+     */
+    ge: (propertyName: '_id' | '_createdDate' | 'providerInfo.appId' | 'providerInfo.productId' | 'name' | 'brand' | 'minimumPrice' | 'productOrigin' | 'directCategories.id' | 'directCategories.index' | 'allCategories.id' | 'allCategories.index' | 'wholesaleOptions.minimumOrderQuantity' | 'supplierInfo.id' | 'supplierInfo.rating', value: any) => ProductsQueryBuilder;
+    /** @param propertyName - Property whose value is compared with `value`.
+     * @param value - Value to compare against.
+     * @documentationMaturity preview
+     */
+    gt: (propertyName: '_id' | '_createdDate' | 'providerInfo.appId' | 'providerInfo.productId' | 'name' | 'brand' | 'minimumPrice' | 'productOrigin' | 'directCategories.id' | 'directCategories.index' | 'allCategories.id' | 'allCategories.index' | 'wholesaleOptions.minimumOrderQuantity' | 'supplierInfo.id' | 'supplierInfo.rating', value: any) => ProductsQueryBuilder;
+    /** @param propertyName - Property whose value is compared with `value`.
+     * @param value - Value to compare against.
+     * @documentationMaturity preview
+     */
+    le: (propertyName: '_id' | '_createdDate' | 'providerInfo.appId' | 'providerInfo.productId' | 'name' | 'brand' | 'minimumPrice' | 'productOrigin' | 'directCategories.id' | 'directCategories.index' | 'allCategories.id' | 'allCategories.index' | 'wholesaleOptions.minimumOrderQuantity' | 'supplierInfo.id' | 'supplierInfo.rating', value: any) => ProductsQueryBuilder;
+    /** @param propertyName - Property whose value is compared with `value`.
+     * @param value - Value to compare against.
+     * @documentationMaturity preview
+     */
+    lt: (propertyName: '_id' | '_createdDate' | 'providerInfo.appId' | 'providerInfo.productId' | 'name' | 'brand' | 'minimumPrice' | 'productOrigin' | 'directCategories.id' | 'directCategories.index' | 'allCategories.id' | 'allCategories.index' | 'wholesaleOptions.minimumOrderQuantity' | 'supplierInfo.id' | 'supplierInfo.rating', value: any) => ProductsQueryBuilder;
+    /** @param propertyName - Property whose value is compared with `string`.
+     * @param string - String to compare against. Case-insensitive.
+     * @documentationMaturity preview
+     */
+    startsWith: (propertyName: '_id' | 'providerInfo.appId' | 'providerInfo.productId' | 'name' | 'brand' | 'minimumPrice' | 'productOrigin' | 'directCategories.id' | 'allCategories.id' | 'supplierInfo.id' | 'supplierInfo.rating', value: string) => ProductsQueryBuilder;
+    /** @param propertyName - Property whose value is compared with `values`.
+     * @param values - List of values to compare against.
+     * @documentationMaturity preview
+     */
+    hasSome: (propertyName: '_id' | '_createdDate' | 'providerInfo.appId' | 'providerInfo.productId' | 'name' | 'visible' | 'brand' | 'minimumPrice' | 'inventory.tier' | 'productOrigin' | 'directCategories.id' | 'directCategories.index' | 'allCategories.id' | 'allCategories.index' | 'wholesaleOptions.minimumOrderQuantity' | 'supplierInfo.id' | 'supplierInfo.rating' | 'supplierInfo.verified', value: any[]) => ProductsQueryBuilder;
+    /** @documentationMaturity preview */
+    in: (propertyName: '_id' | '_createdDate' | 'providerInfo.appId' | 'providerInfo.productId' | 'name' | 'visible' | 'brand' | 'minimumPrice' | 'inventory.tier' | 'productOrigin' | 'directCategories.id' | 'directCategories.index' | 'allCategories.id' | 'allCategories.index' | 'wholesaleOptions.minimumOrderQuantity' | 'supplierInfo.id' | 'supplierInfo.rating' | 'supplierInfo.verified', value: any) => ProductsQueryBuilder;
+    /** @documentationMaturity preview */
+    exists: (propertyName: '_id' | '_createdDate' | 'providerInfo.appId' | 'providerInfo.productId' | 'name' | 'visible' | 'brand' | 'minimumPrice' | 'inventory.tier' | 'productOrigin' | 'directCategories.id' | 'directCategories.index' | 'allCategories.id' | 'allCategories.index' | 'wholesaleOptions.minimumOrderQuantity' | 'supplierInfo.id' | 'supplierInfo.rating' | 'supplierInfo.verified', value: boolean) => ProductsQueryBuilder;
+    /** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
+     * @documentationMaturity preview
+     */
+    ascending: (...propertyNames: Array<'_createdDate' | 'minimumPrice' | 'directCategories.index' | 'allCategories.index' | 'supplierInfo.rating'>) => ProductsQueryBuilder;
+    /** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
+     * @documentationMaturity preview
+     */
+    descending: (...propertyNames: Array<'_createdDate' | 'minimumPrice' | 'directCategories.index' | 'allCategories.index' | 'supplierInfo.rating'>) => ProductsQueryBuilder;
+    /** @param limit - Number of items to return, which is also the `pageSize` of the results object.
+     * @documentationMaturity preview
+     */
+    limit: (limit: number) => ProductsQueryBuilder;
+    /** @param cursor - A pointer to specific record
+     * @documentationMaturity preview
+     */
+    skipTo: (cursor: string) => ProductsQueryBuilder;
+    /** @documentationMaturity preview */
+    find: () => Promise<ProductsQueryResult>;
+}
+/**
+ * @hidden
+ * @fqn wix.suppliershub.marketplace.product.v1.MarketplaceProduct.QueryProducts
+ * @requiredField query
+ */
+declare function typedQueryProducts(query: ProductQuery): Promise<NonNullablePaths<QueryProductsResponse, `products` | `products.${number}.orderProcessingTime.min.value` | `products.${number}.orderProcessingTime.min.unit` | `products.${number}.supplierInfo.verified`, 6>>;
+interface ProductQuerySpec extends QuerySpec {
+    paging: 'cursor';
+    wql: [
+        {
+            fields: [
+                'allCategories',
+                'directCategories',
+                'options',
+                'options.values',
+                'shippingDestinations'
+            ];
+            operators: ['$matchItems'];
+            sort: 'NONE';
+        },
+        {
+            fields: ['printOnDemandOptions.printTechnologies', 'types'];
+            operators: ['$hasAll', '$hasSome'];
+            sort: 'NONE';
+        },
+        {
+            fields: [
+                '_id',
+                'brand',
+                'inventory.tier',
+                'name',
+                'productOrigin',
+                'providerInfo.appId',
+                'providerInfo.productId',
+                'supplierInfo._id',
+                'supplierInfo.verified',
+                'visible',
+                'wholesaleOptions.minimumOrderQuantity'
+            ];
+            operators: '*';
+            sort: 'NONE';
+        },
+        {
+            fields: ['_createdDate', 'minimumPrice', 'supplierInfo.rating'];
+            operators: '*';
+            sort: 'BOTH';
+        }
+    ];
+}
+type CommonQueryWithEntityContext = Query<Product, ProductQuerySpec>;
+type ProductQuery = {
+    /**
+    Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`.
+    */
+    cursorPaging?: {
+        /**
+      Maximum number of items to return in the results.
+      @max: 100
+      */
+        limit?: NonNullable<CommonQueryWithEntityContext['cursorPaging']>['limit'] | null;
+        /**
+      Pointer to the next or previous page in the list of results.
+    
+      Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
+      Not relevant for the first request.
+      @maxLength: 16000
+      */
+        cursor?: NonNullable<CommonQueryWithEntityContext['cursorPaging']>['cursor'] | null;
+    };
+    /**
+    Filter object in the following format:
+    `"filter" : {
+    "fieldName1": "value1",
+    "fieldName2":{"$operator":"value2"}
+    }`
+    Example of operators: `$eq`, `$ne`, `$lt`, `$lte`, `$gt`, `$gte`, `$in`, `$hasSome`, `$hasAll`, `$startsWith`, `$contains`
+    */
+    filter?: CommonQueryWithEntityContext['filter'] | null;
+    /**
+    Sort object in the following format:
+    `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
+    @maxSize: 5
+    */
+    sort?: {
+        /**
+      Name of the field to sort by.
+      @maxLength: 512
+      */
+        fieldName?: NonNullable<CommonQueryWithEntityContext['sort']>[number]['fieldName'];
+        /**
+      Sort order.
+      */
+        order?: NonNullable<CommonQueryWithEntityContext['sort']>[number]['order'];
+        /**
+      Filters to specify which element to use for sorting when `fieldName` refers to a repeated field marked as `MATCH_ITEMS`.
+    
+      These filters ensure the correct element is selected from the collection for sorting. Multiple filters are combined using the `AND` operator.
+    
+      For example, for a document like `{"id": "1", "nestedField": [{"price": 10, "region": "EU"}, {"price": 20, "region": "US"}]}`,
+      if `nestedField` is marked as `MATCH_ITEMS`, sorting by price in the US region requires:
+      `{fieldName: "nestedField.price", "selectItemsBy": [{"nestedField.region": "US"}]}`.
+      @maxSize: 10
+      */
+        selectItemsBy?: NonNullable<CommonQueryWithEntityContext['sort']>[number]['selectItemsBy'] | null;
+    }[];
+};
+declare const utils: {
+    query: {
+        QueryBuilder: () => _wix_sdk_types.QueryBuilder<Product, ProductQuerySpec, ProductQuery>;
+        Filter: _wix_sdk_types.FilterFactory<Product, ProductQuerySpec>;
+        Sort: _wix_sdk_types.SortFactory<ProductQuerySpec>;
+    };
+    search: {
+        SearchBuilder: () => _wix_sdk_types.SearchBuilder<Product, ProductSearchSpec, ProductSearch>;
+        Filter: _wix_sdk_types.FilterFactory<Product, ProductSearchSpec>;
+        Sort: _wix_sdk_types.SortFactory<ProductSearchSpec>;
+        SearchParams: _wix_sdk_types.SearchParamsFactory<ProductSearchSpec>;
+        Aggregation: _wix_sdk_types.AggregationFactory<ProductSearchSpec>;
+    };
+};
+interface ProductSearchSpec extends SearchSpec {
+    searchable: ['brand', 'description', 'name'];
+    aggregatable: [
+        '_createdDate',
+        '_id',
+        'allCategories',
+        'allCategories._id',
+        'allCategories.index',
+        'brand',
+        'directCategories',
+        'directCategories._id',
+        'directCategories.index',
+        'inventory.tier',
+        'minimumPrice',
+        'name',
+        'options',
+        'options.values',
+        'printOnDemandOptions.printTechnologies',
+        'productOrigin',
+        'providerInfo.appId',
+        'providerInfo.productId',
+        'shippingDestinations',
+        'supplierInfo._id',
+        'supplierInfo.rating',
+        'supplierInfo.verified',
+        'types',
+        'visible',
+        'wholesaleOptions.minimumOrderQuantity'
+    ];
+    paging: 'cursor';
+    wql: [
+        {
+            operators: ['$matchItems'];
+            fields: [
+                'allCategories',
+                'directCategories',
+                'options',
+                'options.values',
+                'shippingDestinations'
+            ];
+            sort: 'NONE';
+        },
+        {
+            operators: ['$hasAll', '$hasSome'];
+            fields: ['printOnDemandOptions.printTechnologies', 'types'];
+            sort: 'NONE';
+        },
+        {
+            operators: '*';
+            fields: [
+                '_id',
+                'brand',
+                'inventory.tier',
+                'name',
+                'productOrigin',
+                'providerInfo.appId',
+                'providerInfo.productId',
+                'supplierInfo._id',
+                'supplierInfo.verified',
+                'visible',
+                'wholesaleOptions.minimumOrderQuantity'
+            ];
+            sort: 'NONE';
+        },
+        {
+            operators: '*';
+            fields: ['_createdDate', 'minimumPrice', 'supplierInfo.rating'];
+            sort: 'BOTH';
+        }
+    ];
+}
+type CommonSearchWithEntityContext = Search<Product, ProductSearchSpec>;
+type ProductSearch = {
+    /**
+    Cursor pointing to page of results.
+    When requesting 'cursor_paging.cursor', no `filter`, `sort` or `search` can be provided.
+    */
+    cursorPaging?: {
+        /**
+      Maximum number of items to return in the results.
+      @max: 100
+      */
+        limit?: NonNullable<CommonSearchWithEntityContext['cursorPaging']>['limit'] | null;
+        /**
+      Pointer to the next or previous page in the list of results.
+    
+      Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
+      Not relevant for the first request.
+      @maxLength: 16000
+      */
+        cursor?: NonNullable<CommonSearchWithEntityContext['cursorPaging']>['cursor'] | null;
+    };
+    /**
+    A filter object. See documentation [here](https://bo.wix.com/wix-docs/rnd/platformization-guidelines/api-query-language#platformization-guidelines_api-query-language_defining-in-protobuf)
+    */
+    filter?: CommonSearchWithEntityContext['filter'] | null;
+    /**
+    Sort object in the form [{"fieldName":"sortField1"},{"fieldName":"sortField2","direction":"DESC"}]
+    @maxSize: 10
+    */
+    sort?: {
+        /**
+      Name of the field to sort by.
+      @maxLength: 512
+      */
+        fieldName?: NonNullable<CommonSearchWithEntityContext['sort']>[number]['fieldName'];
+        /**
+      Sort order.
+      */
+        order?: NonNullable<CommonSearchWithEntityContext['sort']>[number]['order'];
+        /**
+      Filters to specify which element to use for sorting when `fieldName` refers to a repeated field marked as `MATCH_ITEMS`.
+    
+      These filters ensure the correct element is selected from the collection for sorting. Multiple filters are combined using the `AND` operator.
+    
+      For example, for a document like `{"id": "1", "nestedField": [{"price": 10, "region": "EU"}, {"price": 20, "region": "US"}]}`,
+      if `nestedField` is marked as `MATCH_ITEMS`, sorting by price in the US region requires:
+      `{fieldName: "nestedField.price", "selectItemsBy": [{"nestedField.region": "US"}]}`.
+      @maxSize: 10
+      */
+        selectItemsBy?: NonNullable<CommonSearchWithEntityContext['sort']>[number]['selectItemsBy'] | null;
+    }[];
+    /**
+    Aggregations | Faceted search: refers to a way to explore large amounts of data by displaying summaries about various partitions of the data and later allowing to narrow the navigation to a specific partition.
+    @maxSize: 10
+    */
+    aggregations?: {
+        /**
+      Value aggregation
+      */
+        value?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['value'];
+        /**
+      Range aggregation
+      */
+        range?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['range'];
+        /**
+      Scalar aggregation
+      */
+        scalar?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['scalar'];
+        /**
+      Date histogram aggregation
+      */
+        dateHistogram?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['dateHistogram'];
+        /**
+      Nested aggregation
+      */
+        nested?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['nested'];
+        /**
+      User-defined name of aggregation, should be unique, will appear in aggregation results
+      @maxLength: 100
+      */
+        name?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['name'] | null;
+        /**
+      Type of aggregation, client must provide matching aggregation field below
+      */
+        type?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['type'];
+        /**
+      Field to aggregate by, use dot notation to specify json path
+      @maxLength: 200
+      */
+        fieldPath?: NonNullable<CommonSearchWithEntityContext['aggregations']>[number]['fieldPath'];
+    }[];
+    /**
+    Free text to match in searchable fields
+    */
+    search?: {
+        /**
+      Search term or expression
+      @maxLength: 100
+      */
+        expression?: NonNullable<CommonSearchWithEntityContext['search']>['expression'] | null;
+    };
+    /**
+    UTC offset or IANA time zone. Valid values are
+    ISO 8601 UTC offsets, such as +02:00 or -06:00,
+    and IANA time zone IDs, such as Europe/Rome
+  
+    Affects all filters and aggregations returned values.
+    You may override this behavior in a specific filter by providing
+    timestamps including time zone. e.g. `"2023-12-20T10:52:34.795Z"`
+    @maxLength: 50
+    */
+    timeZone?: CommonSearchWithEntityContext['timeZone'] | null;
+};
+/**
+ * Updates tags on multiple products by product IDs.
+ *
+ * A tag that appears both in the list of assign and unassign tags, will be assigned
+ * @param productIds - Product IDs to update tags for.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField productIds
+ * @permissionId SUPPLIERS_HUB.PRODUCT_UPDATE_TAGS
+ * @applicableIdentity APP
+ * @fqn wix.suppliershub.marketplace.product.v1.MarketplaceProduct.BulkUpdateProductTags
+ */
+declare function bulkUpdateProductTags(productIds: string[], options?: BulkUpdateProductTagsOptions): Promise<NonNullablePaths<BulkUpdateProductTagsResponse, `results` | `results.${number}.itemMetadata.originalIndex` | `results.${number}.itemMetadata.success` | `results.${number}.itemMetadata.error.code` | `results.${number}.itemMetadata.error.description` | `bulkActionMetadata.totalSuccesses` | `bulkActionMetadata.totalFailures` | `bulkActionMetadata.undetailedFailures`, 6> & {
+    __applicationErrorsType?: BulkUpdateProductTagsApplicationErrors;
+}>;
+interface BulkUpdateProductTagsOptions {
+    /** Tags to assign to the products. */
+    assignTags?: Tags;
+    /** Tags to remove from the products. */
+    unassignTags?: Tags;
+}
+/**
+ * Updates tags on multiple products matching a filter.
+ *
+ * This operation runs asynchronously because it can potentially affect thousands of products.
+ * The response includes a `jobId` for tracking the operation's progress.
+ *
+ * An empty filter updates all products. If a tag appears in both assign and unassign lists, it will be assigned.
+ * @param filter - Filter to select products for tag updates. Empty filter updates all products.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField filter
+ * @permissionId SUPPLIERS_HUB.PRODUCT_UPDATE_TAGS
+ * @applicableIdentity APP
+ * @fqn wix.suppliershub.marketplace.product.v1.MarketplaceProduct.BulkUpdateProductTagsByFilter
+ */
+declare function bulkUpdateProductTagsByFilter(filter: Record<string, any>, options?: BulkUpdateProductTagsByFilterOptions): Promise<NonNullablePaths<BulkUpdateProductTagsByFilterResponse, `jobId`, 2> & {
+    __applicationErrorsType?: BulkUpdateProductTagsByFilterApplicationErrors;
+}>;
+interface BulkUpdateProductTagsByFilterOptions {
+    /** Tags to assign to matching products. */
+    assignTags?: Tags;
+    /** Tags to remove from matching products. */
+    unassignTags?: Tags;
+}
+/**
+ * Queries categories using [WQL - Wix Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language).
+ *
+ * Supports filtering, sorting, and pagination.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField options.namespace
+ * @permissionId SUPPLIERS_HUB.CATEGORY_READ
+ * @applicableIdentity APP
+ * @fqn wix.suppliershub.marketplace.product.v1.MarketplaceProduct.QueryCategories
+ */
+declare function queryCategories(options?: NonNullablePaths<QueryCategoriesOptions, `namespace`, 2>): Promise<NonNullablePaths<QueryCategoriesResponse, `categories` | `categories.${number}.itemCount`, 4>>;
+interface QueryCategoriesOptions {
+    /** Query parameters including filter, sort, and paging options. */
+    query?: CursorQuery;
+    /** The namespace this category belongs to. */
+    namespace: CategoryNamespaceWithLiterals;
+    /** Whether non visible categories should be included in the response. Default is `false`. */
+    returnNonVisibleCategories?: boolean;
+}
+
+export { type ShippingDestination as $, MissingValues as A, type BulkCreateProductsOptions as B, CountrySelections as C, ScalarType as D, Interval as E, AggregationType as F, Mode as G, SortOrder as H, InventoryTier as I, type ProviderInfo as J, type Media as K, type FocalPoint as L, type MaskedProduct as M, NestedAggregationType as N, type ProductOption as O, type Product as P, type QueryCategoriesOptions as Q, RequestedField as R, type SearchProductsResponse as S, TimeUnit as T, type UpdateProduct as U, type OptionValue as V, WebhookIdentityType as W, type OptionValueValueOneOf as X, type ColorOption as Y, type TimeInterval as Z, type TimeValue as _, type BulkCreateProductsResponse as a, type RangeResults as a$, type ShippingDestinationCountriesOptionsOneOf as a0, type Countries as a1, type Inventory as a2, type ProductCategory as a3, type WholesaleOptions as a4, type PriceTier as a5, type SupplierInfo as a6, type PrintOnDemandOptions as a7, type SizeGuide as a8, type Specification as a9, type CommonSorting as aA, type CommonCursorPaging as aB, type QueryProductsResponse as aC, type CommonCursorPagingMetadata as aD, type CommonCursors as aE, type SearchProductsRequest as aF, type CursorSearch as aG, type CursorSearchPagingMethodOneOf as aH, type Aggregation as aI, type AggregationKindOneOf as aJ, type RangeBucket as aK, type IncludeMissingValuesOptions as aL, type ValueAggregation as aM, type ValueAggregationOptionsOneOf as aN, type RangeAggregation as aO, type ScalarAggregation as aP, type DateHistogramAggregation as aQ, type NestedAggregationItem as aR, type NestedAggregationItemKindOneOf as aS, type NestedAggregation as aT, type SearchDetails as aU, type AggregationData as aV, type ValueAggregationResult as aW, type RangeAggregationResult as aX, type NestedAggregationResults as aY, type NestedAggregationResultsResultOneOf as aZ, type ValueResults as a_, type Measurement as aa, type MeasurementValueOneOf as ab, type MeasurementValueRange as ac, type Tags as ad, type TagList as ae, type TagsModified as af, type CreateProductRequest as ag, type CreateProductResponse as ah, type GetProductRequest as ai, type GetProductResponse as aj, type UpdateProductRequest as ak, type UpdateProductResponse as al, type DeleteProductRequest as am, type DeleteProductResponse as an, type BulkCreateProductsRequest as ao, type ItemMetadata as ap, type ApplicationError as aq, type BulkProductResult as ar, type BulkActionMetadata as as, type BulkUpdateProductsRequest as at, type BulkUpdateProductsResponseBulkProductResult as au, type BulkDeleteProductsRequest as av, type BulkDeleteProductsResponseBulkProductResult as aw, type QueryProductsRequest as ax, type CommonCursorQuery as ay, type CommonCursorQueryPagingMethodOneOf as az, type BulkUpdateProductsOptions as b, type NestedAggregationTypeWithLiterals as b$, type AggregationResultsScalarResult as b0, type NestedValueAggregationResult as b1, type ValueResult as b2, type RangeResult as b3, type ScalarResult as b4, type NestedResultValue as b5, type NestedResultValueResultOneOf as b6, type Results as b7, type DateHistogramResult as b8, type GroupByValueResults as b9, type EntityDeletedEvent as bA, type ActionEvent as bB, type Empty as bC, type MessageEnvelope as bD, type IdentificationData as bE, type IdentificationDataIdOneOf as bF, type AccountInfo as bG, type BaseEventMetadata as bH, type EventMetadata as bI, type AccountInfoMetadata as bJ, type ProductsQueryResult as bK, type ProductQuerySpec as bL, type ProductSearchSpec as bM, utils as bN, type ProductTypeWithLiterals as bO, type TimeUnitWithLiterals as bP, type CountrySelectionsWithLiterals as bQ, type InventoryTierWithLiterals as bR, type CategoryNamespaceWithLiterals as bS, type PrintTechnologyWithLiterals as bT, type MeasurementUnitWithLiterals as bU, type RequestedFieldWithLiterals as bV, type CommonSortOrderWithLiterals as bW, type SortTypeWithLiterals as bX, type SortDirectionWithLiterals as bY, type MissingValuesWithLiterals as bZ, type ScalarTypeWithLiterals as b_, type DateHistogramResults as ba, type NestedResults as bb, type AggregationResults as bc, type AggregationResultsResultOneOf as bd, type BulkUpdateProductTagsRequest as be, type BulkUpdateProductTagsResult as bf, type BulkUpdateProductTagsByFilterRequest as bg, type QueryCategoriesRequest as bh, type CursorQuery as bi, type CursorQueryPagingMethodOneOf as bj, type Sorting as bk, type CursorPaging as bl, type Category as bm, type Breadcrumb as bn, type ParentCategory as bo, type CursorPagingMetadata as bp, type Cursors as bq, type BulkAddProductsToStoreRequest as br, type ProductReference as bs, type BulkAddProductsToStoreResponse as bt, type BulkAddProductToStoreResult as bu, type DomainEvent as bv, type DomainEventBodyOneOf as bw, type EntityCreatedEvent as bx, type RestoreInfo as by, type EntityUpdatedEvent as bz, type BulkUpdateProductsResponse as c, type IntervalWithLiterals as c0, type AggregationTypeWithLiterals as c1, type ModeWithLiterals as c2, type SortOrderWithLiterals as c3, type WebhookIdentityTypeWithLiterals as c4, type CommonQueryWithEntityContext as c5, type CommonSearchWithEntityContext as c6, onProductCreated as c7, onProductDeleted as c8, onProductTagsModified as c9, onProductUpdated as ca, createProduct as cb, getProduct as cc, updateProduct as cd, deleteProduct as ce, bulkCreateProducts as cf, bulkUpdateProducts as cg, bulkDeleteProducts as ch, queryProducts as ci, bulkUpdateProductTags as cj, bulkUpdateProductTagsByFilter as ck, queryCategories as cl, type BulkDeleteProductsResponse as d, type ProductSearch as e, type BulkUpdateProductTagsOptions as f, type BulkUpdateProductTagsResponse as g, type BulkUpdateProductTagsApplicationErrors as h, type BulkUpdateProductTagsByFilterOptions as i, type BulkUpdateProductTagsByFilterResponse as j, type BulkUpdateProductTagsByFilterApplicationErrors as k, type QueryCategoriesResponse as l, type ProductCreatedEnvelope as m, type ProductDeletedEnvelope as n, type ProductTagsModifiedEnvelope as o, type ProductUpdatedEnvelope as p, type ProductsQueryBuilder as q, type ProductQuery as r, ProductType as s, typedQueryProducts as t, CategoryNamespace as u, PrintTechnology as v, MeasurementUnit as w, CommonSortOrder as x, SortType as y, SortDirection as z };