@wix/wix-data-items-sdk 1.0.188 → 1.0.190

package/build/es/src/data-v2-data-item-items.universal.js

@@ -6,14 +6,14 @@ import { WixDataPatch, QueryBase, } from '@wix/wix-data-items-common';
  * An item can only be inserted into an existing collection. You can create a new collection using the
  * Data Collections API.
  *
- * The `insert()` function returns a Promise that resolves to the inserted item
+ * The `insert()` method returns a Promise that resolves to the inserted item
  * after it has been added to the specified collection. The Promise is rejected
  * if the current user does not have "create" permissions for the collection or
  * the specified item includes an `_id` property whose value matches an
  * existing ID in the collection. Meaning, `insert()` cannot overwrite an
  * existing item in the collection.
  *
- * Calling the `insert()` function triggers the `beforeInsert()` and
+ * Calling the `insert()` method triggers the `beforeInsert()` and
  * `afterInsert()` hooks if they have been defined.
  *
  * Use the `options` parameter to run `insert()` from backend code without
@@ -22,7 +22,7 @@ import { WixDataPatch, QueryBase, } from '@wix/wix-data-items-common';
  * When inserting an item into a collection that has a reference field, set the
  * value of the reference field to the referenced item's `_id` value or the entire referenced item object.
  *
- * The `insert()` function adds the following properties and values to the item
+ * The `insert()` method adds the following properties and values to the item
  * when it adds it to the collection:
  * - `_id`: A unique identifier for an item in a collection, if the item
  *   doesn't have one or has one that is `undefined`. You can optionally provide
@@ -32,7 +32,7 @@ import { WixDataPatch, QueryBase, } from '@wix/wix-data-items-common';
  *   added, the `_createdDate` and `_updatedDate` are the same.
  *
  * Any valid JavaScript object can be added as a property value. The `insert()`
- * function maintains the structure of the specified object. For example, objects that contain nested objects, Arrays, or Arrays with nested objects are all added to the collection as defined.
+ * method maintains the structure of the specified object. For example, objects that contain nested objects, Arrays, or Arrays with nested objects are all added to the collection as defined.
  *
  * The maximum size of an item that you can add to a collection is 500kb.
  *
@@ -43,14 +43,15 @@ import { WixDataPatch, QueryBase, } from '@wix/wix-data-items-common';
  * >   `_id` is pre-inserted into the collection. Single Item Collections may
  * >   contain only one item.
  * > - If there is a pre-existing item in a Single Item Collection, the
- * >   `insert()` function will not run. To update or change an item in a
- * >   Single Item Collection see the `update()` and `save()` functions.
- * > - The `insert()` function does not support multi-reference fields. For
+ * >   `insert()` method will not run. To update or change an item in a
+ * >   Single Item Collection see the `update()` and `save()` methods.
+ * > - The `insert()` method does not support multi-reference fields. For
  * >   multi-reference fields, use `insertReference()`.
+ * > - [Translatable collections](https://support.wix.com/en/article/wix-multilingual-translating-cms-collection-content) do not allow insertion and modification of items when working in a non-primary language. For example, if a collection's primary language is English, and the site visitor is viewing the site in French, calling insert() fails and issues an error.
  * @public
  * @param dataCollectionId - ID of the collection item belongs to.
  * @param item - Data item to insert.
- * @param options - An object containing options to use when processing this operation.
+ * @param options - Options to use when processing this operation.
  * @documentationMaturity preview
  * @requiredField dataCollectionId
  * @requiredField item
@@ -64,18 +65,14 @@ export async function insert(dataCollectionId, item, options) {
 /**
  * Updates an item in a collection.
  *
- * The `update()` function returns a Promise that resolves to the updated item from
+ * The `update()` method returns a Promise that resolves to the updated item from
  * the specified collection. The Promise is rejected if the current user does not
  * have update permissions for the collection.
  *
- * Calling the `update()` function triggers the `beforeUpdate()` and `afterUpdate()`
+ * Calling the `update()` method triggers the `beforeUpdate()` and `afterUpdate()`
  * hooks if they have been defined.
  *
- * > **Note:**
- * > The specified item must include an `_id` property that already exists in
- * > the collection.
- *
- * The `update()` function compares the `_id` property of the specified item
+ * The `update()` method compares the `_id` property of the specified item
  * with the `_id` property values of the items in the specified collection. If
  * an item in the collection has that `_id` value, `update()` replaces the
  * item's property values with the ones in the specified item. If the existing
@@ -84,7 +81,7 @@ export async function insert(dataCollectionId, item, options) {
  * `_updatedDate` property is also updated to the current date.
  *
  * Any valid JavaScript object can be used as a property value. The `update()`
- * function maintains the structure of the specified object. For example,
+ * method maintains the structure of the specified object. For example,
  * objects that contain nested objects, Arrays, or Arrays with nested objects
  * are all added to the collection as defined.
  *
@@ -98,11 +95,13 @@ export async function insert(dataCollectionId, item, options) {
  * The maximum size of an item that you can update in a collection is 500kb.
  *
  * > **Note:**
- * > The update() function does not support multi-reference fields. For
- * > multi-reference fields, use replaceReferences() or insertReference().
+ * > The specified item must include an `_id` property that already exists in the collection.
+ * > The update() method does not support multi-reference fields. For multi-reference fields, use `replaceReferences()` or `insertReference()`.
+ * > - [Translatable collections](https://support.wix.com/en/article/wix-multilingual-translating-cms-collection-content) do not allow insertion and modification of items when working in a non-primary language. For example, if a collection's primary language is English, and the site visitor is viewing the site in French, calling update() fails and issues an error.
+ *
  * @param dataCollectionId - ID of the collection item belongs to.
  * @param item - Data item to update.
- * @param options - An object containing options to use when processing this operation.
+ * @param options - Options to use when processing this operation.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
@@ -117,12 +116,12 @@ export async function update(dataCollectionId, item, options) {
 /**
  * Inserts or updates an item in a collection.
  *
- * The `save()` function returns a Promise that resolves to the inserted or
+ * The `save()` method returns a Promise that resolves to the inserted or
  * updated item after it has been added or updated in the specified
  * collection. The Promise is rejected if the current user does not have
  * the necessary permissions for the collection.
  *
- * The `save()` function inserts or updates the specified item, depending on
+ * The `save()` method inserts or updates the specified item, depending on
  * whether it already exists in the collection. It compares the `_id` property
  * value of the specified item with the `_id` property values of the items in
  * the specified collection. If an item in the collection has that `_id` value,
@@ -146,15 +145,16 @@ export async function update(dataCollectionId, item, options) {
  * > **Notes:**
  * > - If an item's `_id` property value is set to null or an empty string, an
  * >   error is thrown.
- * > - The `save()` function does not support multi-reference fields. For
+ * > - The `save()` method does not support multi-reference fields. For
  * >   multi-reference fields, use `insertReference() `or `replaceReferences()`.
+ * > - [Translatable collections](https://support.wix.com/en/article/wix-multilingual-translating-cms-collection-content) do not allow insertion and modification of items when working in a non-primary language. For example, if a collection's primary language is English, and the site visitor is viewing the site in French, calling save() fails and issues an error.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
  * @requiredField item
  * @param dataCollectionId - ID of the collection item belongs to.
  * @param item - Data item to save.
- * @param options - An object containing options to use when processing this operation.
+ * @param options - Options to use when processing this operation.
  * @permissionScope Write Data Items
  * @permissionScopeId SCOPE.DC-DATA.WRITE
  */
@@ -165,7 +165,7 @@ export async function save(dataCollectionId, item, options) {
 /**
  * Retrieves an item from a collection.
  *
- * The `get()` function returns a Promise that resolves to the item with ID
+ * The `get()` method returns a Promise that resolves to the item with ID
  * `itemId` from the specified collection, or `null` if the `itemId` is not
  * found. The Promise is rejected if the current user does not have read
  * permissions for the collection.
@@ -174,24 +174,26 @@ export async function save(dataCollectionId, item, options) {
  * referenced item is returned. To return the values of the referenced items
  * use `query()` and `include()`.
  *
- * Calling the `get()` function triggers the `beforeGet()` and `afterGet()`
+ * If the get() method is passed the ID of a hidden item, it returns null.
+ *
+ * Calling the `get()` method triggers the `beforeGet()` and `afterGet()`
  * hooks if they have been defined.
  *
  * Use the `options` parameter to run `get()` from backend code without
  * checking for permissions or without its registered hooks.
  *
  * > **Notes:**
- * > - When using the `query()` or `get()` functions or another data retrieval
+ * > - When using the `query()` or `get()` methods or another data retrieval
  * >   method following a change to your database collection, the data
  * >   retrieved may not contain your most recent changes. See Wix-data and
  * >   Eventual Consistency for more information. To solve this problem, you
- * >   can use the `setTimeout()` function to delay retrieving data following
+ * >   can use the `setTimeout()` method to delay retrieving data following
  * >   any changes to your database collection.
  * > - An `itemId` is required to retrieve an item even from a single-item
  * >   collection.
  * @param dataCollectionId - ID of the collection item belongs to.
  * @param itemId - ID of the data item to retrieve.
- * @param options - An object containing options to use when processing this operation.
+ * @param options - Options to use when processing this operation.
  * @public
  * @documentationMaturity preview
  * @requiredField itemId
@@ -207,27 +209,27 @@ export async function get(dataCollectionId, itemId, options) {
 /**
  * Removes an item from a collection.
  *
- * The `remove()` function returns a Promise that resolves to the removed item
+ * The `remove()` method returns a Promise that resolves to the removed item
  * after it has been removed from the specified collection. The Promise is
  * rejected if the current user does not have "delete" permissions for the
  * collection.
  *
- * Calling the `remove()` function triggers the `beforeRemove()` and
+ * Calling the `remove()` method triggers the `beforeRemove()` and
  * `afterRemove()` hooks if they have been defined.
  *
  * Use the `options` parameter to run `remove()` from backend code without
  * checking for permissions or without its registered hooks.
  *
  * > **Notes:**
- * > The `remove()` function also clears multiple-item reference fields for
+ * > The `remove()` method also clears multiple-item reference fields for
  * > items in collections referenced by the specified item. For example,
  * > suppose you have a **Movies** collection with an **Actors** field that
  * > contains multiple references to items in a **People** collection. Removing
  * > an item in the **Movies** collection also clears the data in the
  * > corresponding multiple-item reference fields in the **People** collection.
- * @param dataCollectionId - ID of the collection item belongs to.
+ * @param dataCollectionId - ID of the collection that contains the item.
  * @param itemId - ID of the item to remove.
- * @param options - An object containing options to use when processing this operation.
+ * @param options - Object containing options to use when processing this operation.
  * @public
  * @documentationMaturity preview
  * @requiredField itemId
@@ -242,7 +244,7 @@ export async function remove(dataCollectionId, itemId, options) {
 /**
  * Removes all items from a collection.
  *
- * The `truncate()` function returns a Promise that resolves after all items
+ * The `truncate()` method returns a Promise that resolves after all items
  * have been removed from the specified collection.
  *
  * `truncate()` runs when at least one of the following is true:
@@ -250,7 +252,7 @@ export async function remove(dataCollectionId, itemId, options) {
  * - The request is performed in backend code with a `suppressAuth` options
  * value of `true`.
  *
- * Calling the `truncate()` function does not trigger any hooks.
+ * Calling the `truncate()` method does not trigger any hooks.
  *
  * > **Note:** `truncate()` also clears multiple-item reference fields in
  * > collections referenced by the specified collection. For example, suppose you
@@ -272,14 +274,14 @@ export async function truncate(dataCollectionId) {
 /**
  * Adds a number of items to a collection.
  *
- * The `bulkInsert()` function returns a Promise that resolves after the items
+ * The `bulkInsert()` method returns a Promise that resolves after the items
  * have been added to the specified collection. The Promise is rejected if the
  * current user does not have "create" permissions for the collection. Items
  * are skipped if they include an `_id` property whose value matches an
  * existing ID in the collection. Meaning, `bulkInsert()` cannot overwrite an
  * existing item in the collection.
  *
- * Calling the `bulkInsert()` function triggers the `beforeInsert()` and
+ * Calling the `bulkInsert()` method triggers the `beforeInsert()` and
  * `afterInsert()` hooks for each item that is inserted if the hooks have been
  * defined.
  *
@@ -290,7 +292,7 @@ export async function truncate(dataCollectionId) {
  * values of the reference fields to the referenced item's `_id` value or the
  * entire referenced item object.
  *
- * The `bulkInsert()` function adds the following properties and values to the
+ * The `bulkInsert()` method adds the following properties and values to the
  * item when it adds it to the collection:
  * - `_id`: A unique identifier for an item in a collection, if the item
  *   doesn't have one or has one that is `undefined`. You can optionally
@@ -301,7 +303,7 @@ export async function truncate(dataCollectionId) {
  *   added, the `createdDate` and `updatedDate` are the same.
  *
  * Any valid JavaScript object can be added as a property value. The
- * `bulkInsert()` function maintains the structure of the specified object. For
+ * `bulkInsert()` method maintains the structure of the specified object. For
  * example, objects that contain nested objects, Arrays, or Arrays with nested
  * objects are all added to the collection as defined.
  *
@@ -310,17 +312,18 @@ export async function truncate(dataCollectionId) {
  * > **Notes:**
  * > - If an item's `_id` property value is set to `null` or an empty string,
  * >   an error is thrown.
- * > - Bulk operations are limited to 1000 items per function call.
- * > - The `bulkInsert()` function is not supported for Single Item Collections.
- * > - The `bulkInsert()` function does not support multi-reference fields. For
+ * > - Bulk operations are limited to 1000 items per method call.
+ * > - The `bulkInsert()` method is not supported for Single Item Collections.
+ * > - The `bulkInsert()` method does not support multi-reference fields. For
  * >   multi-reference fields, use `insertReference()`.
+ * > - [Translatable collections](https://support.wix.com/en/article/wix-multilingual-translating-cms-collection-content) do not allow insertion and modification of items when working in a non-primary language. For example, if a collection's primary language is English, and the site visitor is viewing the site in French, calling bulkInsert() fails and issues an error.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
  * @requiredField items
  * @param dataCollectionId - ID of the collection items belong to.
  * @param items - Data items to insert.
- * @param options - An object containing options to use when processing this operation.
+ * @param options - Options to use when processing this operation.
  * @permissionScope Write Data Items
  * @permissionScopeId SCOPE.DC-DATA.WRITE
  */
@@ -331,18 +334,18 @@ export async function bulkInsert(dataCollectionId, items, options) {
 /**
  * Updates a number of items in a collection.
  *
- * The `bulkUpdate()` function returns a Promise that resolves after the items
+ * The `bulkUpdate()` method returns a Promise that resolves after the items
  * have been updated in the specified collection. The Promise is rejected if
  * the current user does not have update permissions for the collection. Items
  * are skipped if they include an `_id` property whose value does not match an
  * existing ID in the collection. Meaning, `bulkUpdate()` cannot add new items
  * into the collection.
  *
- * Calling the `bulkUpdate()` function triggers the `beforeUpdate()` and
+ * Calling the `bulkUpdate()` method triggers the `beforeUpdate()` and
  * `afterUpdate()` hooks for each item that is updated if the hooks have been
  * defined.
  *
- * The `bulkUpdate()` function compares the `_id` property of the specified
+ * The `bulkUpdate()` method compares the `_id` property of the specified
  * items with the `_id` property values of the items in the specified
  * collection.
  *
@@ -354,7 +357,7 @@ export async function bulkInsert(dataCollectionId, items, options) {
  * `_updatedDate` property is also updated to the current date.
  *
  * Any valid JavaScript object can be used as a property value. The
- * `bulkUpdate()` function maintains the structure of the specified object. For
+ * `bulkUpdate()` method maintains the structure of the specified object. For
  * example, objects that contain nested objects, Arrays, or Arrays with nested
  * objects are all added to the collection as defined.
  *
@@ -368,17 +371,18 @@ export async function bulkInsert(dataCollectionId, items, options) {
  * The maximum size of an item that you can update in a collection is 500kb.
  *
  * > **Notes:**
- * > - Bulk operations are limited to 1000 items per function call.
- * > - The `bulkUpdate()` function is not supported for Single Item Collections.
- * > - The `bulkUpdate()` function does not support multi-reference fields. For
+ * > - Bulk operations are limited to 1000 items per method call.
+ * > - The `bulkUpdate()` method is not supported for Single Item Collections.
+ * > - The `bulkUpdate()` method does not support multi-reference fields. For
  * >   multi-reference fields, use `replaceReferences()` or `insertReference()`.
+ * > - [Translatable collections](https://support.wix.com/en/article/wix-multilingual-translating-cms-collection-content) do not allow insertion and modification of items when working in a non-primary language. For example, if a collection's primary language is English, and the site visitor is viewing the site in French, calling bulkUpdate() fails and issues an error.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
  * @requiredField items
  * @param dataCollectionId - ID of the collection items belong to.
  * @param items - Data items to update.
- * @param options - An object containing options to use when processing this operation.
+ * @param options - Options to use when processing this operation.
  * @permissionScope Write Data Items
  * @permissionScopeId SCOPE.DC-DATA.WRITE
  */
@@ -389,12 +393,12 @@ export async function bulkUpdate(dataCollectionId, items, options) {
 /**
  * Inserts or updates a number of items in a collection.
  *
- * The `bulkSave()` function returns a Promise that resolves after the items
+ * The `bulkSave()` method returns a Promise that resolves after the items
  * have been added or updated in the specified collection. The Promise is
  * rejected if the current user does not have the necessary permissions for the
  * collection.
  *
- * The `bulkSave()` function inserts or updates the specified items, depending
+ * The `bulkSave()` method inserts or updates the specified items, depending
  * on whether they already exist in the collection. It compares the `_id`
  * property value of the specified items with the `_id` property values of the
  * items in the specified collection.
@@ -421,18 +425,19 @@ export async function bulkUpdate(dataCollectionId, items, options) {
  * > **Notes:**
  * > - If an item's `_id` property value is set to null or an empty string, an
  * >   error is thrown.
- * > - Bulk operations are limited to 1000 items per function call.
- * > - The `bulkSave()` function is not supported for Single Item Collections.
- * > - The `bulkSave()` function does not support multi-reference fields. For
+ * > - Bulk operations are limited to 1000 items per method call.
+ * > - The `bulkSave()` method is not supported for Single Item Collections.
+ * > - The `bulkSave()` method does not support multi-reference fields. For
  * >   multi-reference fields, use `replaceReferences()` or
  * >   `insertReference()`.
+ * > - [Translatable collections](https://support.wix.com/en/article/wix-multilingual-translating-cms-collection-content) do not allow insertion and modification of items when working in a non-primary language. For example, if a collection's primary language is English, and the site visitor is viewing the site in French, calling bulkSave() fails and issues an error.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
  * @requiredField items
  * @param dataCollectionId - ID of the collection items belong to.
  * @param items - Data items to save.
- * @param options - An object containing options to use when processing this operation.
+ * @param options - Options to use when processing this operation.
  * @permissionScope Write Data Items
  * @permissionScopeId SCOPE.DC-DATA.WRITE
  */
@@ -443,14 +448,14 @@ export async function bulkSave(dataCollectionId, items, options) {
 /**
  * Removes a number of items from a collection.
  *
- * The `bulkRemove()` function returns a Promise that resolves after the items
+ * The `bulkRemove()` method returns a Promise that resolves after the items
  * have been removed from the specified collection. The Promise is rejected if
  * the current user does not have "delete" permissions for the collection. If
  * the delete permissions for the collection are set to Site member author, the
- * only items that will be deleted are those for which the current user is the
- * owner. All other items will be skipped.
+ * only items that are deleted are those for which the current user is the
+ * owner. All other items are skipped.
  *
- * Calling the `bulkRemove()` function triggers the `beforeRemove()` and
+ * Calling the `bulkRemove()` method triggers the `beforeRemove()` and
  * `afterRemove()` hooks for each item that is deleted if the hooks have been
  * defined.
  *
@@ -458,20 +463,20 @@ export async function bulkSave(dataCollectionId, items, options) {
  * checking for permissions or without its registered hooks.
  *
  * > **Notes:**
- * > - The `bulkRemove()` function also clears multiple-item reference fields
+ * > - The `bulkRemove()` method also clears multiple-item reference fields
  * >   for items in collections referenced by the specified items. For example,
  * >   suppose you have a **Movies** collection with an **Actors** field that
  * >   contains multiple references to items in a **People** collection.
  * >   Removing items in the **Movies** collection also clears the data in the
  * >   corresponding multiple-item reference fields in the People collection.
- * > - Bulk operations are limited to 1000 items per function call.
+ * > - Bulk operations are limited to 1000 items per method call.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
  * @requiredField dataItemIds
  * @param dataCollectionId - ID of the collection items belong to.
  * @param itemIds - IDs of the items to remove. The array must contain at least one item. Passing an empty array returns an error.
- * @param options - An object containing options to use when processing this operation.
+ * @param options - Options to use when processing this operation.
  * @permissionScope Write Data Items
  * @permissionScopeId SCOPE.DC-DATA.WRITE
  */
@@ -480,17 +485,13 @@ export async function bulkRemove(dataCollectionId, itemIds, options) {
     return createWixData(httpClient, sideEffects).bulkRemove(dataCollectionId, itemIds, options);
 }
 /**
- * Checks if a reference to the referenced item exists in the specified
- * property of the referring item.
+ * Checks if a reference to the referenced item exists in the specified field of the referring item.
  *
- * The `isReferenced()` function returns a Promise that resolves to true if the
- * referring item contains a reference to the referenced item in the specified
- * property. The Promise is rejected if the current user does not have read
- * permissions for the collection.
+ * The `isReferenced()` method returns a Promise that resolves to true if the referring item contains a reference to the referenced item in the specified field. The Promise is rejected if the current user does not have read permissions for the collection.
  *
- * Calling the `isReferenced()` function does not trigger any hooks.
+ * Calling the `isReferenced()` method does not trigger any hooks.
  *
- * > **Note:** The `isReferenced()` function is not supported for Single Item
+ * > **Note:** The `isReferenced()` method is not supported for Single Item
  * > Collections.
  * @public
  * @documentationMaturity preview
@@ -498,118 +499,121 @@ export async function bulkRemove(dataCollectionId, itemIds, options) {
  * @requiredField referencedItemId
  * @requiredField referringItemFieldName
  * @requiredField referringItemId
+ * @requiredField referringItem
+ * @requiredField referencedItem
+ * @requiredField field
  * @param dataCollectionId - ID of the collection containing the referring item.
- * @param propertyName - Field to check for a reference to the item that may be referenced.
- * @param referringItem - The referring item.
- * @param referencedItem - Item that may be referenced.
+ * @param field - Field to check for a reference to the item that might be referenced.
+ * @param referringItem - Referring item.
+ * @param referencedItem - Item that might be referenced.
  * @param options - Options for checking whether a field contains a reference to an item.
  * @permissionScope Read Data Items
  * @permissionScopeId SCOPE.DC-DATA.READ
  */
-export async function isReferenced(dataCollectionId, propertyName, referringItem, referencedItem, options) {
+export async function isReferenced(dataCollectionId, field, referringItem, referencedItem, options) {
     const { httpClient, sideEffects } = arguments[5];
-    return createWixData(httpClient, sideEffects).isReferenced(dataCollectionId, propertyName, referringItem, referencedItem, options);
+    return createWixData(httpClient, sideEffects).isReferenced(dataCollectionId, field, referringItem, referencedItem, options);
 }
 /**
  * Inserts a reference in the specified property.
  *
- * The `insertReference()` function returns a Promise that resolves when a
+ * The `insertReference()` method returns a Promise that resolves when a
  * reference to the referenced item(s) is added to the referring item in the
  * specified property. The Promise is rejected if the current user does not
  * have update permissions for the collection.
  *
- * Calling the `insertReference()` function does not trigger any hooks.
+ * Calling the `insertReference()` method does not trigger any hooks.
  *
  * > **Notes:**
- * > - The `insertReference()` function only applies to multi-reference fields.
- * > - The `insertReference()` function is not supported for Single Item
+ * > - The `insertReference()` method only applies to multi-reference fields.
+ * > - The `insertReference()` method is not supported for Single Item
  * >   Collections.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
- * @requiredField propertyName
+ * @requiredField field
  * @requiredField referringItem
  * @requiredField referencedItem
- * @param dataCollectionId - The ID of the collection that contains the referring item.
- * @param propertyName - The property to insert the reference into.
- * @param referringItem - The referring item or referring item's ID.
- * @param referencedItem - The referenced item, referenced item's ID, an array of referenced items, or an array of referenced item IDs.
- * @param options - An object containing options to use when processing this operation.
+ * @param dataCollectionId - ID of the collection that contains the referring item.
+ * @param field - Field to insert the reference into.
+ * @param referringItem - Referring item or referring item's ID.
+ * @param referencedItem - Referenced item, referenced item's ID, an array of referenced items, or an array of referenced item IDs.
+ * @param options - Options to use when processing this operation.
  * @permissionScope Write Data Items
  * @permissionScopeId SCOPE.DC-DATA.WRITE
  */
-export async function insertReference(dataCollectionId, propertyName, referringItem, referencedItem, options) {
+export async function insertReference(dataCollectionId, field, referringItem, referencedItem, options) {
     const { httpClient, sideEffects } = arguments[4];
-    if (typeof propertyName !== 'string' &&
+    if (typeof field !== 'string' &&
         referringItem == undefined &&
         referencedItem == undefined) {
         // support undocumented insertReference method when second parameter is WixDataReference[]
-        return createWixData(httpClient, sideEffects).insertReference(dataCollectionId, propertyName, options);
+        return createWixData(httpClient, sideEffects).insertReference(dataCollectionId, field, options);
     }
     else {
-        return createWixData(httpClient, sideEffects).insertReference(dataCollectionId, propertyName, referringItem, referencedItem, options);
+        return createWixData(httpClient, sideEffects).insertReference(dataCollectionId, field, referringItem, referencedItem, options);
     }
 }
 /**
  * Removes a reference from the specified property.
  *
- * The `removeReference()` function returns a Promise that resolves when a
+ * The `removeReference()` method returns a Promise that resolves when a
  * reference to the referenced item(s) is removed from the specified property
  * in the referring item. The Promise is rejected if the current user does not
  * have update permissions for the collection.
  *
- * Calling the `removeReference()` function does not trigger any hooks.
+ * Calling the `removeReference()` method does not trigger any hooks.
  *
- * > **Note:** The `removeReference()` function is not supported for Single
+ * > **Note:** The `removeReference()` method is not supported for Single
  * > Item Collections.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
- * @requiredField propertyName
+ * @requiredField field
  * @requiredField referringItem
  * @requiredField referencedItem
- * @param dataCollectionId - The ID of the collection that contains the referring item.
- * @param propertyName - The property to remove the reference from.
- * @param referringItem - The referring item or referring item's ID.
- * @param referencedItem - The referenced item, referenced item's ID, an array of referenced items, or an array of referenced item IDs.
- * @param options - An object containing options to use when processing this operation.
+ * @param dataCollectionId - ID of the collection that contains the referring item.
+ * @param field - Field from which to remove the reference.
+ * @param referringItem - Referring item or referring item's ID.
+ * @param referencedItem - Referenced item, referenced item's ID, an array of referenced items, or an array of referenced item IDs.
+ * @param options - Options to use when processing this operation.
  * @permissionScope Write Data Items
  * @permissionScopeId SCOPE.DC-DATA.WRITE
  */
-export async function removeReference(dataCollectionId, propertyName, referringItem, referencedItem, options) {
+export async function removeReference(dataCollectionId, field, referringItem, referencedItem, options) {
     const { httpClient, sideEffects } = arguments[4];
-    return createWixData(httpClient, sideEffects).removeReference(dataCollectionId, propertyName, referringItem, referencedItem, options);
+    return createWixData(httpClient, sideEffects).removeReference(dataCollectionId, field, referringItem, referencedItem, options);
 }
 /**
  * Replaces current references with references in the specified property.
  *
- * The `replaceReferences()` function returns a Promise that resolves when the
+ * The `replaceReferences()` method returns a Promise that resolves when the
  * item's current references in the specified property are removed and
  * references to the referenced items are added in their place. The Promise is
  * rejected if the current user does not have update permissions for the
  * collection.
  *
- * Calling the `replaceReferences()` function does not trigger any hooks.
+ * Calling the `replaceReferences()` method does not trigger any hooks.
  *
- * > **Note:** The `replaceReferences()` function is not supported for Single
+ * > **Note:** The `replaceReferences()` method is not supported for Single
  * > Item Collections.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
- * @requiredField propertyName
+ * @requiredField field
  * @requiredField referringItem
  * @requiredField referencedItem
- * @param dataCollectionId - The ID of the collection that contains the referring item.
- * @param propertyName - The property to replaces the references in.
- * @param referringItem - The referring item or referring item's ID.
- * @param referencedItem - The referenced item, referenced item's ID, an array of referenced items, or an array of referenced item IDs.
- * @param options - An object containing options to use when processing this operation.
+ * @param dataCollectionId - ID of the collection that contains the referring item.
+ * @param field - Field to replaces the references in.
+ * @param referringItem - Referring item or referring item's ID.
+ * @param referencedItem - Referenced item, referenced item's ID, an array of referenced items, or an array of referenced item IDs.
+ * @param options - Options to use when processing this operation.
  * @permissionScope Write Data Items
  * @permissionScopeId SCOPE.DC-DATA.WRITE
  */
-export async function replaceReferences(dataCollectionId, propertyName, referringItem, referencedItem, options) {
+export async function replaceReferences(dataCollectionId, field, referringItem, referencedItem, options) {
     const { httpClient, sideEffects } = arguments[4];
-    return createWixData(httpClient, sideEffects).replaceReferences(dataCollectionId, propertyName, referringItem, referencedItem, options);
+    return createWixData(httpClient, sideEffects).replaceReferences(dataCollectionId, field, referringItem, referencedItem, options);
 }
 export function patch(dataCollectionId, itemId) {
     const { httpClient, sideEffects } = arguments[2];
@@ -622,23 +626,33 @@ export function bulkPatch(dataCollectionId, itemIds) {
 /**
  * Creates a query to retrieve items from a database collection.
  *
- * The `query()` function builds a query to retrieve data items from a collection and returns a `WixDataQueryBuilder` object.
- *
- * The returned object contains the query definition which is typically used to run the query using the `find()` function.
+ * The `query()` method builds a query to retrieve data items from a collection and returns a `WixDataQuery` object, which contains the query definition.
  *
- * You can refine the query by chaining `WixDataQueryBuilder` functions onto the query. `WixDataQueryBuilder` functions enable you to sort, filter, and control the results that `query()` returns.
+ * You can refine the query by chaining `WixDataQuery` methods onto the query. `WixDataQuery` methods enable you to sort, filter, and control the results that `query()` returns.
  *
- * The functions that are chained to `query()` are applied in the order they are called. For example, if you sort on an `age` field in ascending order and then on a `name` field in descending order, the results are sorted first by the age of the items and then, if there are multiple results with the same age, the items are sorted by name in descending order, per age value.
+ * The methods that are chained to `query()` are applied in the order they are called. For example, if you sort on an `age` field in ascending order and then on a `name` field in descending order, the results are sorted first by the age of the items and then, if there are multiple results with the same age, the items are sorted by name in descending order, per age value.
  *
- * If the collection that you are querying has references to other collections, by default the data from referenced collections is not retrieved. To get the data from referenced items, specify them using `include()` function.
+ * The `query()` method runs with the following `WixDataQuery` defaults that you can override:
+ * - `skip`: 0
+ * - `limit`: 50
+ * - `descending`: by `_createdDate`
+ * - `include`: none
  *
- * > **Note**: When calling `query()` following an update to your collection, the data retrieved may not contain the most recent changes. If you need the most up-to-date data, set `options.consistentRead` to `true`.
+ * If the collection that you are querying has references to other collections, by default the data from referenced collections is not retrieved. To retrieve data from the referenced items, specify them using the `include()` method.
  *
+ * > **Notes**:
+ * > - When calling `query()` following an update to your collection, the data retrieved might not contain the most recent changes. If you need the most up-to-date data, set `options.consistentRead` to `true`.
+ * - Items marked as hidden are not retrieved.
  *
+ * When working with Wix app collections, queried fields must have the following permissions:
+ * - Connect to data
+ * - Can use in dynamic page URLs
+ * - Can be sorted and filtered
+ * - Read-only: Check which fields can be used in a query.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
- * @param dataCollectionId - The ID of the collection to run the query on.
+ * @param dataCollectionId - ID of the collection to run the query on.
  * @permissionScope Read Data Items
  * @permissionScopeId SCOPE.DC-DATA.READ
  * @applicableIdentity APP
@@ -650,18 +664,24 @@ export function query(dataCollectionId) {
 /**
  * Creates an aggregation on a data collection.
  *
- * The `aggregate()` function builds an aggregation on the specified collection and returns a `WixDataAggregate` object.
+ * The `aggregate()` method builds an aggregation on the specified collection and returns a `WixDataAggregate` object.
  *
  * An aggregation enables you to perform certain calculations on your collection data, or on groups of items that you define, to retrieve meaningful summaries.
  * You can also add paging, filtering, and sorting preferences to your aggregation to retrieve exactly what you need.
  *
- * The returned object contains the aggregate definition which is typically used to run the aggregation using the `run()` function.
+ * The returned object contains the aggregate definition which is typically used to run the aggregation using the `run()` method.
+ *
+ * You can refine the aggregation by chaining `WixDataAggregate` methods on to the aggregate.
+ *
+ * The `aggregate()` method runs with the following defaults that you can override:
+ *
+ *  + `skip` - 0
+ *  + `limit`- 50
  *
- * You can refine the aggregation by chaining `WixDataAggregate` functions on to the aggregate.
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
- * @param dataCollectionId - The ID of the collection to run the aggregation on.
+ * @param dataCollectionId - ID of the collection to run the aggregation on.
  * @permissionScope Read Data Items
  * @permissionScopeId SCOPE.DC-DATA.READ
  * @applicableIdentity APP
@@ -673,38 +693,41 @@ export function aggregate(dataCollectionId) {
 /**
  * Retrieves the full items referenced in the specified field of an item.
  *
- * Reference and multi-reference fields refer to items in different collections.
- * Use this function to retrieve the full details of the referenced items themselves.
+ * Reference and multi-reference fields refer to items in different collections. Use this method to retrieve the full details of the referenced items.
+ *
+ * For example, suppose you have a **Movies** collection with an **Actors** field that contains references to items in a **People** collection. Querying the **Movies** collection using `queryReferenced()` retrieves the relevant **People** items referenced in the **Actors** field of the specified **Movie** item. This gives you information from the **People** collection about each of the actors in the specified movie.
  *
- * For example, suppose you have a **Movies** collection with an **Actors** field that contains references to items in a **People** collection.
- * Querying the **Movies** collection using `queryReferenced()` returns the relevant **People** items referenced in the **Actors** field of the specified **Movie** item.
- * This gives you information from the **People** collection about each of the actors in the specified movie.
+ * The queryReferenced() method returns a Promise that resolves to the full items referenced in the specified property of the item from the specified collection. The Promise is rejected if the current user does not have read permissions for the specified collection or the collection containing the referenced items.
  *
- * > **Note**: When calling `queryReferenced()` following an update to your collection, the data retrieved may not contain the most recent changes. If you need the most up-to-date data, set `options.consistentRead` to `true`.
+ * > **Notes**:
+ * > - Calling `queryReferenced()` does not trigger any hooks.
+ * > - You can only call `queryReferenced()` for [multi-reference fields](https://support.wix.com/en/article/about-referencing-multiple-items-in-one-field).
+ * > - This method does not support [single-item collections](ADDLINK).
+ * > - When calling `queryReferenced()` following an update to your collection, the data retrieved [may not contain the most recent changes](https://dev.wix.com/docs/sdk/backend-modules/data/eventual-consistency). If you need the most up-to-date data, set `options.consistentRead` to `true`.
+ * Learn more about [querying items that reference other items](https://support.wix.com/en/article/including-referenced-data-when-filtering).
  * @public
  * @documentationMaturity preview
  * @requiredField dataCollectionId
- * @requiredField holdingItem
- * @requiredField relationshipAttribute
- * @param dataCollectionId - The ID of the collection that contains the referring item.
- * @param holdingItem - The referring item or referring item's ID.
- * @param relationshipAttribute - The property that contains the references to the referenced items.
+ * @requiredField referringItem
+ * @requiredField field
+ * @param dataCollectionId - ID of the collection that contains the referring item.
+ * @param referringItem - Referring item or referring item's ID.
+ * @param field - Field that contains the references to the referenced items.
  * @param options - Options for querying referenced data items.
  * @permissionScope Read Data Items
  * @permissionScopeId SCOPE.DC-DATA.READ
  * @applicableIdentity APP
  */
-export async function queryReferenced(dataCollectionId, holdingItem, relationshipAttribute, options) {
+export async function queryReferenced(dataCollectionId, referringItem, field, options) {
     const { httpClient, sideEffects } = arguments[4];
-    return createWixData(httpClient, sideEffects).queryReferenced(dataCollectionId, holdingItem, relationshipAttribute, options);
+    return createWixData(httpClient, sideEffects).queryReferenced(dataCollectionId, referringItem, field, options);
 }
 /**
- * Creates a filter to be used with queries and aggregations.
+ * Creates a filter for queries and aggregations.
  *
- * The `filter()` function builds a filter to be applied to a query or an aggregation, and returns a `WixDataFilter` object.
- * The returned object contains the filter definition and can be combined with query builder using `and()`, `or()` and `not()` functions.
+ * The `filter()` method builds a filter to be applied to a query or an aggregation. It returns a `WixDataFilter` object, which can be used with other filter methods such as `and()`, `or()` and `not()`, to create complex filter definitions.
  *
- * When working with Wix App Collections, check which fields can be used in a filter.
+ * When working with [Wix app collections](https://support.wix.com/en/article/cms-formerly-content-manager-working-with-wix-app-collections), check which fields can be used in a filter.
  *
  * @public
  * @documentationMaturity preview