@wix/auto_sdk_stores_customizations-v-3 1.0.80 → 1.0.82

package/build/cjs/schemas.js

@@ -48,8 +48,12 @@ __export(schemas_exports, {
   QueryCustomizationsResponse: () => QueryCustomizationsResponse,
   RemoveCustomizationChoicesRequest: () => RemoveCustomizationChoicesRequest,
   RemoveCustomizationChoicesResponse: () => RemoveCustomizationChoicesResponse,
+  ReorderCustomizationChoicesRequest: () => ReorderCustomizationChoicesRequest,
+  ReorderCustomizationChoicesResponse: () => ReorderCustomizationChoicesResponse,
   SetCustomizationChoicesRequest: () => SetCustomizationChoicesRequest,
   SetCustomizationChoicesResponse: () => SetCustomizationChoicesResponse,
+  UpdateCustomizationChoicesRequest: () => UpdateCustomizationChoicesRequest,
+  UpdateCustomizationChoicesResponse: () => UpdateCustomizationChoicesResponse,
   UpdateCustomizationRequest: () => UpdateCustomizationRequest,
   UpdateCustomizationResponse: () => UpdateCustomizationResponse
 });
@@ -118,7 +122,11 @@ var CreateCustomizationRequest = z.object({
                 name: z.string().describe("Choice name.").min(1).max(50).optional(),
                 defaultAddedPrice: z.string().describe(
                   "Default amount added to a product's price when this customization is assigned to a modifier."
-                ).optional().nullable()
+                ).optional().nullable(),
+                displayImage: z.string().describe(
+                  "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+                ).optional(),
+                primaryChoiceIds: z.array(z.string()).max(4).optional()
               }),
               z.xor([
                 z.object({ colorCode: z.never().optional() }),
@@ -199,7 +207,11 @@ var CreateCustomizationResponse = z.intersection(
               name: z.string().describe("Choice name.").min(1).max(50).optional(),
               defaultAddedPrice: z.string().describe(
                 "Default amount added to a product's price when this customization is assigned to a modifier."
-              ).optional().nullable()
+              ).optional().nullable(),
+              displayImage: z.string().describe(
+                "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+              ).optional(),
+              primaryChoiceIds: z.array(z.string()).max(4).optional()
             }),
             z.xor([
               z.object({ colorCode: z.never().optional() }),
@@ -223,7 +235,7 @@ var GetCustomizationRequest = z.object({
     "Must be a valid GUID"
   ),
   options: z.object({
-    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT"])).max(100).optional()
+    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT", "CHOICE_DISPLAY_IMAGE"])).max(100).optional()
   }).optional()
 });
 var GetCustomizationResponse = z.intersection(
@@ -288,7 +300,11 @@ var GetCustomizationResponse = z.intersection(
               name: z.string().describe("Choice name.").min(1).max(50).optional(),
               defaultAddedPrice: z.string().describe(
                 "Default amount added to a product's price when this customization is assigned to a modifier."
-              ).optional().nullable()
+              ).optional().nullable(),
+              displayImage: z.string().describe(
+                "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+              ).optional(),
+              primaryChoiceIds: z.array(z.string()).max(4).optional()
             }),
             z.xor([
               z.object({ colorCode: z.never().optional() }),
@@ -368,7 +384,11 @@ var UpdateCustomizationRequest = z.object({
                 name: z.string().describe("Choice name.").min(1).max(50).optional(),
                 defaultAddedPrice: z.string().describe(
                   "Default amount added to a product's price when this customization is assigned to a modifier."
-                ).optional().nullable()
+                ).optional().nullable(),
+                displayImage: z.string().describe(
+                  "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+                ).optional(),
+                primaryChoiceIds: z.array(z.string()).max(4).optional()
               }),
               z.xor([
                 z.object({ colorCode: z.never().optional() }),
@@ -387,7 +407,7 @@ var UpdateCustomizationRequest = z.object({
     ])
   ).describe("Customization to update."),
   options: z.object({
-    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT"])).max(100).optional()
+    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT", "CHOICE_DISPLAY_IMAGE"])).max(100).optional()
   }).optional()
 });
 var UpdateCustomizationResponse = z.intersection(
@@ -452,7 +472,11 @@ var UpdateCustomizationResponse = z.intersection(
               name: z.string().describe("Choice name.").min(1).max(50).optional(),
               defaultAddedPrice: z.string().describe(
                 "Default amount added to a product's price when this customization is assigned to a modifier."
-              ).optional().nullable()
+              ).optional().nullable(),
+              displayImage: z.string().describe(
+                "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+              ).optional(),
+              primaryChoiceIds: z.array(z.string()).max(4).optional()
             }),
             z.xor([
               z.object({ colorCode: z.never().optional() }),
@@ -576,7 +600,7 @@ var QueryCustomizationsRequest = z.object({
     ).optional()
   }).catchall(z.any()).describe("Query options."),
   options: z.object({
-    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT"])).max(100).optional()
+    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT", "CHOICE_DISPLAY_IMAGE"])).max(100).optional()
   }).optional()
 });
 var QueryCustomizationsResponse = z.object({
@@ -645,7 +669,11 @@ var QueryCustomizationsResponse = z.object({
                   name: z.string().describe("Choice name.").min(1).max(50).optional(),
                   defaultAddedPrice: z.string().describe(
                     "Default amount added to a product's price when this customization is assigned to a modifier."
-                  ).optional().nullable()
+                  ).optional().nullable(),
+                  displayImage: z.string().describe(
+                    "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+                  ).optional(),
+                  primaryChoiceIds: z.array(z.string()).max(4).optional()
                 }),
                 z.xor([
                   z.object({ colorCode: z.never().optional() }),
@@ -743,7 +771,11 @@ var BulkCreateCustomizationsRequest = z.object({
                   name: z.string().describe("Choice name.").min(1).max(50).optional(),
                   defaultAddedPrice: z.string().describe(
                     "Default amount added to a product's price when this customization is assigned to a modifier."
-                  ).optional().nullable()
+                  ).optional().nullable(),
+                  displayImage: z.string().describe(
+                    "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+                  ).optional(),
+                  primaryChoiceIds: z.array(z.string()).max(4).optional()
                 }),
                 z.xor([
                   z.object({ colorCode: z.never().optional() }),
@@ -851,7 +883,11 @@ var BulkCreateCustomizationsResponse = z.object({
                     name: z.string().describe("Choice name.").min(1).max(50).optional(),
                     defaultAddedPrice: z.string().describe(
                       "Default amount added to a product's price when this customization is assigned to a modifier."
-                    ).optional().nullable()
+                    ).optional().nullable(),
+                    displayImage: z.string().describe(
+                      "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+                    ).optional(),
+                    primaryChoiceIds: z.array(z.string()).max(4).optional()
                   }),
                   z.xor([
                     z.object({ colorCode: z.never().optional() }),
@@ -900,7 +936,11 @@ var AddCustomizationChoicesRequest = z.object({
         name: z.string().describe("Choice name.").min(1).max(50).optional(),
         defaultAddedPrice: z.string().describe(
           "Default amount added to a product's price when this customization is assigned to a modifier."
-        ).optional().nullable()
+        ).optional().nullable(),
+        displayImage: z.string().describe(
+          "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+        ).optional(),
+        primaryChoiceIds: z.array(z.string()).max(4).optional()
       }),
       z.xor([
         z.object({ colorCode: z.never().optional() }),
@@ -913,7 +953,7 @@ var AddCustomizationChoicesRequest = z.object({
     )
   ).min(1).max(100),
   options: z.object({
-    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT"])).max(100).optional()
+    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT", "CHOICE_DISPLAY_IMAGE"])).max(100).optional()
   }).optional()
 });
 var AddCustomizationChoicesResponse = z.object({
@@ -981,7 +1021,11 @@ var AddCustomizationChoicesResponse = z.object({
                 name: z.string().describe("Choice name.").min(1).max(50).optional(),
                 defaultAddedPrice: z.string().describe(
                   "Default amount added to a product's price when this customization is assigned to a modifier."
-                ).optional().nullable()
+                ).optional().nullable(),
+                displayImage: z.string().describe(
+                  "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+                ).optional(),
+                primaryChoiceIds: z.array(z.string()).max(4).optional()
               }),
               z.xor([
                 z.object({ colorCode: z.never().optional() }),
@@ -1019,7 +1063,11 @@ var SetCustomizationChoicesRequest = z.object({
         name: z.string().describe("Choice name.").min(1).max(50).optional(),
         defaultAddedPrice: z.string().describe(
           "Default amount added to a product's price when this customization is assigned to a modifier."
-        ).optional().nullable()
+        ).optional().nullable(),
+        displayImage: z.string().describe(
+          "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+        ).optional(),
+        primaryChoiceIds: z.array(z.string()).max(4).optional()
       }),
       z.xor([
         z.object({ colorCode: z.never().optional() }),
@@ -1032,7 +1080,7 @@ var SetCustomizationChoicesRequest = z.object({
     )
   ).min(1).max(200),
   options: z.object({
-    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT"])).max(100).optional()
+    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT", "CHOICE_DISPLAY_IMAGE"])).max(100).optional()
   }).optional()
 });
 var SetCustomizationChoicesResponse = z.object({
@@ -1100,7 +1148,11 @@ var SetCustomizationChoicesResponse = z.object({
                 name: z.string().describe("Choice name.").min(1).max(50).optional(),
                 defaultAddedPrice: z.string().describe(
                   "Default amount added to a product's price when this customization is assigned to a modifier."
-                ).optional().nullable()
+                ).optional().nullable(),
+                displayImage: z.string().describe(
+                  "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+                ).optional(),
+                primaryChoiceIds: z.array(z.string()).max(4).optional()
               }),
               z.xor([
                 z.object({ colorCode: z.never().optional() }),
@@ -1127,7 +1179,7 @@ var RemoveCustomizationChoicesRequest = z.object({
   choiceIds: z.array(z.string()).min(1).max(100),
   options: z.object({
     revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe("Customization revision.").optional(),
-    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT"])).max(100).optional()
+    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT", "CHOICE_DISPLAY_IMAGE"])).max(100).optional()
   }).optional()
 });
 var RemoveCustomizationChoicesResponse = z.object({
@@ -1195,7 +1247,11 @@ var RemoveCustomizationChoicesResponse = z.object({
                 name: z.string().describe("Choice name.").min(1).max(50).optional(),
                 defaultAddedPrice: z.string().describe(
                   "Default amount added to a product's price when this customization is assigned to a modifier."
-                ).optional().nullable()
+                ).optional().nullable(),
+                displayImage: z.string().describe(
+                  "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+                ).optional(),
+                primaryChoiceIds: z.array(z.string()).max(4).optional()
               }),
               z.xor([
                 z.object({ colorCode: z.never().optional() }),
@@ -1214,6 +1270,241 @@ var RemoveCustomizationChoicesResponse = z.object({
     ])
   ).describe("Updated customization.").optional()
 });
+var UpdateCustomizationChoicesRequest = z.object({
+  customizationId: z.string().describe("Customization ID.").regex(
+    /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
+    "Must be a valid GUID"
+  ),
+  revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
+    "Revision number, which increments by 1 each time the customization is updated.\nTo prevent conflicting changes,\nthe current revision must be passed when updating the customization."
+  ),
+  options: z.object({
+    choices: z.array(
+      z.object({
+        choice: z.intersection(
+          z.object({
+            _id: z.string().describe("Choice ID.").regex(
+              /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
+              "Must be a valid GUID"
+            ).optional(),
+            choiceType: z.enum(["CHOICE_TEXT", "ONE_COLOR"]).optional(),
+            key: z.string().describe(
+              "A read-only identifier generated from the choice name.\n\nUse `key` in the `catalogReference.options` object when [integrating Catalog V3 with eCommerce APIs](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/e-commerce-integration)."
+            ).min(1).max(50).optional().nullable(),
+            name: z.string().describe("Choice name.").min(1).max(50).optional(),
+            defaultAddedPrice: z.string().describe(
+              "Default amount added to a product's price when this customization is assigned to a modifier."
+            ).optional().nullable(),
+            displayImage: z.string().describe(
+              "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+            ).optional(),
+            primaryChoiceIds: z.array(z.string()).max(4).optional()
+          }),
+          z.xor([
+            z.object({ colorCode: z.never().optional() }),
+            z.object({
+              colorCode: z.string().describe(
+                "Color code in HEX format, [as described by MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color)."
+              ).min(3).max(20)
+            })
+          ])
+        ).describe("Choice to update.")
+      })
+    ).min(1).max(100),
+    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT", "CHOICE_DISPLAY_IMAGE"])).max(100).optional()
+  })
+});
+var UpdateCustomizationChoicesResponse = z.object({
+  customization: z.intersection(
+    z.object({
+      _id: z.string().describe("Customization ID.").min(1).max(36).optional().nullable(),
+      revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
+        "Revision number, which increments by 1 each time the customization is updated.\nTo prevent conflicting changes,\nthe current revision must be passed when updating the customization.\n\nIgnored when creating a customization."
+      ).optional().nullable(),
+      _createdDate: z.date().describe("Date and time the customization was created.").optional().nullable(),
+      _updatedDate: z.date().describe("Date and time the customization was updated.").optional().nullable(),
+      key: z.string().describe(
+        "A read-only identifier generated from the customization name.\n\nUse `key` in the `catalogReference.options` object when [integrating Catalog V3 with eCommerce APIs](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/e-commerce-integration)."
+      ).min(1).max(50).optional().nullable(),
+      name: z.string().describe(
+        'Customization name for options (for example, `"color"`, `"size"`) and modifiers (for example, `"greeting card"`).'
+      ).min(1).max(50).optional(),
+      customizationType: z.enum(["PRODUCT_OPTION", "MODIFIER"]).describe("Customization type.").optional(),
+      customizationRenderType: z.enum(["FREE_TEXT", "TEXT_CHOICES", "SWATCH_CHOICES"]).describe(
+        "Customization render type.\n\nDefines how the customization will be displayed in the storefront."
+      ).optional(),
+      assignedProductsCount: z.number().int().describe(
+        'Number of products this customization is assigned to.\n> **Note:** Returned only when you pass `"ASSIGNED_PRODUCTS_COUNT"` to the `fields` array in Customizations API requests.'
+      ).optional().nullable()
+    }),
+    z.xor([
+      z.object({
+        freeTextInput: z.never().optional(),
+        choicesSettings: z.never().optional()
+      }),
+      z.object({
+        choicesSettings: z.never().optional(),
+        freeTextInput: z.object({
+          minCharCount: z.number().int().describe("Minimum text character length.").optional(),
+          maxCharCount: z.number().int().describe("Maximum text character length.").max(500).optional(),
+          defaultAddedPrice: z.string().describe(
+            "Default amount added to a product's price when this choice is assigned to a modifier."
+          ).optional().nullable(),
+          title: z.string().describe(
+            "Title to display to customer for their free-text input."
+          ).min(1).max(100).optional(),
+          key: z.string().describe(
+            "A read-only identifier generated from the title.\n\nUse `key` in the `catalogReference.options` object when [integrating Catalog V3 with eCommerce APIs](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/e-commerce-integration)."
+          ).min(1).max(150).optional().nullable()
+        }).describe(
+          "Free text input settings.\n\n> **Note:** To be passed along with `customizationRenderType: FREE_TEXT`."
+        )
+      }),
+      z.object({
+        freeTextInput: z.never().optional(),
+        choicesSettings: z.object({
+          choices: z.array(
+            z.intersection(
+              z.object({
+                _id: z.string().describe("Choice ID.").regex(
+                  /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
+                  "Must be a valid GUID"
+                ).optional(),
+                choiceType: z.enum(["CHOICE_TEXT", "ONE_COLOR"]).describe(
+                  "Choice type.\n\n> **Notes:**\n> + For `customizationRenderType: SWATCH_CHOICES`, the supported `choiceType` value is: `ONE_COLOR`.\n> + For a `customizationRenderType` of `TEXT_CHOICES`, the supported `choiceType` value is: `CHOICE_TEXT`."
+                ).optional(),
+                key: z.string().describe(
+                  "A read-only identifier generated from the choice name.\n\nUse `key` in the `catalogReference.options` object when [integrating Catalog V3 with eCommerce APIs](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/e-commerce-integration)."
+                ).min(1).max(50).optional().nullable(),
+                name: z.string().describe("Choice name.").min(1).max(50).optional(),
+                defaultAddedPrice: z.string().describe(
+                  "Default amount added to a product's price when this customization is assigned to a modifier."
+                ).optional().nullable(),
+                displayImage: z.string().describe(
+                  "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+                ).optional(),
+                primaryChoiceIds: z.array(z.string()).max(4).optional()
+              }),
+              z.xor([
+                z.object({ colorCode: z.never().optional() }),
+                z.object({
+                  colorCode: z.string().describe(
+                    "Color code in HEX format, [as described by MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color)."
+                  ).min(3).max(20)
+                })
+              ])
+            )
+          ).min(1).max(200).optional()
+        }).describe(
+          "Choices settings.\n\n> **Note:** Must be passed along with `customizationRenderType` of `SWATCH_CHOICES` and `TEXT_CHOICES`."
+        )
+      })
+    ])
+  ).describe("Updated customization.").optional()
+});
+var ReorderCustomizationChoicesRequest = z.object({
+  customizationId: z.string().describe("Customization ID.").regex(
+    /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
+    "Must be a valid GUID"
+  ),
+  revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
+    "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."
+  ),
+  options: z.object({
+    choiceIds: z.array(z.string()).min(1).max(200),
+    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT", "CHOICE_DISPLAY_IMAGE"])).max(100).optional()
+  })
+});
+var ReorderCustomizationChoicesResponse = z.object({
+  customization: z.intersection(
+    z.object({
+      _id: z.string().describe("Customization ID.").min(1).max(36).optional().nullable(),
+      revision: z.string().regex(/^-?\d+$/, "Must be a valid Int64 string").describe(
+        "Revision number, which increments by 1 each time the customization is updated.\nTo prevent conflicting changes,\nthe current revision must be passed when updating the customization.\n\nIgnored when creating a customization."
+      ).optional().nullable(),
+      _createdDate: z.date().describe("Date and time the customization was created.").optional().nullable(),
+      _updatedDate: z.date().describe("Date and time the customization was updated.").optional().nullable(),
+      key: z.string().describe(
+        "A read-only identifier generated from the customization name.\n\nUse `key` in the `catalogReference.options` object when [integrating Catalog V3 with eCommerce APIs](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/e-commerce-integration)."
+      ).min(1).max(50).optional().nullable(),
+      name: z.string().describe(
+        'Customization name for options (for example, `"color"`, `"size"`) and modifiers (for example, `"greeting card"`).'
+      ).min(1).max(50).optional(),
+      customizationType: z.enum(["PRODUCT_OPTION", "MODIFIER"]).describe("Customization type.").optional(),
+      customizationRenderType: z.enum(["FREE_TEXT", "TEXT_CHOICES", "SWATCH_CHOICES"]).describe(
+        "Customization render type.\n\nDefines how the customization will be displayed in the storefront."
+      ).optional(),
+      assignedProductsCount: z.number().int().describe(
+        'Number of products this customization is assigned to.\n> **Note:** Returned only when you pass `"ASSIGNED_PRODUCTS_COUNT"` to the `fields` array in Customizations API requests.'
+      ).optional().nullable()
+    }),
+    z.xor([
+      z.object({
+        freeTextInput: z.never().optional(),
+        choicesSettings: z.never().optional()
+      }),
+      z.object({
+        choicesSettings: z.never().optional(),
+        freeTextInput: z.object({
+          minCharCount: z.number().int().describe("Minimum text character length.").optional(),
+          maxCharCount: z.number().int().describe("Maximum text character length.").max(500).optional(),
+          defaultAddedPrice: z.string().describe(
+            "Default amount added to a product's price when this choice is assigned to a modifier."
+          ).optional().nullable(),
+          title: z.string().describe(
+            "Title to display to customer for their free-text input."
+          ).min(1).max(100).optional(),
+          key: z.string().describe(
+            "A read-only identifier generated from the title.\n\nUse `key` in the `catalogReference.options` object when [integrating Catalog V3 with eCommerce APIs](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/e-commerce-integration)."
+          ).min(1).max(150).optional().nullable()
+        }).describe(
+          "Free text input settings.\n\n> **Note:** To be passed along with `customizationRenderType: FREE_TEXT`."
+        )
+      }),
+      z.object({
+        freeTextInput: z.never().optional(),
+        choicesSettings: z.object({
+          choices: z.array(
+            z.intersection(
+              z.object({
+                _id: z.string().describe("Choice ID.").regex(
+                  /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
+                  "Must be a valid GUID"
+                ).optional(),
+                choiceType: z.enum(["CHOICE_TEXT", "ONE_COLOR"]).describe(
+                  "Choice type.\n\n> **Notes:**\n> + For `customizationRenderType: SWATCH_CHOICES`, the supported `choiceType` value is: `ONE_COLOR`.\n> + For a `customizationRenderType` of `TEXT_CHOICES`, the supported `choiceType` value is: `CHOICE_TEXT`."
+                ).optional(),
+                key: z.string().describe(
+                  "A read-only identifier generated from the choice name.\n\nUse `key` in the `catalogReference.options` object when [integrating Catalog V3 with eCommerce APIs](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/e-commerce-integration)."
+                ).min(1).max(50).optional().nullable(),
+                name: z.string().describe("Choice name.").min(1).max(50).optional(),
+                defaultAddedPrice: z.string().describe(
+                  "Default amount added to a product's price when this customization is assigned to a modifier."
+                ).optional().nullable(),
+                displayImage: z.string().describe(
+                  "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+                ).optional(),
+                primaryChoiceIds: z.array(z.string()).max(4).optional()
+              }),
+              z.xor([
+                z.object({ colorCode: z.never().optional() }),
+                z.object({
+                  colorCode: z.string().describe(
+                    "Color code in HEX format, [as described by MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color)."
+                  ).min(3).max(20)
+                })
+              ])
+            )
+          ).min(1).max(200).optional()
+        }).describe(
+          "Choices settings.\n\n> **Note:** Must be passed along with `customizationRenderType` of `SWATCH_CHOICES` and `TEXT_CHOICES`."
+        )
+      })
+    ])
+  ).describe(
+    "Updated customization, with `choices` in the new order and `choicesSettings.sortOrder` set to `MANUAL`."
+  ).optional()
+});
 var BulkAddCustomizationChoicesRequest = z.object({
   customizationsChoices: z.array(
     z.object({
@@ -1232,7 +1523,11 @@ var BulkAddCustomizationChoicesRequest = z.object({
             name: z.string().describe("Choice name.").min(1).max(50).optional(),
             defaultAddedPrice: z.string().describe(
               "Default amount added to a product's price when this customization is assigned to a modifier."
-            ).optional().nullable()
+            ).optional().nullable(),
+            displayImage: z.string().describe(
+              "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+            ).optional(),
+            primaryChoiceIds: z.array(z.string()).max(4).optional()
           }),
           z.xor([
             z.object({ colorCode: z.never().optional() }),
@@ -1250,7 +1545,7 @@ var BulkAddCustomizationChoicesRequest = z.object({
     returnEntity: z.boolean().describe(
       "Whether to return the full customization entities in the response.\n\nDefault: `false`"
     ).optional(),
-    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT"])).max(100).optional()
+    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT", "CHOICE_DISPLAY_IMAGE"])).max(100).optional()
   }).optional()
 });
 var BulkAddCustomizationChoicesResponse = z.object({
@@ -1336,7 +1631,11 @@ var BulkAddCustomizationChoicesResponse = z.object({
                     name: z.string().describe("Choice name.").min(1).max(50).optional(),
                     defaultAddedPrice: z.string().describe(
                       "Default amount added to a product's price when this customization is assigned to a modifier."
-                    ).optional().nullable()
+                    ).optional().nullable(),
+                    displayImage: z.string().describe(
+                      "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+                    ).optional(),
+                    primaryChoiceIds: z.array(z.string()).max(4).optional()
                   }),
                   z.xor([
                     z.object({ colorCode: z.never().optional() }),
@@ -1429,7 +1728,11 @@ var BulkUpdateCustomizationsRequest = z.object({
                     name: z.string().describe("Choice name.").min(1).max(50).optional(),
                     defaultAddedPrice: z.string().describe(
                       "Default amount added to a product's price when this customization is assigned to a modifier."
-                    ).optional().nullable()
+                    ).optional().nullable(),
+                    displayImage: z.string().describe(
+                      "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+                    ).optional(),
+                    primaryChoiceIds: z.array(z.string()).max(4).optional()
                   }),
                   z.xor([
                     z.object({ colorCode: z.never().optional() }),
@@ -1453,7 +1756,7 @@ var BulkUpdateCustomizationsRequest = z.object({
     returnEntity: z.boolean().describe(
       "Whether to return the full customization entities in the response.\n\nDefault: `false`"
     ).optional(),
-    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT"])).max(100).optional()
+    fields: z.array(z.enum(["ASSIGNED_PRODUCTS_COUNT", "CHOICE_DISPLAY_IMAGE"])).max(100).optional()
   }).optional()
 });
 var BulkUpdateCustomizationsResponse = z.object({
@@ -1539,7 +1842,11 @@ var BulkUpdateCustomizationsResponse = z.object({
                     name: z.string().describe("Choice name.").min(1).max(50).optional(),
                     defaultAddedPrice: z.string().describe(
                       "Default amount added to a product's price when this customization is assigned to a modifier."
-                    ).optional().nullable()
+                    ).optional().nullable(),
+                    displayImage: z.string().describe(
+                      "Optional image displayed alongside a ONE_COLOR choice in the storefront.\nOnly valid for ONE_COLOR choices; not populated for other choice types."
+                    ).optional(),
+                    primaryChoiceIds: z.array(z.string()).max(4).optional()
                   }),
                   z.xor([
                     z.object({ colorCode: z.never().optional() }),
@@ -1589,8 +1896,12 @@ var BulkUpdateCustomizationsResponse = z.object({
   QueryCustomizationsResponse,
   RemoveCustomizationChoicesRequest,
   RemoveCustomizationChoicesResponse,
+  ReorderCustomizationChoicesRequest,
+  ReorderCustomizationChoicesResponse,
   SetCustomizationChoicesRequest,
   SetCustomizationChoicesResponse,
+  UpdateCustomizationChoicesRequest,
+  UpdateCustomizationChoicesResponse,
   UpdateCustomizationRequest,
   UpdateCustomizationResponse
 });