@wix/auto_sdk_stores_customizations-v-3 1.0.2 → 1.0.4

package/build/cjs/src/stores-catalog-v3-customization-customizations-v-3.universal.d.ts

@@ -7,6 +7,7 @@ export interface Customization extends CustomizationCustomizationSettingsOneOf {
      * Free text input settings.
      *
      * > **Note:** To be passed along with `customizationRenderType: FREE_TEXT`.
+     * @immutable
      */
     freeTextInput?: FreeTextSettings;
     /**
@@ -17,6 +18,8 @@ export interface Customization extends CustomizationCustomizationSettingsOneOf {
     choicesSettings?: ChoicesSettings;
     /**
      * Customization ID.
+     * @minLength 1
+     * @maxLength 36
      * @readonly
      */
     _id?: string | null;
@@ -39,14 +42,22 @@ export interface Customization extends CustomizationCustomizationSettingsOneOf {
      * @readonly
      */
     _updatedDate?: Date | null;
-    /** Customization name for options (for example, `"color"`, `"size"`) and modifiers (for example, `"greeting card"`). */
+    /**
+     * Customization name for options (for example, `"color"`, `"size"`) and modifiers (for example, `"greeting card"`).
+     * @minLength 1
+     * @maxLength 50
+     */
     name?: string;
-    /** Customization type. */
+    /**
+     * Customization type.
+     * @immutable
+     */
     customizationType?: CustomizationType;
     /**
      * Customization render type.
      *
      * Defines how the customization will be displayed in the storefront.
+     * @immutable
      */
     customizationRenderType?: CustomizationRenderType;
     /**
@@ -62,6 +73,7 @@ export interface CustomizationCustomizationSettingsOneOf {
      * Free text input settings.
      *
      * > **Note:** To be passed along with `customizationRenderType: FREE_TEXT`.
+     * @immutable
      */
     freeTextInput?: FreeTextSettings;
     /**
@@ -85,22 +97,43 @@ export declare enum CustomizationRenderType {
 export interface FreeTextSettings {
     /** Minimum text character length. */
     minCharCount?: number;
-    /** Maximum text character length. */
+    /**
+     * Maximum text character length.
+     * @max 500
+     */
     maxCharCount?: number;
-    /** Default amount added to a product's price when this choice is assigned to a modifier. */
+    /**
+     * Default amount added to a product's price when this choice is assigned to a modifier.
+     * @decimalValue options { gte:0, lte:999999999, maxScale:3 }
+     */
     defaultAddedPrice?: string | null;
-    /** Title to display to customer for their free-text input. */
+    /**
+     * Title to display to customer for their free-text input.
+     * @minLength 1
+     * @maxLength 100
+     */
     title?: string;
 }
 export interface ChoicesSettings {
-    /** List of choices. */
+    /**
+     * List of choices.
+     * @minSize 1
+     * @maxSize 200
+     * @immutable
+     */
     choices?: Choice[];
 }
 export interface Choice extends ChoiceValueOneOf {
-    /** Color code in HEX format, [as described by MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color). */
+    /**
+     * Color code in HEX format, [as described by MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color).
+     * @minLength 3
+     * @maxLength 20
+     * @format COLOR_HEX
+     */
     colorCode?: string;
     /**
      * Choice ID.
+     * @format GUID
      * @readonly
      */
     _id?: string;
@@ -110,16 +143,26 @@ export interface Choice extends ChoiceValueOneOf {
      * > **Notes:**
      * > + For `customizationRenderType: SWATCH_CHOICES`, the supported `choiceType` values are: `ONE_COLOR`, `MULTIPLE_COLORS`, or `IMAGE`.
      * > + For a `customizationRenderType` of `TEXT_CHOICES` and `FREE_TEXT`, the supported `choiceType` value is: `CHOICE_TEXT`.
+     * @immutable
      */
     choiceType?: ChoiceType;
     /**
      * A read-only key generated based on choice name. Used for eCommerce integration.
      * @readonly
+     * @minLength 1
+     * @maxLength 50
      */
     key?: string | null;
-    /** Choice name. */
+    /**
+     * Choice name.
+     * @minLength 1
+     * @maxLength 50
+     */
     name?: string;
-    /** Default amount added to a product's price when this customization is assigned to a modifier. */
+    /**
+     * Default amount added to a product's price when this customization is assigned to a modifier.
+     * @decimalValue options { gte:0, lte:999999999, maxScale:3 }
+     */
     defaultAddedPrice?: string | null;
     /**
      * Number of products this choice is assigned to .
@@ -129,7 +172,12 @@ export interface Choice extends ChoiceValueOneOf {
 }
 /** @oneof */
 export interface ChoiceValueOneOf {
-    /** Color code in HEX format, [as described by MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color). */
+    /**
+     * Color code in HEX format, [as described by MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color).
+     * @minLength 3
+     * @maxLength 20
+     * @format COLOR_HEX
+     */
     colorCode?: string;
 }
 export declare enum ChoiceType {
@@ -144,7 +192,13 @@ export declare enum ChoiceType {
     IMAGE = "IMAGE"
 }
 export interface MultipleColors {
-    /** A list of color codes. */
+    /**
+     * A list of color codes.
+     * @minLength 3
+     * @maxLength 20
+     * @minSize 2
+     * @maxSize 2
+     */
     colorCodes?: string[];
 }
 export interface FocalPoint {
@@ -158,9 +212,15 @@ export interface FocalPoint {
     width?: number | null;
 }
 export interface InvalidateCache extends InvalidateCacheGetByOneOf {
-    /** Invalidate by msId. NOT recommended, as this will invalidate the entire site cache! */
+    /**
+     * Invalidate by msId. NOT recommended, as this will invalidate the entire site cache!
+     * @format GUID
+     */
     metaSiteId?: string;
-    /** Invalidate by Site ID. NOT recommended, as this will invalidate the entire site cache! */
+    /**
+     * Invalidate by Site ID. NOT recommended, as this will invalidate the entire site cache!
+     * @format GUID
+     */
     siteId?: string;
     /** Invalidate by App */
     app?: App;
@@ -170,7 +230,10 @@ export interface InvalidateCache extends InvalidateCacheGetByOneOf {
     uri?: URI;
     /** Invalidate by file (for media files such as PDFs) */
     file?: File;
-    /** tell us why you're invalidating the cache. You don't need to add your app name */
+    /**
+     * tell us why you're invalidating the cache. You don't need to add your app name
+     * @maxLength 256
+     */
     reason?: string | null;
     /** Is local DS */
     localDc?: boolean;
@@ -178,9 +241,15 @@ export interface InvalidateCache extends InvalidateCacheGetByOneOf {
 }
 /** @oneof */
 export interface InvalidateCacheGetByOneOf {
-    /** Invalidate by msId. NOT recommended, as this will invalidate the entire site cache! */
+    /**
+     * Invalidate by msId. NOT recommended, as this will invalidate the entire site cache!
+     * @format GUID
+     */
     metaSiteId?: string;
-    /** Invalidate by Site ID. NOT recommended, as this will invalidate the entire site cache! */
+    /**
+     * Invalidate by Site ID. NOT recommended, as this will invalidate the entire site cache!
+     * @format GUID
+     */
     siteId?: string;
     /** Invalidate by App */
     app?: App;
@@ -192,27 +261,52 @@ export interface InvalidateCacheGetByOneOf {
     file?: File;
 }
 export interface App {
-    /** The AppDefId */
+    /**
+     * The AppDefId
+     * @minLength 1
+     */
     appDefId?: string;
-    /** The instance Id */
+    /**
+     * The instance Id
+     * @format GUID
+     */
     instanceId?: string;
 }
 export interface Page {
-    /** the msid the page is on */
+    /**
+     * the msid the page is on
+     * @format GUID
+     */
     metaSiteId?: string;
-    /** Invalidate by Page ID */
+    /**
+     * Invalidate by Page ID
+     * @minLength 1
+     */
     pageId?: string;
 }
 export interface URI {
-    /** the msid the URI is on */
+    /**
+     * the msid the URI is on
+     * @format GUID
+     */
     metaSiteId?: string;
-    /** URI path to invalidate (e.g. page/my/path) - without leading/trailing slashes */
+    /**
+     * URI path to invalidate (e.g. page/my/path) - without leading/trailing slashes
+     * @minLength 1
+     */
     uriPath?: string;
 }
 export interface File {
-    /** the msid the file is related to */
+    /**
+     * the msid the file is related to
+     * @format GUID
+     */
     metaSiteId?: string;
-    /** Invalidate by filename (for media files such as PDFs) */
+    /**
+     * Invalidate by filename (for media files such as PDFs)
+     * @minLength 1
+     * @maxLength 256
+     */
     fileName?: string;
 }
 export interface CreateCustomizationRequest {
@@ -224,12 +318,16 @@ export interface CreateCustomizationResponse {
     customization?: Customization;
 }
 export interface GetCustomizationRequest {
-    /** Customization ID. */
+    /**
+     * Customization ID.
+     * @format GUID
+     */
     customizationId: string;
     /**
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }
@@ -250,6 +348,7 @@ export interface UpdateCustomizationRequest {
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }
@@ -258,7 +357,10 @@ export interface UpdateCustomizationResponse {
     customization?: Customization;
 }
 export interface DeleteCustomizationRequest {
-    /** Customization ID. */
+    /**
+     * Customization ID.
+     * @format GUID
+     */
     customizationId: string;
 }
 export interface DeleteCustomizationResponse {
@@ -270,6 +372,7 @@ export interface QueryCustomizationsRequest {
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }
@@ -288,6 +391,7 @@ export interface CursorQuery extends CursorQueryPagingMethodOneOf {
     /**
      * Sort object in the following format:
      * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
+     * @maxSize 5
      */
     sort?: Sorting[];
 }
@@ -297,7 +401,10 @@ export interface CursorQueryPagingMethodOneOf {
     cursorPaging?: CursorPaging;
 }
 export interface Sorting {
-    /** Name of the field to sort by. */
+    /**
+     * Name of the field to sort by.
+     * @maxLength 512
+     */
     fieldName?: string;
     /** Sort order. */
     order?: SortOrder;
@@ -309,18 +416,26 @@ export declare enum SortOrder {
     DESC = "DESC"
 }
 export interface CursorPaging {
-    /** Maximum number of items to return in the results. */
+    /**
+     * Maximum number of items to return in the results.
+     * @max 100
+     */
     limit?: number | null;
     /**
      * Pointer to the next or previous page in the list of results.
      *
      * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
      * Not relevant for the first request.
+     * @maxLength 16000
      */
     cursor?: string | null;
 }
 export interface QueryCustomizationsResponse {
-    /** List of customizations. */
+    /**
+     * List of customizations.
+     * @minSize 1
+     * @maxSize 200
+     */
     customizations?: Customization[];
     /** Details on the paged set of results returned. */
     pagingMetadata?: CursorPagingMetadata;
@@ -339,13 +454,23 @@ export interface CursorPagingMetadata {
     hasNext?: boolean | null;
 }
 export interface Cursors {
-    /** Cursor string pointing to the next page in the list of results. */
+    /**
+     * Cursor string pointing to the next page in the list of results.
+     * @maxLength 16000
+     */
     next?: string | null;
-    /** Cursor pointing to the previous page in the list of results. */
+    /**
+     * Cursor pointing to the previous page in the list of results.
+     * @maxLength 16000
+     */
     prev?: string | null;
 }
 export interface BulkCreateCustomizationsRequest {
-    /** Customizations to create. */
+    /**
+     * Customizations to create.
+     * @minSize 1
+     * @maxSize 100
+     */
     customizations: Customization[];
     /**
      * Whether to return the full customization entities in the response.
@@ -355,7 +480,11 @@ export interface BulkCreateCustomizationsRequest {
     returnEntity?: boolean;
 }
 export interface BulkCreateCustomizationsResponse {
-    /** Customizations created by bulk action. */
+    /**
+     * Customizations created by bulk action.
+     * @minSize 1
+     * @maxSize 100
+     */
     results?: BulkCustomizationResult[];
     /** Bulk action metadata. */
     bulkActionMetadata?: BulkActionMetadata;
@@ -371,7 +500,11 @@ export interface BulkCustomizationResult {
     customization?: Customization;
 }
 export interface ItemMetadata {
-    /** Item ID. Should always be available, unless it's impossible (for example, when failing to create an item). */
+    /**
+     * Item ID. Should always be available, unless it's impossible (for example, when failing to create an item).
+     * @minLength 1
+     * @maxLength 36
+     */
     _id?: string | null;
     /** Index of the item within the request array. Allows for correlation between request and response items. */
     originalIndex?: number;
@@ -400,18 +533,30 @@ export interface CustomizationIdsWrapper {
     /**
      * list of all the customization ids that are invalid
      * e.g list of failed choices ids
+     * @minSize 1
+     * @maxSize 100
+     * @minLength 1
+     * @maxLength 36
      */
     customizationIds?: string[];
 }
 export interface AddCustomizationChoicesRequest {
-    /** Customization ID. */
+    /**
+     * Customization ID.
+     * @format GUID
+     */
     customizationId: string;
-    /** Choices to add. */
+    /**
+     * Choices to add.
+     * @minSize 1
+     * @maxSize 100
+     */
     choices: Choice[];
     /**
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }
@@ -420,14 +565,22 @@ export interface AddCustomizationChoicesResponse {
     customization?: Customization;
 }
 export interface SetCustomizationChoicesRequest {
-    /** Customization ID. */
+    /**
+     * Customization ID.
+     * @format GUID
+     */
     customizationId: string;
-    /** Choices to set. */
+    /**
+     * Choices to set.
+     * @minSize 1
+     * @maxSize 100
+     */
     choices: Choice[];
     /**
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }
@@ -436,9 +589,17 @@ export interface SetCustomizationChoicesResponse {
     customization?: Customization;
 }
 export interface RemoveCustomizationChoicesRequest {
-    /** Customization ID. */
+    /**
+     * Customization ID.
+     * @format GUID
+     */
     customizationId: string;
-    /** IDs of choices to remove. */
+    /**
+     * IDs of choices to remove.
+     * @format GUID
+     * @minSize 1
+     * @maxSize 100
+     */
     choiceIds: string[];
     /** Customization revision. */
     revision?: string;
@@ -446,6 +607,7 @@ export interface RemoveCustomizationChoicesRequest {
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }
@@ -454,7 +616,11 @@ export interface RemoveCustomizationChoicesResponse {
     customization?: Customization;
 }
 export interface BulkAddCustomizationChoicesRequest {
-    /** List of customization IDs and choices. */
+    /**
+     * List of customization IDs and choices.
+     * @minSize 1
+     * @maxSize 100
+     */
     customizationsChoices: CustomizationChoices[];
     /**
      * Whether to return the full customization entities in the response.
@@ -466,23 +632,40 @@ export interface BulkAddCustomizationChoicesRequest {
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }
 export interface CustomizationChoices {
-    /** Customization ID. */
+    /**
+     * Customization ID.
+     * @minLength 1
+     * @maxLength 36
+     */
     customizationId?: string;
-    /** Choices to add. */
+    /**
+     * Choices to add.
+     * @minSize 1
+     * @maxSize 100
+     */
     choices?: Choice[];
 }
 export interface BulkAddCustomizationChoicesResponse {
-    /** Customizations updated by bulk action. */
+    /**
+     * Customizations updated by bulk action.
+     * @minSize 1
+     * @maxSize 100
+     */
     results?: BulkCustomizationResult[];
     /** Bulk action metadata. */
     bulkActionMetadata?: BulkActionMetadata;
 }
 export interface BulkUpdateCustomizationsRequest {
-    /** List of customizations to update. */
+    /**
+     * List of customizations to update.
+     * @minSize 1
+     * @maxSize 100
+     */
     customizations: MaskedCustomization[];
     /**
      * Whether to return the full customization entities in the response.
@@ -494,6 +677,7 @@ export interface BulkUpdateCustomizationsRequest {
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }
@@ -502,7 +686,11 @@ export interface MaskedCustomization {
     customization?: Customization;
 }
 export interface BulkUpdateCustomizationsResponse {
-    /** Customizations updated by bulk action. */
+    /**
+     * Customizations updated by bulk action.
+     * @minSize 1
+     * @maxSize 100
+     */
     results?: BulkCustomizationResult[];
     /** Bulk action metadata. */
     bulkActionMetadata?: BulkActionMetadata;
@@ -580,9 +768,15 @@ export interface ActionEvent {
 export interface Empty {
 }
 export interface MessageEnvelope {
-    /** App instance ID. */
+    /**
+     * App instance ID.
+     * @format GUID
+     */
     instanceId?: string | null;
-    /** Event type. */
+    /**
+     * Event type.
+     * @maxLength 150
+     */
     eventType?: string;
     /** The identification type and identity data. */
     identity?: IdentificationData;
@@ -590,26 +784,50 @@ export interface MessageEnvelope {
     data?: string;
 }
 export interface IdentificationData extends IdentificationDataIdOneOf {
-    /** ID of a site visitor that has not logged in to the site. */
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
     anonymousVisitorId?: string;
-    /** ID of a site visitor that has logged in to the site. */
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
     memberId?: string;
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
     wixUserId?: string;
-    /** ID of an app. */
+    /**
+     * ID of an app.
+     * @format GUID
+     */
     appId?: string;
     /** @readonly */
     identityType?: WebhookIdentityType;
 }
 /** @oneof */
 export interface IdentificationDataIdOneOf {
-    /** ID of a site visitor that has not logged in to the site. */
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
     anonymousVisitorId?: string;
-    /** ID of a site visitor that has logged in to the site. */
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
     memberId?: string;
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
     wixUserId?: string;
-    /** ID of an app. */
+    /**
+     * ID of an app.
+     * @format GUID
+     */
     appId?: string;
 }
 export declare enum WebhookIdentityType {
@@ -698,9 +916,15 @@ export interface BulkUpdateCustomizationsResponseNonNullableFields {
     bulkActionMetadata?: BulkActionMetadataNonNullableFields;
 }
 export interface BaseEventMetadata {
-    /** App instance ID. */
+    /**
+     * App instance ID.
+     * @format GUID
+     */
     instanceId?: string | null;
-    /** Event type. */
+    /**
+     * Event type.
+     * @maxLength 150
+     */
     eventType?: string;
     /** The identification type and identity data. */
     identity?: IdentificationData;
@@ -749,12 +973,18 @@ export interface CustomizationCreatedEnvelope {
 }
 /**
  * Triggered when a customization is created.
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Read v3 catalog
  * @permissionScopeId SCOPE.STORES.CATALOG_READ
  * @permissionScope Manage Products
  * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
+ * @permissionScope Read Stores - all read permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.READ-STORES
  * @permissionScope Read Products
  * @permissionScopeId SCOPE.DC-STORES.READ-PRODUCTS
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Product write in v3 catalog
  * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
  * @permissionScope Read customizations in v3 catalog
@@ -809,6 +1039,8 @@ export declare function onCustomizationUpdated(handler: (event: CustomizationUpd
  * @requiredField customization.freeTextInput.title
  * @requiredField customization.name
  * @permissionId WIX_STORES.CUSTOMIZATION_CREATE
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Customization write in v3 catalog
  * @permissionScopeId SCOPE.STORES.CUSTOMIZATION_WRITE
  * @permissionScope Manage Products
@@ -829,12 +1061,18 @@ export declare function createCustomization(customization: Customization): Promi
  * @documentationMaturity preview
  * @requiredField customizationId
  * @permissionId WIX_STORES.CUSTOMIZATION_READ
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Read v3 catalog
  * @permissionScopeId SCOPE.STORES.CATALOG_READ
  * @permissionScope Manage Products
  * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
+ * @permissionScope Read Stores - all read permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.READ-STORES
  * @permissionScope Read Products
  * @permissionScopeId SCOPE.DC-STORES.READ-PRODUCTS
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Product write in v3 catalog
  * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
  * @permissionScope Read customizations in v3 catalog
@@ -854,6 +1092,7 @@ export interface GetCustomizationOptions {
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }
@@ -870,6 +1109,8 @@ export interface GetCustomizationOptions {
  * @requiredField customization
  * @requiredField customization.revision
  * @permissionId WIX_STORES.CUSTOMIZATION_UPDATE
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Customization write in v3 catalog
  * @permissionScopeId SCOPE.STORES.CUSTOMIZATION_WRITE
  * @permissionScope Manage Products
@@ -888,6 +1129,7 @@ export interface UpdateCustomization {
      * Free text input settings.
      *
      * > **Note:** To be passed along with `customizationRenderType: FREE_TEXT`.
+     * @immutable
      */
     freeTextInput?: FreeTextSettings;
     /**
@@ -898,6 +1140,8 @@ export interface UpdateCustomization {
     choicesSettings?: ChoicesSettings;
     /**
      * Customization ID.
+     * @minLength 1
+     * @maxLength 36
      * @readonly
      */
     _id?: string | null;
@@ -920,14 +1164,22 @@ export interface UpdateCustomization {
      * @readonly
      */
     _updatedDate?: Date | null;
-    /** Customization name for options (for example, `"color"`, `"size"`) and modifiers (for example, `"greeting card"`). */
+    /**
+     * Customization name for options (for example, `"color"`, `"size"`) and modifiers (for example, `"greeting card"`).
+     * @minLength 1
+     * @maxLength 50
+     */
     name?: string;
-    /** Customization type. */
+    /**
+     * Customization type.
+     * @immutable
+     */
     customizationType?: CustomizationType;
     /**
      * Customization render type.
      *
      * Defines how the customization will be displayed in the storefront.
+     * @immutable
      */
     customizationRenderType?: CustomizationRenderType;
     /**
@@ -942,6 +1194,7 @@ export interface UpdateCustomizationOptions {
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }
@@ -954,6 +1207,8 @@ export interface UpdateCustomizationOptions {
  * @documentationMaturity preview
  * @requiredField customizationId
  * @permissionId WIX_STORES.CUSTOMIZATION_DELETE
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Customization write in v3 catalog
  * @permissionScopeId SCOPE.STORES.CUSTOMIZATION_WRITE
  * @permissionScope Manage Products
@@ -984,12 +1239,18 @@ export declare function deleteCustomization(customizationId: string): Promise<vo
  * and [Sorting and Paging](https://dev.wix.com/docs/rest/articles/getting-started/sorting-and-paging).
  * @public
  * @documentationMaturity preview
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Read v3 catalog
  * @permissionScopeId SCOPE.STORES.CATALOG_READ
  * @permissionScope Manage Products
  * @permissionScopeId SCOPE.DC-STORES.MANAGE-PRODUCTS
+ * @permissionScope Read Stores - all read permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.READ-STORES
  * @permissionScope Read Products
  * @permissionScopeId SCOPE.DC-STORES.READ-PRODUCTS
+ * @permissionScope Manage Restaurants - all permissions
+ * @permissionScopeId SCOPE.RESTAURANTS.MEGA-SCOPES
  * @permissionScope Product write in v3 catalog
  * @permissionScopeId SCOPE.STORES.PRODUCT_WRITE
  * @permissionScope Read customizations in v3 catalog
@@ -1009,6 +1270,7 @@ export interface QueryCustomizationsOptions {
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[] | undefined;
 }
@@ -1096,6 +1358,8 @@ export interface CustomizationsQueryBuilder {
  * @documentationMaturity preview
  * @requiredField customizations
  * @permissionId WIX_STORES.CUSTOMIZATION_CREATE
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Customization write in v3 catalog
  * @permissionScopeId SCOPE.STORES.CUSTOMIZATION_WRITE
  * @permissionScope Manage Products
@@ -1125,6 +1389,8 @@ export interface BulkCreateCustomizationsOptions {
  * @requiredField choices
  * @requiredField customizationId
  * @permissionId WIX_STORES.CUSTOMIZATION_UPDATE
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Customization write in v3 catalog
  * @permissionScopeId SCOPE.STORES.CUSTOMIZATION_WRITE
  * @permissionScope Manage Products
@@ -1142,6 +1408,7 @@ export interface AddCustomizationChoicesOptions {
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }
@@ -1156,6 +1423,8 @@ export interface AddCustomizationChoicesOptions {
  * @requiredField choices
  * @requiredField customizationId
  * @permissionId WIX_STORES.CUSTOMIZATION_UPDATE
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Customization write in v3 catalog
  * @permissionScopeId SCOPE.STORES.CUSTOMIZATION_WRITE
  * @permissionScope Manage Products
@@ -1173,6 +1442,7 @@ export interface SetCustomizationChoicesOptions {
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }
@@ -1187,6 +1457,8 @@ export interface SetCustomizationChoicesOptions {
  * @requiredField choiceIds
  * @requiredField customizationId
  * @permissionId WIX_STORES.CUSTOMIZATION_UPDATE
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Customization write in v3 catalog
  * @permissionScopeId SCOPE.STORES.CUSTOMIZATION_WRITE
  * @permissionScope Manage Products
@@ -1206,6 +1478,7 @@ export interface RemoveCustomizationChoicesOptions {
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }
@@ -1218,6 +1491,8 @@ export interface RemoveCustomizationChoicesOptions {
  * @requiredField customizationsChoices.choices
  * @requiredField customizationsChoices.customizationId
  * @permissionId WIX_STORES.CUSTOMIZATION_UPDATE
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Customization write in v3 catalog
  * @permissionScopeId SCOPE.STORES.CUSTOMIZATION_WRITE
  * @permissionScope Manage Products
@@ -1241,6 +1516,7 @@ export interface BulkAddCustomizationChoicesOptions {
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }
@@ -1258,6 +1534,8 @@ export interface BulkAddCustomizationChoicesOptions {
  * @requiredField customizations.customization.name
  * @requiredField customizations.customization.revision
  * @permissionId WIX_STORES.CUSTOMIZATION_UPDATE
+ * @permissionScope Manage Stores - all permissions
+ * @permissionScopeId SCOPE.DC-STORES-MEGA.MANAGE-STORES
  * @permissionScope Customization write in v3 catalog
  * @permissionScopeId SCOPE.STORES.CUSTOMIZATION_WRITE
  * @permissionScope Manage Products
@@ -1281,6 +1559,7 @@ export interface BulkUpdateCustomizationsOptions {
      * Fields to include in the response.
      *
      * Supported values: `ASSIGNED_PRODUCTS_COUNT`
+     * @maxSize 100
      */
     fields?: RequestedFields[];
 }