@wix/auto_sdk_stores_customizations-v-3 1.0.67 → 1.0.68

package/build/internal/es/index.typings.d.mts

@@ -194,6 +194,19 @@ interface Choice extends ChoiceValueOneOf {
      * @decimalValue options { gte:0, lte:999999999, maxScale:3 }
      */
     defaultAddedPrice?: string | null;
+    /**
+     * IDs of parent choices that this choice is grouped under for storefront filtering.
+     * A choice with `parentChoiceIds` is considered a "child" choice.
+     * Child choices are excluded from the top-level storefront filter list
+     * and displayed only under their parent choice groups.
+     *
+     * A child choice can have multiple parents, in which case it appears under each parent group.
+     * Only a single level of parent-child grouping is supported. A choice that is a parent can't also be a child.
+     * @internal
+     * @format GUID
+     * @maxSize 4
+     */
+    parentChoiceIds?: string[];
 }
 /** @oneof */
 interface ChoiceValueOneOf {
@@ -732,6 +745,40 @@ interface RemoveCustomizationChoicesResponse {
     /** Updated customization. */
     customization?: Customization;
 }
+interface UpdateCustomizationChoicesRequest {
+    /**
+     * Customization ID.
+     * @format GUID
+     */
+    customizationId: string;
+    /**
+     * 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;
+    /**
+     * Choices to update. Each item must include a `choice` with a valid `id` matching an existing choice in the customization.
+     * @minSize 1
+     * @maxSize 100
+     */
+    choices: MaskedChoice[];
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
+     */
+    fields?: RequestedFieldsWithLiterals[];
+}
+interface MaskedChoice {
+    /** Choice to update. */
+    choice?: Choice;
+}
+interface UpdateCustomizationChoicesResponse {
+    /** Updated customization. */
+    customization?: Customization;
+}
 interface BulkAddCustomizationChoicesRequest {
     /**
      * List of customization IDs and choices.
@@ -1002,6 +1049,12 @@ type CreateCustomizationValidationErrors = {
     ruleName?: 'MIXED_CHOICE_IDS_CONSISTENCY';
 } | {
     ruleName?: 'ID_NOT_ALLOWED_IN_REQUEST';
+} | {
+    ruleName?: 'PARENT_CHOICE_SELF_REFERENCE';
+} | {
+    ruleName?: 'PARENT_CHOICE_NOT_FOUND';
+} | {
+    ruleName?: 'PARENT_CHOICE_HIERARCHY_VIOLATION';
 };
 /** @docsIgnore */
 type DeleteCustomizationValidationErrors = {
@@ -1040,6 +1093,12 @@ type BulkCreateCustomizationsValidationErrors = {
     ruleName?: 'MIXED_CHOICE_IDS_CONSISTENCY';
 } | {
     ruleName?: 'ID_NOT_ALLOWED_IN_REQUEST';
+} | {
+    ruleName?: 'PARENT_CHOICE_SELF_REFERENCE';
+} | {
+    ruleName?: 'PARENT_CHOICE_NOT_FOUND';
+} | {
+    ruleName?: 'PARENT_CHOICE_HIERARCHY_VIOLATION';
 };
 /** @docsIgnore */
 type AddCustomizationChoicesApplicationErrors = {
@@ -1058,6 +1117,12 @@ type AddCustomizationChoicesValidationErrors = {
     ruleName?: 'INVALID_CHOICE_VALUE';
 } | {
     ruleName?: 'DUPLICATE_CHOICE_NAME';
+} | {
+    ruleName?: 'PARENT_CHOICE_SELF_REFERENCE';
+} | {
+    ruleName?: 'PARENT_CHOICE_NOT_FOUND';
+} | {
+    ruleName?: 'PARENT_CHOICE_HIERARCHY_VIOLATION';
 };
 /** @docsIgnore */
 type SetCustomizationChoicesApplicationErrors = {
@@ -1078,6 +1143,12 @@ type SetCustomizationChoicesValidationErrors = {
     ruleName?: 'NOT_ALLOWED_DELETE_CHOICE_ASSIGNED_TO_PRODUCT';
 } | {
     ruleName?: 'DUPLICATE_CHOICE_NAME';
+} | {
+    ruleName?: 'PARENT_CHOICE_SELF_REFERENCE';
+} | {
+    ruleName?: 'PARENT_CHOICE_NOT_FOUND';
+} | {
+    ruleName?: 'PARENT_CHOICE_HIERARCHY_VIOLATION';
 };
 /** @docsIgnore */
 type RemoveCustomizationChoicesApplicationErrors = {
@@ -1088,6 +1159,24 @@ type RemoveCustomizationChoicesApplicationErrors = {
 /** @docsIgnore */
 type RemoveCustomizationChoicesValidationErrors = {
     ruleName?: 'NOT_ALLOWED_CUSTOMIZATION_WITHOUT_CHOICES';
+} | {
+    ruleName?: 'PARENT_CHOICE_DELETE_REFERENCED';
+};
+/** @docsIgnore */
+type UpdateCustomizationChoicesApplicationErrors = {
+    code?: 'CHOICE_NOT_FOUND';
+    description?: string;
+    data?: Record<string, any>;
+};
+/** @docsIgnore */
+type UpdateCustomizationChoicesValidationErrors = {
+    ruleName?: 'UNSUPPORTED_CHOICE_FIELD';
+} | {
+    ruleName?: 'PARENT_CHOICE_SELF_REFERENCE';
+} | {
+    ruleName?: 'PARENT_CHOICE_NOT_FOUND';
+} | {
+    ruleName?: 'PARENT_CHOICE_HIERARCHY_VIOLATION';
 };
 /** @docsIgnore */
 type BulkAddCustomizationChoicesApplicationErrors = {
@@ -1104,6 +1193,12 @@ type BulkAddCustomizationChoicesValidationErrors = {
     ruleName?: 'INVALID_CHOICE_TYPE';
 } | {
     ruleName?: 'INVALID_CHOICE_VALUE';
+} | {
+    ruleName?: 'PARENT_CHOICE_SELF_REFERENCE';
+} | {
+    ruleName?: 'PARENT_CHOICE_NOT_FOUND';
+} | {
+    ruleName?: 'PARENT_CHOICE_HIERARCHY_VIOLATION';
 };
 interface BaseEventMetadata {
     /**
@@ -1693,6 +1788,44 @@ interface RemoveCustomizationChoicesOptions {
      */
     fields?: RequestedFieldsWithLiterals[];
 }
+/**
+ * Updates properties of existing choices in a customization.
+ * Choices are identified by their IDs. Only the fields specified in `fieldMask` are updated.
+ *
+ * Currently supports updating `parentChoiceIds`.
+ * @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.
+ * @internal
+ * @documentationMaturity preview
+ * @requiredField customizationId
+ * @requiredField options.choices
+ * @requiredField options.choices.choice
+ * @requiredField revision
+ * @permissionId WIX_STORES.CUSTOMIZATION_UPDATE
+ * @applicableIdentity APP
+ * @fqn wix.stores.catalog.customization.v3.CustomizationService.UpdateCustomizationChoices
+ */
+declare function updateCustomizationChoices(customizationId: string, revision: string, options?: NonNullablePaths<UpdateCustomizationChoicesOptions, `choices` | `choices.${number}.choice`, 4>): Promise<NonNullablePaths<UpdateCustomizationChoicesResponse, `customization.freeTextInput.minCharCount` | `customization.freeTextInput.maxCharCount` | `customization.freeTextInput.title` | `customization.choicesSettings.choices` | `customization.choicesSettings.choices.${number}.colorCode` | `customization.choicesSettings.choices.${number}._id` | `customization.choicesSettings.choices.${number}.choiceType` | `customization.choicesSettings.choices.${number}.name` | `customization.name` | `customization.customizationType` | `customization.customizationRenderType`, 6> & {
+    __applicationErrorsType?: UpdateCustomizationChoicesApplicationErrors;
+    __validationErrorsType?: UpdateCustomizationChoicesValidationErrors;
+}>;
+interface UpdateCustomizationChoicesOptions {
+    /**
+     * Choices to update. Each item must include a `choice` with a valid `id` matching an existing choice in the customization.
+     * @minSize 1
+     * @maxSize 100
+     */
+    choices: MaskedChoice[];
+    /**
+     * Fields to include in the response.
+     *
+     * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
+     */
+    fields?: RequestedFieldsWithLiterals[];
+}
 /**
  * Adds choices to multiple customizations.
  * @param customizationsChoices - List of customization IDs and choices.
@@ -1756,4 +1889,4 @@ interface BulkUpdateCustomizationsOptions {
     fields?: RequestedFieldsWithLiterals[];
 }
 
-export { type AccountInfo, type AccountInfoMetadata, type ActionEvent, type AddCustomizationChoicesApplicationErrors, type AddCustomizationChoicesOptions, type AddCustomizationChoicesRequest, type AddCustomizationChoicesResponse, type AddCustomizationChoicesValidationErrors, type App, type ApplicationError, type BaseEventMetadata, type BulkActionMetadata, type BulkAddCustomizationChoicesApplicationErrors, type BulkAddCustomizationChoicesOptions, type BulkAddCustomizationChoicesRequest, type BulkAddCustomizationChoicesResponse, type BulkAddCustomizationChoicesValidationErrors, type BulkCreateCustomizationsApplicationErrors, type BulkCreateCustomizationsForMigrationRequest, type BulkCreateCustomizationsForMigrationResponse, type BulkCreateCustomizationsOptions, type BulkCreateCustomizationsRequest, type BulkCreateCustomizationsResponse, type BulkCreateCustomizationsValidationErrors, type BulkCustomizationResult, type BulkUpdateCustomizationsOptions, type BulkUpdateCustomizationsRequest, type BulkUpdateCustomizationsResponse, type Choice, ChoiceType, type ChoiceTypeWithLiterals, type ChoiceValueOneOf, type ChoicesSettings, type CommonQueryWithEntityContext, type CreateCustomizationApplicationErrors, type CreateCustomizationRequest, type CreateCustomizationResponse, type CreateCustomizationValidationErrors, type CursorPaging, type CursorPagingMetadata, type CursorQuery, type CursorQueryPagingMethodOneOf, type Cursors, type CustomTag, type Customization, type CustomizationChoices, type CustomizationCreatedEnvelope, type CustomizationCustomizationSettingsOneOf, type CustomizationDeletedEnvelope, type CustomizationIdsWrapper, type CustomizationQuery, type CustomizationQuerySpec, CustomizationRenderType, type CustomizationRenderTypeWithLiterals, CustomizationType, type CustomizationTypeWithLiterals, type CustomizationUpdatedEnvelope, type CustomizationsQueryBuilder, type CustomizationsQueryResult, type DeleteCustomizationRequest, type DeleteCustomizationResponse, type DeleteCustomizationValidationErrors, type DomainEvent, type DomainEventBodyOneOf, type Empty, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type EventMetadata, type File, type FocalPoint, type FreeTextSettings, type GetCustomizationOptions, type GetCustomizationRequest, type GetCustomizationResponse, type IdentificationData, type IdentificationDataIdOneOf, type InvalidateCache, type InvalidateCacheGetByOneOf, type ItemMetadata, type MaskedCustomization, type MessageEnvelope, type MultipleColors, type Page, type Pages, type QueryCustomizationsOptions, type QueryCustomizationsRequest, type QueryCustomizationsResponse, type RecloneSiteRequest, type RecloneSiteResponse, type RemoveCustomizationChoicesApplicationErrors, type RemoveCustomizationChoicesOptions, type RemoveCustomizationChoicesRequest, type RemoveCustomizationChoicesResponse, type RemoveCustomizationChoicesValidationErrors, RequestedFields, type RequestedFieldsWithLiterals, type RestoreInfo, type SetCustomizationChoicesApplicationErrors, type SetCustomizationChoicesOptions, type SetCustomizationChoicesRequest, type SetCustomizationChoicesResponse, type SetCustomizationChoicesValidationErrors, SortOrder, type SortOrderWithLiterals, type Sorting, type URI, type URIs, type UpdateCustomization, type UpdateCustomizationOptions, type UpdateCustomizationRequest, type UpdateCustomizationResponse, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, addCustomizationChoices, bulkAddCustomizationChoices, bulkCreateCustomizations, bulkUpdateCustomizations, createCustomization, deleteCustomization, getCustomization, onCustomizationCreated, onCustomizationDeleted, onCustomizationUpdated, queryCustomizations, removeCustomizationChoices, setCustomizationChoices, typedQueryCustomizations, updateCustomization, utils };
+export { type AccountInfo, type AccountInfoMetadata, type ActionEvent, type AddCustomizationChoicesApplicationErrors, type AddCustomizationChoicesOptions, type AddCustomizationChoicesRequest, type AddCustomizationChoicesResponse, type AddCustomizationChoicesValidationErrors, type App, type ApplicationError, type BaseEventMetadata, type BulkActionMetadata, type BulkAddCustomizationChoicesApplicationErrors, type BulkAddCustomizationChoicesOptions, type BulkAddCustomizationChoicesRequest, type BulkAddCustomizationChoicesResponse, type BulkAddCustomizationChoicesValidationErrors, type BulkCreateCustomizationsApplicationErrors, type BulkCreateCustomizationsForMigrationRequest, type BulkCreateCustomizationsForMigrationResponse, type BulkCreateCustomizationsOptions, type BulkCreateCustomizationsRequest, type BulkCreateCustomizationsResponse, type BulkCreateCustomizationsValidationErrors, type BulkCustomizationResult, type BulkUpdateCustomizationsOptions, type BulkUpdateCustomizationsRequest, type BulkUpdateCustomizationsResponse, type Choice, ChoiceType, type ChoiceTypeWithLiterals, type ChoiceValueOneOf, type ChoicesSettings, type CommonQueryWithEntityContext, type CreateCustomizationApplicationErrors, type CreateCustomizationRequest, type CreateCustomizationResponse, type CreateCustomizationValidationErrors, type CursorPaging, type CursorPagingMetadata, type CursorQuery, type CursorQueryPagingMethodOneOf, type Cursors, type CustomTag, type Customization, type CustomizationChoices, type CustomizationCreatedEnvelope, type CustomizationCustomizationSettingsOneOf, type CustomizationDeletedEnvelope, type CustomizationIdsWrapper, type CustomizationQuery, type CustomizationQuerySpec, CustomizationRenderType, type CustomizationRenderTypeWithLiterals, CustomizationType, type CustomizationTypeWithLiterals, type CustomizationUpdatedEnvelope, type CustomizationsQueryBuilder, type CustomizationsQueryResult, type DeleteCustomizationRequest, type DeleteCustomizationResponse, type DeleteCustomizationValidationErrors, type DomainEvent, type DomainEventBodyOneOf, type Empty, type EntityCreatedEvent, type EntityDeletedEvent, type EntityUpdatedEvent, type EventMetadata, type File, type FocalPoint, type FreeTextSettings, type GetCustomizationOptions, type GetCustomizationRequest, type GetCustomizationResponse, type IdentificationData, type IdentificationDataIdOneOf, type InvalidateCache, type InvalidateCacheGetByOneOf, type ItemMetadata, type MaskedChoice, type MaskedCustomization, type MessageEnvelope, type MultipleColors, type Page, type Pages, type QueryCustomizationsOptions, type QueryCustomizationsRequest, type QueryCustomizationsResponse, type RecloneSiteRequest, type RecloneSiteResponse, type RemoveCustomizationChoicesApplicationErrors, type RemoveCustomizationChoicesOptions, type RemoveCustomizationChoicesRequest, type RemoveCustomizationChoicesResponse, type RemoveCustomizationChoicesValidationErrors, RequestedFields, type RequestedFieldsWithLiterals, type RestoreInfo, type SetCustomizationChoicesApplicationErrors, type SetCustomizationChoicesOptions, type SetCustomizationChoicesRequest, type SetCustomizationChoicesResponse, type SetCustomizationChoicesValidationErrors, SortOrder, type SortOrderWithLiterals, type Sorting, type URI, type URIs, type UpdateCustomization, type UpdateCustomizationChoicesApplicationErrors, type UpdateCustomizationChoicesOptions, type UpdateCustomizationChoicesRequest, type UpdateCustomizationChoicesResponse, type UpdateCustomizationChoicesValidationErrors, type UpdateCustomizationOptions, type UpdateCustomizationRequest, type UpdateCustomizationResponse, WebhookIdentityType, type WebhookIdentityTypeWithLiterals, addCustomizationChoices, bulkAddCustomizationChoices, bulkCreateCustomizations, bulkUpdateCustomizations, createCustomization, deleteCustomization, getCustomization, onCustomizationCreated, onCustomizationDeleted, onCustomizationUpdated, queryCustomizations, removeCustomizationChoices, setCustomizationChoices, typedQueryCustomizations, updateCustomization, updateCustomizationChoices, utils };

package/build/internal/es/index.typings.mjs

@@ -538,6 +538,67 @@ function removeCustomizationChoices(payload) {
   }
   return __removeCustomizationChoices;
 }
+function updateCustomizationChoices(payload) {
+  function __updateCustomizationChoices({ host }) {
+    const serializedData = transformPaths(payload, [
+      {
+        transformFn: transformSDKFieldMaskToRESTFieldMask,
+        paths: [{ path: "choices.fieldMask" }]
+      },
+      {
+        transformFn: transformSDKTimestampToRESTTimestamp,
+        paths: [{ path: "choices.choice.image.urlExpirationDate" }]
+      },
+      {
+        transformFn: transformSDKFloatToRESTFloat,
+        paths: [
+          { path: "choices.choice.image.focalPoint.x" },
+          { path: "choices.choice.image.focalPoint.y" }
+        ]
+      }
+    ]);
+    const metadata = {
+      entityFqdn: "wix.stores.catalog.v3.customization",
+      method: "POST",
+      methodFqn: "wix.stores.catalog.customization.v3.CustomizationService.UpdateCustomizationChoices",
+      packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
+      url: resolveWixStoresCatalogCustomizationV3CustomizationServiceUrl({
+        protoPath: "/v3/customizations/{customizationId}/update-choices",
+        data: serializedData,
+        host
+      }),
+      data: serializedData,
+      transformResponse: (payload2) => transformPaths(payload2, [
+        {
+          transformFn: transformRESTTimestampToSDKTimestamp,
+          paths: [
+            { path: "customization.createdDate" },
+            { path: "customization.updatedDate" },
+            {
+              path: "customization.choicesSettings.choices.image.urlExpirationDate"
+            }
+          ]
+        },
+        {
+          transformFn: transformRESTFloatToSDKFloat,
+          paths: [
+            {
+              path: "customization.choicesSettings.choices.image.focalPoint.x"
+            },
+            {
+              path: "customization.choicesSettings.choices.image.focalPoint.y"
+            }
+          ]
+        }
+      ])
+    };
+    return metadata;
+  }
+  return __updateCustomizationChoices;
+}
 function bulkAddCustomizationChoices(payload) {
   function __bulkAddCustomizationChoices({ host }) {
     const serializedData = transformPaths(payload, [
@@ -1125,6 +1186,56 @@ async function removeCustomizationChoices2(customizationId, choiceIds, options)
     throw transformedError;
   }
 }
+async function updateCustomizationChoices2(customizationId, revision, options) {
+  const { httpClient, sideEffects } = arguments[3];
+  const payload = transformPaths2(
+    renameKeysFromSDKRequestToRESTRequest({
+      customizationId,
+      revision,
+      choices: options?.choices,
+      fields: options?.fields
+    }),
+    [
+      {
+        transformFn: transformSDKImageToRESTImage,
+        paths: [{ path: "choices.choice.image" }]
+      }
+    ]
+  );
+  const reqOpts = updateCustomizationChoices(
+    payload
+  );
+  sideEffects?.onSiteCall?.();
+  try {
+    const result = await httpClient.request(reqOpts);
+    sideEffects?.onSuccess?.(result);
+    return renameKeysFromRESTResponseToSDKResponse(
+      transformPaths2(result.data, [
+        {
+          transformFn: transformRESTImageToSDKImage,
+          paths: [{ path: "customization.choicesSettings.choices.image" }]
+        }
+      ])
+    );
+  } catch (err) {
+    const transformedError = sdkTransformError(
+      err,
+      {
+        spreadPathsToArguments: {},
+        explicitPathsToArguments: {
+          customizationId: "$[0]",
+          revision: "$[1]",
+          choices: "$[2].choices",
+          fields: "$[2].fields"
+        },
+        singleArgumentUnchanged: false
+      },
+      ["customizationId", "revision", "options"]
+    );
+    sideEffects?.onError?.(err);
+    throw transformedError;
+  }
+}
 async function bulkAddCustomizationChoices2(customizationsChoices, options) {
   const { httpClient, sideEffects } = arguments[2];
   const payload = transformPaths2(
@@ -1246,6 +1357,7 @@ export {
   setCustomizationChoices2 as setCustomizationChoices,
   typedQueryCustomizations,
   updateCustomization2 as updateCustomization,
+  updateCustomizationChoices2 as updateCustomizationChoices,
   utils
 };
 //# sourceMappingURL=index.typings.mjs.map