@wix/stores 1.0.310 → 1.0.312

package/type-bundles/meta.bundle.d.ts

@@ -1446,7 +1446,7 @@ interface BulkAdjustProductPropertiesResponse$1 {
     /** Bulk action metadata. */
     bulkActionMetadata?: BulkActionMetadata$b;
 }
-interface Paging$5 {
+interface Paging$7 {
     /** Amount of items to load per page */
     limit?: number | null;
     /** Number of items to skip in the display (relevant for all pages after the first) */
@@ -1588,7 +1588,7 @@ interface QueryProductVariantsRequest$1 {
     choices?: Record<string, string>;
     /** List of variant IDs (not relevant when passing choices). */
     variantIds?: string[];
-    paging?: Paging$5;
+    paging?: Paging$7;
     /** Whether merchant specific data should be included in the response. Requires permissions to manage products. */
     includeMerchantSpecificData?: boolean;
 }
@@ -2850,7 +2850,7 @@ interface BulkAdjustProductPropertiesResponse {
     /** Bulk action metadata. */
     bulkActionMetadata?: BulkActionMetadata$a;
 }
-interface Paging$4 {
+interface Paging$6 {
     /** Amount of items to load per page */
     limit?: number | null;
     /** Number of items to skip in the display (relevant for all pages after the first) */
@@ -2992,7 +2992,7 @@ interface QueryProductVariantsRequest {
     choices?: Record<string, string>;
     /** List of variant IDs (not relevant when passing choices). */
     variantIds?: string[];
-    paging?: Paging$4;
+    paging?: Paging$6;
     /** Whether merchant specific data should be included in the response. Requires permissions to manage products. */
     includeMerchantSpecificData?: boolean;
 }
@@ -3551,7 +3551,9 @@ interface Sorting$b {
     order?: SortOrder$b;
 }
 declare enum SortOrder$b {
+    /** Ascending order. */
     ASC = "ASC",
+    /** Descending order. */
     DESC = "DESC"
 }
 interface CursorPaging$b {
@@ -3895,7 +3897,9 @@ interface Sorting$a {
     order?: SortOrder$a;
 }
 declare enum SortOrder$a {
+    /** Ascending order. */
     ASC = "ASC",
+    /** Descending order. */
     DESC = "DESC"
 }
 interface CursorPaging$a {
@@ -4289,9 +4293,13 @@ interface ChoiceValueOneOf$1 {
 }
 declare enum ChoiceType$3 {
     UNKNOWN_CHOICE_TYPE = "UNKNOWN_CHOICE_TYPE",
+    /** For a `customizationRenderType` of `TEXT_CHOICES` and `FREE_TEXT`. */
     CHOICE_TEXT = "CHOICE_TEXT",
+    /** For `customizationRenderType: SWATCH_CHOICES`. */
     ONE_COLOR = "ONE_COLOR",
+    /** For `customizationRenderType: SWATCH_CHOICES`. */
     MULTIPLE_COLORS = "MULTIPLE_COLORS",
+    /** For `customizationRenderType: SWATCH_CHOICES`. */
     IMAGE = "IMAGE"
 }
 interface CreateCustomizationRequest$1 {
@@ -4313,7 +4321,9 @@ interface GetCustomizationRequest$1 {
     fields?: RequestedFields$7[];
 }
 declare enum RequestedFields$7 {
+    /** Unknown requested field. */
     UNKNOWN_REQUESTED_FIELD = "UNKNOWN_REQUESTED_FIELD",
+    /** Assigned products count. */
     ASSIGNED_PRODUCTS_COUNT = "ASSIGNED_PRODUCTS_COUNT"
 }
 interface GetCustomizationResponse$1 {
@@ -4380,7 +4390,9 @@ interface Sorting$9 {
     order?: SortOrder$9;
 }
 declare enum SortOrder$9 {
+    /** Ascending order. */
     ASC = "ASC",
+    /** Descending order. */
     DESC = "DESC"
 }
 interface CursorPaging$9 {
@@ -4801,9 +4813,13 @@ interface ChoiceValueOneOf {
 }
 declare enum ChoiceType$2 {
     UNKNOWN_CHOICE_TYPE = "UNKNOWN_CHOICE_TYPE",
+    /** For a `customizationRenderType` of `TEXT_CHOICES` and `FREE_TEXT`. */
     CHOICE_TEXT = "CHOICE_TEXT",
+    /** For `customizationRenderType: SWATCH_CHOICES`. */
     ONE_COLOR = "ONE_COLOR",
+    /** For `customizationRenderType: SWATCH_CHOICES`. */
     MULTIPLE_COLORS = "MULTIPLE_COLORS",
+    /** For `customizationRenderType: SWATCH_CHOICES`. */
     IMAGE = "IMAGE"
 }
 interface CreateCustomizationRequest {
@@ -4825,7 +4841,9 @@ interface GetCustomizationRequest {
     fields?: RequestedFields$6[];
 }
 declare enum RequestedFields$6 {
+    /** Unknown requested field. */
     UNKNOWN_REQUESTED_FIELD = "UNKNOWN_REQUESTED_FIELD",
+    /** Assigned products count. */
     ASSIGNED_PRODUCTS_COUNT = "ASSIGNED_PRODUCTS_COUNT"
 }
 interface GetCustomizationResponse {
@@ -4892,7 +4910,9 @@ interface Sorting$8 {
     order?: SortOrder$8;
 }
 declare enum SortOrder$8 {
+    /** Ascending order. */
     ASC = "ASC",
+    /** Descending order. */
     DESC = "DESC"
 }
 interface CursorPaging$8 {
@@ -9086,14 +9106,11 @@ interface InventoryItemTrackingMethodOneOf$3 {
 }
 declare enum AvailabilityStatus$3 {
     UNKNOWN_AVAILABILITY_STATUS = "UNKNOWN_AVAILABILITY_STATUS",
+    /** Product is out of stock. */
     OUT_OF_STOCK = "OUT_OF_STOCK",
+    /** Product is in stock. See `quantity` field for exact amount in stock. */
     IN_STOCK = "IN_STOCK",
-    /**
-     * Whether the variant is available for preorder. InventoryItem will be available only when all below conditions are met:
-     * 1. the variant is out of stock
-     * 2. preorder is enabled on inventory item level (preorder_setting.enabled is true)
-     * 3. preorder limit wasn't reached (preorder_setting.limit)
-     */
+    /** Product is only available for preorder. See `preorderInfo` field for more info. */
     PREORDER = "PREORDER"
 }
 interface PreorderInfo$5 {
@@ -9311,34 +9328,32 @@ interface BulkInventoryItemResult$3 {
 }
 interface QueryInventoryItemsRequest$1 {
     /** Query options. */
-    query?: InventoryQuery$1;
+    query?: QueryV2$1;
 }
-interface InventoryQuery$1 extends InventoryQueryPagingMethodOneOf$1 {
-    /** Pointer to page of results using offset. Cannot be used together with `cursorPaging`. */
-    paging?: InventoryPaging$1;
-    /** Cursor pointing to page of results. Cannot be used together with `paging`. `cursorPaging.cursor` can not be used together with `filter` or `sort`. */
-    cursorPaging?: InventoryCursorPaging$1;
+interface QueryV2$1 extends QueryV2PagingMethodOneOf$1 {
+    /** Paging options to limit and skip the number of items. */
+    paging?: Paging$5;
+    /** 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$5;
     /**
-     * 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 object.
+     *
+     * Learn more about the [filter section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section).
      */
     filter?: Record<string, any> | null;
     /**
-     * Sort object in the following format:
-     * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
+     * Sort object.
+     *
+     * Learn more about the [sort section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section).
      */
     sort?: Sorting$5[];
 }
 /** @oneof */
-interface InventoryQueryPagingMethodOneOf$1 {
-    /** Pointer to page of results using offset. Cannot be used together with `cursorPaging`. */
-    paging?: InventoryPaging$1;
-    /** Cursor pointing to page of results. Cannot be used together with `paging`. `cursorPaging.cursor` can not be used together with `filter` or `sort`. */
-    cursorPaging?: InventoryCursorPaging$1;
+interface QueryV2PagingMethodOneOf$1 {
+    /** Paging options to limit and skip the number of items. */
+    paging?: Paging$5;
+    /** 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$5;
 }
 interface Sorting$5 {
     /** Name of the field to sort by. */
@@ -9350,22 +9365,19 @@ declare enum SortOrder$5 {
     ASC = "ASC",
     DESC = "DESC"
 }
-interface InventoryPaging$1 {
+interface Paging$5 {
     /** Number of items to load. */
     limit?: number | null;
     /** Number of items to skip in the current sort order. */
     offset?: number | null;
 }
-interface InventoryCursorPaging$1 {
-    /**
-     * Number of items to load.
-     * Cursor token returned in the query response. To be used on the next query request, but not the first query request.
-     */
+interface CursorPaging$5 {
+    /** Maximum number of items to return in the results. */
     limit?: number | null;
     /**
      * Pointer to the next or previous page in the list of results.
-     * You can get the relevant cursor token
-     * from the `pagingMetadata` object in the previous call's response.
+     *
+     * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
      * Not relevant for the first request.
      */
     cursor?: string | null;
@@ -9380,9 +9392,9 @@ interface PlatformPagingMetadataV2$1 {
     /** The number of items returned in this response. */
     count?: number | null;
     /** Cursors to navigate through result pages. Returned if cursor paging was used. */
-    cursors?: Cursors$5;
+    cursors?: CommonCursors$3;
 }
-interface Cursors$5 {
+interface CommonCursors$3 {
     /** Cursor string pointing to the next page in the list of results. */
     next?: string | null;
     /** Cursor pointing to the previous page in the list of results. */
@@ -9629,17 +9641,6 @@ interface GroupByAggregationKindOneOf$1 {
     /** Value aggregation configuration. */
     value?: ValueAggregation$1;
 }
-interface CursorPaging$5 {
-    /** Maximum number of items to return in the results. */
-    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.
-     */
-    cursor?: string | null;
-}
 interface SearchInventoryItemsResponse$1 {
     /** List of inventory items. */
     inventoryItems?: InventoryItem$3[];
@@ -9661,6 +9662,12 @@ interface CursorPagingMetadata$5 {
      */
     hasNext?: boolean | null;
 }
+interface Cursors$5 {
+    /** Cursor string pointing to the next page in the list of results. */
+    next?: string | null;
+    /** Cursor pointing to the previous page in the list of results. */
+    prev?: string | null;
+}
 interface AggregationData$1 {
     /** key = aggregation name (as derived from search request). */
     results?: AggregationResults$1[];
@@ -10171,14 +10178,11 @@ interface InventoryItemTrackingMethodOneOf$2 {
 }
 declare enum AvailabilityStatus$2 {
     UNKNOWN_AVAILABILITY_STATUS = "UNKNOWN_AVAILABILITY_STATUS",
+    /** Product is out of stock. */
     OUT_OF_STOCK = "OUT_OF_STOCK",
+    /** Product is in stock. See `quantity` field for exact amount in stock. */
     IN_STOCK = "IN_STOCK",
-    /**
-     * Whether the variant is available for preorder. InventoryItem will be available only when all below conditions are met:
-     * 1. the variant is out of stock
-     * 2. preorder is enabled on inventory item level (preorder_setting.enabled is true)
-     * 3. preorder limit wasn't reached (preorder_setting.limit)
-     */
+    /** Product is only available for preorder. See `preorderInfo` field for more info. */
     PREORDER = "PREORDER"
 }
 interface PreorderInfo$4 {
@@ -10396,34 +10400,32 @@ interface BulkInventoryItemResult$2 {
 }
 interface QueryInventoryItemsRequest {
     /** Query options. */
-    query?: InventoryQuery;
+    query?: QueryV2;
 }
-interface InventoryQuery extends InventoryQueryPagingMethodOneOf {
-    /** Pointer to page of results using offset. Cannot be used together with `cursorPaging`. */
-    paging?: InventoryPaging;
-    /** Cursor pointing to page of results. Cannot be used together with `paging`. `cursorPaging.cursor` can not be used together with `filter` or `sort`. */
-    cursorPaging?: InventoryCursorPaging;
+interface QueryV2 extends QueryV2PagingMethodOneOf {
+    /** Paging options to limit and skip the number of items. */
+    paging?: Paging$4;
+    /** 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$4;
     /**
-     * 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 object.
+     *
+     * Learn more about the [filter section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-filter-section).
      */
     filter?: Record<string, any> | null;
     /**
-     * Sort object in the following format:
-     * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
+     * Sort object.
+     *
+     * Learn more about the [sort section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section).
      */
     sort?: Sorting$4[];
 }
 /** @oneof */
-interface InventoryQueryPagingMethodOneOf {
-    /** Pointer to page of results using offset. Cannot be used together with `cursorPaging`. */
-    paging?: InventoryPaging;
-    /** Cursor pointing to page of results. Cannot be used together with `paging`. `cursorPaging.cursor` can not be used together with `filter` or `sort`. */
-    cursorPaging?: InventoryCursorPaging;
+interface QueryV2PagingMethodOneOf {
+    /** Paging options to limit and skip the number of items. */
+    paging?: Paging$4;
+    /** 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$4;
 }
 interface Sorting$4 {
     /** Name of the field to sort by. */
@@ -10435,22 +10437,19 @@ declare enum SortOrder$4 {
     ASC = "ASC",
     DESC = "DESC"
 }
-interface InventoryPaging {
+interface Paging$4 {
     /** Number of items to load. */
     limit?: number | null;
     /** Number of items to skip in the current sort order. */
     offset?: number | null;
 }
-interface InventoryCursorPaging {
-    /**
-     * Number of items to load.
-     * Cursor token returned in the query response. To be used on the next query request, but not the first query request.
-     */
+interface CursorPaging$4 {
+    /** Maximum number of items to return in the results. */
     limit?: number | null;
     /**
      * Pointer to the next or previous page in the list of results.
-     * You can get the relevant cursor token
-     * from the `pagingMetadata` object in the previous call's response.
+     *
+     * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
      * Not relevant for the first request.
      */
     cursor?: string | null;
@@ -10465,9 +10464,9 @@ interface PlatformPagingMetadataV2 {
     /** The number of items returned in this response. */
     count?: number | null;
     /** Cursors to navigate through result pages. Returned if cursor paging was used. */
-    cursors?: Cursors$4;
+    cursors?: CommonCursors$2;
 }
-interface Cursors$4 {
+interface CommonCursors$2 {
     /** Cursor string pointing to the next page in the list of results. */
     next?: string | null;
     /** Cursor pointing to the previous page in the list of results. */
@@ -10714,17 +10713,6 @@ interface GroupByAggregationKindOneOf {
     /** Value aggregation configuration. */
     value?: ValueAggregation;
 }
-interface CursorPaging$4 {
-    /** Maximum number of items to return in the results. */
-    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.
-     */
-    cursor?: string | null;
-}
 interface SearchInventoryItemsResponse {
     /** List of inventory items. */
     inventoryItems?: InventoryItem$2[];
@@ -10746,6 +10734,12 @@ interface CursorPagingMetadata$4 {
      */
     hasNext?: boolean | null;
 }
+interface Cursors$4 {
+    /** Cursor string pointing to the next page in the list of results. */
+    next?: string | null;
+    /** Cursor pointing to the previous page in the list of results. */
+    prev?: string | null;
+}
 interface AggregationData {
     /** key = aggregation name (as derived from search request). */
     results?: AggregationResults[];
@@ -12770,7 +12764,9 @@ interface VideoResolution {
 }
 declare enum MediaType$1 {
     UNKNOWN_MEDIA_TYPE = "UNKNOWN_MEDIA_TYPE",
+    /** Image media type. */
     IMAGE = "IMAGE",
+    /** Video media type. */
     VIDEO = "VIDEO"
 }
 interface Thumbnail$1 {
@@ -12855,8 +12851,11 @@ interface ConnectedOptionOptionSettingsOneOf$1 {
     choicesSettings?: ChoicesSettings$1;
 }
 declare enum ProductOptionRenderType$1 {
+    /** Not implemented. */
     UNKNOWN_OPTION_RENDER_TYPE = "UNKNOWN_OPTION_RENDER_TYPE",
+    /** Text choices. */
     TEXT_CHOICES = "TEXT_CHOICES",
+    /** Swatch choices. */
     SWATCH_CHOICES = "SWATCH_CHOICES"
 }
 interface ChoicesSettings$1 {
@@ -12899,9 +12898,13 @@ interface ConnectedOptionChoiceValueOneOf$1 {
 }
 declare enum ChoiceType$1 {
     UNKNOWN_CHOICE_TYPE = "UNKNOWN_CHOICE_TYPE",
+    /** Text choice. */
     CHOICE_TEXT = "CHOICE_TEXT",
+    /** Single color choice. */
     ONE_COLOR = "ONE_COLOR",
+    /** Multiple colors choice. */
     MULTIPLE_COLORS = "MULTIPLE_COLORS",
+    /** Image choice. */
     IMAGE = "IMAGE"
 }
 interface ConnectedModifier$1 extends ConnectedModifierModifierSettingsOneOf$1 {
@@ -12926,9 +12929,13 @@ interface ConnectedModifierModifierSettingsOneOf$1 {
     choicesSettings?: ModifierChoicesSettings$1;
 }
 declare enum ModifierRenderType$1 {
+    /** Not implemented. */
     UNKNOWN_MODIFIER_RENDER_TYPE = "UNKNOWN_MODIFIER_RENDER_TYPE",
+    /** Free text. */
     FREE_TEXT = "FREE_TEXT",
+    /** Text choices. */
     TEXT_CHOICES = "TEXT_CHOICES",
+    /** Swatch choices. */
     SWATCH_CHOICES = "SWATCH_CHOICES"
 }
 interface FreeTextSettings$1 {
@@ -13046,52 +13053,53 @@ interface FixedMonetaryAmount$1 {
 interface Inventory$1 {
     /**
      * Current availability status.
-     *
-     * + `IN_STOCK`: All variants are in stock and available for purchase
-     * + `OUT_OF_STOCK`: All variants are out of stock
-     * + `PARTIALLY_OUT_OF_STOCK`: Some variants are out of stock and some are in stock and available for purchase
      * @readonly
      */
     availabilityStatus?: InventoryAvailabilityStatus$1;
     /**
-     * Current preorder status/
-     *
-     * + `ENABLED`: All variants are enabled for preorder
-     * + `DISABLED`: All variants are disabled for preorder
-     * + `PARTIALLY_ENABLED`: Some variants are disabled and some are enabled for preorder
+     * Current preorder status.
      * @readonly
      */
     preorderStatus?: PreorderStatus$1;
     /**
-     * Supported values:
-     * + `ALL_VARIANTS`: All the product variants are available for preorder.
-     * + `NO_VARIANTS`: None of the product variants are available for preorder.
-     * + `SOME_VARIANTS`: Some of the product variants are available for preorder.
+     * Preorder availability status.
      * @readonly
      */
     preorderAvailability?: ProductPreorderAvailability$1;
 }
 declare enum InventoryAvailabilityStatus$1 {
     UNKNOWN_AVAILABILITY_STATUS = "UNKNOWN_AVAILABILITY_STATUS",
+    /** All variants are in stock and available for purchase. */
     IN_STOCK = "IN_STOCK",
+    /** All variants are out of stock. */
     OUT_OF_STOCK = "OUT_OF_STOCK",
+    /** Some variants are out of stock and some are in stock and available for purchase. */
     PARTIALLY_OUT_OF_STOCK = "PARTIALLY_OUT_OF_STOCK"
 }
 declare enum PreorderStatus$1 {
     UNKNOWN_PREORDER_STATUS = "UNKNOWN_PREORDER_STATUS",
+    /** All variants are enabled for preorder. */
     ENABLED = "ENABLED",
+    /** All variants are disabled for preorder. */
     DISABLED = "DISABLED",
+    /** Some variants are disabled and some are enabled for preorder. */
     PARTIALLY_ENABLED = "PARTIALLY_ENABLED"
 }
 declare enum ProductPreorderAvailability$1 {
     UNKNOWN_PREORDER_AVAILABILITY_STATUS = "UNKNOWN_PREORDER_AVAILABILITY_STATUS",
+    /** All the product variants are available for preorder. */
     ALL_VARIANTS = "ALL_VARIANTS",
+    /** None of the product variants are available for preorder. */
     NO_VARIANTS = "NO_VARIANTS",
+    /** Some of the product variants are available for preorder. */
     SOME_VARIANTS = "SOME_VARIANTS"
 }
 declare enum ProductType$1 {
+    /** Not implemented. */
     UNKNOWN_PRODUCT_TYPE = "UNKNOWN_PRODUCT_TYPE",
+    /** Physical product. */
     PHYSICAL = "PHYSICAL",
+    /** Digital product. */
     DIGITAL = "DIGITAL"
 }
 interface PhysicalProperties$1 {
@@ -13365,11 +13373,17 @@ interface SecuredMedia$1 {
     fileType?: FileType$1;
 }
 declare enum FileType$1 {
+    /** Unspecified file type. */
     UNSPECIFIED = "UNSPECIFIED",
+    /** Secure picture file. */
     SECURE_PICTURE = "SECURE_PICTURE",
+    /** Secure video file. */
     SECURE_VIDEO = "SECURE_VIDEO",
+    /** Secure document file. */
     SECURE_DOCUMENT = "SECURE_DOCUMENT",
+    /** Secure music file. */
     SECURE_MUSIC = "SECURE_MUSIC",
+    /** Secure archive file. */
     SECURE_ARCHIVE = "SECURE_ARCHIVE"
 }
 interface SubscriptionPricesInfo$1 {
@@ -13495,7 +13509,9 @@ interface SubscriptionDiscountDiscountOneOf$1 {
 }
 declare enum DiscountType$3 {
     UNKNOWN_DISCOUNT = "UNKNOWN_DISCOUNT",
+    /** Discount by a specific amount. */
     AMOUNT = "AMOUNT",
+    /** Discount by a percentage. */
     PERCENT = "PERCENT"
 }
 interface VariantSummary$1 {
@@ -13517,11 +13533,12 @@ interface CreateProductRequest$1 {
     fields?: SingleEntityOpsRequestedFields$1[];
 }
 declare enum SingleEntityOpsRequestedFields$1 {
+    /** Not implemented. */
     UNKNOWN_REQUESTED_FIELD = "UNKNOWN_REQUESTED_FIELD",
     URL = "URL",
     CURRENCY = "CURRENCY",
     INFO_SECTION = "INFO_SECTION",
-    /** You can request merchant data only if you have `WIX_STORES.PRODUCT_MERCHANT_DATA_READ` permission. */
+    /** You can request merchant data only if you have the `SCOPE.STORES.PRODUCT_READ_ADMIN` permission scope. */
     MERCHANT_DATA = "MERCHANT_DATA",
     PLAIN_DESCRIPTION = "PLAIN_DESCRIPTION",
     INFO_SECTION_PLAIN_DESCRIPTION = "INFO_SECTION_PLAIN_DESCRIPTION",
@@ -13958,14 +13975,11 @@ interface InventoryItemTrackingMethodOneOf$1 {
 }
 declare enum AvailabilityStatus$1 {
     UNKNOWN_AVAILABILITY_STATUS = "UNKNOWN_AVAILABILITY_STATUS",
+    /** Product is out of stock. */
     OUT_OF_STOCK = "OUT_OF_STOCK",
+    /** Product is in stock. See `quantity` field for exact amount in stock. */
     IN_STOCK = "IN_STOCK",
-    /**
-     * Whether the variant is available for preorder. InventoryItem will be available only when all below conditions are met:
-     * 1. the variant is out of stock
-     * 2. preorder is enabled on inventory item level (preorder_setting.enabled is true)
-     * 3. preorder limit wasn't reached (preorder_setting.limit)
-     */
+    /** Product is only available for preorder. See `preorderInfo` field for more info. */
     PREORDER = "PREORDER"
 }
 interface Product$1 {
@@ -14029,11 +14043,12 @@ interface BulkCreateProductsRequest$1 {
     fields?: RequestedFields$3[];
 }
 declare enum RequestedFields$3 {
+    /** Not implemented. */
     UNKNOWN_REQUESTED_FIELD = "UNKNOWN_REQUESTED_FIELD",
     URL = "URL",
     CURRENCY = "CURRENCY",
     INFO_SECTION = "INFO_SECTION",
-    /** You can request merchant data only if you have `WIX_STORES.PRODUCT_MERCHANT_DATA_READ` permission. */
+    /** You can request merchant data only if you have the `SCOPE.STORES.PRODUCT_READ_ADMIN` permission scope. */
     MERCHANT_DATA = "MERCHANT_DATA",
     PLAIN_DESCRIPTION = "PLAIN_DESCRIPTION",
     INFO_SECTION_PLAIN_DESCRIPTION = "INFO_SECTION_PLAIN_DESCRIPTION",
@@ -17153,7 +17168,9 @@ interface ProductMediaMediaOneOf {
 }
 declare enum MediaType {
     UNKNOWN_MEDIA_TYPE = "UNKNOWN_MEDIA_TYPE",
+    /** Image media type. */
     IMAGE = "IMAGE",
+    /** Video media type. */
     VIDEO = "VIDEO"
 }
 interface Thumbnail {
@@ -17238,8 +17255,11 @@ interface ConnectedOptionOptionSettingsOneOf {
     choicesSettings?: ChoicesSettings;
 }
 declare enum ProductOptionRenderType {
+    /** Not implemented. */
     UNKNOWN_OPTION_RENDER_TYPE = "UNKNOWN_OPTION_RENDER_TYPE",
+    /** Text choices. */
     TEXT_CHOICES = "TEXT_CHOICES",
+    /** Swatch choices. */
     SWATCH_CHOICES = "SWATCH_CHOICES"
 }
 interface ChoicesSettings {
@@ -17282,9 +17302,13 @@ interface ConnectedOptionChoiceValueOneOf {
 }
 declare enum ChoiceType {
     UNKNOWN_CHOICE_TYPE = "UNKNOWN_CHOICE_TYPE",
+    /** Text choice. */
     CHOICE_TEXT = "CHOICE_TEXT",
+    /** Single color choice. */
     ONE_COLOR = "ONE_COLOR",
+    /** Multiple colors choice. */
     MULTIPLE_COLORS = "MULTIPLE_COLORS",
+    /** Image choice. */
     IMAGE = "IMAGE"
 }
 interface ConnectedModifier extends ConnectedModifierModifierSettingsOneOf {
@@ -17309,9 +17333,13 @@ interface ConnectedModifierModifierSettingsOneOf {
     choicesSettings?: ModifierChoicesSettings;
 }
 declare enum ModifierRenderType {
+    /** Not implemented. */
     UNKNOWN_MODIFIER_RENDER_TYPE = "UNKNOWN_MODIFIER_RENDER_TYPE",
+    /** Free text. */
     FREE_TEXT = "FREE_TEXT",
+    /** Text choices. */
     TEXT_CHOICES = "TEXT_CHOICES",
+    /** Swatch choices. */
     SWATCH_CHOICES = "SWATCH_CHOICES"
 }
 interface FreeTextSettings {
@@ -17429,52 +17457,53 @@ interface FixedMonetaryAmount {
 interface Inventory {
     /**
      * Current availability status.
-     *
-     * + `IN_STOCK`: All variants are in stock and available for purchase
-     * + `OUT_OF_STOCK`: All variants are out of stock
-     * + `PARTIALLY_OUT_OF_STOCK`: Some variants are out of stock and some are in stock and available for purchase
      * @readonly
      */
     availabilityStatus?: InventoryAvailabilityStatus;
     /**
-     * Current preorder status/
-     *
-     * + `ENABLED`: All variants are enabled for preorder
-     * + `DISABLED`: All variants are disabled for preorder
-     * + `PARTIALLY_ENABLED`: Some variants are disabled and some are enabled for preorder
+     * Current preorder status.
      * @readonly
      */
     preorderStatus?: PreorderStatus;
     /**
-     * Supported values:
-     * + `ALL_VARIANTS`: All the product variants are available for preorder.
-     * + `NO_VARIANTS`: None of the product variants are available for preorder.
-     * + `SOME_VARIANTS`: Some of the product variants are available for preorder.
+     * Preorder availability status.
      * @readonly
      */
     preorderAvailability?: ProductPreorderAvailability;
 }
 declare enum InventoryAvailabilityStatus {
     UNKNOWN_AVAILABILITY_STATUS = "UNKNOWN_AVAILABILITY_STATUS",
+    /** All variants are in stock and available for purchase. */
     IN_STOCK = "IN_STOCK",
+    /** All variants are out of stock. */
     OUT_OF_STOCK = "OUT_OF_STOCK",
+    /** Some variants are out of stock and some are in stock and available for purchase. */
     PARTIALLY_OUT_OF_STOCK = "PARTIALLY_OUT_OF_STOCK"
 }
 declare enum PreorderStatus {
     UNKNOWN_PREORDER_STATUS = "UNKNOWN_PREORDER_STATUS",
+    /** All variants are enabled for preorder. */
     ENABLED = "ENABLED",
+    /** All variants are disabled for preorder. */
     DISABLED = "DISABLED",
+    /** Some variants are disabled and some are enabled for preorder. */
     PARTIALLY_ENABLED = "PARTIALLY_ENABLED"
 }
 declare enum ProductPreorderAvailability {
     UNKNOWN_PREORDER_AVAILABILITY_STATUS = "UNKNOWN_PREORDER_AVAILABILITY_STATUS",
+    /** All the product variants are available for preorder. */
     ALL_VARIANTS = "ALL_VARIANTS",
+    /** None of the product variants are available for preorder. */
     NO_VARIANTS = "NO_VARIANTS",
+    /** Some of the product variants are available for preorder. */
     SOME_VARIANTS = "SOME_VARIANTS"
 }
 declare enum ProductType {
+    /** Not implemented. */
     UNKNOWN_PRODUCT_TYPE = "UNKNOWN_PRODUCT_TYPE",
+    /** Physical product. */
     PHYSICAL = "PHYSICAL",
+    /** Digital product. */
     DIGITAL = "DIGITAL"
 }
 interface PhysicalProperties {
@@ -17748,11 +17777,17 @@ interface SecuredMedia {
     fileType?: FileType;
 }
 declare enum FileType {
+    /** Unspecified file type. */
     UNSPECIFIED = "UNSPECIFIED",
+    /** Secure picture file. */
     SECURE_PICTURE = "SECURE_PICTURE",
+    /** Secure video file. */
     SECURE_VIDEO = "SECURE_VIDEO",
+    /** Secure document file. */
     SECURE_DOCUMENT = "SECURE_DOCUMENT",
+    /** Secure music file. */
     SECURE_MUSIC = "SECURE_MUSIC",
+    /** Secure archive file. */
     SECURE_ARCHIVE = "SECURE_ARCHIVE"
 }
 interface SubscriptionPricesInfo {
@@ -17878,7 +17913,9 @@ interface SubscriptionDiscountDiscountOneOf {
 }
 declare enum DiscountType$2 {
     UNKNOWN_DISCOUNT = "UNKNOWN_DISCOUNT",
+    /** Discount by a specific amount. */
     AMOUNT = "AMOUNT",
+    /** Discount by a percentage. */
     PERCENT = "PERCENT"
 }
 interface VariantSummary {
@@ -17900,11 +17937,12 @@ interface CreateProductRequest {
     fields?: SingleEntityOpsRequestedFields[];
 }
 declare enum SingleEntityOpsRequestedFields {
+    /** Not implemented. */
     UNKNOWN_REQUESTED_FIELD = "UNKNOWN_REQUESTED_FIELD",
     URL = "URL",
     CURRENCY = "CURRENCY",
     INFO_SECTION = "INFO_SECTION",
-    /** You can request merchant data only if you have `WIX_STORES.PRODUCT_MERCHANT_DATA_READ` permission. */
+    /** You can request merchant data only if you have the `SCOPE.STORES.PRODUCT_READ_ADMIN` permission scope. */
     MERCHANT_DATA = "MERCHANT_DATA",
     PLAIN_DESCRIPTION = "PLAIN_DESCRIPTION",
     INFO_SECTION_PLAIN_DESCRIPTION = "INFO_SECTION_PLAIN_DESCRIPTION",
@@ -18341,14 +18379,11 @@ interface InventoryItemTrackingMethodOneOf {
 }
 declare enum AvailabilityStatus {
     UNKNOWN_AVAILABILITY_STATUS = "UNKNOWN_AVAILABILITY_STATUS",
+    /** Product is out of stock. */
     OUT_OF_STOCK = "OUT_OF_STOCK",
+    /** Product is in stock. See `quantity` field for exact amount in stock. */
     IN_STOCK = "IN_STOCK",
-    /**
-     * Whether the variant is available for preorder. InventoryItem will be available only when all below conditions are met:
-     * 1. the variant is out of stock
-     * 2. preorder is enabled on inventory item level (preorder_setting.enabled is true)
-     * 3. preorder limit wasn't reached (preorder_setting.limit)
-     */
+    /** Product is only available for preorder. See `preorderInfo` field for more info. */
     PREORDER = "PREORDER"
 }
 interface Product {
@@ -18412,11 +18447,12 @@ interface BulkCreateProductsRequest {
     fields?: RequestedFields$2[];
 }
 declare enum RequestedFields$2 {
+    /** Not implemented. */
     UNKNOWN_REQUESTED_FIELD = "UNKNOWN_REQUESTED_FIELD",
     URL = "URL",
     CURRENCY = "CURRENCY",
     INFO_SECTION = "INFO_SECTION",
-    /** You can request merchant data only if you have `WIX_STORES.PRODUCT_MERCHANT_DATA_READ` permission. */
+    /** You can request merchant data only if you have the `SCOPE.STORES.PRODUCT_READ_ADMIN` permission scope. */
     MERCHANT_DATA = "MERCHANT_DATA",
     PLAIN_DESCRIPTION = "PLAIN_DESCRIPTION",
     INFO_SECTION_PLAIN_DESCRIPTION = "INFO_SECTION_PLAIN_DESCRIPTION",
@@ -20257,7 +20293,9 @@ interface Sorting$3 {
     order?: SortOrder$3;
 }
 declare enum SortOrder$3 {
+    /** Ascending order. */
     ASC = "ASC",
+    /** Descending order. */
     DESC = "DESC"
 }
 interface CursorPaging$3 {
@@ -20595,7 +20633,9 @@ interface Sorting$2 {
     order?: SortOrder$2;
 }
 declare enum SortOrder$2 {
+    /** Ascending order. */
     ASC = "ASC",
+    /** Descending order. */
     DESC = "DESC"
 }
 interface CursorPaging$2 {
@@ -20886,9 +20926,6 @@ interface StoresLocation$1 {
     wixLocationId?: string | null;
     /**
      * Location type.
-     *
-     * + `VIRTUAL`: Online store.
-     * + `PHYSICAL`: Physical location. For example, for POS.
      * @readonly
      */
     locationType?: LocationType$1;
@@ -20902,9 +20939,9 @@ interface StoresLocation$1 {
 }
 declare enum LocationType$1 {
     UNKNOWN_LOCATION_TYPE = "UNKNOWN_LOCATION_TYPE",
-    /** Online stores location. */
+    /** Online store. */
     VIRTUAL = "VIRTUAL",
-    /** Physical location like POS */
+    /** Physical location, for example, POS. */
     PHYSICAL = "PHYSICAL"
 }
 interface GetStoresLocationRequest$1 {
@@ -21034,9 +21071,6 @@ interface StoresLocation {
     wixLocationId?: string | null;
     /**
      * Location type.
-     *
-     * + `VIRTUAL`: Online store.
-     * + `PHYSICAL`: Physical location. For example, for POS.
      * @readonly
      */
     locationType?: LocationType;
@@ -21050,9 +21084,9 @@ interface StoresLocation {
 }
 declare enum LocationType {
     UNKNOWN_LOCATION_TYPE = "UNKNOWN_LOCATION_TYPE",
-    /** Online stores location. */
+    /** Online store. */
     VIRTUAL = "VIRTUAL",
-    /** Physical location like POS */
+    /** Physical location, for example, POS. */
     PHYSICAL = "PHYSICAL"
 }
 interface GetStoresLocationRequest {