Rocket.Chat/apps/meteor/app/livechat/server/lib/contacts/createContact.ts

import type { ILivechatContactChannel, IVisitorLastChat } from '@rocket.chat/core-typings';
import { LivechatContacts } from '@rocket.chat/models';

import { getAllowedCustomFields } from './getAllowedCustomFields';
import { validateContactManager } from './validateContactManager';
import { validateCustomFields } from './validateCustomFields';

export type CreateContactParams = {
	name: string;
	emails?: string[];
	phones?: string[];
	unknown: boolean;
	customFields?: Record<string, string | unknown>;
	lastChat?: IVisitorLastChat;
	contactManager?: string;
	channels?: ILivechatContactChannel[];
	importIds?: string[];
	shouldValidateCustomFields?: boolean;
};

export async function createContact({
	name,
	emails,
	phones,
	customFields: receivedCustomFields = {},
	lastChat,
	contactManager,
	channels = [],
	unknown,
	importIds,
	shouldValidateCustomFields = true,
}: CreateContactParams): Promise<string> {
	if (contactManager) {
		await validateContactManager(contactManager);
	}

	const customFields = shouldValidateCustomFields
		? validateCustomFields(await getAllowedCustomFields(), receivedCustomFields)
		: receivedCustomFields;

	return LivechatContacts.insertContact({
		name,
		...(emails && { emails: emails?.map((address) => ({ address })) }),
		...(phones && { phones: phones?.map((phoneNumber) => ({ phoneNumber })) }),
		...(contactManager && { contactManager }),
		...(channels && { channels }),
		...(customFields && { customFields }),
		...(lastChat && { lastChat }),
		unknown,
		...(importIds?.length && { importIds }),
	});
}