@wix/auto_sdk_crm_contacts 1.0.0

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

@@ -0,0 +1,849 @@
+import { transformError as sdkTransformError } from '@wix/sdk-runtime/transform-error';
+import { queryBuilder } from '@wix/sdk-runtime/query-builder';
+import { renameKeysFromSDKRequestToRESTRequest, renameKeysFromRESTResponseToSDKResponse, } from '@wix/sdk-runtime/rename-all-nested-keys';
+import * as ambassadorWixContactsV4Contact from './contacts-v4-contact-contacts.http.js';
+// @ts-ignore
+import { transformSDKAddressToRESTAddress } from '@wix/sdk-runtime/transformations/address';
+import { transformRESTAddressToSDKAddress } from '@wix/sdk-runtime/transformations/address';
+import { transformSDKImageToRESTImage } from '@wix/sdk-runtime/transformations/image';
+import { transformRESTImageToSDKImage } from '@wix/sdk-runtime/transformations/image';
+import { transformPaths } from '@wix/sdk-runtime/transformations/transform-paths';
+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["HOPP"] = "HOPP";
+})(ContactSourceType || (ContactSourceType = {}));
+export var ContactActivityType;
+(function (ContactActivityType) {
+    /** Visited the site. */
+    ContactActivityType["GENERAL"] = "GENERAL";
+    /** Became a new contact. */
+    ContactActivityType["CONTACT_CREATED"] = "CONTACT_CREATED";
+    /** Logged in. */
+    ContactActivityType["MEMBER_LOGIN"] = "MEMBER_LOGIN";
+    /** Requested a site membership. */
+    ContactActivityType["MEMBER_REGISTER"] = "MEMBER_REGISTER";
+    /** Was approved, blocked, or unblocked. */
+    ContactActivityType["MEMBER_STATUS_CHANGED"] = "MEMBER_STATUS_CHANGED";
+    /** Submitted a form. */
+    ContactActivityType["FORM_SUBMITTED"] = "FORM_SUBMITTED";
+    /** Started a chat. */
+    ContactActivityType["INBOX_FORM_SUBMITTED"] = "INBOX_FORM_SUBMITTED";
+    /** Paid a payment request. */
+    ContactActivityType["INBOX_PAYMENT_REQUEST_PAID"] = "INBOX_PAYMENT_REQUEST_PAID";
+    /** Received a message from the site. */
+    ContactActivityType["INBOX_MESSAGE_TO_CUSTOMER"] = "INBOX_MESSAGE_TO_CUSTOMER";
+    /** Sent a new message to the site. */
+    ContactActivityType["INBOX_MESSAGE_FROM_CUSTOMER"] = "INBOX_MESSAGE_FROM_CUSTOMER";
+    /** Subscribed to a site newsletter through a form. */
+    ContactActivityType["NEWSLETTER_SUBSCRIPTION_FORM_SUBMITTED"] = "NEWSLETTER_SUBSCRIPTION_FORM_SUBMITTED";
+    /** Unsubscribed from a site newsletter. */
+    ContactActivityType["NEWSLETTER_SUBSCRIPTION_UNSUBSCRIBE"] = "NEWSLETTER_SUBSCRIPTION_UNSUBSCRIBE";
+    /** Made a purchase. */
+    ContactActivityType["ECOM_PURCHASE"] = "ECOM_PURCHASE";
+    /** Abandoned a shopping cart. */
+    ContactActivityType["ECOM_CART_ABANDON"] = "ECOM_CART_ABANDON";
+    /** Checked out shopping cart and submitted buyer info (but didn’t complete the purchase yet). */
+    ContactActivityType["ECOM_CHECKOUT_BUYER"] = "ECOM_CHECKOUT_BUYER";
+    /** Booked an appointment. */
+    ContactActivityType["BOOKINGS_APPOINTMENT"] = "BOOKINGS_APPOINTMENT";
+    /** Made a Wix Hotels reservation. */
+    ContactActivityType["HOTELS_RESERVATION"] = "HOTELS_RESERVATION";
+    /** Paid for a Wix Hotels reservation. */
+    ContactActivityType["HOTELS_PURCHASE"] = "HOTELS_PURCHASE";
+    /** Confirmed a Wix Hotels reservation. */
+    ContactActivityType["HOTELS_CONFIRMATION"] = "HOTELS_CONFIRMATION";
+    /** Canceled a Wix Hotels reservation. */
+    ContactActivityType["HOTELS_CANCEL"] = "HOTELS_CANCEL";
+    /** Purchased a video. */
+    ContactActivityType["VIDEO_PURCHASE"] = "VIDEO_PURCHASE";
+    /** Rented a video. */
+    ContactActivityType["VIDEO_RENT"] = "VIDEO_RENT";
+    /** Made a purchase with a pay button. */
+    ContactActivityType["CASHIER_BUTTON_PURCHASE"] = "CASHIER_BUTTON_PURCHASE";
+    /** Became a new Wix Marketplace lead. */
+    ContactActivityType["ARENA_NEW_LEAD"] = "ARENA_NEW_LEAD";
+    /** RSVP'd to an event. */
+    ContactActivityType["EVENTS_RSVP"] = "EVENTS_RSVP";
+    /** Paid an invoice. */
+    ContactActivityType["INVOICE_PAY"] = "INVOICE_PAY";
+    /** An invoice is now overdue. */
+    ContactActivityType["INVOICE_OVERDUE"] = "INVOICE_OVERDUE";
+    /** Accepted a price quote. */
+    ContactActivityType["PRICE_QUOTE_ACCEPT"] = "PRICE_QUOTE_ACCEPT";
+    /** A price quote has expired. */
+    ContactActivityType["PRICE_QUOTE_EXPIRE"] = "PRICE_QUOTE_EXPIRE";
+    /** Ordered food with Wix Restaurants. */
+    ContactActivityType["RESTAURANTS_ORDER"] = "RESTAURANTS_ORDER";
+    /** Made a Wix Restaurants reservation. */
+    ContactActivityType["RESTAURANTS_RESERVATION"] = "RESTAURANTS_RESERVATION";
+    /** Opened an email from the site. */
+    ContactActivityType["SHOUTOUT_OPEN"] = "SHOUTOUT_OPEN";
+    /** Clicked a link in an email from the site. */
+    ContactActivityType["SHOUTOUT_CLICK"] = "SHOUTOUT_CLICK";
+    /** Merged with another contact. */
+    ContactActivityType["CONTACT_MERGED"] = "CONTACT_MERGED";
+    /** Subscribed to a site newsletter. */
+    ContactActivityType["NEWSLETTER_SUBSCRIPTION_SUBSCRIBE"] = "NEWSLETTER_SUBSCRIPTION_SUBSCRIBE";
+    /** Subscription status to site newsletters is pending confirmation. */
+    ContactActivityType["NEWSLETTER_SUBSCRIPTION_PENDING"] = "NEWSLETTER_SUBSCRIPTION_PENDING";
+    /** Subscription status to site newsletters is not set. */
+    ContactActivityType["NEWSLETTER_SUBSCRIPTION_NOT_SET"] = "NEWSLETTER_SUBSCRIPTION_NOT_SET";
+    /** Subscribed to phone notifications. */
+    ContactActivityType["PHONE_SUBSCRIPTION_SUBSCRIBE"] = "PHONE_SUBSCRIPTION_SUBSCRIBE";
+    /** Subscription to phone notificatons is pending confirmation. */
+    ContactActivityType["PHONE_SUBSCRIPTION_PENDING"] = "PHONE_SUBSCRIPTION_PENDING";
+    /** Subscription to phone notificatons is not set. */
+    ContactActivityType["PHONE_SUBSCRIPTION_NOT_SET"] = "PHONE_SUBSCRIPTION_NOT_SET";
+    /** Subscribed to phone notifications. */
+    ContactActivityType["PHONE_SUBSCRIPTION_UNSUBSCRIBE"] = "PHONE_SUBSCRIPTION_UNSUBSCRIBE";
+})(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";
+    /** City/town */
+    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 SubscriptionStatus;
+(function (SubscriptionStatus) {
+    SubscriptionStatus["NO_SUBSCRIPTION_STATUS"] = "NO_SUBSCRIPTION_STATUS";
+    SubscriptionStatus["NOT_SET"] = "NOT_SET";
+    SubscriptionStatus["PENDING"] = "PENDING";
+    SubscriptionStatus["SUBSCRIBED"] = "SUBSCRIBED";
+    SubscriptionStatus["UNSUBSCRIBED"] = "UNSUBSCRIBED";
+})(SubscriptionStatus || (SubscriptionStatus = {}));
+export var EmailDeliverabilityStatus;
+(function (EmailDeliverabilityStatus) {
+    EmailDeliverabilityStatus["NOT_SET"] = "NOT_SET";
+    EmailDeliverabilityStatus["VALID"] = "VALID";
+    EmailDeliverabilityStatus["BOUNCED"] = "BOUNCED";
+    EmailDeliverabilityStatus["SPAM_COMPLAINT"] = "SPAM_COMPLAINT";
+    EmailDeliverabilityStatus["INACTIVE"] = "INACTIVE";
+})(EmailDeliverabilityStatus || (EmailDeliverabilityStatus = {}));
+export var PhoneDeliverabilityStatus;
+(function (PhoneDeliverabilityStatus) {
+    PhoneDeliverabilityStatus["NO_PHONE_DELIVERABILITY_STATUS"] = "NO_PHONE_DELIVERABILITY_STATUS";
+    PhoneDeliverabilityStatus["NOT_SET"] = "NOT_SET";
+})(PhoneDeliverabilityStatus || (PhoneDeliverabilityStatus = {}));
+export var MemberStatus;
+(function (MemberStatus) {
+    MemberStatus["PENDING"] = "PENDING";
+    MemberStatus["ACTIVE"] = "ACTIVE";
+    MemberStatus["DELETED"] = "DELETED";
+    MemberStatus["BLOCKED"] = "BLOCKED";
+    MemberStatus["OFFLINE"] = "OFFLINE";
+})(MemberStatus || (MemberStatus = {}));
+export var PrivacyStatus;
+(function (PrivacyStatus) {
+    PrivacyStatus["PRIVATE"] = "PRIVATE";
+    PrivacyStatus["PUBLIC"] = "PUBLIC";
+})(PrivacyStatus || (PrivacyStatus = {}));
+export var Role;
+(function (Role) {
+    Role["UNSPECIFIED_ROLE"] = "UNSPECIFIED_ROLE";
+    Role["OWNER"] = "OWNER";
+    Role["CONTRIBUTOR"] = "CONTRIBUTOR";
+})(Role || (Role = {}));
+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, addresses */
+    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) {
+    /** The specified contact was returned. */
+    GetContactResponseType["REGULAR"] = "REGULAR";
+    /** Not used. */
+    GetContactResponseType["IMPLICIT"] = "IMPLICIT";
+    /** The specified contact was previously merged with another contact and the new contact was returned. */
+    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 = {}));
+export var WebhookIdentityType;
+(function (WebhookIdentityType) {
+    WebhookIdentityType["UNKNOWN"] = "UNKNOWN";
+    WebhookIdentityType["ANONYMOUS_VISITOR"] = "ANONYMOUS_VISITOR";
+    WebhookIdentityType["MEMBER"] = "MEMBER";
+    WebhookIdentityType["WIX_USER"] = "WIX_USER";
+    WebhookIdentityType["APP"] = "APP";
+})(WebhookIdentityType || (WebhookIdentityType = {}));
+/**
+ * Creates a new contact.
+ *
+ * The `info` object must include at least one of the following:
+ * - Name
+ * - Phone number
+ * - Email address
+ *
+ * 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` to `true`.
+ * @param info - Contact info.
+ * @public
+ * @requiredField info
+ * @param options - Create contact options.
+ * @permissionId CONTACTS.MODIFY
+ * @permissionScope Manage Contacts
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-CONTACTS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
+ * @applicableIdentity APP
+ * @returns Contact.
+ * @fqn com.wixpress.contacts.core.api.v4.ContactsServiceV4.CreateContact
+ */
+export async function createContact(info, options) {
+    // @ts-ignore
+    const { httpClient, sideEffects } = arguments[2];
+    const payload = transformPaths(renameKeysFromSDKRequestToRESTRequest({
+        info: info,
+        allowDuplicates: options?.allowDuplicates,
+    }), [
+        {
+            transformFn: transformSDKAddressToRESTAddress,
+            paths: [{ path: 'info.addresses.items.address' }],
+        },
+        {
+            transformFn: transformSDKImageToRESTImage,
+            paths: [{ path: 'info.picture.image' }],
+        },
+    ]);
+    const reqOpts = ambassadorWixContactsV4Contact.createContact(payload);
+    sideEffects?.onSiteCall?.();
+    try {
+        const result = await httpClient.request(reqOpts);
+        sideEffects?.onSuccess?.(result);
+        return renameKeysFromRESTResponseToSDKResponse(transformPaths(result.data, [
+            {
+                transformFn: transformRESTImageToSDKImage,
+                paths: [
+                    { path: 'contact.picture' },
+                    { path: 'contact.info.picture.image' },
+                    { path: 'contact.memberInfo.profileInfo.photo' },
+                ],
+            },
+            {
+                transformFn: transformRESTAddressToSDKAddress,
+                paths: [{ path: 'contact.info.addresses.items.address' }],
+            },
+        ]));
+    }
+    catch (err) {
+        const transformedError = sdkTransformError(err, {
+            spreadPathsToArguments: {},
+            explicitPathsToArguments: {
+                info: '$[0]',
+                allowDuplicates: '$[1].allowDuplicates',
+            },
+            singleArgumentUnchanged: false,
+        }, ['info', 'options']);
+        sideEffects?.onError?.(err);
+        throw transformedError;
+    }
+}
+/**
+ * Updates a contact.
+ *
+ * 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.
+ *
+ * You can't call Update Contact to update the `primaryEmail` of a contact who is also a member.
+ * Instead, use the Members API to update the member's login email, which will also update the contact's primary email.
+ *
+ * Members are typically linked to contacts, and while they share a relationship, the member ID and contact ID are distinct identifiers. Make sure to specifiy the contact ID when calling Update Contact.
+ * @param contactId - ID of the contact to update.
+ * @param info - Contact info.
+ * @param revision - Revision number.
+ * When updating, include the existing `revision`
+ * to prevent conflicting updates.
+ * @public
+ * @requiredField contactId
+ * @requiredField info
+ * @requiredField revision
+ * @param options - Contact update options.
+ * @permissionId CONTACTS.MODIFY
+ * @permissionId CONTACTS.MODIFY_MEMBERSHIP_STATUS
+ * @permissionId CONTACTS.MODIFY_MEMBER_PRIMARY_EMAIL_PERMISSION
+ * @permissionScope Manage Contacts
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-CONTACTS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
+ * @applicableIdentity APP
+ * @returns Updated contact.
+ * @fqn com.wixpress.contacts.core.api.v4.ContactsServiceV4.UpdateContact
+ */
+export async function updateContact(contactId, info, revision, options) {
+    // @ts-ignore
+    const { httpClient, sideEffects } = arguments[4];
+    const payload = transformPaths(renameKeysFromSDKRequestToRESTRequest({
+        contactId: contactId,
+        info: info,
+        revision: revision,
+        allowDuplicates: options?.allowDuplicates,
+    }), [
+        {
+            transformFn: transformSDKAddressToRESTAddress,
+            paths: [{ path: 'info.addresses.items.address' }],
+        },
+        {
+            transformFn: transformSDKImageToRESTImage,
+            paths: [{ path: 'info.picture.image' }],
+        },
+    ]);
+    const reqOpts = ambassadorWixContactsV4Contact.updateContact(payload);
+    sideEffects?.onSiteCall?.();
+    try {
+        const result = await httpClient.request(reqOpts);
+        sideEffects?.onSuccess?.(result);
+        return renameKeysFromRESTResponseToSDKResponse(transformPaths(result.data, [
+            {
+                transformFn: transformRESTImageToSDKImage,
+                paths: [
+                    { path: 'contact.picture' },
+                    { path: 'contact.info.picture.image' },
+                    { path: 'contact.memberInfo.profileInfo.photo' },
+                ],
+            },
+            {
+                transformFn: transformRESTAddressToSDKAddress,
+                paths: [{ path: 'contact.info.addresses.items.address' }],
+            },
+        ]));
+    }
+    catch (err) {
+        const transformedError = sdkTransformError(err, {
+            spreadPathsToArguments: {},
+            explicitPathsToArguments: {
+                contactId: '$[0]',
+                info: '$[1]',
+                revision: '$[2]',
+                allowDuplicates: '$[3].allowDuplicates',
+            },
+            singleArgumentUnchanged: false,
+        }, ['contactId', 'info', 'revision', 'options']);
+        sideEffects?.onError?.(err);
+        throw transformedError;
+    }
+}
+/**
+ * Merges source contacts into a target contact.
+ *
+ * Merging contacts has the following effects on the target contact:
+ *
+ * - No target contact data is overwritten or deleted.
+ * - Arrays (emails, phone numbers, addresses, and labels) from the source contacts are added to the target contact's arrays.
+ * - If you merge more than one source contact, the 1st source contact specified is added first, then the 2nd, and so on.
+ * - If there is duplicate information between the target contact and the source contact, the information isn't duplicated in the target contact's arrays.
+ *
+ * <blockquote class="important">
+ *
+ * __Important:__
+ * Merges cannot be undone.
+ * In REST, call Preview Merge Contacts to test before merging.
+ *
+ * </blockquote>
+ *
+ * When you merge contacts, source contacts are typically deleted.
+ * However, if a source contact is a site member or a Wix user,
+ * the merge will fail because site members and Wix users can't be deleted.
+ * This means that site members and Wix users can only be specified as target contacts in a merge.
+ *
+ * After merging, calling Get Contact with a deleted source contact ID returns the target contact ID.
+ * Specifying a deleted source contact ID is not supported on any other method.
+ *
+ * When contacts are merged:
+ *
+ * - The Contact Merged event is triggered.
+ * - The Contact Updated event is triggered for the target contact. `originatedFrom` is set to `merge`.
+ * - The Contact Deleted event is triggered for each source contact. `originatedFrom` is set to `merge`.
+ * @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 specified.
+ * @public
+ * @requiredField targetContactId
+ * @requiredField targetContactRevision
+ * @param options - Merge contacts options.
+ * @permissionId CONTACTS.MERGE
+ * @permissionScope Manage Contacts
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-CONTACTS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
+ * @applicableIdentity APP
+ * @fqn com.wixpress.contacts.core.api.v4.ContactsServiceV4.MergeContacts
+ */
+export async function mergeContacts(targetContactId, targetContactRevision, options) {
+    // @ts-ignore
+    const { httpClient, sideEffects } = arguments[3];
+    const payload = renameKeysFromSDKRequestToRESTRequest({
+        targetContactId: targetContactId,
+        targetContactRevision: targetContactRevision,
+        sourceContactIds: options?.sourceContactIds,
+    });
+    const reqOpts = ambassadorWixContactsV4Contact.mergeContacts(payload);
+    sideEffects?.onSiteCall?.();
+    try {
+        const result = await httpClient.request(reqOpts);
+        sideEffects?.onSuccess?.(result);
+        return renameKeysFromRESTResponseToSDKResponse(transformPaths(result.data, [
+            {
+                transformFn: transformRESTImageToSDKImage,
+                paths: [
+                    { path: 'contact.picture' },
+                    { path: 'contact.info.picture.image' },
+                    { path: 'contact.memberInfo.profileInfo.photo' },
+                ],
+            },
+            {
+                transformFn: transformRESTAddressToSDKAddress,
+                paths: [{ path: 'contact.info.addresses.items.address' }],
+            },
+        ]));
+    }
+    catch (err) {
+        const transformedError = sdkTransformError(err, {
+            spreadPathsToArguments: {},
+            explicitPathsToArguments: {
+                targetContactId: '$[0]',
+                targetContactRevision: '$[1]',
+                sourceContactIds: '$[2].sourceContactIds',
+            },
+            singleArgumentUnchanged: false,
+        }, ['targetContactId', 'targetContactRevision', 'options']);
+        sideEffects?.onError?.(err);
+        throw transformedError;
+    }
+}
+/**
+ * Deletes a contact.
+ *
+ * Deleting a contact permanently removes it from the contact list.
+ * If a contact is also a site member or Wix user, or has a valid billing subscription,
+ * the contact can't be deleted. The related site member or Wix user must first be deleted
+ * and any valid billing subscriptions must be canceled, before the contact can be deleted.
+ *
+ * Members are typically linked to contacts, and while they share a relationship, the member ID and contact ID are distinct identifiers.
+ * Make sure to specify the contact ID when calling Delete Contact.
+ * @param contactId - ID of the contact to delete.
+ * @public
+ * @requiredField contactId
+ * @permissionId CONTACTS.MODIFY
+ * @permissionId MEMBERS.MEMBER_DELETE
+ * @permissionScope Manage Contacts
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-CONTACTS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
+ * @permissionScope Manage Members
+ * @permissionScopeId SCOPE.DC-MEMBERS.MANAGE-MEMBERS
+ * @applicableIdentity APP
+ * @fqn com.wixpress.contacts.core.api.v4.ContactsServiceV4.DeleteContact
+ */
+export async function deleteContact(contactId) {
+    // @ts-ignore
+    const { httpClient, sideEffects } = arguments[1];
+    const payload = renameKeysFromSDKRequestToRESTRequest({
+        contactId: contactId,
+    });
+    const reqOpts = ambassadorWixContactsV4Contact.deleteContact(payload);
+    sideEffects?.onSiteCall?.();
+    try {
+        const result = await httpClient.request(reqOpts);
+        sideEffects?.onSuccess?.(result);
+    }
+    catch (err) {
+        const transformedError = sdkTransformError(err, {
+            spreadPathsToArguments: {},
+            explicitPathsToArguments: { contactId: '$[0]' },
+            singleArgumentUnchanged: false,
+        }, ['contactId']);
+        sideEffects?.onError?.(err);
+        throw transformedError;
+    }
+}
+/**
+ * Adds labels to a contact.
+ *
+ * Use the Labels API to create or retrieve labels.
+ *
+ * Members are typically linked to contacts, and while they share a relationship, the member ID and contact ID are distinct identifiers.
+ * Make sure to specify the contact ID when calling Label Contact.
+ * @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.
+ * Use the Labels API to create or retrieve labels.
+ * @public
+ * @requiredField contactId
+ * @requiredField labelKeys
+ * @permissionId CONTACTS.MODIFY
+ * @permissionScope Manage Contacts
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-CONTACTS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
+ * @applicableIdentity APP
+ * @returns Updated contact.
+ * @fqn com.wixpress.contacts.core.api.v4.ContactsServiceV4.LabelContact
+ */
+export async function labelContact(contactId, labelKeys) {
+    // @ts-ignore
+    const { httpClient, sideEffects } = arguments[2];
+    const payload = renameKeysFromSDKRequestToRESTRequest({
+        contactId: contactId,
+        labelKeys: labelKeys,
+    });
+    const reqOpts = ambassadorWixContactsV4Contact.labelContact(payload);
+    sideEffects?.onSiteCall?.();
+    try {
+        const result = await httpClient.request(reqOpts);
+        sideEffects?.onSuccess?.(result);
+        return renameKeysFromRESTResponseToSDKResponse(transformPaths(result.data, [
+            {
+                transformFn: transformRESTImageToSDKImage,
+                paths: [
+                    { path: 'contact.picture' },
+                    { path: 'contact.info.picture.image' },
+                    { path: 'contact.memberInfo.profileInfo.photo' },
+                ],
+            },
+            {
+                transformFn: transformRESTAddressToSDKAddress,
+                paths: [{ path: 'contact.info.addresses.items.address' }],
+            },
+        ]));
+    }
+    catch (err) {
+        const transformedError = sdkTransformError(err, {
+            spreadPathsToArguments: {},
+            explicitPathsToArguments: { contactId: '$[0]', labelKeys: '$[1]' },
+            singleArgumentUnchanged: false,
+        }, ['contactId', 'labelKeys']);
+        sideEffects?.onError?.(err);
+        throw transformedError;
+    }
+}
+/**
+ * Removes labels from a contact.
+ *
+ * If a label is no longer needed
+ * and you want to remove it from all contacts,
+ * you can delete by calling Delete Label from the Labels API.
+ *
+ * Members are typically linked to contacts, and while they share a relationship, the member ID and contact ID are distinct identifiers.
+ * Make sure to specify the contact ID when calling Unlabel Contact.
+ * @param contactId - ID of the contact to remove labels from.
+ * @param labelKeys - List of label keys to remove from the contact.
+ * @public
+ * @requiredField contactId
+ * @requiredField labelKeys
+ * @permissionId CONTACTS.MODIFY
+ * @permissionScope Manage Contacts
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-CONTACTS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
+ * @applicableIdentity APP
+ * @returns Updated contact.
+ * @fqn com.wixpress.contacts.core.api.v4.ContactsServiceV4.UnlabelContact
+ */
+export async function unlabelContact(contactId, labelKeys) {
+    // @ts-ignore
+    const { httpClient, sideEffects } = arguments[2];
+    const payload = renameKeysFromSDKRequestToRESTRequest({
+        contactId: contactId,
+        labelKeys: labelKeys,
+    });
+    const reqOpts = ambassadorWixContactsV4Contact.unlabelContact(payload);
+    sideEffects?.onSiteCall?.();
+    try {
+        const result = await httpClient.request(reqOpts);
+        sideEffects?.onSuccess?.(result);
+        return renameKeysFromRESTResponseToSDKResponse(transformPaths(result.data, [
+            {
+                transformFn: transformRESTImageToSDKImage,
+                paths: [
+                    { path: 'contact.picture' },
+                    { path: 'contact.info.picture.image' },
+                    { path: 'contact.memberInfo.profileInfo.photo' },
+                ],
+            },
+            {
+                transformFn: transformRESTAddressToSDKAddress,
+                paths: [{ path: 'contact.info.addresses.items.address' }],
+            },
+        ]));
+    }
+    catch (err) {
+        const transformedError = sdkTransformError(err, {
+            spreadPathsToArguments: {},
+            explicitPathsToArguments: { contactId: '$[0]', labelKeys: '$[1]' },
+            singleArgumentUnchanged: false,
+        }, ['contactId', 'labelKeys']);
+        sideEffects?.onError?.(err);
+        throw transformedError;
+    }
+}
+/**
+ * Creates a query to retrieve a list of contacts.
+ *
+ * The `queryContacts()` function builds a query to retrieve a list of contacts and returns a `ContactsQueryBuilder` object.
+ *
+ * The returned object contains the query definition, which is typically used to run the query using the `find()` function.
+ *
+ * You can refine the query by chaining `ContactsQueryBuilder` functions onto the query. `ContactsQueryBuilder` functions enable you to sort, filter, and control the results `queryContacts()` returns.
+ *
+ * `queryContacts()` runs with these `ContactsQueryBuilder` defaults, which you can override:
+ *
+ * - `skip(0)`
+ * - `limit(50)`
+ * - `descending(\"_createdDate\")`
+ *
+ * The functions that are chained to `queryContacts()` are applied in the order they are called. For example, if you apply `ascending('info.company')` and then `descending('info.name.last')`, the results are sorted first by the company name, and then, if there are multiple results with the same company, the items are sorted by last name.
+ * @public
+ * @param options - Query contact options.
+ * @permissionScope Read Contacts
+ * @permissionScopeId SCOPE.DC-CONTACTS.READ-CONTACTS
+ * @permissionScope Read Members and Contacts - all read permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.READ-MEMBERS-CONTACTS
+ * @permissionScope Manage Contacts
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-CONTACTS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
+ * @permissionId CONTACTS.VIEW
+ * @applicableIdentity APP
+ * @fqn com.wixpress.contacts.core.api.v4.ContactsServiceV4.QueryContacts
+ */
+export function queryContacts(options) {
+    // @ts-ignore
+    const { httpClient, sideEffects } = arguments[1];
+    return queryBuilder({
+        func: async (payload) => {
+            const reqOpts = ambassadorWixContactsV4Contact.queryContacts({
+                ...payload,
+                ...(options ?? {}),
+            });
+            sideEffects?.onSiteCall?.();
+            try {
+                const result = await httpClient.request(reqOpts);
+                sideEffects?.onSuccess?.(result);
+                return result;
+            }
+            catch (err) {
+                sideEffects?.onError?.(err);
+                throw err;
+            }
+        },
+        requestTransformer: (query) => {
+            const args = [query, options];
+            return renameKeysFromSDKRequestToRESTRequest({
+                ...args?.[1],
+                query: args?.[0],
+            });
+        },
+        responseTransformer: ({ data }) => {
+            const transformedData = renameKeysFromRESTResponseToSDKResponse(transformPaths(data, [
+                {
+                    transformFn: transformRESTImageToSDKImage,
+                    paths: [
+                        { path: 'contacts.picture' },
+                        { path: 'contacts.info.picture.image' },
+                        { path: 'contacts.memberInfo.profileInfo.photo' },
+                    ],
+                },
+                {
+                    transformFn: transformRESTAddressToSDKAddress,
+                    paths: [{ path: 'contacts.info.addresses.items.address' }],
+                },
+            ]));
+            return {
+                items: transformedData?.contacts,
+                pagingMetadata: transformedData?.pagingMetadata,
+            };
+        },
+        errorTransformer: (err) => {
+            const transformedError = sdkTransformError(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: { query: '$[0]' },
+                singleArgumentUnchanged: false,
+            });
+            throw transformedError;
+        },
+        pagingMethod: 'OFFSET',
+        transformationPaths: {},
+    });
+}
+/**
+ * Retrieves a contact.
+ *
+ * #### Getting Merged Contacts
+ *
+ * When a source contact is merged
+ * with a target contact, the source contact is deleted.
+ * When calling Get Contact for a merged contact,
+ * you can use the source or target contact ID.
+ * In both bases, the target contact is returned.
+ *
+ * This is supported only when calling Get Contact on merged contacts.
+ * Previously deleted source contact IDs can't be used for any other method.
+ * @param _id - ID of the contact to retrieve.
+ * @public
+ * @requiredField _id
+ * @param options - Get contact options.
+ * @permissionId CONTACTS.VIEW
+ * @permissionScope Read Contacts
+ * @permissionScopeId SCOPE.DC-CONTACTS.READ-CONTACTS
+ * @permissionScope Read Members and Contacts - all read permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.READ-MEMBERS-CONTACTS
+ * @permissionScope Manage Contacts
+ * @permissionScopeId SCOPE.DC-CONTACTS.MANAGE-CONTACTS
+ * @permissionScope Manage Members and Contacts - all permissions
+ * @permissionScopeId SCOPE.DC-CONTACTS-MEGA.MANAGE-MEMBERS-CONTACTS
+ * @applicableIdentity APP
+ * @returns The requested contact.
+ * @fqn com.wixpress.contacts.core.api.v4.ContactsServiceV4.GetContact
+ */
+export async function getContact(_id, options) {
+    // @ts-ignore
+    const { httpClient, sideEffects } = arguments[2];
+    const payload = renameKeysFromSDKRequestToRESTRequest({
+        id: _id,
+        fields: options?.fields,
+        fieldsets: options?.fieldsets,
+    });
+    const reqOpts = ambassadorWixContactsV4Contact.getContact(payload);
+    sideEffects?.onSiteCall?.();
+    try {
+        const result = await httpClient.request(reqOpts);
+        sideEffects?.onSuccess?.(result);
+        return renameKeysFromRESTResponseToSDKResponse(transformPaths(result.data, [
+            {
+                transformFn: transformRESTImageToSDKImage,
+                paths: [
+                    { path: 'contact.picture' },
+                    { path: 'contact.info.picture.image' },
+                    { path: 'contact.memberInfo.profileInfo.photo' },
+                ],
+            },
+            {
+                transformFn: transformRESTAddressToSDKAddress,
+                paths: [{ path: 'contact.info.addresses.items.address' }],
+            },
+        ]))?.contact;
+    }
+    catch (err) {
+        const transformedError = sdkTransformError(err, {
+            spreadPathsToArguments: {},
+            explicitPathsToArguments: {
+                id: '$[0]',
+                fields: '$[1].fields',
+                fieldsets: '$[1].fieldsets',
+            },
+            singleArgumentUnchanged: false,
+        }, ['_id', 'options']);
+        sideEffects?.onError?.(err);
+        throw transformedError;
+    }
+}
+//# sourceMappingURL=contacts-v4-contact-contacts.universal.js.map