@wix/ditto-codegen-public 1.0.210 → 1.0.212

package/dist/docs-output/api-docs/crm-contacts-onContactUpdated-doc.txt

@@ -1,99 +0,0 @@
-<crm_contacts_onContactUpdated>
-<description>
-# This is a Webhook method
-
-# Method name:
-
-crm.contacts.onContactUpdated(handler: OnContactUpdatedHandler)
-
-# Method Link:
-
-https://dev.wix.com/docs/sdk/backend-modules/crm/contacts/on-contact-updated
-
-# Method Description:
-
-Triggered when a contact is updated.
-
-
-</description>
-<usage>
-import { contacts } from "@wix/crm";
-
-   contacts.onContactUpdated((event) => {
-     // handle your event here
-   });
-   
-</usage>
-<type_definition>
-```
-Method: crm.contacts.onContactUpdated(handler)
-Description: Triggered when a contact is updated.
-Method parameters:
-  param name:  handler | type: OnContactUpdatedHandler | description:  none 
-      - name: event  | type: ContactUpdatedEnvelope | description:  none 
-          - name: entity  | type: Contact | description:  none 
-              - name: info  | type: ContactInfo | description:  Contact's details. 
-                  - name: addresses  | type: ContactAddressesWrapper | description:  Contact's street addresses. 
-                      - name: items  | type: Array<ContactAddress> | description:  List of up to 50 addresses. 
-                            - name: address  | type: Address | description:  Street address. 
-                                - name: addressLine1  | type: string | description:  Main address line, usually street and number, as free text. 
-                                - name: addressLine2  | type: string | description:  Free text providing more detailed address information, such as apartment, suite, or floor. 
-                                - name: city  | type: string | description:  City name. 
-                                - name: country  | type: string | description:  2-letter country code in an [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format. 
-                                - name: postalCode  | type: string | description:  Postal or zip code. 
-                                - name: subdivision  | type: string | description:  Code for a subdivision (such as state, prefecture, or province) in an [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) format. 
-                                - ONE-OF: 
-                                  - name: addressLine  | type: string | description:  Main address line, usually street and number, as free text. 
-                                  - name: streetAddress  | type: StreetAddress | description:  Street address object, with number and name in separate fields. 
-                                      - name: name  | type: string | description:  Street name. 
-                                      - name: number  | type: string | description:  Street number. 
-                            - name: tag  | type: AddressTag | description:  Address type. `UNTAGGED` is shown as "Other" in the Contact List. 
-                                enum: BILLING, HOME, SHIPPING, UNTAGGED, WORK
-                  - name: birthdate  | type: string | description:  Birth date in `YYYY-MM-DD` format. For example, `2020-03-15`. 
-                  - name: company  | type: string | description:  Contact's company name. 
-                  - name: emails  | type: ContactEmailsWrapper | description:  Contact's email addresses. 
-                      - name: items  | type: Array<ContactEmail> | description:  List of up to 50 email addresses. 
-                            - name: email  | type: string | description:  Email address. 
-                            - name: primary  | type: boolean | description:  Indicates whether this is the contact's primary email address. When changing `primary` to `true` for an email, the contact's other emails become `false`. Changing the primary email of a contact also affects the subscription status to marketing emails that are decided based on the primary email. 
-                            - name: tag  | type: EmailTag | description:  Email type.  `UNTAGGED` is shown as "Other" in the Contact List. 
-                                enum: HOME, MAIN, UNTAGGED, WORK
-                  - name: extendedFields  | type: ExtendedFieldsWrapper | description:  Additional custom fields.  Empty fields are not returned. 
-                      - name: items  | type: Record<string, any> | description:  Contact's extended fields, where each key is the field key, and each value is the field's value for the contact.  To view and manage extended fields, use the Extended Fields API. 
-                  - name: jobTitle  | type: string | description:  Contact's job title. 
-                  - name: labelKeys  | type: LabelsWrapper | description:  List of contact's labels.  Labels are used to organize contacts. Labels can be added and removed using Label Contact and Unlabel Contact, respectively.  To view or manage contact labels, use the Labels API. 
-                      - name: items  | type: Array<string> | description:  List of contact label keys.  Contact labels help categorize contacts. Label keys must exist to be added to the contact. Contact labels can be created or retrieved with Find or Create Label or List Labels. 
-                  - name: locale  | type: string | description:  Locale in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format. Typically, this is a lowercase 2-letter language code, followed by a hyphen, followed by an uppercase 2-letter country code. For example, `en-US` for U.S. English, and `de-DE` for Germany German. 
-                  - name: name  | type: ContactName | description:  Contact's first and last name. 
-                      - name: first  | type: string | description:  Contact's first name. 
-                      - name: last  | type: string | description:  Contact's last name. 
-                  - name: phones  | type: ContactPhonesWrapper | description:  Contact's phone numbers. 
-                      - name: items  | type: Array<ContactPhone> | description:  List of up to 50 phone numbers. 
-                            - name: countryCode  | type: string | description:  [ISO-3166 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code. 
-                            - name: phone  | type: string | description:  Phone number. 
-                            - name: primary  | type: boolean | description:  Indicates whether this is the contact's primary phone number. When changing `primary` to `true` for a phone, the contact's `primary` field for other phones becomes `false`. Changing the primary phone number also affects the subscription status to SMS messages that are decided based on the primary phone. 
-                            - name: tag  | type: PhoneTag | description:  Phone type.  `UNTAGGED` is shown as "Other" in the Contact List. 
-                                enum: FAX, HOME, MAIN, MOBILE, UNTAGGED, WORK
-                  - name: picture  | type: ContactPicture | description:  Contact's profile picture. 
-                      - name: image  | type: string | description:  Image. This can contain an image URL or a Wix Media image GUID. 
-          - name: metadata  | type: EventMetadata | description:  none 
-              - name: _id  | type: string | description:  Event GUID. With this GUID you can easily spot duplicated events and ignore them. 
-              - name: entityEventSequence  | type: string | description:  A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number. You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it. 
-              - name: entityFqdn  | type: string | description:  Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities. For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`. 
-              - name: entityId  | type: string | description:  GUID of the entity associated with the event. 
-              - name: eventTime  | type: Date | description:  Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`. 
-              - name: eventType  | type: string | description:  Event type. 
-              - name: identity  | type: IdentificationData | description:  The identification type and identity data. 
-                  - ONE-OF: 
-                    - name: anonymousVisitorId  | type: string | description:  GUID of a site visitor that has not logged in to the site. 
-                    - name: appId  | type: string | description:  GUID of an app. 
-                    - name: memberId  | type: string | description:  GUID of a site visitor that has logged in to the site. 
-                    - name: wixUserId  | type: string | description:  GUID of a Wix user (site owner, contributor, etc.). 
-              - name: instanceId  | type: string | description:  App instance GUID. 
-              - name: originatedFrom  | type: string | description:  If present, indicates the action that triggered the event. 
-              - name: slug  | type: string | description:  Event action name, placed at the top level to make it easier for users to dispatch messages. For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`. 
-              - name: triggeredByAnonymizeRequest  | type: boolean | description:  Whether the event was triggered as a result of a privacy regulation application (for example, GDPR). 
-Return type: PRIMITIVE<void>
-
-```
-</type_definition>
-</crm_contacts_onContactUpdated>

package/dist/docs-output/api-docs/data-items-get-doc.txt

@@ -1,105 +0,0 @@
-<data_items_get>
-<description>
-# Method name:
-
-data.items.get(dataCollectionId: string, itemId: string, options: WixDataReadWithProjectionOptions)
-
-# Method Link:
-
-https://dev.wix.com/docs/sdk/backend-modules/data/items/get
-
-# Method Description:
-
-Retrieves an item from a collection.
-
-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.
-
-If the specified collection contains reference fields, the ID of the
-referenced item is returned. To return the values of the referenced items
-use `query()` and `include()`.
-
-If the `get()` method is passed the ID of [a hidden item](https://support.wix.com/en/article/cms-controlling-live-site-item-visibility-from-your-collection), it returns null.
-
-Calling the `get()` method triggers the [`beforeGet()`](https://dev.wix.com/docs/velo/api-reference/wix-data/hooks/before-get) and [`afterGet()`](https://dev.wix.com/docs/velo/api-reference/wix-data/hooks/after-get) hooks if they have been defined.
-
-> **Notes:**
-> - When using the `query()` or `get()` methods or another data retrieval method immediately following a change to your database collection, the data retrieved may not contain your most recent changes. Learn more about [Wix Data and eventual consistency](https://dev.wix.com/docs/sdk/backend-modules/data/eventual-consistency). To solve this, you can use the `setTimeout()` method to delay retrieving data following any changes to your database collection.
-> - To speed up data retrieval, the results of certain data queries are cached. Learn more about [caching data query results](https://dev.wix.com/docs/develop-websites/articles/databases/wix-data/data-api/about-caching-data-query-results).
-> - An `itemId` is required to retrieve an item even from a [single-item collection](https://support.wix.com/en/article/cms-adding-and-setting-up-a-single-item-collection).
-
-# Method Permissions:
-
-- Read Data Items
-
-# Method Permissions Scopes IDs:
-
-- SCOPE.DC-DATA.READ
-
-
-
-# Method Code Examples:
-
-## Get an item from a collection
-
-```javascript
-import { items } from "@wix/data";
-
-async function getItem() {
- const item = await items.get("myCollection", "00001");
- console.log(item);
-}
-
-/*  item is:
-*
-*  {
-*    "_id":          "00001",
-*    "_owner":       "ffdkj9c2-df8g-f9ke-lk98-4kjhfr89keedb",
-*    "_createdDate": "2017-05-24T12:33:18.938Z",
-*    "_updatedDate": "2017-05-24T12:33:18.938Z",
-*    "title":        "Mr.",
-*    "first_name":   "John",
-*    "last_name":    "Doe"
-*  }
-*/
-```
-
-
-
-## default
-
-```javascript
-try {
-     const result = await items.get("collection-0.6451284333427125", "6892593d-d57f-428d-bc53-3f0870a1beef", {});
-     return result;
-   } catch (error) {
-     console.error(error);
-     throw error;
-  }
-```
-</description>
-<type_definition>
-```
-Method: data.items.get(dataCollectionId, itemId, options)
-Description: Retrieves an item from a collection.  The `get()` method returns a Promise that resolves to the item with GUID `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.  If the specified collection contains reference fields, the GUID of the referenced item is returned. To return the values of the referenced items use `query()` and `include()`.  If the `get()` method is passed the GUID of [a hidden item](https://support.wix.com/en/article/cms-controlling-live-site-item-visibility-from-your-collection), it returns null.  Calling the `get()` method triggers the [`beforeGet()`](https://dev.wix.com/docs/velo/api-reference/wix-data/hooks/before-get) and [`afterGet()`](https://dev.wix.com/docs/velo/api-reference/wix-data/hooks/after-get) hooks if they have been defined.  > **Notes:** > - When using the `query()` or `get()` methods or another data retrieval method immediately following a change to your database collection, the data retrieved may not contain your most recent changes. Learn more about [Wix Data and eventual consistency](https://dev.wix.com/docs/sdk/backend-modules/data/eventual-consistency). To solve this, you can use the `setTimeout()` method to delay retrieving data following any changes to your database collection. > - To speed up data retrieval, the results of certain data queries are cached. Learn more about [caching data query results](https://dev.wix.com/docs/develop-websites/articles/databases/wix-data/data-api/about-caching-data-query-results). > - An `itemId` is required to retrieve an item even from a [single-item collection](https://support.wix.com/en/article/cms-adding-and-setting-up-a-single-item-collection).
-Method parameters:
-  param name:  dataCollectionId | type: string | description:  GUID of the collection item belongs to. 
-  param name:  itemId | type: string | description:  GUID of the data item to retrieve. | required: true
-  param name:  options | type: WixDataReadWithProjectionOptions | description:  Options to use when processing this operation. 
-      - name: appOptions  | type: Record<string, any> | description:  Options for [querying Wix app collections](https://dev.wix.com/docs/develop-websites/articles/wix-apps/wix-app-collections/querying-wix-app-collections). 
-      - name: consistentRead  | type: boolean | description:  When `true`, reads data from the primary database instance. This decreases performance but ensures data retrieved is up-to-date even immediately after an update. Learn more about [Wix Data and eventual consistency](https://dev.wix.com/docs/sdk/backend-modules/data/eventual-consistency). 
-      - name: fields  | type: Array<string> | description:  Lists of fields to return in a result. 
-      - name: language  | type: string | description:  Language to translate result text into, in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format. If provided, the result text is returned in the specified language. If not provided, the result text is not translated.  > **Note:** Translation for the specified language must be enabled for the collection in [Wix Multilingual](https://www.wix.com/app-market/wix-multilingual). 
-      - name: showDrafts  | type: boolean | description:  When `true`, operations include draft items. Read operations include draft items in their response, and write operations modify draft items.  Default: `false`. 
-      - name: suppressHooks  | type: boolean | description:  Prevents hooks from running for the operation. Can only be used in the [backend code of a Wix site](https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/backend-code/about-the-site-backend).  Default: `false`. 
-Return type: PROMISE<WixDataItem>
-      - name: _createdDate  | type: Date | description:  Date and time the item was added to the collection. 
-      - name: _id  | type: string | description:  Data item GUID. 
-      - name: _owner  | type: string | description:  GUID of the user who created the item. Can be modified with site owner permissions. 
-      - name: _updatedDate  | type: Date | description:  Date and time the item was last modified. When the item is first inserted, `_createdDate` and `_updatedDate` have the same value. 
-
-```
-</type_definition>
-</data_items_get>

package/dist/docs-output/api-docs/data-items-insert-doc.txt

@@ -1,247 +0,0 @@
-<data_items_insert>
-<description>
-# Method name:
-
-data.items.insert(dataCollectionId: string, item: Partial, options: WixDataInsertOptions)
-
-# Method Link:
-
-https://dev.wix.com/docs/sdk/backend-modules/data/items/insert
-
-# Method Description:
-
-Adds an item to a collection.
-
-An item can only be inserted into an existing collection. You can create a new collection using the
-Data Collections API.
-
-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()` method triggers the [`beforeInsert()`](https://dev.wix.com/docs/velo/api-reference/wix-data/hooks/before-insert) and [`afterInsert()`](https://dev.wix.com/docs/velo/api-reference/wix-data/hooks/after-insert) hooks if they have been defined.
-
-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()` 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
- your own ID. Once an ID is assigned to an item it cannot be changed.
-- `_createdDate`: The date the item was added to the collection.
-- `_updatedDate`: The date the item was modified. When the item is first
- added, the `_createdDate` and `_updatedDate` are the same.
-
-Any valid JavaScript object can be added as a property value. The `insert()`
-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.
-
-
-> **Notes:**
-> - The maximum size of an item that you can add to a collection is 500kb.
-> - If an item's `_id` property value is set to `null` or an empty string, an error is thrown.
-> - When creating a [single-item collection](https://support.wix.com/en/article/cms-adding-and-setting-up-a-single-item-collection), an item with the system field `_id` is pre-inserted into the collection. [Single-item collections](https://support.wix.com/en/article/cms-adding-and-setting-up-a-single-item-collection) may contain only one item.
-> - If there is a pre-existing item in a [single-item collection](https://support.wix.com/en/article/cms-adding-and-setting-up-a-single-item-collection), the `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.
-
-# Method Permissions:
-
-- Write Data Items
-
-# Method Permissions Scopes IDs:
-
-- SCOPE.DC-DATA.WRITE
-
-
-
-# Method Code Examples:
-
-## Insert an item into a collection
-
-```javascript
-import { items } from "@wix/data";
-
-async function insertItem() {
- const toInsert = {
-   "title":        "Mr.",
-   "first_name":   "John",
-   "last_name":    "Doe"
- };  
- const inserted = await items.insert("myCollection", toInsert);
- console.log(inserted); // See below
-}
-
-/*  item is:
-*
-*  {
-*    "_id":          "rifk4nrk-dj4o-djhe-oidk-fnoqw4oiglk4i",
-*    "_owner":       "ffdkj9c2-df8g-f9ke-lk98-4kjhfr89keedb",
-*    "_createdDate": "2017-05-24T12:33:18.938Z",
-*    "_updatedDate": "2017-05-24T12:33:18.938Z",
-*    "title":        "Mr.",
-*    "first_name":   "John",
-*    "last_name":    "Doe"
-*  }
-*/
-```
-
-
-
-## Insert an item with a specified ID into a collection
-
-```javascript
-import { items } from "@wix/data";
-
-async function insertItem() {
- const toInsert = {
-   "_id":          "00001",
-   "title":        "Mr.",
-   "first_name":   "John",
-   "last_name":    "Doe"
- };
- 
- const inserted = await items.insert("myCollection", toInsert);
- console.log(inserted);
-}
-/*  item is:
-*
-*  {
-*    "_id":          "00001",
-*    "_owner":       "ffdkj9c2-df8g-f9ke-lk98-4kjhfr89keedb",
-*    "_createdDate": "2017-05-24T12:33:18.938Z",
-*    "_updatedDate": "2017-05-24T12:33:18.938Z",
-*    "title":        "Mr.",
-*    "first_name":   "John",
-*    "last_name":    "Doe"
-*  }
-*/
-```
-
-## Insert an item including a reference to another item using the referenced item's ID
-
-```javascript
-import { items } from "@wix/data";
-
-async function insertItem() {
- const countryId = "id-of-usa-item";
- 
- const toInsert = {
-   "title":        "Mr.",
-   "first_name":   "John",
-   "last_name":    "Doe",
-   "country":      countryId
- };
- 
- const inserted = await items.insert("myCollection", toInsert);
- console.log(inserted); // See below
-}
-
-/*  item is:
-*
-*  {
-*    "_id":          "rifk4nrk-dj4o-djhe-oidk-fnoqw4oiglk4i",
-*    "_owner":       "ffdkj9c2-df8g-f9ke-lk98-4kjhfr89keedb",
-*    "_createdDate": "2017-05-24T12:33:18.938Z",
-*    "_updatedDate": "2017-05-24T12:33:18.938Z",
-*    "title":        "Mr.",
-*    "first_name":   "John",
-*    "last_name":    "Doe",
-*    "country":      "id-of-usa-item"
-*  }
-*/
-```
-
-## Insert an item including a reference to another item using the reference item
-
-```javascript
-import { items } from "@wix/data";
-
-async function insertItem() {
- const countryItem = // Get country item
- 
- const toInsert = {
-   "title":        "Mr.",
-   "first_name":   "John",
-   "last_name":    "Doe",
-   "country":      countryItem
- };
- 
- const inserted = await items.insert("myCollection", toInsert);
- console.log(inserted); // See below
-}
-
-/*  item is:
-*
-*  {
-*    "_id":          "rifk4nrk-dj4o-djhe-oidk-fnoqw4oiglk4i",
-*    "_owner":       "ffdkj9c2-df8g-f9ke-lk98-4kjhfr89keedb",
-*    "_createdDate": "2017-05-24T12:33:18.938Z",
-*    "_updatedDate": "2017-05-24T12:33:18.938Z",
-*    "title":        "Mr.",
-*    "first_name":   "John",
-*    "last_name":    "Doe",
-*    "country":      "id-of-usa-item"
-*  }
-*/
-```
-
-## Insert an item into a collection using a custom function
-
-```javascript
-import { items } from "@wix/data";
-
-// Create an operation using insert() //
-
-function createGreeting(language, greeting) {
- const toInsert = {
-   language,
-   greeting
- };
-
- return items.insert('Greetings', toInsert);
-}
-
-```
-
-## default
-
-```javascript
-try {
-     const result = await items.insert("collection-0.28758841360566656", {
-         _id: "1ad20d72-f217-4663-b1c1-47fe7b9fcde5",
-         name: "Sample Item",
-         phone: "+972501234567",
-         image: "https://static.wixstatic.com/media/503ea4_ed9a38760ae04aab86b47e82525fdcac~mv2.jpg",
-         createdDate: Date.now(),
-         updatedDate: Date.now()
-     }, {
-         suppressHooks: false
-     });
-     return result;
-   } catch (error) {
-     console.error(error);
-     throw error;
-  }
-```
-</description>
-<type_definition>
-```
-Method: data.items.insert(dataCollectionId, item, options)
-Description: Adds an item to a collection.  An item can only be inserted into an existing collection. You can create a new collection using the Data Collections API.  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 GUID in the collection. Meaning, `insert()` cannot overwrite an existing item in the collection.  Calling the `insert()` method triggers the [`beforeInsert()`](https://dev.wix.com/docs/velo/api-reference/wix-data/hooks/before-insert) and [`afterInsert()`](https://dev.wix.com/docs/velo/api-reference/wix-data/hooks/after-insert) hooks if they have been defined.  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()` 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   your own GUID. Once an GUID is assigned to an item it cannot be changed. - `_createdDate`: The date the item was added to the collection. - `_updatedDate`: The date the item was modified. When the item is first   added, the `_createdDate` and `_updatedDate` are the same.  Any valid JavaScript object can be added as a property value. The `insert()` 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.   > **Notes:** > - The maximum size of an item that you can add to a collection is 500kb. > - If an item's `_id` property value is set to `null` or an empty string, an error is thrown. > - When creating a [single-item collection](https://support.wix.com/en/article/cms-adding-and-setting-up-a-single-item-collection), an item with the system field `_id` is pre-inserted into the collection. [Single-item collections](https://support.wix.com/en/article/cms-adding-and-setting-up-a-single-item-collection) may contain only one item. > - If there is a pre-existing item in a [single-item collection](https://support.wix.com/en/article/cms-adding-and-setting-up-a-single-item-collection), the `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.
-Method parameters:
-  param name:  dataCollectionId | type: string | description:  GUID of the collection item belongs to. | required: true
-  param name:  item | type: Partial | description:  Data item to insert. | required: true
-  param name:  options | type: WixDataInsertOptions | description:  Options to use when processing this operation. 
-Return type: PROMISE<WixDataItem>
-      - name: _createdDate  | type: Date | description:  Date and time the item was added to the collection. 
-      - name: _id  | type: string | description:  Data item GUID. 
-      - name: _owner  | type: string | description:  GUID of the user who created the item. Can be modified with site owner permissions. 
-      - name: _updatedDate  | type: Date | description:  Date and time the item was last modified. When the item is first inserted, `_createdDate` and `_updatedDate` have the same value. 
-
-```
-</type_definition>
-</data_items_insert>

package/dist/docs-output/api-docs/data-items-onDataItemCreated-doc.txt

@@ -1,61 +0,0 @@
-<data_items_onDataItemCreated>
-<description>
-# This is a Webhook method
-
-# Method name:
-
-data.items.onDataItemCreated(handler: OnDataItemCreatedHandler)
-
-# Method Link:
-
-https://dev.wix.com/docs/sdk/backend-modules/data/items/on-data-item-created
-
-# Method Description:
-
-Triggered when a data item is inserted.
-
-
-</description>
-<usage>
-import { items } from "@wix/data";
-
-   items.onDataItemCreated((event) => {
-     // handle your event here
-   });
-   
-</usage>
-<type_definition>
-```
-Method: data.items.onDataItemCreated(handler)
-Description: Triggered when a data item is inserted.
-Method parameters:
-  param name:  handler | type: OnDataItemCreatedHandler | description:  none 
-      - name: event  | type: DataItemCreatedEnvelope | description:  none 
-          - name: entity  | type: DataItemEntity | description:  none 
-              - name: _id  | type: string | description:  Data item GUID. 
-              - name: data  | type: WixDataItem | description:  Data item contents. 
-                  - name: _id  | type: string | description:  Data item GUID. 
-                  - name: _owner  | type: string | description:  GUID of the user who created the item. Can be modified with site owner permissions. 
-              - name: dataCollectionId  | type: string | description:  GUID of the collection to which this item belongs. 
-          - name: metadata  | type: EventMetadata | description:  none 
-              - name: _id  | type: string | description:  Unique event GUID. Allows clients to ignore duplicate webhooks. 
-              - name: entityEventSequence  | type: string | description:  A sequence number defining the order of updates to the underlying entity. For example, given that some entity was updated at 16:00 and than again at 16:01, it is guaranteed that the sequence number of the second update is strictly higher than the first. As the consumer, you can use this value to ensure that you handle messages in the correct order. To do so, you will need to persist this number on your end, and compare the sequence number from the message against the one you have stored. Given that the stored number is higher, you should ignore the message. 
-              - name: entityFqdn  | type: string | description:  Assumes actions are also always typed to an entity_type Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction 
-              - name: entityId  | type: string | description:  GUID of the entity associated with the event. 
-              - name: eventTime  | type: Date | description:  Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z 
-              - name: eventType  | type: string | description:  Event type. 
-              - name: identity  | type: IdentificationData | description:  The identification type and identity data. 
-                  - ONE-OF: 
-                    - name: anonymousVisitorId  | type: string | description:  GUID of a site visitor that has not logged in to the site. 
-                    - name: appId  | type: string | description:  GUID of an app. 
-                    - name: memberId  | type: string | description:  GUID of a site visitor that has logged in to the site. 
-                    - name: wixUserId  | type: string | description:  GUID of a Wix user (site owner, contributor, etc.). 
-              - name: instanceId  | type: string | description:  App instance GUID. 
-              - name: originatedFrom  | type: string | description:  If present, indicates the action that triggered the event. 
-              - name: slug  | type: string | description:  This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug) This is although the created/updated/deleted notion is duplication of the oneof types Example: created/updated/deleted/started/completed/email_opened 
-              - name: triggeredByAnonymizeRequest  | type: boolean | description:  Whether the event was triggered as a result of a privacy regulation application (for example, GDPR). 
-Return type: PRIMITIVE<void>
-
-```
-</type_definition>
-</data_items_onDataItemCreated>

package/dist/docs-output/api-docs/data-items-onDataItemDeleted-doc.txt

@@ -1,58 +0,0 @@
-<data_items_onDataItemDeleted>
-<description>
-# This is a Webhook method
-
-# Method name:
-
-data.items.onDataItemDeleted(handler: OnDataItemDeletedHandler)
-
-# Method Link:
-
-https://dev.wix.com/docs/sdk/backend-modules/data/items/on-data-item-deleted
-
-# Method Description:
-
-Triggered when a data item is deleted or truncated.
-
-
-</description>
-<usage>
-import { items } from "@wix/data";
-
-   items.onDataItemDeleted((event) => {
-     // handle your event here
-   });
-   
-</usage>
-<type_definition>
-```
-Method: data.items.onDataItemDeleted(handler)
-Description: Triggered when a data item is deleted or truncated.
-Method parameters:
-  param name:  handler | type: OnDataItemDeletedHandler | description:  none 
-      - name: event  | type: DataItemDeletedEnvelope | description:  none 
-          - name: entity  | type: DataItemDeletedEntity | description:  none 
-              - name: _id  | type: string | description:  Data item GUID. 
-              - name: dataCollectionId  | type: string | description:  GUID of the collection to which this item belongs. 
-          - name: metadata  | type: EventMetadata | description:  none 
-              - name: _id  | type: string | description:  Unique event GUID. Allows clients to ignore duplicate webhooks. 
-              - name: entityEventSequence  | type: string | description:  A sequence number defining the order of updates to the underlying entity. For example, given that some entity was updated at 16:00 and than again at 16:01, it is guaranteed that the sequence number of the second update is strictly higher than the first. As the consumer, you can use this value to ensure that you handle messages in the correct order. To do so, you will need to persist this number on your end, and compare the sequence number from the message against the one you have stored. Given that the stored number is higher, you should ignore the message. 
-              - name: entityFqdn  | type: string | description:  Assumes actions are also always typed to an entity_type Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction 
-              - name: entityId  | type: string | description:  GUID of the entity associated with the event. 
-              - name: eventTime  | type: Date | description:  Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z 
-              - name: eventType  | type: string | description:  Event type. 
-              - name: identity  | type: IdentificationData | description:  The identification type and identity data. 
-                  - ONE-OF: 
-                    - name: anonymousVisitorId  | type: string | description:  GUID of a site visitor that has not logged in to the site. 
-                    - name: appId  | type: string | description:  GUID of an app. 
-                    - name: memberId  | type: string | description:  GUID of a site visitor that has logged in to the site. 
-                    - name: wixUserId  | type: string | description:  GUID of a Wix user (site owner, contributor, etc.). 
-              - name: instanceId  | type: string | description:  App instance GUID. 
-              - name: originatedFrom  | type: string | description:  If present, indicates the action that triggered the event. 
-              - name: slug  | type: string | description:  This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug) This is although the created/updated/deleted notion is duplication of the oneof types Example: created/updated/deleted/started/completed/email_opened 
-              - name: triggeredByAnonymizeRequest  | type: boolean | description:  Whether the event was triggered as a result of a privacy regulation application (for example, GDPR). 
-Return type: PRIMITIVE<void>
-
-```
-</type_definition>
-</data_items_onDataItemDeleted>

package/dist/docs-output/api-docs/data-items-onDataItemUpdated-doc.txt

@@ -1,61 +0,0 @@
-<data_items_onDataItemUpdated>
-<description>
-# This is a Webhook method
-
-# Method name:
-
-data.items.onDataItemUpdated(handler: OnDataItemUpdatedHandler)
-
-# Method Link:
-
-https://dev.wix.com/docs/sdk/backend-modules/data/items/on-data-item-updated
-
-# Method Description:
-
-Triggered when a data item is updated or patched.
-
-
-</description>
-<usage>
-import { items } from "@wix/data";
-
-   items.onDataItemUpdated((event) => {
-     // handle your event here
-   });
-   
-</usage>
-<type_definition>
-```
-Method: data.items.onDataItemUpdated(handler)
-Description: Triggered when a data item is updated or patched.
-Method parameters:
-  param name:  handler | type: OnDataItemUpdatedHandler | description:  none 
-      - name: event  | type: DataItemUpdatedEnvelope | description:  none 
-          - name: entity  | type: DataItemEntity | description:  none 
-              - name: _id  | type: string | description:  Data item GUID. 
-              - name: data  | type: WixDataItem | description:  Data item contents. 
-                  - name: _id  | type: string | description:  Data item GUID. 
-                  - name: _owner  | type: string | description:  GUID of the user who created the item. Can be modified with site owner permissions. 
-              - name: dataCollectionId  | type: string | description:  GUID of the collection to which this item belongs. 
-          - name: metadata  | type: EventMetadata | description:  none 
-              - name: _id  | type: string | description:  Unique event GUID. Allows clients to ignore duplicate webhooks. 
-              - name: entityEventSequence  | type: string | description:  A sequence number defining the order of updates to the underlying entity. For example, given that some entity was updated at 16:00 and than again at 16:01, it is guaranteed that the sequence number of the second update is strictly higher than the first. As the consumer, you can use this value to ensure that you handle messages in the correct order. To do so, you will need to persist this number on your end, and compare the sequence number from the message against the one you have stored. Given that the stored number is higher, you should ignore the message. 
-              - name: entityFqdn  | type: string | description:  Assumes actions are also always typed to an entity_type Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction 
-              - name: entityId  | type: string | description:  GUID of the entity associated with the event. 
-              - name: eventTime  | type: Date | description:  Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z 
-              - name: eventType  | type: string | description:  Event type. 
-              - name: identity  | type: IdentificationData | description:  The identification type and identity data. 
-                  - ONE-OF: 
-                    - name: anonymousVisitorId  | type: string | description:  GUID of a site visitor that has not logged in to the site. 
-                    - name: appId  | type: string | description:  GUID of an app. 
-                    - name: memberId  | type: string | description:  GUID of a site visitor that has logged in to the site. 
-                    - name: wixUserId  | type: string | description:  GUID of a Wix user (site owner, contributor, etc.). 
-              - name: instanceId  | type: string | description:  App instance GUID. 
-              - name: originatedFrom  | type: string | description:  If present, indicates the action that triggered the event. 
-              - name: slug  | type: string | description:  This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug) This is although the created/updated/deleted notion is duplication of the oneof types Example: created/updated/deleted/started/completed/email_opened 
-              - name: triggeredByAnonymizeRequest  | type: boolean | description:  Whether the event was triggered as a result of a privacy regulation application (for example, GDPR). 
-Return type: PRIMITIVE<void>
-
-```
-</type_definition>
-</data_items_onDataItemUpdated>