@wix/auto_sdk_stores_customizations-v-3 1.0.81 → 1.0.82

package/build/cjs/index.typings.d.ts

@@ -198,6 +198,18 @@ interface Choice extends ChoiceValueOneOf {
      * Only valid for ONE_COLOR choices; not populated for other choice types.
      */
     displayImage?: string;
+    /**
+     * IDs of the primary choices this choice is grouped under.
+     *
+     * A choice that has `primaryChoiceIds` is a "linked" choice; a choice without `primaryChoiceIds` is a "primary" choice.
+     * A linked choice can reference up to 4 primary choices and appears nested under each of them on the storefront,
+     * rather than in the top-level choice list.
+     *
+     * Only one level of grouping is supported: a primary choice cannot itself be a linked choice.
+     * @format GUID
+     * @maxSize 4
+     */
+    primaryChoiceIds?: string[];
 }
 /** @oneof */
 interface ChoiceValueOneOf {
@@ -793,7 +805,7 @@ interface ReorderCustomizationChoicesRequest {
     /** Revision number, which increments by 1 each time the customization is updated. To prevent conflicting changes, the current revision must be passed when updating the customization. */
     revision: string;
     /**
-     * Choice IDs in the desired display order. Must contain exactly the same set of IDs as the customization's current choices — no additions or removals.
+     * Choice IDs in the desired display order. Must contain exactly the same IDs as the customization's current choices, with no additions, removals, or duplicates.
      * @format GUID
      * @minSize 1
      * @maxSize 200
@@ -802,20 +814,20 @@ interface ReorderCustomizationChoicesRequest {
     /**
      * Fields to include in the response.
      *
-     * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * Supported values: `ASSIGNED_PRODUCTS_COUNT`.
      * @maxSize 100
      */
     fields?: RequestedFieldsWithLiterals[];
 }
 interface ReorderCustomizationChoicesResponse {
-    /** Updated customization. */
+    /** Updated customization, with `choices` in the new order and `choicesSettings.sortOrder` set to `MANUAL`. */
     customization?: Customization;
 }
 /** Additional error details returned with the `CHOICE_IDS_MISMATCH` error. */
 interface ChoiceIdsMismatchData {
-    /** Choice IDs that exist in the customization but are missing from the request. */
+    /** Choice IDs that exist in the customization but are missing from `choiceIds`. */
     missingIds?: string[];
-    /** Choice IDs included in the request that don't exist in the customization. */
+    /** Choice IDs included in `choiceIds` that don't exist in the customization, or that appear in `choiceIds` more than once. */
     extraIds?: string[];
 }
 interface BulkAddCustomizationChoicesRequest {
@@ -1889,10 +1901,13 @@ interface UpdateCustomizationChoicesOptions {
     fields?: RequestedFieldsWithLiterals[];
 }
 /**
- * Reorders a customization's choices. The new order is persisted and reflected in the customization's choices list.
- * Calling this endpoint sets `choicesSettings.sortOrder` to `MANUAL`.
+ * Sets the display order of a customization's choices.
+ *
+ * Each time the customization is updated, `revision` increments by 1. The current `revision` must be passed when updating the customization. This ensures you're working with the latest customization and prevents unintended overwrites.
  *
- * To control how choices are sorted in storefront filter panels, use [Update Customization](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/customizations-v3/update-customization) to set the `choicesSettings.sortOrder` field.
+ * The new order is persisted in the customization's `choices` list. Calling this method also sets `choicesSettings.sortOrder` to `MANUAL`.
+ *
+ * To change how choices are sorted in storefront filter panels without specifying an explicit order, call [Update Customization](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/customizations-v3/update-customization) and set the `choicesSettings.sortOrder` field.
  * @param customizationId - Customization ID.
  * @param revision - Revision number, which increments by 1 each time the customization is updated. To prevent conflicting changes, the current revision must be passed when updating the customization.
  * @public
@@ -1909,7 +1924,7 @@ declare function reorderCustomizationChoices(customizationId: string, revision:
 }>;
 interface ReorderCustomizationChoicesOptions {
     /**
-     * Choice IDs in the desired display order. Must contain exactly the same set of IDs as the customization's current choices — no additions or removals.
+     * Choice IDs in the desired display order. Must contain exactly the same IDs as the customization's current choices, with no additions, removals, or duplicates.
      * @format GUID
      * @minSize 1
      * @maxSize 200
@@ -1918,7 +1933,7 @@ interface ReorderCustomizationChoicesOptions {
     /**
      * Fields to include in the response.
      *
-     * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * Supported values: `ASSIGNED_PRODUCTS_COUNT`.
      * @maxSize 100
      */
     fields?: RequestedFieldsWithLiterals[];