@wix/crm 1.0.0 → 1.0.2

package/build/es/src/contacts-v4-contact.universal.js

@@ -0,0 +1,874 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { serializer, transformError } from '@wix/metro-runtime/velo';
+import * as ambassadorWixContactsV4Contact from './contacts-v4-contact.http';
+let __verbose = false;
+function __log(...args) {
+    __verbose && console.log(...args);
+}
+function __inspect(obj) {
+    return obj;
+}
+export const __debug = {
+    verboseLogging: {
+        on: () => (__verbose = true),
+        off: () => (__verbose = false),
+    },
+};
+const _toVeloEntity = '$';
+const _fromVeloEntity = '$';
+export var ContactSourceType;
+(function (ContactSourceType) {
+    ContactSourceType["OTHER"] = "OTHER";
+    ContactSourceType["ADMIN"] = "ADMIN";
+    ContactSourceType["WIX_APP"] = "WIX_APP";
+    ContactSourceType["IMPORT"] = "IMPORT";
+    ContactSourceType["THIRD_PARTY"] = "THIRD_PARTY";
+    ContactSourceType["WIX_BOOKINGS"] = "WIX_BOOKINGS";
+    ContactSourceType["WIX_CHAT"] = "WIX_CHAT";
+    ContactSourceType["WIX_EMAIL_MARKETING"] = "WIX_EMAIL_MARKETING";
+    ContactSourceType["WIX_EVENTS"] = "WIX_EVENTS";
+    ContactSourceType["WIX_FORMS"] = "WIX_FORMS";
+    ContactSourceType["WIX_GROUPS"] = "WIX_GROUPS";
+    ContactSourceType["WIX_HOTELS"] = "WIX_HOTELS";
+    ContactSourceType["WIX_MARKET_PLACE"] = "WIX_MARKET_PLACE";
+    ContactSourceType["WIX_MUSIC"] = "WIX_MUSIC";
+    ContactSourceType["WIX_RESTAURANTS"] = "WIX_RESTAURANTS";
+    ContactSourceType["WIX_SITE_MEMBERS"] = "WIX_SITE_MEMBERS";
+    ContactSourceType["WIX_STORES"] = "WIX_STORES";
+    ContactSourceType["WIX_CODE"] = "WIX_CODE";
+})(ContactSourceType || (ContactSourceType = {}));
+export var ContactActivityType;
+(function (ContactActivityType) {
+    /** Last visit to your site (any unknown activity) */
+    ContactActivityType["GENERAL"] = "GENERAL";
+    /** This cannot be reported, used when contact created, will throw exception */
+    ContactActivityType["CONTACT_CREATED"] = "CONTACT_CREATED";
+    /** "auth/login" */
+    ContactActivityType["MEMBER_LOGIN"] = "MEMBER_LOGIN";
+    /** "auth/register" */
+    ContactActivityType["MEMBER_REGISTER"] = "MEMBER_REGISTER";
+    /** "auth/status-change" */
+    ContactActivityType["MEMBER_STATUS_CHANGED"] = "MEMBER_STATUS_CHANGED";
+    /** "contact/contact-form", (but also "form/contact-form", "form/form") */
+    ContactActivityType["FORM_SUBMITTED"] = "FORM_SUBMITTED";
+    /** "form/lead-capture-form" */
+    ContactActivityType["INBOX_FORM_SUBMITTED"] = "INBOX_FORM_SUBMITTED";
+    /** "chat/payment-request-paid" */
+    ContactActivityType["INBOX_PAYMENT_REQUEST_PAID"] = "INBOX_PAYMENT_REQUEST_PAID";
+    /** "messaging/email" - Direction BUSINESS_TO_CUSTOMER */
+    ContactActivityType["INBOX_MESSAGE_TO_CUSTOMER"] = "INBOX_MESSAGE_TO_CUSTOMER";
+    /** "messaging/email" - Direction CUSTOMER_TO_BUSINESS */
+    ContactActivityType["INBOX_MESSAGE_FROM_CUSTOMER"] = "INBOX_MESSAGE_FROM_CUSTOMER";
+    /** "contact/subscription-form" (but also "form/subscription-form") */
+    ContactActivityType["NEWSLETTER_SUBSCRIPTION_FORM_SUBMITTED"] = "NEWSLETTER_SUBSCRIPTION_FORM_SUBMITTED";
+    /** "contact/unsubscribe" */
+    ContactActivityType["NEWSLETTER_SUBSCRIPTION_UNSUBSCRIBE"] = "NEWSLETTER_SUBSCRIPTION_UNSUBSCRIBE";
+    /** "e_commerce/purchase" */
+    ContactActivityType["ECOM_PURCHASE"] = "ECOM_PURCHASE";
+    /** "e_commerce/cart-abandon" */
+    ContactActivityType["ECOM_CART_ABANDON"] = "ECOM_CART_ABANDON";
+    /** "e_commerce/checkout-buyer" */
+    ContactActivityType["ECOM_CHECKOUT_BUYER"] = "ECOM_CHECKOUT_BUYER";
+    /** "scheduler/appointment" */
+    ContactActivityType["BOOKINGS_APPOINTMENT"] = "BOOKINGS_APPOINTMENT";
+    /** "hotels/reservation" */
+    ContactActivityType["HOTELS_RESERVATION"] = "HOTELS_RESERVATION";
+    /** "hotels/purchase" */
+    ContactActivityType["HOTELS_PURCHASE"] = "HOTELS_PURCHASE";
+    /** "hotels/confirmation" */
+    ContactActivityType["HOTELS_CONFIRMATION"] = "HOTELS_CONFIRMATION";
+    /** "hotels/cancel" */
+    ContactActivityType["HOTELS_CANCEL"] = "HOTELS_CANCEL";
+    /** "video/purchase" */
+    ContactActivityType["VIDEO_PURCHASE"] = "VIDEO_PURCHASE";
+    /** "video/rent" */
+    ContactActivityType["VIDEO_RENT"] = "VIDEO_RENT";
+    /** "cashier/button_purchase" */
+    ContactActivityType["CASHIER_BUTTON_PURCHASE"] = "CASHIER_BUTTON_PURCHASE";
+    /** "arena/new-lead" */
+    ContactActivityType["ARENA_NEW_LEAD"] = "ARENA_NEW_LEAD";
+    /** "events/rsvp" */
+    ContactActivityType["EVENTS_RSVP"] = "EVENTS_RSVP";
+    /** "invoice/pay" */
+    ContactActivityType["INVOICE_PAY"] = "INVOICE_PAY";
+    /** "invoice/overdue" */
+    ContactActivityType["INVOICE_OVERDUE"] = "INVOICE_OVERDUE";
+    /** "price-quote/accept" */
+    ContactActivityType["PRICE_QUOTE_ACCEPT"] = "PRICE_QUOTE_ACCEPT";
+    /** "price-quote/expire" */
+    ContactActivityType["PRICE_QUOTE_EXPIRE"] = "PRICE_QUOTE_EXPIRE";
+    /** "restaurants/order" */
+    ContactActivityType["RESTAURANTS_ORDER"] = "RESTAURANTS_ORDER";
+    /** "restaurants/reservation" */
+    ContactActivityType["RESTAURANTS_RESERVATION"] = "RESTAURANTS_RESERVATION";
+    /** "shoutout/open" */
+    ContactActivityType["SHOUTOUT_OPEN"] = "SHOUTOUT_OPEN";
+    /** "shoutout/click" */
+    ContactActivityType["SHOUTOUT_CLICK"] = "SHOUTOUT_CLICK";
+    ContactActivityType["CONTACT_MERGED"] = "CONTACT_MERGED";
+})(ContactActivityType || (ContactActivityType = {}));
+export var EmailTag;
+(function (EmailTag) {
+    EmailTag["UNTAGGED"] = "UNTAGGED";
+    EmailTag["MAIN"] = "MAIN";
+    EmailTag["HOME"] = "HOME";
+    EmailTag["WORK"] = "WORK";
+})(EmailTag || (EmailTag = {}));
+export var PhoneTag;
+(function (PhoneTag) {
+    PhoneTag["UNTAGGED"] = "UNTAGGED";
+    PhoneTag["MAIN"] = "MAIN";
+    PhoneTag["HOME"] = "HOME";
+    PhoneTag["MOBILE"] = "MOBILE";
+    PhoneTag["WORK"] = "WORK";
+    PhoneTag["FAX"] = "FAX";
+})(PhoneTag || (PhoneTag = {}));
+export var AddressTag;
+(function (AddressTag) {
+    AddressTag["UNTAGGED"] = "UNTAGGED";
+    AddressTag["HOME"] = "HOME";
+    AddressTag["WORK"] = "WORK";
+    AddressTag["BILLING"] = "BILLING";
+    AddressTag["SHIPPING"] = "SHIPPING";
+})(AddressTag || (AddressTag = {}));
+export var SubdivisionType;
+(function (SubdivisionType) {
+    SubdivisionType["UNKNOWN_SUBDIVISION_TYPE"] = "UNKNOWN_SUBDIVISION_TYPE";
+    /** state */
+    SubdivisionType["ADMINISTRATIVE_AREA_LEVEL_1"] = "ADMINISTRATIVE_AREA_LEVEL_1";
+    /** county */
+    SubdivisionType["ADMINISTRATIVE_AREA_LEVEL_2"] = "ADMINISTRATIVE_AREA_LEVEL_2";
+    /** cities/towns */
+    SubdivisionType["ADMINISTRATIVE_AREA_LEVEL_3"] = "ADMINISTRATIVE_AREA_LEVEL_3";
+    /** neighborhood/quarter */
+    SubdivisionType["ADMINISTRATIVE_AREA_LEVEL_4"] = "ADMINISTRATIVE_AREA_LEVEL_4";
+    /** street/block */
+    SubdivisionType["ADMINISTRATIVE_AREA_LEVEL_5"] = "ADMINISTRATIVE_AREA_LEVEL_5";
+    /** (ADMINISTRATIVE_AREA_LEVEL_0) indicates the national political entity, and is typically the highest order type returned by the Geocoder. */
+    SubdivisionType["COUNTRY"] = "COUNTRY";
+})(SubdivisionType || (SubdivisionType = {}));
+export var ImageProvider;
+(function (ImageProvider) {
+    ImageProvider["UNKNOWN"] = "UNKNOWN";
+    /** Image stored outside Wix */
+    ImageProvider["EXTERNAL"] = "EXTERNAL";
+    /** Stored in wix media platform, Must be uploaded by using `GeneratePictureUploadUrl` */
+    ImageProvider["WIX_MEDIA"] = "WIX_MEDIA";
+})(ImageProvider || (ImageProvider = {}));
+export var SortOrder;
+(function (SortOrder) {
+    SortOrder["ASC"] = "ASC";
+    SortOrder["DESC"] = "DESC";
+})(SortOrder || (SortOrder = {}));
+export var ContactFieldSet;
+(function (ContactFieldSet) {
+    /** name, primaryEmail, primaryPhone */
+    ContactFieldSet["BASIC"] = "BASIC";
+    /** name, phones, emails, addressses */
+    ContactFieldSet["COMMUNICATION_DETAILS"] = "COMMUNICATION_DETAILS";
+    /** name, primaryInfo(email, phone), extendedFields */
+    ContactFieldSet["EXTENDED"] = "EXTENDED";
+    /** Full contact object */
+    ContactFieldSet["FULL"] = "FULL";
+})(ContactFieldSet || (ContactFieldSet = {}));
+export var ContactsFacetType;
+(function (ContactsFacetType) {
+    ContactsFacetType["UNKNOWN"] = "UNKNOWN";
+    ContactsFacetType["ALL_CONTACTS"] = "ALL_CONTACTS";
+    ContactsFacetType["NOT_LABELED"] = "NOT_LABELED";
+    ContactsFacetType["LABEL"] = "LABEL";
+    ContactsFacetType["SUBSCRIPTION_STATUS"] = "SUBSCRIPTION_STATUS";
+    ContactsFacetType["MEMBERSHIP_STATUS"] = "MEMBERSHIP_STATUS";
+})(ContactsFacetType || (ContactsFacetType = {}));
+export var Action;
+(function (Action) {
+    Action["UNKNOWN"] = "UNKNOWN";
+    Action["UPDATED"] = "UPDATED";
+    Action["CREATED"] = "CREATED";
+})(Action || (Action = {}));
+export var UpsertContactResponseAction;
+(function (UpsertContactResponseAction) {
+    UpsertContactResponseAction["UNKNOWN"] = "UNKNOWN";
+    UpsertContactResponseAction["UPDATED"] = "UPDATED";
+    UpsertContactResponseAction["CREATED"] = "CREATED";
+})(UpsertContactResponseAction || (UpsertContactResponseAction = {}));
+export var GetContactResponseType;
+(function (GetContactResponseType) {
+    /** Normal contact */
+    GetContactResponseType["REGULAR"] = "REGULAR";
+    /** Contact that id was already allocated for it, but the contact not yet created. */
+    GetContactResponseType["IMPLICIT"] = "IMPLICIT";
+    /** Contact was merged into another contact */
+    GetContactResponseType["MERGED"] = "MERGED";
+})(GetContactResponseType || (GetContactResponseType = {}));
+export var SubmitOperation;
+(function (SubmitOperation) {
+    SubmitOperation["UNKNOWN"] = "UNKNOWN";
+    SubmitOperation["CREATE"] = "CREATE";
+    SubmitOperation["UPDATE"] = "UPDATE";
+})(SubmitOperation || (SubmitOperation = {}));
+export var Mode;
+(function (Mode) {
+    /** any */
+    Mode["OR"] = "OR";
+    /** all */
+    Mode["AND"] = "AND";
+})(Mode || (Mode = {}));
+const _contact = { picture: 'wix.common.Image', info: '_contactInfo' };
+const _contactAddress = { address: 'wix.common.Address' };
+const _contactAddressesWrapper = { items: '_contactAddress' };
+const _contactInfo = {
+    addresses: '_contactAddressesWrapper',
+    picture: '_contactPicture',
+};
+const _contactPicture = { image: 'wix.common.Image' };
+const _createContactRequest = { info: '_contactInfo' };
+const _createContactResponse = { contact: '_contact' };
+const _deleteContactRequest = {};
+const _deleteContactResponse = {};
+const _getContactRequest = {};
+const _getContactResponse = { contact: '_contact' };
+const _labelContactRequest = {};
+const _labelContactResponse = { contact: '_contact' };
+const _mergeContactsRequest = {};
+const _mergeContactsResponse = { contact: '_contact' };
+const _unlabelContactRequest = {};
+const _unlabelContactResponse = { contact: '_contact' };
+const _updateContactRequest = { info: '_contactInfo' };
+const _updateContactResponse = { contact: '_contact' };
+/**
+ * Creates a new contact.
+ *
+ *
+ * The `createContact()` function returns a Promise
+ * that resolves to the new contact when it is created.
+ *   > **Note:**
+ *  > This function replaces the deprecated
+ *  > `wixCrmBackend.createContact()`.
+ *  > The deprecated function will continue to work, but it will not receive updates.
+ *  > To keep any existing code compatible with future changes, see the
+ *  > [migration instructions](wix-crm-backend/createcontact#migration-instructions).
+ *
+ * The `contactInfo` parameter object must include a name, phone number, or email address.
+ *  If all 3 of these parameters are missing,
+ *  the contact won't be created.
+ *
+ * <!--
+ * > **Note:**
+ * > Only visitors with
+ * > **Manage Contacts** [permissions](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Froles-and-permissions)
+ * > can create contacts.
+ * > You can override the permissions by setting the `suppressAuth` option to `true`.
+ * -->
+ *   By default,
+ *  if the call contains an email already in use by another contact,
+ *  the new contact won't be created.
+ *  To override this behavior,
+ *  set `allowDuplicates` in the `options` object to `true`.
+ *
+ * This function is not a universal function and runs only on the backend.
+ * @param info - Contact info.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField info
+ * @param options - Create contact options.
+ * @returns Contact.
+ */
+export function createContact(info, options) {
+    var _a, _b, _c;
+    return __awaiter(this, arguments, void 0, function* () {
+        const requestTransformation = {
+            info: '$[0]',
+            allowDuplicates: '$[1].allowDuplicates',
+        };
+        const responseTransformation = '$';
+        // @ts-ignore
+        const { httpClient, sideEffects } = arguments[2];
+        const { toAmbassadorRequest } = serializer({
+            rootSchema: _createContactRequest,
+            depSchemas: {
+                _contactAddress,
+                _contactAddressesWrapper,
+                _contactInfo,
+                _contactPicture,
+            },
+            fqdnTransformation: {
+                paths: [],
+                transformation: _fromVeloEntity,
+            },
+            customTransformation: requestTransformation,
+        });
+        const { fromJSON } = serializer({
+            rootSchema: _createContactResponse,
+            depSchemas: {
+                _contact,
+                _contactAddress,
+                _contactAddressesWrapper,
+                _contactInfo,
+                _contactPicture,
+            },
+            fqdnTransformation: {
+                paths: [...['contact']],
+                transformation: _toVeloEntity,
+            },
+            customTransformation: responseTransformation,
+        });
+        const payload = toAmbassadorRequest([info, options]);
+        const reqOpts = ambassadorWixContactsV4Contact.createContact(payload);
+        __log(`"CreateContact" sending request with: ${__inspect(reqOpts)}`);
+        (_a = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSiteCall) === null || _a === void 0 ? void 0 : _a.call(sideEffects);
+        try {
+            const result = yield httpClient.request(reqOpts);
+            (_b = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSuccess) === null || _b === void 0 ? void 0 : _b.call(sideEffects, result);
+            return fromJSON(result.data);
+        }
+        catch (err) {
+            const transformedError = transformError(err, requestTransformation, [
+                'info',
+                'options',
+            ]);
+            (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
+            throw transformedError;
+        }
+    });
+}
+/**
+ * Updates a contact's properties.
+ *
+ * The `updateContact()` function returns a Promise that resolves
+ * when the specified contact's information is updated.
+ *
+ *  > **Note:**
+ * > This function replaces the deprecated
+ * > `wixCrmBackend.updateContact()`.
+ * > The deprecated function will continue to work, but it will not receive updates.
+ * > To keep any existing code compatible with future changes, see the
+ * > [migration instructions](wix-crm-backend/updatecontact#migration-instructions).
+ *
+ *  Each time the contact is updated,
+ * `revision` increments by 1.
+ * The existing `revision` must be included when updating the contact.
+ * This ensures you're working with the latest contact information,
+ * and it prevents unintended overwrites.
+ *
+ * <!--
+ *  > **Note:**
+ * > Only visitors with
+ * > **Manage Contacts** [permissions](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Froles-and-permissions)
+ * > can update contacts.
+ * > You can override the permissions by setting the `suppressAuth` option to `true`.
+ * -->
+ *
+ * This function is not a universal function and runs only on the backend.
+ * @param contactId - ID of the contact to update.
+ * @param info - Contact info.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField contactId
+ * @requiredField info
+ * @requiredField options
+ * @requiredField options.revision
+ * @param options - Contact update options.
+ * @returns Updated contact.
+ */
+export function updateContact(contactId, info, options) {
+    var _a, _b, _c;
+    return __awaiter(this, arguments, void 0, function* () {
+        const requestTransformation = {
+            contactId: '$[0]',
+            info: '$[1]',
+            revision: '$[2].revision',
+            allowDuplicates: '$[2].allowDuplicates',
+        };
+        const responseTransformation = '$';
+        // @ts-ignore
+        const { httpClient, sideEffects } = arguments[3];
+        const { toAmbassadorRequest } = serializer({
+            rootSchema: _updateContactRequest,
+            depSchemas: {
+                _contactAddress,
+                _contactAddressesWrapper,
+                _contactInfo,
+                _contactPicture,
+            },
+            fqdnTransformation: {
+                paths: [],
+                transformation: _fromVeloEntity,
+            },
+            customTransformation: requestTransformation,
+        });
+        const { fromJSON } = serializer({
+            rootSchema: _updateContactResponse,
+            depSchemas: {
+                _contact,
+                _contactAddress,
+                _contactAddressesWrapper,
+                _contactInfo,
+                _contactPicture,
+            },
+            fqdnTransformation: {
+                paths: [...['contact']],
+                transformation: _toVeloEntity,
+            },
+            customTransformation: responseTransformation,
+        });
+        const payload = toAmbassadorRequest([contactId, info, options]);
+        const reqOpts = ambassadorWixContactsV4Contact.updateContact(payload);
+        __log(`"UpdateContact" sending request with: ${__inspect(reqOpts)}`);
+        (_a = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSiteCall) === null || _a === void 0 ? void 0 : _a.call(sideEffects);
+        try {
+            const result = yield httpClient.request(reqOpts);
+            (_b = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSuccess) === null || _b === void 0 ? void 0 : _b.call(sideEffects, result);
+            return fromJSON(result.data);
+        }
+        catch (err) {
+            const transformedError = transformError(err, requestTransformation, [
+                'contactId',
+                'info',
+                'options',
+            ]);
+            (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
+            throw transformedError;
+        }
+    });
+}
+/**
+ * Merges source contacts into a target contact.
+ *
+ * Merging contacts has these effects on the target contact:
+ *
+ * - No target contact data is overwritten or deleted.
+ * - Arrays (emails, phones, addresses, and labels) are merged from the source contacts.
+ * - If merging more than one source contact, the 1st source is given precedence, then the 2nd, and so on.
+ *
+ * <blockquote class="important">
+ *
+ * __Important:__
+ * Merges cannot be undone.
+ * Use [Preview Merge Contacts](#preview-merge-contacts)
+ * to test before merging.
+ *
+ * </blockquote>
+ *
+ * Source contacts are deleted when merging.
+ * However, if a source contact is a site member or contributor,
+ * the merge fails because site contributors and members can't be deleted.
+ * Site members and contributors can be target contacts only.
+ *
+ * After merging,
+ * if you call [Get Contact](#get-contact) with a deleted source contact ID,
+ * the target contact ID is returned.
+ * This is supported when calling Get Contact only.
+ * Deleted source contact IDs are not supported on any other endpoint.
+ *
+ * Merging contacts triggers these webhooks:
+ *
+ * - [Contact Merged](https://dev.wix.com/api/rest/contacts/contacts/contacts-v4/contact-merged-webhook) is triggered.
+ * - [Contact Updated](https://dev.wix.com/api/rest/contacts/contacts/contacts-v4/contact-updated-webhook) is triggered for the target contact. `originatedFrom` is set to `merge`.
+ * - [Contact Deleted](https://dev.wix.com/api/rest/contacts/contacts/contacts-v4/contact-deleted-webhook) is triggered for each source contact. `originatedFrom` is set to `merge`.
+ *
+ * This function is not a universal function and runs only on the backend.
+ * @param targetContactId - Target contact ID.
+ * @param targetContactRevision - Target contact revision number, which increments by 1 each time the contact is updated.
+ * To prevent conflicting changes,
+ * the target contact's current revision must be passed.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField targetContactId
+ * @requiredField targetContactRevision
+ * @param options - Merge contacts options.
+ */
+export function mergeContacts(targetContactId, targetContactRevision, options) {
+    var _a, _b, _c;
+    return __awaiter(this, arguments, void 0, function* () {
+        const requestTransformation = {
+            targetContactId: '$[0]',
+            targetContactRevision: '$[1]',
+            sourceContactIds: '$[2].sourceContactIds',
+        };
+        const responseTransformation = '$';
+        // @ts-ignore
+        const { httpClient, sideEffects } = arguments[3];
+        const { toAmbassadorRequest } = serializer({
+            rootSchema: _mergeContactsRequest,
+            depSchemas: {},
+            fqdnTransformation: {
+                paths: [],
+                transformation: _fromVeloEntity,
+            },
+            customTransformation: requestTransformation,
+        });
+        const { fromJSON } = serializer({
+            rootSchema: _mergeContactsResponse,
+            depSchemas: {
+                _contact,
+                _contactAddress,
+                _contactAddressesWrapper,
+                _contactInfo,
+                _contactPicture,
+            },
+            fqdnTransformation: {
+                paths: [...['contact']],
+                transformation: _toVeloEntity,
+            },
+            customTransformation: responseTransformation,
+        });
+        const payload = toAmbassadorRequest([
+            targetContactId,
+            targetContactRevision,
+            options,
+        ]);
+        const reqOpts = ambassadorWixContactsV4Contact.mergeContacts(payload);
+        __log(`"MergeContacts" sending request with: ${__inspect(reqOpts)}`);
+        (_a = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSiteCall) === null || _a === void 0 ? void 0 : _a.call(sideEffects);
+        try {
+            const result = yield httpClient.request(reqOpts);
+            (_b = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSuccess) === null || _b === void 0 ? void 0 : _b.call(sideEffects, result);
+            return fromJSON(result.data);
+        }
+        catch (err) {
+            const transformedError = transformError(err, requestTransformation, [
+                'targetContactId',
+                'targetContactRevision',
+                'options',
+            ]);
+            (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
+            throw transformedError;
+        }
+    });
+}
+/**
+ * Deletes a contact who is not a site member or contributor.
+ *
+ * The `deleteContact()` function returns a Promise
+ * that resolves when the specified contact is deleted.
+ *  > **Note:**
+ * > This function replaces the deprecated
+ * > `wixCrmBackend.deleteContact()`.
+ * > The deprecated function will continue to work, but it will not receive updates.
+ * > To keep any existing code compatible with future changes, see the
+ * > [migration instructions](wix-crm-backend/deletecontact#migration-instructions).
+ *
+ *  Deleting a contact permanently removes them from your Contact List.
+ *
+ *  If the contact is also a site member,
+ * the member must be deleted first,
+ * and then the contact can be deleted.
+ *
+ * <!--
+ *  > **Note:**
+ * > Only visitors with
+ * > **Manage Contacts** [permissions](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Froles-and-permissions)
+ * > can delete contacts.
+ * > You can override the permissions by setting the `suppressAuth` option to `true`.
+ * -->
+ *
+ * This function is not a universal function and runs only on the backend.
+ * @param contactId - ID of the contact to delete.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField contactId
+ */
+export function deleteContact(contactId) {
+    var _a, _b, _c;
+    return __awaiter(this, arguments, void 0, function* () {
+        const requestTransformation = { contactId: '$[0]' };
+        const responseTransformation = '$';
+        // @ts-ignore
+        const { httpClient, sideEffects } = arguments[1];
+        const { toAmbassadorRequest } = serializer({
+            rootSchema: _deleteContactRequest,
+            depSchemas: {},
+            fqdnTransformation: {
+                paths: [],
+                transformation: _fromVeloEntity,
+            },
+            customTransformation: requestTransformation,
+        });
+        const { fromJSON } = serializer({
+            rootSchema: _deleteContactResponse,
+            depSchemas: {},
+            fqdnTransformation: {
+                paths: [],
+                transformation: _toVeloEntity,
+            },
+            customTransformation: responseTransformation,
+        });
+        const payload = toAmbassadorRequest([contactId]);
+        const reqOpts = ambassadorWixContactsV4Contact.deleteContact(payload);
+        __log(`"DeleteContact" sending request with: ${__inspect(reqOpts)}`);
+        (_a = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSiteCall) === null || _a === void 0 ? void 0 : _a.call(sideEffects);
+        try {
+            const result = yield httpClient.request(reqOpts);
+            (_b = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSuccess) === null || _b === void 0 ? void 0 : _b.call(sideEffects, result);
+            return fromJSON(result.data);
+        }
+        catch (err) {
+            const transformedError = transformError(err, requestTransformation, [
+                'contactId',
+            ]);
+            (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
+            throw transformedError;
+        }
+    });
+}
+/**
+ * Adds labels to a contact.
+ *
+ *
+ * The `labelContact()` function returns a Promise
+ * that resolves when the specified labels are added to the contact.
+ *  - **To create new labels:** Use [`findOrCreateLabel()`](wix-crm-backend/contacts/findorcreatelabel).
+ * - **To find labels:** Use [`findOrCreateLabel()`](wix-crm-backend/contacts/findorcreatelabel), [`getLabel()`](wix-crm-backend/contacts/getlabel), or [`queryLabels()`](wix-crm-backend/contacts/queryLabels).
+ *
+ * <!--
+ *  > **Note:**
+ * > Only visitors with
+ * > **Manage Contacts** [permissions](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Froles-and-permissions)
+ * > can label contacts.
+ * > You can override the permissions by setting the `suppressAuth` option to `true`.
+ * -->
+ *
+ * This function is not a universal function and runs only on the backend.
+ * @param contactId - ID of the contact to add labels to.
+ * @param labelKeys - List of label keys to add to the contact.
+ *
+ * Label keys must exist to be added to the contact.
+ *  Contact labels can be created or retrieved with
+ *  [`findOrCreateLabel()`](wix-crm-backend/contacts/findorcreatelabel)
+ *  or
+ *  [`queryLabels()`](wix-crm-backend/contacts/queryLabels).
+ * @public
+ * @documentationMaturity preview
+ * @requiredField contactId
+ * @requiredField labelKeys
+ * @returns Updated contact.
+ */
+export function labelContact(contactId, labelKeys) {
+    var _a, _b, _c;
+    return __awaiter(this, arguments, void 0, function* () {
+        const requestTransformation = { contactId: '$[0]', labelKeys: '$[1]' };
+        const responseTransformation = '$';
+        // @ts-ignore
+        const { httpClient, sideEffects } = arguments[2];
+        const { toAmbassadorRequest } = serializer({
+            rootSchema: _labelContactRequest,
+            depSchemas: {},
+            fqdnTransformation: {
+                paths: [],
+                transformation: _fromVeloEntity,
+            },
+            customTransformation: requestTransformation,
+        });
+        const { fromJSON } = serializer({
+            rootSchema: _labelContactResponse,
+            depSchemas: {
+                _contact,
+                _contactAddress,
+                _contactAddressesWrapper,
+                _contactInfo,
+                _contactPicture,
+            },
+            fqdnTransformation: {
+                paths: [...['contact']],
+                transformation: _toVeloEntity,
+            },
+            customTransformation: responseTransformation,
+        });
+        const payload = toAmbassadorRequest([contactId, labelKeys]);
+        const reqOpts = ambassadorWixContactsV4Contact.labelContact(payload);
+        __log(`"LabelContact" sending request with: ${__inspect(reqOpts)}`);
+        (_a = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSiteCall) === null || _a === void 0 ? void 0 : _a.call(sideEffects);
+        try {
+            const result = yield httpClient.request(reqOpts);
+            (_b = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSuccess) === null || _b === void 0 ? void 0 : _b.call(sideEffects, result);
+            return fromJSON(result.data);
+        }
+        catch (err) {
+            const transformedError = transformError(err, requestTransformation, [
+                'contactId',
+                'labelKeys',
+            ]);
+            (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
+            throw transformedError;
+        }
+    });
+}
+/**
+ * Removes labels from a contact.
+ *
+ *  The `unlabelContact()` function returns a Promise
+ *  that resolves when the specified labels are removed from the contact.
+ *
+ *   If a label is no longer needed
+ *  and you want to remove it from all contacts,
+ *  you can delete it with
+ *  [`deleteLabel()`](wix-crm-backend/contacts/deletelabel).
+ *
+ * <!--
+ *   > **Note:**
+ *  > Only visitors with
+ *  > **Manage Contacts** [permissions](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Froles-and-permissions)
+ *  > can unlabel contacts.
+ *  > You can override the permissions by setting the `suppressAuth` option to `true`.
+ * -->
+ *
+ * This function is not a universal function and runs only on the backend.
+ * @param contactId - ID of the contact to remove labels from.
+ * @param labelKeys - List of label keys to remove from the contact.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField contactId
+ * @requiredField labelKeys
+ * @returns Updated contact.
+ */
+export function unlabelContact(contactId, labelKeys) {
+    var _a, _b, _c;
+    return __awaiter(this, arguments, void 0, function* () {
+        const requestTransformation = { contactId: '$[0]', labelKeys: '$[1]' };
+        const responseTransformation = '$';
+        // @ts-ignore
+        const { httpClient, sideEffects } = arguments[2];
+        const { toAmbassadorRequest } = serializer({
+            rootSchema: _unlabelContactRequest,
+            depSchemas: {},
+            fqdnTransformation: {
+                paths: [],
+                transformation: _fromVeloEntity,
+            },
+            customTransformation: requestTransformation,
+        });
+        const { fromJSON } = serializer({
+            rootSchema: _unlabelContactResponse,
+            depSchemas: {
+                _contact,
+                _contactAddress,
+                _contactAddressesWrapper,
+                _contactInfo,
+                _contactPicture,
+            },
+            fqdnTransformation: {
+                paths: [...['contact']],
+                transformation: _toVeloEntity,
+            },
+            customTransformation: responseTransformation,
+        });
+        const payload = toAmbassadorRequest([contactId, labelKeys]);
+        const reqOpts = ambassadorWixContactsV4Contact.unlabelContact(payload);
+        __log(`"UnlabelContact" sending request with: ${__inspect(reqOpts)}`);
+        (_a = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSiteCall) === null || _a === void 0 ? void 0 : _a.call(sideEffects);
+        try {
+            const result = yield httpClient.request(reqOpts);
+            (_b = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSuccess) === null || _b === void 0 ? void 0 : _b.call(sideEffects, result);
+            return fromJSON(result.data);
+        }
+        catch (err) {
+            const transformedError = transformError(err, requestTransformation, [
+                'contactId',
+                'labelKeys',
+            ]);
+            (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
+            throw transformedError;
+        }
+    });
+}
+/**
+ * Retrieves a contact.
+ *
+ *
+ * The `getContact()` function returns a Promise
+ * that resolves when the contact is found.
+ * #### Getting Merged Contacts
+ * When a source contact is merged
+ * with a target contact, the source contact is deleted.
+ * When calling `getContact()` for a merged contact,
+ * you can use the source or target contact ID.
+ * In both cases, the target contact is returned.
+ *
+ * This is supported only when calling `getContact()`,
+ * and only for merged contacts.
+ * Deleted source contact IDs are not supported on any other function.
+ * > **Notes:**
+ * >
+ * > - This function replaces the deprecated
+ * >   `wixCrmBackend.getContactById()`.
+ * >   The deprecated function will continue to work, but it will not receive updates.
+ * >   To keep any existing code compatible with future changes, see the
+ * >   [migration instructions](wix-crm-backend/getcontactbyid#migration-instructions).
+ * <!-- > - Only visitors with
+ * >   **Manage Contacts** [permissions](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Froles-and-permissions)
+ * >   can retrieve contacts.
+ * >   You can override the permissions by setting the `suppressAuth` option to `true`.
+ * -->
+ *
+ * This function is not a universal function and runs only on the backend.
+ * @param _id - ID of the contact to retrieve.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField _id
+ * @param options - Get contact options.
+ * @returns The requested contact.
+ */
+export function getContact(_id, options) {
+    var _a, _b, _c;
+    return __awaiter(this, arguments, void 0, function* () {
+        const requestTransformation = {
+            id: '$[0]',
+            fields: '$[1].fields',
+            fieldsets: '$[1].fieldsets',
+        };
+        const responseTransformation = '$.contact';
+        // @ts-ignore
+        const { httpClient, sideEffects } = arguments[2];
+        const { toAmbassadorRequest } = serializer({
+            rootSchema: _getContactRequest,
+            depSchemas: {},
+            fqdnTransformation: {
+                paths: [],
+                transformation: _fromVeloEntity,
+            },
+            customTransformation: requestTransformation,
+        });
+        const { fromJSON } = serializer({
+            rootSchema: _getContactResponse,
+            depSchemas: {
+                _contact,
+                _contactAddress,
+                _contactAddressesWrapper,
+                _contactInfo,
+                _contactPicture,
+            },
+            fqdnTransformation: {
+                paths: [...['contact']],
+                transformation: _toVeloEntity,
+            },
+            customTransformation: responseTransformation,
+        });
+        const payload = toAmbassadorRequest([_id, options]);
+        const reqOpts = ambassadorWixContactsV4Contact.getContact(payload);
+        __log(`"GetContact" sending request with: ${__inspect(reqOpts)}`);
+        (_a = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSiteCall) === null || _a === void 0 ? void 0 : _a.call(sideEffects);
+        try {
+            const result = yield httpClient.request(reqOpts);
+            (_b = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSuccess) === null || _b === void 0 ? void 0 : _b.call(sideEffects, result);
+            return fromJSON(result.data);
+        }
+        catch (err) {
+            const transformedError = transformError(err, requestTransformation, [
+                '_id',
+                'options',
+            ]);
+            (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
+            throw transformedError;
+        }
+    });
+}
+//# sourceMappingURL=contacts-v4-contact.universal.js.map