@constructor-io/constructorio-node 5.5.1 → 5.8.0

package/src/modules/catalog.js

@@ -31,7 +31,9 @@ function createCatalogUrl(path, options, additionalQueryParams = {}, apiVersion
 
   const queryString = qs.stringify(queryParams, { indices: false });
 
-  return `${serviceUrl}/${encodeURIComponent(apiVersion)}/${encodeURIComponent(path)}?${queryString}`;
+  const encodedPath = path.split('/').map(encodeURIComponent).join('/');
+
+  return `${serviceUrl}/${encodeURIComponent(apiVersion)}/${encodedPath}?${queryString}`;
 }
 
 // Convert a read stream to buffer
@@ -59,7 +61,7 @@ async function createQueryParamsAndFormData(parameters) {
   const formData = new FormData();
 
   if (parameters) {
-    const { section, notification_email, notificationEmail = notification_email, force, item_groups, onMissing } = parameters;
+    const { section, notification_email, notificationEmail = notification_email, force, item_groups, onMissing, format = 'csv' } = parameters;
     let { items, variations, itemGroups = item_groups } = parameters;
 
     try {
@@ -106,24 +108,32 @@ async function createQueryParamsAndFormData(parameters) {
       queryParams.on_missing = onMissing;
     }
 
+    if (typeof format !== 'string' || !['csv', 'jsonl'].includes(format.toLowerCase())) {
+      throw new Error('format must be csv or jsonl');
+    }
+
+    const normalizedFormat = format.toLowerCase();
+
+    queryParams.format = normalizedFormat;
+
     // Pull items from parameters
     if (items) {
       formData.append('items', items, {
-        filename: 'items.csv',
+        filename: `items.${normalizedFormat}`,
       });
     }
 
     // Pull variations from parameters
     if (variations) {
       formData.append('variations', variations, {
-        filename: 'variations.csv',
+        filename: `variations.${normalizedFormat}`,
       });
     }
 
     // Pull item groups from parameters
     if (itemGroups) {
       formData.append('item_groups', itemGroups, {
-        filename: 'item_groups.csv',
+        filename: `item_groups.${normalizedFormat}`,
       });
     }
   }
@@ -201,8 +211,8 @@ class Catalog {
    *             id: 'blk_pllvr_hd_001',
    *             data: {
    *               keywords: ['midnight black', 'black', 'hoodie', 'tops', 'outerwear'],
-   *               url: '/products/blk_pllvr_hd_001'
-   *               image_url: '/products/images/blk_pllvr_hd_001'
+   *               url: '/products/blk_pllvr_hd_001',
+   *               image_url: '/products/images/blk_pllvr_hd_001',
    *               description: 'a modified short description about the black pullover hoodie',
    *             }
    *         },
@@ -2553,9 +2563,10 @@ class Catalog {
    * @param {string} parameters.section - The section to update
    * @param {string} [parameters.notificationEmail] - An email address to receive an email notification if the task fails
    * @param {boolean} [parameters.force=false] - Process the catalog even if it will invalidate a large number of existing items
-   * @param {file} [parameters.items] - The CSV file with all new items
-   * @param {file} [parameters.variations] - The CSV file with all new variations
-   * @param {file} [parameters.itemGroups] - The CSV file with all new itemGroups
+   * @param {file} [parameters.items] - The file with all new items (csv or jsonl, depending on the format parameter)
+   * @param {file} [parameters.variations] - The file with all new variations (csv or jsonl, depending on the format parameter)
+   * @param {file} [parameters.itemGroups] - The file with all new itemGroups (csv or jsonl, depending on the format parameter)
+   * @param {string} [parameters.format] - File format of all uploaded catalog files (items, variations, and itemGroups). Can be either csv or jsonl.
    * @param {object} [networkParameters] - Parameters relevant to the network request
    * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
    * @returns {Promise}
@@ -2567,6 +2578,7 @@ class Catalog {
    *     items: itemsFileBufferOrStream,
    *     variations: variationsFileBufferOrStream,
    *     itemGroups: itemGroupsFileBufferOrStream,
+   *     format: 'csv'
    * });
    */
   async replaceCatalog(parameters = {}, networkParameters = {}) {
@@ -2605,9 +2617,10 @@ class Catalog {
    * @param {string} parameters.section - The section to update
    * @param {string} [parameters.notificationEmail] - An email address to receive an email notification if the task fails
    * @param {boolean} [parameters.force=false] - Process the catalog even if it will invalidate a large number of existing items
-   * @param {file} [parameters.items] - The CSV file with all new items
-   * @param {file} [parameters.variations] - The CSV file with all new variations
-   * @param {file} [parameters.itemGroups] - The CSV file with all new itemGroups
+   * @param {file} [parameters.items] - The file with all new items (csv or jsonl, depending on the format parameter)
+   * @param {file} [parameters.variations] - The file with all new variations (csv or jsonl, depending on the format parameter)
+   * @param {file} [parameters.itemGroups] - The file with all new itemGroups (csv or jsonl, depending on the format parameter)
+   * @param {string} [parameters.format] - File format of the uploaded items and variations files. Can be either csv or jsonl.
    * @param {object} [networkParameters] - Parameters relevant to the network request
    * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
    * @returns {Promise}
@@ -2619,6 +2632,7 @@ class Catalog {
    *     items: itemsFileBufferOrStream,
    *     variations: variationsFileBufferOrStream,
    *     itemGroups: itemGroupsFileBufferOrStream,
+   *     format: 'csv'
    * });
    */
   async updateCatalog(parameters = {}, networkParameters = {}) {
@@ -2658,9 +2672,10 @@ class Catalog {
    * @param {string} [parameters.notificationEmail] - An email address to receive an email notification if the task fails
    * @param {boolean} [parameters.force=false] - Process the catalog even if it will invalidate a large number of existing items
    * @param {string} [parameters.onMissing="FAIL"] - Defines the strategy for handling items which are present in the file and missing in the system. IGNORE silently prevents adding them to the system, CREATE creates them, FAIL fails the ingestion in case of their presence
-   * @param {file} [parameters.items] - The CSV file with all new items
-   * @param {file} [parameters.variations] - The CSV file with all new variations
-   * @param {file} [parameters.itemGroups] - The CSV file with all new itemGroups
+   * @param {file} [parameters.items] - The file with all new items (csv or jsonl, depending on the format parameter)
+   * @param {file} [parameters.variations] - The file with all new variations (csv or jsonl, depending on the format parameter)
+   * @param {file} [parameters.itemGroups] - The file with all new itemGroups (csv or jsonl, depending on the format parameter)
+   * @param {string} [parameters.format] - File format of the uploaded items and variations files. Can be either csv or jsonl.
    * @param {object} [networkParameters] - Parameters relevant to the network request
    * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
    * @returns {Promise}
@@ -2672,6 +2687,7 @@ class Catalog {
    *     items: itemsFileBufferOrStream,
    *     variations: variationsFileBufferOrStream,
    *     itemGroups: itemGroupsFileBufferOrStream,
+   *     format: 'csv'
    * });
    */
   async patchCatalog(parameters = {}, networkParameters = {}) {
@@ -2710,7 +2726,8 @@ class Catalog {
    * @param {string} parameters.section - The section to update
    * @param {string} [parameters.notificationEmail] - An email address to receive an email notification if the task fails
    * @param {boolean} [parameters.force=false] - Process the catalog even if it will invalidate a large number of existing items
-   * @param {file} [parameters.tarArchive] - The tar file that includes csv files
+   * @param {file} [parameters.tarArchive] - The tar file that includes catalog files (csv or jsonl, depending on the format parameter)
+   * @param {string} [parameters.format] - File format of the uploaded items and variations files. Can be either csv or jsonl.
    * @param {object} [networkParameters] - Parameters relevant to the network request
    * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
    * @returns {Promise}
@@ -2720,6 +2737,7 @@ class Catalog {
    *     section: 'Products',
    *     notificationEmail: 'notifications@example.com',
    *     tarArchive: tarArchiveBufferOrStream,
+   *     format: 'csv'
    * });
    */
   async replaceCatalogUsingTarArchive(parameters = {}, networkParameters = {}) {
@@ -2766,7 +2784,8 @@ class Catalog {
    * @param {string} parameters.section - The section to update
    * @param {string} [parameters.notificationEmail] - An email address to receive an email notification if the task fails
    * @param {boolean} [parameters.force=false] - Process the catalog even if it will invalidate a large number of existing items
-   * @param {file} [parameters.tarArchive] - The tar file that includes csv files
+   * @param {file} [parameters.tarArchive] - The tar file that includes catalog files (csv or jsonl, depending on the format parameter)
+   * @param {string} [parameters.format] - File format of the uploaded items and variations files. Can be either csv or jsonl.
    * @param {object} [networkParameters] - Parameters relevant to the network request
    * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
    * @returns {Promise}
@@ -2776,6 +2795,7 @@ class Catalog {
    *     section: 'Products',
    *     notificationEmail: 'notifications@example.com',
    *     tarArchive: tarArchiveBufferOrStream,
+   *     format: 'csv'
    * });
    */
   async updateCatalogUsingTarArchive(parameters = {}, networkParameters = {}) {
@@ -2825,7 +2845,8 @@ class Catalog {
    * @param {string} [parameters.notificationEmail] - An email address to receive an email notification if the task fails
    * @param {boolean} [parameters.force=false] - Process the catalog even if it will invalidate a large number of existing items
    * @param {string} [parameters.onMissing="FAIL"] - Defines the strategy for handling items which are present in the file and missing in the system. IGNORE silently prevents adding them to the system, CREATE creates them, FAIL fails the ingestion in case of their presence
-   * @param {file} [parameters.tarArchive] - The tar file that includes csv files
+   * @param {file} [parameters.tarArchive] - The tar file that includes catalog files (csv or jsonl, depending on the format parameter)
+   * @param {string} [parameters.format] - File format of the uploaded items and variations files. Can be either csv or jsonl.
    * @param {object} [networkParameters] - Parameters relevant to the network request
    * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
    * @returns {Promise}
@@ -2835,6 +2856,7 @@ class Catalog {
    *     section: 'Products',
    *     notificationEmail: 'notifications@example.com',
    *     tarArchive: tarArchiveBufferOrStream,
+   *     format: 'csv'
    * });
    */
   async patchCatalogUsingTarArchive(parameters = {}, networkParameters = {}) {
@@ -2909,8 +2931,12 @@ class Catalog {
    *     sortDescending: false,
    *     position: 1,
    * });
+   * @deprecated Use [addFacetConfigurationV2]{@link module:catalog~addFacetConfigurationV2} instead. This method will be removed in the next major version.
    */
   addFacetConfiguration(parameters = {}, networkParameters = {}) {
+    // eslint-disable-next-line no-console
+    console.warn('ConstructorIO: addFacetConfiguration is deprecated and will be removed in the next major version. Use addFacetConfigurationV2 instead.');
+
     let requestUrl;
     const { fetch } = this.options;
     const controller = new AbortController();
@@ -2962,8 +2988,12 @@ class Catalog {
    *     page: 2,
    *     numResultsPerPage: 50,
    * });
+   * @deprecated Use [getFacetConfigurationsV2]{@link module:catalog~getFacetConfigurationsV2} instead. This method will be removed in the next major version.
    */
   getFacetConfigurations(parameters = {}, networkParameters = {}) {
+    // eslint-disable-next-line no-console
+    console.warn('ConstructorIO: getFacetConfigurations is deprecated and will be removed in the next major version. Use getFacetConfigurationsV2 instead.');
+
     let requestUrl;
     const { fetch } = this.options;
     const controller = new AbortController();
@@ -3021,8 +3051,12 @@ class Catalog {
    * constructorio.catalog.getFacetConfiguration({
    *     name: 'color',
    * });
+   * @deprecated Use [getFacetConfigurationV2]{@link module:catalog~getFacetConfigurationV2} instead. This method will be removed in the next major version.
    */
   getFacetConfiguration(parameters = {}, networkParameters = {}) {
+    // eslint-disable-next-line no-console
+    console.warn('ConstructorIO: getFacetConfiguration is deprecated and will be removed in the next major version. Use getFacetConfigurationV2 instead.');
+
     let requestUrl;
     const { fetch } = this.options;
     const controller = new AbortController();
@@ -3084,8 +3118,12 @@ class Catalog {
    *         }
    *     ],
    * });
+   * @deprecated Use [modifyFacetConfigurationsV2]{@link module:catalog~modifyFacetConfigurationsV2} instead. This method will be removed in the next major version.
    */
   modifyFacetConfigurations(parameters = {}, networkParameters = {}) {
+    // eslint-disable-next-line no-console
+    console.warn('ConstructorIO: modifyFacetConfigurations is deprecated and will be removed in the next major version. Use modifyFacetConfigurationsV2 instead.');
+
     let requestUrl;
     const { fetch } = this.options;
     const controller = new AbortController();
@@ -3159,8 +3197,12 @@ class Catalog {
    *     sortDescending: false,
    *     position: 1,
    * });
+   * @deprecated Use [replaceFacetConfigurationV2]{@link module:catalog~replaceFacetConfigurationV2} instead. This method will be removed in the next major version.
    */
   replaceFacetConfiguration(parameters = {}, networkParameters = {}) {
+    // eslint-disable-next-line no-console
+    console.warn('ConstructorIO: replaceFacetConfiguration is deprecated and will be removed in the next major version. Use replaceFacetConfigurationV2 instead.');
+
     let requestUrl;
     const { fetch } = this.options;
     const controller = new AbortController();
@@ -3231,8 +3273,12 @@ class Catalog {
    *     sortDescending: true,
    *     position: 1,
    * });
+   * @deprecated Use [modifyFacetConfigurationV2]{@link module:catalog~modifyFacetConfigurationV2} instead. This method will be removed in the next major version.
    */
   modifyFacetConfiguration(parameters = {}, networkParameters = {}) {
+    // eslint-disable-next-line no-console
+    console.warn('ConstructorIO: modifyFacetConfiguration is deprecated and will be removed in the next major version. Use modifyFacetConfigurationV2 instead.');
+
     let requestUrl;
     const { fetch } = this.options;
     const controller = new AbortController();
@@ -3285,8 +3331,12 @@ class Catalog {
    * constructorio.catalog.removeFacetConfiguration({
    *     name: 'color',
    * });
+   * @deprecated Use [removeFacetConfigurationV2]{@link module:catalog~removeFacetConfigurationV2} instead. This method will be removed in the next major version.
    */
   removeFacetConfiguration(parameters = {}, networkParameters = {}) {
+    // eslint-disable-next-line no-console
+    console.warn('ConstructorIO: removeFacetConfiguration is deprecated and will be removed in the next major version. Use removeFacetConfigurationV2 instead.');
+
     let requestUrl;
     const { fetch } = this.options;
     const controller = new AbortController();
@@ -3764,8 +3814,12 @@ class Catalog {
    *     numResultsPerPage: 50,
    *     filters: { exactSearchable: true }
    * });
+   * @deprecated Use [retrieveSearchabilitiesV2]{@link module:catalog~retrieveSearchabilitiesV2} instead. This method will be removed in the next major version.
    */
   retrieveSearchabilities(parameters = {}, networkParameters = {}) {
+    // eslint-disable-next-line no-console
+    console.warn('ConstructorIO: retrieveSearchabilities is deprecated and will be removed in the next major version. Use retrieveSearchabilitiesV2 instead.');
+
     let requestUrl;
     const { fetch } = this.options;
     const controller = new AbortController();
@@ -3866,8 +3920,12 @@ class Catalog {
    *     },
    *   ],
    * });
+   * @deprecated Use [patchSearchabilitiesV2]{@link module:catalog~patchSearchabilitiesV2} instead. This method will be removed in the next major version.
    */
   patchSearchabilities(parameters = {}, networkParameters = {}) {
+    // eslint-disable-next-line no-console
+    console.warn('ConstructorIO: patchSearchabilities is deprecated and will be removed in the next major version. Use patchSearchabilitiesV2 instead.');
+
     let requestUrl;
     const { fetch } = this.options;
     const controller = new AbortController();
@@ -3903,6 +3961,1033 @@ class Catalog {
       return helpers.throwHttpErrorFromResponse(new Error(), response);
     });
   }
+
+  // -------------------- V2 Facet Configuration Methods --------------------
+
+  /**
+   * Create a facet configuration (V2)
+   *
+   * @function addFacetConfigurationV2
+   * @param {object} parameters - Additional parameters for facet configuration details
+   * @param {string} parameters.name - Unique facet name used to refer to the facet in your catalog
+   * @param {string} parameters.pathInMetadata - The path in metadata of each item where this facet is present
+   * @param {string} parameters.type - Type of facet. Must be one of multiple, hierarchical, or range
+   * @param {string} [parameters.displayName] - The name of the facet presented to the end users
+   * @param {string} [parameters.sortOrder] - Defines the criterion by which the options of this facet group are sorted
+   * @param {boolean} [parameters.sortDescending] - Set to true if the options should be sorted in descending order
+   * @param {string} [parameters.rangeType] - Should be 'static' if a facet is configured as range
+   * @param {string} [parameters.rangeFormat] - Format of range facets: 'boundaries' for sliders, 'options' for buckets
+   * @param {string} [parameters.rangeInclusive] - Used to create inclusive buckets: 'above', 'below', or null
+   * @param {number[]} [parameters.rangeLimits] - Defines the cut-off points for generating static range buckets
+   * @param {string} [parameters.matchType] - Specifies the behavior of filters: 'any', 'all', or 'none'
+   * @param {number} [parameters.position] - Slot facet groups to fixed positions
+   * @param {boolean} [parameters.hidden] - Specifies whether the facet is hidden from users
+   * @param {boolean} [parameters.protected] - Specifies whether the facet is protected from users
+   * @param {boolean} [parameters.countable] - Specifies whether counts for each facet option should be calculated
+   * @param {number} [parameters.optionsLimit] - Maximum number of options to return in search responses
+   * @param {object} [parameters.data] - Dictionary/Object with any extra facet data
+   * @param {string} [parameters.section] - The section in which your facet is defined. Default value is Products.
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise<object>} - Facet configuration response with name, path_in_metadata, type, and other fields
+   * @see https://docs.constructor.com/reference/configuration-facets
+   * @example
+   * constructorio.catalog.addFacetConfigurationV2({
+   *     name: 'color',
+   *     pathInMetadata: 'color',
+   *     type: 'multiple',
+   *     displayName: 'Color',
+   * });
+   */
+  addFacetConfigurationV2(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const { fetch } = this.options;
+    const controller = new AbortController();
+    const { signal } = controller;
+    const { section, name, pathInMetadata, ...rest } = parameters;
+
+    if (!name || typeof name !== 'string') {
+      return Promise.reject(new Error('name is a required parameter of type string'));
+    }
+
+    if (!pathInMetadata || typeof pathInMetadata !== 'string') {
+      return Promise.reject(new Error('pathInMetadata is a required parameter of type string'));
+    }
+
+    const validFacetTypes = ['multiple', 'hierarchical', 'range'];
+
+    if (!rest.type || !validFacetTypes.includes(rest.type)) {
+      return Promise.reject(new Error('type is a required parameter and must be one of: multiple, hierarchical, or range'));
+    }
+
+    const additionalQueryParams = {};
+
+    if (!helpers.isNil(section)) {
+      additionalQueryParams.section = section;
+    }
+
+    try {
+      requestUrl = createCatalogUrl('facets', this.options, additionalQueryParams, 'v2');
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    // Handle network timeout if specified
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+    return fetch(requestUrl, {
+      method: 'POST',
+      body: JSON.stringify(toSnakeCaseKeys({ name, pathInMetadata, ...rest })),
+      headers: {
+        'Content-Type': 'application/json',
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    });
+  }
+
+  /**
+   * Get all facet configurations (V2)
+   *
+   * @function getFacetConfigurationsV2
+   * @param {object} parameters - Additional parameters for retrieving facet configurations.
+   * @param {number} [parameters.page] - Page number you'd like to request. Defaults to 1.
+   * @param {number} [parameters.numResultsPerPage] - Number of facets per page in paginated response. Default value is 100.
+   * @param {number} [parameters.offset] - The number of results to skip from the beginning. Cannot be used together with page.
+   * @param {string} [parameters.section] - The section in which your facet is defined. Default value is Products.
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise<{facets: object[], total_count: number}>} - Paginated list of facet configurations
+   * @see https://docs.constructor.com/reference/configuration-facets
+   * @example
+   * constructorio.catalog.getFacetConfigurationsV2({
+   *     page: 2,
+   *     numResultsPerPage: 50,
+   * });
+   */
+  getFacetConfigurationsV2(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const { fetch } = this.options;
+    const controller = new AbortController();
+    const { signal } = controller;
+    const { numResultsPerPage, page, offset, section } = parameters;
+    const additionalQueryParams = {};
+
+    if (!helpers.isNil(section)) {
+      additionalQueryParams.section = section;
+    }
+
+    if (!helpers.isNil(numResultsPerPage)) {
+      additionalQueryParams.num_results_per_page = numResultsPerPage;
+    }
+
+    if (!helpers.isNil(page)) {
+      additionalQueryParams.page = page;
+    }
+
+    if (!helpers.isNil(offset)) {
+      additionalQueryParams.offset = offset;
+    }
+
+    try {
+      requestUrl = createCatalogUrl('facets', this.options, additionalQueryParams, 'v2');
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    // Handle network timeout if specified
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    });
+  }
+
+  /**
+   * Get a single facet's configuration (V2)
+   *
+   * @function getFacetConfigurationV2
+   * @param {object} parameters - Additional parameters for retrieving a facet configuration.
+   * @param {string} parameters.name - Unique facet name used to refer to the facet in your catalog
+   * @param {string} [parameters.section] - The section in which your facet is defined. Default value is Products.
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise<object>} - Facet configuration response with name, path_in_metadata, type, and other fields
+   * @see https://docs.constructor.com/reference/configuration-facets
+   * @example
+   * constructorio.catalog.getFacetConfigurationV2({
+   *     name: 'color',
+   * });
+   */
+  getFacetConfigurationV2(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const { fetch } = this.options;
+    const controller = new AbortController();
+    const { signal } = controller;
+    const { section, name } = parameters;
+
+    if (!name || typeof name !== 'string') {
+      return Promise.reject(new Error('name is a required parameter of type string'));
+    }
+
+    const additionalQueryParams = {};
+
+    if (!helpers.isNil(section)) {
+      additionalQueryParams.section = section;
+    }
+
+    try {
+      requestUrl = createCatalogUrl(`facets/${name}`, this.options, additionalQueryParams, 'v2');
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    // Handle network timeout if specified
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    });
+  }
+
+  /**
+   * Create or replace facet configurations (V2)
+   *
+   * Caution: Replacing will overwrite all other configurations you may have defined for the facet group,
+   * resetting them to their defaults, except facet options - they will not be affected.
+   *
+   * @function createOrReplaceFacetConfigurationsV2
+   * @param {object} parameters - Additional parameters for creating or replacing facet configurations
+   * @param {array} parameters.facetConfigurations - List of facet configurations to create or replace (max 25 items)
+   * @param {string} [parameters.section] - The section in which your facet is defined. Default value is Products.
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise<{facets: object[]}>} - List of created/replaced facet configurations
+   * @see https://docs.constructor.com/reference/configuration-facets
+   * @example
+   * constructorio.catalog.createOrReplaceFacetConfigurationsV2({
+   *     facetConfigurations: [
+   *         {
+   *             name: 'color',
+   *             pathInMetadata: 'color',
+   *             type: 'multiple',
+   *             displayName: 'Color',
+   *         },
+   *     ],
+   * });
+   */
+  createOrReplaceFacetConfigurationsV2(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const { fetch } = this.options;
+    const controller = new AbortController();
+    const { signal } = controller;
+    const { section, facetConfigurations: facetConfigurationsRaw } = parameters;
+
+    if (!facetConfigurationsRaw || !Array.isArray(facetConfigurationsRaw)) {
+      return Promise.reject(new Error('facetConfigurations is a required parameter of type array'));
+    }
+
+    const facetConfigurations = facetConfigurationsRaw.map((config) => toSnakeCaseKeys(config));
+    const additionalQueryParams = {};
+
+    if (!helpers.isNil(section)) {
+      additionalQueryParams.section = section;
+    }
+
+    try {
+      requestUrl = createCatalogUrl('facets', this.options, additionalQueryParams, 'v2');
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    // Handle network timeout if specified
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'PUT',
+      body: JSON.stringify({ facets: facetConfigurations }),
+      headers: {
+        'Content-Type': 'application/json',
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    });
+  }
+
+  /**
+   * Modify the configurations of multiple facets (partially) at once (V2)
+   *
+   * @function modifyFacetConfigurationsV2
+   * @param {object} parameters - Additional parameters for modifying facet configurations
+   * @param {array} parameters.facetConfigurations - List of facet configurations you would like to update (max 1000 items)
+   * @param {string} [parameters.section] - The section in which your facet is defined. Default value is Products.
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise<{facets: object[]}>} - List of modified facet configurations
+   * @see https://docs.constructor.com/reference/configuration-facets
+   * @example
+   * constructorio.catalog.modifyFacetConfigurationsV2({
+   *     facetConfigurations: [
+   *         {
+   *             name: 'color',
+   *             displayName: 'Color',
+   *             sortOrder: 'value',
+   *         },
+   *     ],
+   * });
+   */
+  modifyFacetConfigurationsV2(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const { fetch } = this.options;
+    const controller = new AbortController();
+    const { signal } = controller;
+    const { section, facetConfigurations: facetConfigurationsRaw } = parameters;
+
+    if (!facetConfigurationsRaw || !Array.isArray(facetConfigurationsRaw)) {
+      return Promise.reject(new Error('facetConfigurations is a required parameter of type array'));
+    }
+
+    const facetConfigurations = facetConfigurationsRaw.map((config) => toSnakeCaseKeys(config));
+    const additionalQueryParams = {};
+
+    if (!helpers.isNil(section)) {
+      additionalQueryParams.section = section;
+    }
+
+    try {
+      requestUrl = createCatalogUrl('facets', this.options, additionalQueryParams, 'v2');
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    // Handle network timeout if specified
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'PATCH',
+      body: JSON.stringify({ facets: facetConfigurations }),
+      headers: {
+        'Content-Type': 'application/json',
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    });
+  }
+
+  /**
+   * Replace the configuration of a facet (completely) (V2)
+   *
+   * Caution: This will overwrite all other configurations you may have defined for the facet group,
+   * resetting them to their defaults, except facet options - they will not be affected.
+   *
+   * @function replaceFacetConfigurationV2
+   * @param {object} parameters - Additional parameters for facet configuration details
+   * @param {string} parameters.name - Unique facet name used to refer to the facet in your catalog
+   * @param {string} parameters.pathInMetadata - The path in metadata of each item where this facet is present
+   * @param {string} parameters.type - Type of facet. Must be one of multiple, hierarchical, or range
+   * @param {string} [parameters.displayName] - The name of the facet presented to the end users
+   * @param {string} [parameters.sortOrder] - Defines the criterion by which the options are sorted
+   * @param {boolean} [parameters.sortDescending] - Set to true if the options should be sorted in descending order
+   * @param {string} [parameters.rangeType] - Should be 'static' if a facet is configured as range
+   * @param {string} [parameters.rangeFormat] - Format of range facets: 'boundaries' or 'options'
+   * @param {string} [parameters.rangeInclusive] - Used to create inclusive buckets: 'above', 'below', or null
+   * @param {number[]} [parameters.rangeLimits] - Defines the cut-off points for generating static range buckets
+   * @param {string} [parameters.matchType] - Specifies the behavior of filters: 'any', 'all', or 'none'
+   * @param {number} [parameters.position] - Slot facet groups to fixed positions
+   * @param {boolean} [parameters.hidden] - Specifies whether the facet is hidden from users
+   * @param {boolean} [parameters.protected] - Specifies whether the facet is protected from users
+   * @param {boolean} [parameters.countable] - Specifies whether counts for each facet option should be calculated
+   * @param {number} [parameters.optionsLimit] - Maximum number of options to return in search responses
+   * @param {object} [parameters.data] - Dictionary/Object with any extra facet data
+   * @param {string} [parameters.section] - The section in which your facet is defined. Default value is Products.
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise<object>} - Replaced facet configuration response
+   * @see https://docs.constructor.com/reference/configuration-facets
+   * @example
+   * constructorio.catalog.replaceFacetConfigurationV2({
+   *     name: 'color',
+   *     pathInMetadata: 'color',
+   *     type: 'multiple',
+   *     displayName: 'Color',
+   * });
+   */
+  replaceFacetConfigurationV2(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const { fetch } = this.options;
+    const controller = new AbortController();
+    const { signal } = controller;
+    const { section, name, pathInMetadata, ...rest } = parameters;
+
+    if (!name || typeof name !== 'string') {
+      return Promise.reject(new Error('name is a required parameter of type string'));
+    }
+
+    if (!pathInMetadata || typeof pathInMetadata !== 'string') {
+      return Promise.reject(new Error('pathInMetadata is a required parameter of type string'));
+    }
+
+    const validFacetTypes = ['multiple', 'hierarchical', 'range'];
+
+    if (!rest.type || !validFacetTypes.includes(rest.type)) {
+      return Promise.reject(new Error('type is a required parameter and must be one of: multiple, hierarchical, or range'));
+    }
+
+    const additionalQueryParams = {};
+
+    if (!helpers.isNil(section)) {
+      additionalQueryParams.section = section;
+    }
+
+    try {
+      requestUrl = createCatalogUrl(`facets/${name}`, this.options, additionalQueryParams, 'v2');
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    // Handle network timeout if specified
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'PUT',
+      body: JSON.stringify(toSnakeCaseKeys({ name, pathInMetadata, ...rest })),
+      headers: {
+        'Content-Type': 'application/json',
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    });
+  }
+
+  /**
+   * Modify the configuration of a facet (partially) (V2)
+   *
+   * @function modifyFacetConfigurationV2
+   * @param {object} parameters - Additional parameters for facet configuration details
+   * @param {string} parameters.name - Unique facet name used to refer to the facet in your catalog
+   * @param {string} [parameters.pathInMetadata] - The path in metadata of each item where this facet is present
+   * @param {string} [parameters.type] - Type of facet. Must be one of multiple, hierarchical, or range
+   * @param {string} [parameters.displayName] - The name of the facet presented to the end users
+   * @param {string} [parameters.sortOrder] - Defines the criterion by which the options are sorted
+   * @param {boolean} [parameters.sortDescending] - Set to true if the options should be sorted in descending order
+   * @param {string} [parameters.rangeType] - Should be 'static' if a facet is configured as range
+   * @param {string} [parameters.rangeFormat] - Format of range facets: 'boundaries' or 'options'
+   * @param {string} [parameters.rangeInclusive] - Used to create inclusive buckets: 'above', 'below', or null
+   * @param {number[]} [parameters.rangeLimits] - Defines the cut-off points for generating static range buckets
+   * @param {string} [parameters.matchType] - Specifies the behavior of filters: 'any', 'all', or 'none'
+   * @param {number} [parameters.position] - Slot facet groups to fixed positions
+   * @param {boolean} [parameters.hidden] - Specifies whether the facet is hidden from users
+   * @param {boolean} [parameters.protected] - Specifies whether the facet is protected from users
+   * @param {boolean} [parameters.countable] - Specifies whether counts for each facet option should be calculated
+   * @param {number} [parameters.optionsLimit] - Maximum number of options to return in search responses
+   * @param {object} [parameters.data] - Dictionary/Object with any extra facet data
+   * @param {string} [parameters.section] - The section in which your facet is defined. Default value is Products.
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise<object>} - Modified facet configuration response
+   * @see https://docs.constructor.com/reference/configuration-facets
+   * @example
+   * constructorio.catalog.modifyFacetConfigurationV2({
+   *     name: 'color',
+   *     displayName: 'Color',
+   *     sortOrder: 'num_matches',
+   * });
+   */
+  modifyFacetConfigurationV2(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const { fetch } = this.options;
+    const controller = new AbortController();
+    const { signal } = controller;
+    const { section, name, ...rest } = parameters;
+
+    if (!name || typeof name !== 'string') {
+      return Promise.reject(new Error('name is a required parameter of type string'));
+    }
+
+    const additionalQueryParams = {};
+
+    if (!helpers.isNil(section)) {
+      additionalQueryParams.section = section;
+    }
+
+    try {
+      requestUrl = createCatalogUrl(`facets/${name}`, this.options, additionalQueryParams, 'v2');
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    // Handle network timeout if specified
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'PATCH',
+      body: JSON.stringify(toSnakeCaseKeys(rest)),
+      headers: {
+        'Content-Type': 'application/json',
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    });
+  }
+
+  /**
+   * Remove a facet configuration (V2)
+   *
+   * Caution: Once a facet group's configuration is removed, all configurations will return to their default values.
+   * This includes all facet option configurations (display name, position, etc) you may have defined.
+   *
+   * @function removeFacetConfigurationV2
+   * @param {object} parameters - Additional parameters for facet configuration details
+   * @param {string} parameters.name - Unique facet name used to refer to the facet in your catalog
+   * @param {string} [parameters.section] - The section in which your facet is defined. Default value is Products.
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise<object>} - Removed facet configuration response
+   * @see https://docs.constructor.com/reference/configuration-facets
+   * @example
+   * constructorio.catalog.removeFacetConfigurationV2({
+   *     name: 'color',
+   * });
+   */
+  removeFacetConfigurationV2(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const { fetch } = this.options;
+    const controller = new AbortController();
+    const { signal } = controller;
+    const { section, name } = parameters;
+
+    if (!name || typeof name !== 'string') {
+      return Promise.reject(new Error('name is a required parameter of type string'));
+    }
+
+    const additionalQueryParams = {};
+
+    if (!helpers.isNil(section)) {
+      additionalQueryParams.section = section;
+    }
+
+    try {
+      requestUrl = createCatalogUrl(`facets/${name}`, this.options, additionalQueryParams, 'v2');
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    // Handle network timeout if specified
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'DELETE',
+      headers: {
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    });
+  }
+
+  // -------------------- V2 Searchabilities Methods --------------------
+
+  /**
+   * Retrieve all searchabilities (V2)
+   *
+   * @function retrieveSearchabilitiesV2
+   * @param {object} parameters - Additional parameters for retrieving searchabilities
+   * @param {string} [parameters.name] - Name of searchability field to filter for
+   * @param {number} [parameters.page] - Page number you'd like to request
+   * @param {number} [parameters.offset] - The number of results to skip from the beginning
+   * @param {number} [parameters.numResultsPerPage] - Number of searchabilities per page. Default value is 20.
+   * @param {boolean} [parameters.fuzzySearchable] - Filter by fuzzy_searchable
+   * @param {boolean} [parameters.exactSearchable] - Filter by exact_searchable
+   * @param {boolean} [parameters.displayable] - Filter by displayable
+   * @param {string} [parameters.matchType] - Whether filters should be ANDed or ORed ('and' or 'or')
+   * @param {string} [parameters.sortBy] - The criteria by which searchabilities should be sorted ('name')
+   * @param {string} [parameters.sortOrder] - The sort order ('ascending' or 'descending')
+   * @param {string} [parameters.section] - The section in which the searchability is defined. Default value is Products.
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise<{searchabilities: object[], total_count: number}>} - Paginated list of searchability configurations
+   * @see https://docs.constructor.com/reference/configuration-searchabilities
+   * @example
+   * constructorio.catalog.retrieveSearchabilitiesV2({
+   *     page: 1,
+   *     numResultsPerPage: 50,
+   * });
+   */
+  retrieveSearchabilitiesV2(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const { fetch } = this.options;
+    const controller = new AbortController();
+    const { signal } = controller;
+    const {
+      name,
+      page,
+      offset,
+      numResultsPerPage,
+      fuzzySearchable,
+      exactSearchable,
+      displayable,
+      matchType,
+      sortBy,
+      sortOrder,
+      section,
+    } = parameters;
+    const additionalQueryParams = {};
+
+    if (!helpers.isNil(section)) {
+      additionalQueryParams.section = section;
+    }
+
+    if (!helpers.isNil(page)) {
+      additionalQueryParams.page = page;
+    }
+
+    if (!helpers.isNil(offset)) {
+      additionalQueryParams.offset = offset;
+    }
+
+    if (!helpers.isNil(numResultsPerPage)) {
+      additionalQueryParams.num_results_per_page = numResultsPerPage;
+    }
+
+    if (!helpers.isNil(name)) {
+      additionalQueryParams.name = name;
+    }
+
+    if (!helpers.isNil(fuzzySearchable)) {
+      additionalQueryParams.fuzzy_searchable = fuzzySearchable;
+    }
+
+    if (!helpers.isNil(exactSearchable)) {
+      additionalQueryParams.exact_searchable = exactSearchable;
+    }
+
+    if (!helpers.isNil(displayable)) {
+      additionalQueryParams.displayable = displayable;
+    }
+
+    if (!helpers.isNil(matchType)) {
+      additionalQueryParams.match_type = matchType;
+    }
+
+    if (!helpers.isNil(sortBy)) {
+      additionalQueryParams.sort_by = sortBy;
+    }
+
+    if (!helpers.isNil(sortOrder)) {
+      additionalQueryParams.sort_order = sortOrder;
+    }
+
+    try {
+      requestUrl = createCatalogUrl('searchabilities', this.options, additionalQueryParams, 'v2');
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    // Handle network timeout if specified
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    });
+  }
+
+  /**
+   * Get a single searchability configuration (V2)
+   *
+   * @function retrieveSearchabilityV2
+   * @param {object} parameters - Additional parameters for retrieving a searchability
+   * @param {string} parameters.name - Name of the searchability field
+   * @param {string} [parameters.section] - The section in which the searchability is defined. Default value is Products.
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise<object>} - Searchability configuration response
+   * @see https://docs.constructor.com/reference/configuration-searchabilities
+   * @example
+   * constructorio.catalog.retrieveSearchabilityV2({
+   *     name: 'keywords',
+   * });
+   */
+  retrieveSearchabilityV2(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const { fetch } = this.options;
+    const controller = new AbortController();
+    const { signal } = controller;
+    const { name, section } = parameters;
+
+    if (!name || typeof name !== 'string') {
+      return Promise.reject(new Error('name is a required parameter of type string'));
+    }
+
+    const additionalQueryParams = {};
+
+    if (!helpers.isNil(section)) {
+      additionalQueryParams.section = section;
+    }
+
+    try {
+      requestUrl = createCatalogUrl(`searchabilities/${name}`, this.options, additionalQueryParams, 'v2');
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    // Handle network timeout if specified
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    });
+  }
+
+  /**
+   * Create or update searchabilities (V2)
+   *
+   * @function patchSearchabilitiesV2
+   * @param {object} parameters - Additional parameters for patching searchabilities
+   * @param {object[]} parameters.searchabilities - Array of searchabilities to create or update (1-60 items)
+   * @param {boolean} [parameters.skipRebuild] - Skip index rebuild. Default value is false.
+   * @param {string} [parameters.section] - The section in which the searchability is defined. Default value is Products.
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise<{searchabilities: object[], total_count: number}>} - Updated searchability configurations
+   * @see https://docs.constructor.com/reference/configuration-searchabilities
+   * @example
+   * constructorio.catalog.patchSearchabilitiesV2({
+   *   searchabilities: [
+   *     {
+   *       name: 'style_id',
+   *       exactSearchable: true,
+   *     },
+   *     {
+   *       name: 'keywords',
+   *       fuzzySearchable: true,
+   *     },
+   *   ],
+   * });
+   */
+  patchSearchabilitiesV2(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const { fetch } = this.options;
+    const controller = new AbortController();
+    const { signal } = controller;
+    const { searchabilities: searchabilitiesRaw, skipRebuild, section } = parameters;
+
+    if (!searchabilitiesRaw || !Array.isArray(searchabilitiesRaw)) {
+      return Promise.reject(new Error('searchabilities is a required parameter of type array'));
+    }
+
+    const searchabilities = searchabilitiesRaw.map((config) => toSnakeCaseKeys(config));
+    const additionalQueryParams = {};
+
+    if (!helpers.isNil(section)) {
+      additionalQueryParams.section = section;
+    }
+
+    if (!helpers.isNil(skipRebuild)) {
+      additionalQueryParams.skip_rebuild = skipRebuild;
+    }
+
+    try {
+      requestUrl = createCatalogUrl('searchabilities', this.options, additionalQueryParams, 'v2');
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    // Handle network timeout if specified
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'PATCH',
+      body: JSON.stringify({ searchabilities }),
+      headers: {
+        'Content-Type': 'application/json',
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    });
+  }
+
+  /**
+   * Update a single searchability configuration (V2)
+   *
+   * @function patchSearchabilityV2
+   * @param {object} parameters - Additional parameters for patching a searchability
+   * @param {string} parameters.name - Name of the searchability field
+   * @param {boolean} [parameters.fuzzySearchable] - Whether the field is fuzzy searchable
+   * @param {boolean} [parameters.exactSearchable] - Whether the field is exact searchable
+   * @param {boolean} [parameters.displayable] - Whether the field is displayable
+   * @param {boolean} [parameters.hidden] - Whether the field is hidden
+   * @param {boolean} [parameters.skipRebuild] - Skip index rebuild. Default value is false.
+   * @param {string} [parameters.section] - The section in which the searchability is defined. Default value is Products.
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise<object>} - Updated searchability configuration response
+   * @see https://docs.constructor.com/reference/configuration-searchabilities
+   * @example
+   * constructorio.catalog.patchSearchabilityV2({
+   *     name: 'keywords',
+   *     fuzzySearchable: true,
+   * });
+   */
+  patchSearchabilityV2(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const { fetch } = this.options;
+    const controller = new AbortController();
+    const { signal } = controller;
+    const { name, skipRebuild, section, ...rest } = parameters;
+
+    if (!name || typeof name !== 'string') {
+      return Promise.reject(new Error('name is a required parameter of type string'));
+    }
+
+    const additionalQueryParams = {};
+
+    if (!helpers.isNil(section)) {
+      additionalQueryParams.section = section;
+    }
+
+    if (!helpers.isNil(skipRebuild)) {
+      additionalQueryParams.skip_rebuild = skipRebuild;
+    }
+
+    try {
+      requestUrl = createCatalogUrl(`searchabilities/${name}`, this.options, additionalQueryParams, 'v2');
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    // Handle network timeout if specified
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'PATCH',
+      body: JSON.stringify(toSnakeCaseKeys(rest)),
+      headers: {
+        'Content-Type': 'application/json',
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    });
+  }
+
+  /**
+   * Delete searchabilities (V2)
+   *
+   * @function deleteSearchabilitiesV2
+   * @param {object} parameters - Additional parameters for deleting searchabilities
+   * @param {object[]} parameters.searchabilities - Array of searchabilities names to delete (1-60 items)
+   * @param {boolean} [parameters.skipRebuild] - Skip index rebuild. Default value is false.
+   * @param {string} [parameters.section] - The section in which the searchability is defined. Default value is Products.
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise<{searchabilities: object[], total_count: number}>} - Deleted searchability configurations
+   * @see https://docs.constructor.com/reference/configuration-searchabilities
+   * @example
+   * constructorio.catalog.deleteSearchabilitiesV2({
+   *   searchabilities: [
+   *     { name: 'style_id' },
+   *     { name: 'keywords' },
+   *   ],
+   * });
+   */
+  deleteSearchabilitiesV2(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const { fetch } = this.options;
+    const controller = new AbortController();
+    const { signal } = controller;
+    const { searchabilities: searchabilitiesRaw, skipRebuild, section } = parameters;
+
+    if (!searchabilitiesRaw || !Array.isArray(searchabilitiesRaw)) {
+      return Promise.reject(new Error('searchabilities is a required parameter of type array'));
+    }
+
+    const searchabilities = searchabilitiesRaw.map((config) => toSnakeCaseKeys(config));
+    const additionalQueryParams = {};
+
+    if (!helpers.isNil(section)) {
+      additionalQueryParams.section = section;
+    }
+
+    if (!helpers.isNil(skipRebuild)) {
+      additionalQueryParams.skip_rebuild = skipRebuild;
+    }
+
+    try {
+      requestUrl = createCatalogUrl('searchabilities', this.options, additionalQueryParams, 'v2');
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    // Handle network timeout if specified
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'DELETE',
+      body: JSON.stringify({ searchabilities }),
+      headers: {
+        'Content-Type': 'application/json',
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    });
+  }
+
+  /**
+   * Delete a single searchability configuration (V2)
+   *
+   * @function deleteSearchabilityV2
+   * @param {object} parameters - Additional parameters for deleting a searchability
+   * @param {string} parameters.name - Name of the searchability field to delete
+   * @param {boolean} [parameters.skipRebuild] - Skip index rebuild. Default value is false.
+   * @param {string} [parameters.section] - The section in which the searchability is defined. Default value is Products.
+   * @param {object} [networkParameters] - Parameters relevant to the network request
+   * @param {number} [networkParameters.timeout] - Request timeout (in milliseconds)
+   * @returns {Promise<object>} - Deleted searchability configuration response
+   * @see https://docs.constructor.com/reference/configuration-searchabilities
+   * @example
+   * constructorio.catalog.deleteSearchabilityV2({
+   *     name: 'keywords',
+   * });
+   */
+  deleteSearchabilityV2(parameters = {}, networkParameters = {}) {
+    let requestUrl;
+    const { fetch } = this.options;
+    const controller = new AbortController();
+    const { signal } = controller;
+    const { name, skipRebuild, section } = parameters;
+
+    if (!name || typeof name !== 'string') {
+      return Promise.reject(new Error('name is a required parameter of type string'));
+    }
+
+    const additionalQueryParams = {};
+
+    if (!helpers.isNil(section)) {
+      additionalQueryParams.section = section;
+    }
+
+    if (!helpers.isNil(skipRebuild)) {
+      additionalQueryParams.skip_rebuild = skipRebuild;
+    }
+
+    try {
+      requestUrl = createCatalogUrl(`searchabilities/${name}`, this.options, additionalQueryParams, 'v2');
+    } catch (e) {
+      return Promise.reject(e);
+    }
+
+    // Handle network timeout if specified
+    helpers.applyNetworkTimeout(this.options, networkParameters, controller);
+
+    return fetch(requestUrl, {
+      method: 'DELETE',
+      headers: {
+        ...helpers.createAuthHeader(this.options),
+      },
+      signal,
+    }).then((response) => {
+      if (response.ok) {
+        return response.json();
+      }
+
+      return helpers.throwHttpErrorFromResponse(new Error(), response);
+    });
+  }
 }
 
 module.exports = Catalog;