@relationlabs/im v0.4.0-beta-3

@relationlabs/im

JS SDK for relation IM: A simple API for building IM services.

Quick start

Download using NPM

npm install --save @relationlabs/im
npm install --save @relationlabs/auth

then

use authByMetamask to activate Metamask signing and acquire an addressAuthToken

import { authByMetamask } from "@relationlabs/auth";

const { error, token: addressAuthToken } = await authByMetamask()

then

use getRelationToken to acquire unifiedAuthToken. The APIKEY should be acquired from the Admin.

import RelationIM from "@relationlabs/im";
import { authByMetamask } from "@relationlabs/auth";

const { error, token: addressAuthToken } = await authByMetamask()

const APIKEY = '581c6c4fa0b54912b00088aa563342a4'

if (!error && addressAuthToken) {
    const { error, token: unifiedAuthToken } = await RelationIM.getRelationToken(addressAuthToken, APIKEY)
    if (!error && unifiedAuthToken) {

    }
}

then

instantiate an im instance

const myIm = RelationIM.init({token: unifiedAuthToken, apiKey: APIKEY, connect: true})

API reference

Static Method

RelationIM.getRelationToken (acquire a unifiedAuthToken)

RelationIM.getRelationToken(addressAuthToken, APIKEY)

Note: In the return message, token refers to the account's unifiedAuthToken in relation. If there is no such account, one will be registered by default.

RelationIM.init(You need to initialize an API before calling it.)

RelationIM.init({configOptions})

Note: When using init to initialize the interface, you can use connect to specify whether to connect to socket. The parameter refresh means whether to refresh the RelationIM instance.

RelationIM.getInstance(to acquire the RelationIM instance already initialized.)

RelationIM.getInstance()

Note: Normally you only need one RelationIM instance. However, you may frequently call common APIs. To avoid redunant initiations of RelationIM and socket , we suggest you manually specify a static methodRelationIM.getInstancewhere needed so that you can acquire theRelationIM` instance already initialized.

Events

import { Im } from "@relationlabs/im";

myIm.bind(Im.RECEIVE_MSG_OK, (e) => {
    const message = e['im-message']
})

Methods

setImToken(token: string)

Update the token for an instance

myIm.setImToken('new token')

setImApiKey(apiKey: string)

Update the ApiKey for an instance

myIm.setImApiKey('new apiKey')

getUserInfo(address?: string)

Acquire a user's basic information

getFollowing(data: { address: string, cursor?: string, limit?: number })

To acquire a list of the people the user is following.

recommend(data: { address: string, cursor?: string, limit?: number })

The recommendation engine will recommend potential friends based on these factors: the user's Twitter followers, transactions on the Ethereum chain, NFT holdings, and users in the lists of following.

follow(address: string)

To follow a user

unfollow(address: string)

To unfollower a user

sendMessage(data: sendMessageType)

To send a message. The data structure sendMessageType has the following parameters:

Note: channelUuid and toRelationId cannot be empty at the same time. If the sendUuidis empty, the system will connect the current timestamp and a random number with channelUuid and toRelationId as the default sendUuid. If you are sending a message to a user never had a conversation before, once the message is sent, a new channel will be created automatically and its channelUuid will be returned.

userChannelsList(data: listRequestType)

To acquire a user's list of channels. The parameters of listRequestType are as follows:

messageList(data: messageListRequestType)

To acquire the list of messages of a channel for a user. The parameters of messageListRequestType are as follows:

channelCreate(data: {members, name, type})

To create a new channel

channelInfo(channelUuid: string)

To acquire the details of a channel.

channelDisband(channelUuid: string)

dismiss a channel

channelMemberLeave(channelUuid: string)

when the current user choose to leave a channel.

to parse a message

use the 'messageParse()' method to parse an original message

import { messageParser } from "@relationlabs/im"

const msg: Message

const parsedMsg: ParsedMessage = messageParser(msg)

// to define types

// message type
type MessageType = 'SYS' | 'TEXT' | 'CARD' | 'ANNOUNCEMENT' | 'BATCH_TRANSFER';

// the construct of an original message
type Message = {
    type: MessageType;
    content: string;
    quote?: Message;
}

// the construct generated by parsing a message
type ParsedMessage = {
    type: MessageType;
    content: string;
    parsedContent?: ParsedContent;
    quote?: Message;
    unidentified?: boolean | undefined;
}

//content parsed
type ParsedContent = string|JoinGroupMessage|ShareMessage|NormalImageMessage|NFTMessage|MentionMessage

// invitation to join a chat group
type JoinGroupMessage = {
    groupId: string;
    groupName: string;
    chatType: 'p2p'|'group'
}

// sharing an URL
type ShareMessage = {
    shareUrl: string;
    shareName: string;
    shareIcon: string;
}

// normal image
type NormalImageMessage = {
    imgUrl: string;
    s3Key: string;
}

// NFT
type NFTMessage = {
    imgUrl: string;
    nftChain: string;
}

// to quote a message
type MentionMessage = {
    mentionContent: string;
    mentionPosition: number[];
}

In ParsedMessage construct, unidentified flags if the message can be parsed, and parsedContent is the result parsed from the content in the original message. Other keys in the construct come from respective segments in the construct of the original message.