Dart / Flutter

The DNotifier Dart SDK allows developers to integrate Realtime Chat, Pub/Sub messaging, and AI features directly into Flutter mobile apps and Dart-based applications.

It provides simple APIs to connect, send messages, subscribe to channels, and interact with AI agents.

---

connect()

Description: Authenticates with DNotifier and connects your app to the realtime network. Sets up message callbacks for incoming messages and connection state changes.

Callbacks (optional):

• onConnected — called when the client is successfully connected

• onMessage — called for every incoming message

• onDisconnected — called if the connection closes or encounters an error

Usage:

await client.connect();

---

getPlanLimits()

Description: Returns your subscription limits after authentication, including messaging, AI requests, and knowledge base usage.

Returns:

{
  messagesHardLimit,
  maxAIRequestsPerMonth,
  maxAIWordsPerMonth,
  knowledgeBaseMaxWords,
  aiEnabled,
  maxUsers,
  maxRowsPerUser
}

Usage:

final limits = client.getPlanLimits();
print("AI Enabled: ${limits.aiEnabled}, Max AI Requests: ${limits.maxAIRequestsPerMonth}");

---

send({ senderId, receiverId, receiverIds, data })

Description: Send a realtime text message to one or multiple recipients.

Parameters:

• senderId — required

• receiverId — single recipient (optional if receiverIds is provided)

• receiverIds — array of recipients (optional if receiverId is provided)

• data — message payload

Usage:

client.send(
  senderId: "user123",
  receiverId: "user456",
  data: {"text": "Hello from Flutter!"}
);

// Send Image
final imagePath = File('$_projectRoot/samples/sample.png');
if (await imagePath.exists()) {
  final imageBytes = await imagePath.readAsBytes();
  notifier.send(
    senderId: userId,
    receiverId: userId,
    data: <String, dynamic>{
      'type': 'image',
      'content': imageBytes,
    },
  );
}

// Send Audio
final audioPath = File('$_projectRoot/samples/sample.m4a');
if (await audioPath.exists()) {
  final audioBytes = await audioPath.readAsBytes();
  notifier.send(
    senderId: userId,
    receiverId: userId,
    data: <String, dynamic>{
      'type': 'audio',
      'content': audioBytes,
    },
  );
}

// Send Doc
final docPath = File('$_projectRoot/samples/sample.pdf');
if (await docPath.exists()) {
  final docBytes = await docPath.readAsBytes();
  notifier.send(
    senderId: userId,
    receiverId: userId,
    data: <String, dynamic>{
      'type': 'doc',
      'content': docBytes,
    },
  );

If a message exceeds the size limit defined in your subscription plan, it will be counted as multiple messages. You can review the usage breakdown in the Dashboard graphs for better visibility.

---

sendAI({ senderId, message })

Description: Send a message to the AI pipeline. Responses are returned via the onMessage callback.

Parameters:

• senderId — required

• message — object

Usage:

client.sendAI(
  senderId: "user123",
  message: { text : "Explain DNotifier in simple terms." }
  //message : { messages : [] } 
);

---

fetchAIHistory({ senderId })

Description: Fetch previous AI messages sent by a user.

Parameters:

• senderId — required

Usage:

client.fetchAIHistory(senderId: "user123");

---

sendBinary({ senderId, receiverIds, buffer, type })

Description: Send binary data (images, audio, files) to one or multiple recipients.

Parameters:

• senderId — required

• receiverIds — array of recipients

• buffer — binary data (required)

• type — optional, default "binary"

Usage:

client.sendBinary(
  senderId: "user123",
  receiverIds: ["user456", "user789"],
  buffer: myFileBytes,
  type: "image"
);

---

Deprecated: sendWithOpenAI({ senderId, message })

Description: Deprecated: Use sendAI() instead. Maintains compatibility with older code.

Full Workflow Example (Safe Post-Connection)

import 'package:dnotifier/dnotifier.dart';

void main() async {
  final client = DNotifier(
    appId: "YOUR_APP_ID",
    secret: "YOUR_SECRET",
    userId: "user123",
    onConnected: () {
      print("Connected to DNotifier!");

      // Send a text message
      client.send(
        senderId: "user123",
        receiverId: "user456",
        data: {"text": "Hello from Flutter!"}
      );

      // Send a message to AI
      client.sendAI(
        senderId: "user123",
        message: { text : "Explain DNotifier in simple terms." }
        //message : { messages : [] } 
        // for more details, check official package page
      );

      print("Messages sent!");
    },
    onMessage: (msg) => print("Received: $msg"),
    onDisconnected: (info) => print("Disconnected: $info"),
  );

  await client.connect();
}