Class Dm<ContentTypes>

constructor

• new Dm<ContentTypes>(client, params, lastMessage?): Dm<ContentTypes>

• Type Parameters

  • ContentTypes extends DefaultContentTypes = DefaultContentTypes

  Parameters

  • client: Client<ContentTypes>

  • params: DmParams

  • Optional lastMessage: DecodedMessage<ContentTypes>

  Returns Dm<ContentTypes>

client

createdAt

id

Optional lastMessage

state

topic

version

consentState

• consentState(): Promise<ConsentState>

• Returns Promise<ConsentState>

members

• members(): Promise<Member[]>

• Returns Promise<Member[]>

  A Promise that resolves to an array of Member objects. To get the latest member list from the network, call sync() first.

messages

• messages(opts?): Promise<DecodedMessage<ContentTypes>[]>

• This method returns an array of messages associated with the dm. To get the latest messages from the network, call sync() first.

  Parameters

  • Optional opts: MessagesOptions

  Returns Promise<DecodedMessage<ContentTypes>[]>

  A Promise that resolves to an array of DecodedMessage objects.

peerInboxId

• peerInboxId(): Promise<InboxId>

• This method return the peer inbox id associated with the dm.

  Returns Promise<InboxId>

  A Promise that resolves to a InboxId.

prepareMessage

• prepareMessage<SendContentTypes>(content): Promise<string>

• Prepare a dm message to be sent.

  Type Parameters

  • SendContentTypes extends DefaultContentTypes = ContentTypes

  Parameters

  • content: ConversationSendPayload<SendContentTypes>

    The content of the message. It can be either a string or a structured MessageContent object.

  Returns Promise<string>

  A Promise that resolves to a string identifier for the prepared message to be sent.

  Throws

  Throws an error if there is an issue with sending the message.

processMessage

• processMessage(encryptedMessage): Promise<DecodedMessage<ContentTypes>>

• Parameters

  • encryptedMessage: string

  Returns Promise<DecodedMessage<ContentTypes>>

publishPreparedMessages

• publishPreparedMessages(): Promise<any>

• Publish all prepared messages.

  Returns Promise<any>

  Throws

  Throws an error if there is an issue finding the unpublished message

send

• send<SendContentTypes>(content): Promise<MessageId>

• Sends a message to the current dm.

  Type Parameters

  • SendContentTypes extends DefaultContentTypes = ContentTypes

  Parameters

  • content: ConversationSendPayload<SendContentTypes>

    The content of the message. It can be either a string or a structured MessageContent object.

  Returns Promise<MessageId>

  A Promise that resolves to a string identifier for the sent message.

  Throws

  Throws an error if there is an issue with sending the message.

streamMessages

• streamMessages(callback): Promise<(() => void)>

• Sets up a real-time message stream for the current dm.

  This method subscribes to incoming messages in real-time and listens for new message events. When a new message is detected, the provided callback function is invoked with the details of the message. Additionally, this method returns a function that can be called to unsubscribe and end the message stream.

  Parameters

  • callback: ((message) => Promise<void>)

    A callback function that will be invoked with the new DecodedMessage when a message is received.

    • • (message): Promise<void>

      • Parameters

        • message: DecodedMessage<ContentTypes>

        Returns Promise<void>

  Returns Promise<(() => void)>

  A function that, when called, unsubscribes from the message stream and ends real-time updates.

sync

• sync(): Promise<void>

• Executes a network request to fetch the latest messages and membership changes associated with the dm and saves them to the local state.

  Returns Promise<void>

updateConsent

• updateConsent(state): Promise<void>

• Parameters

  • state: ConsentState

  Returns Promise<void>