mtcute/packages/client/src/methods/contacts/add-contact.ts

import { BaseTelegramClient } from '@mtcute/core'

import { InputPeerLike, User } from '../../types/index.js'
import { normalizeToInputUser } from '../../utils/peer-utils.js'
import { assertIsUpdatesGroup } from '../../utils/updates-utils.js'
import { resolvePeer } from '../users/resolve-peer.js'

/**
 * Add an existing Telegram user as a contact
 */
export async function addContact(
    client: BaseTelegramClient,
    params: {
        /** User ID, username or phone number */
        userId: InputPeerLike

        /**
         * First name of the contact
         */
        firstName: string

        /**
         * Last name of the contact
         */
        lastName?: string

        /**
         * Phone number of the contact, if available
         */
        phone?: string

        /**
         * Whether to share your own phone number
         * with the newly created contact
         *
         * @default false
         */
        sharePhone?: boolean
    },
): Promise<User> {
    const { userId, firstName, lastName = '', phone = '', sharePhone = false } = params
    const peer = normalizeToInputUser(await resolvePeer(client, userId), userId)

    const res = await client.call({
        _: 'contacts.addContact',
        id: peer,
        firstName,
        lastName,
        phone,
        addPhonePrivacyException: sharePhone,
    })

    assertIsUpdatesGroup('contacts.addContact', res)

    client.network.handleUpdate(res)

    return new User(res.users[0])
}