meeting_place_chat 0.0.1-dev.53

Chat SDK is a package that provides secure, end-to-end encrypted messaging using Decentralised Identifiers (DID) and DIDComm v2.1 protocol.

Affinidi Meeting Place - Chat SDK for Dart

Affinidi Meeting Place - Chat SDK for Dart provides libraries to send secure and private messages using Decentralised Identifiers (DIDs) and DIDComm v2.1. Messages are protected with end-to-end encryption so only the intended recipient can read the content.

The Chat SDK is part of the Meeting Place SDK toolkit and enables a safe and secure method of discovering, connecting, and communicating between individuals, businesses, and AI agents.

DISCLAIMER: Affinidi provides this SDK as a developer tool to facilitate decentralized messaging. Any personal data exchanged or stored via this tool is entirely initiated and controlled by end-users. Affinidi does not collect, access, or process such data. Implementing parties are responsible for ensuring that their applications comply with applicable privacy laws and user transparency obligations.

Core Concepts

• Decentralised Identifier (DID) - A globally unique identifier that enables secure interactions. The DID is the cornerstone of Self-Sovereign Identity (SSI), a concept that aims to put individuals or entities in control of their digital identities.

• DIDComm Message - is a JSON Web Message (JWM), a lightweight, secure, and standardised format for structured communication using JSON. It represents headers, message types, routing metadata, and payloads designed to enable secure and interoperable communication across different systems.

• Mediator - A service that handles and routes messages sent between participants (e.g., users, organisations, another mediator, or even AI agents).

• Out-Of-Band - The protocol defined in DIDComm enables sharing a DIDComm message or invitation through a transport method other than a direct, established DIDComm channel, such as via a QR code or a URL.

• Connection Offer (Invitation) - An invite to connect containing description and ContactCard info of the publisher. Each connection offer is assigned with a unique passphrase that others can use to discover and accept the offer to connect.

Key Features

• End-to-end encryption for secure and private communication.
• Support for individual chats over DIDComm.
• Notifies connections for contact details update (e.g., name change).
• Supports ContactCard in publishing a connection offer (invitation) and establishing connections with others to chat.
• Supports DIDComm Message v2.1 transport for sending and receiving messages.

Chat Capabilities

meeting_place_chat is the DIDComm-focused chat package in the Meeting Place SDK. Use it when you need DIDComm-based chat features such as:

• Individual DIDComm chats
• Text messages
• Image attachments
• Reactions
• Typing indicators
• Presence indicator
• Delivery receipts
• Visual effects
• Contact details update
• Human ZKP

This package exposes supported chat features through chatSDK.capabilities. Use it before showing optional actions in your app:

if (chatSDK.capabilities.supports(ChatFeature.reactions)) {
  await chatSDK.reactOnMessage(message, reaction: '+1');
}

MeetingPlaceChatSDK.initialiseChatFromChannel(...) only supports channels whose transport is ChannelTransport.didcomm.

Requirements

• Dart SDK ^3.8.0

Installation

Run:

dart pub add meeting_place_chat

or manually, add the package into your pubspec.yaml file:

dependencies:
  meeting_place_chat: ^<version_number>

and then run the command below to install the package:

dart pub get

Visit the pub.dev install page of the Dart package for more information.

Quick Start

Create an individual DIDComm channel with the Core SDK first, then start a chat session from that channel.

import 'package:meeting_place_chat/meeting_place_chat.dart';
import 'package:meeting_place_core/meeting_place_core.dart';

final chatSDK = MeetingPlaceChatSDK.initialiseChatFromChannel(
  channel,
  coreSDK: coreSDK,
  chatRepository: chatRepository,
  options: const MeetingPlaceChatSDKOptions(),
);

final chat = await chatSDK.startChatSession();
final messages = chat.messages;

For more sample usage, go to example folder.

Common Chat Actions

Use capabilities before showing optional actions.

await chatSDK.sendTextMessage('Hello');
await chatSDK.sendChatActivity(); // typing/activity signal

if (chatSDK.capabilities.supports(ChatFeature.reactions)) {
  await chatSDK.reactOnMessage(message, reaction: '+1');
}

if (chatSDK.capabilities.supports(ChatFeature.messageEdit)) {
  await chatSDK.editTextMessage(message, 'Updated message');
}

if (chatSDK.capabilities.supports(ChatFeature.messageDelete)) {
  await chatSDK.deleteMessage(message);
}

Running tests locally

Option 1: Running tests via melos (recommended for CI and automation)

This approach uses environment variables from your shell and does not require an .env file.

To run tests in this package from the terminal:

1. Export your environment variables in your terminal:

   export CONTROL_PLANE_DID="your:control-plane:did"
   export MEDIATOR_DID="your:mediator:did"
   

   Replace these DIDs with your actual test values.

2. Run tests using Melos:

   melos run test
   

---

Option 2: Running tests directly from VS Code (with .env file for local development)

If you want to run tests directly from VS Code (using the Run button or Test Explorer), you can use an .env file for local configuration:

1. Create your local environment file:

   (Run this command in your terminal to copy the template and create test/.env for your tests.)

   cp test/templates/.example.env test/.env
   

2. Edit test/.env and update the values for CONTROL_PLANE_DID and MEDIATOR_DID to match your test environment.

3. Run your test files directly in VS Code:

   • The test utilities will automatically load variables from test/.env.

Note:

• The .env file should be placed in the test folder as test/.env.
• The template file is provided at test/templates/.example.env for convenience.

---

Support & feedback

If you face any issues or have suggestions, please don't hesitate to contact us using this link.

Reporting technical issues

If you have a technical issue with the project's codebase, you can also create an issue directly in GitHub.

1. Ensure the bug was not already reported by searching on GitHub under Issues.

2. If you're unable to find an open issue addressing the problem, open a new one. Be sure to include a title and clear description, as much relevant information as possible, and a code sample or an executable test case demonstrating the expected behaviour that is not occurring.

Contributing

Want to contribute?

Head over to our CONTRIBUTING guidelines.