Firebase chat API 🔥

Firebase-chat-ready-API is a simple package enable fast connection to firebase realtime database to create chat manager. Create chat rooms, send messages and listen to instance messages .

Getting started in a minute

Installation with

1$ npm install @nezam/firebase-chat-ready-api

Usage

This package have two main classes ChatRoom class and Message class as the ChatRoom class have properties and functions related to the whole chat room such as title, get messages, sending messages, etc ...

and the Message class have properties and functions related to individual message like message body, time of creation, update message, etc ...

First, import it

No ES6

1const {
2	initializeFirebase,
3	ChatRoom
4} = require("@nezam/firebase-chat-ready-api");

ES6

1import { initializeFirebase, ChatRoom } from "@nezam/firebase-chat-ready-api";

Initialize the app

1initializeFirebase({
2	// your firebase app config...
3});

---

Create chat room between two users

1// define users objects
2let userA = {userId: '1'} 
3let userB = {userId: '2'}
4// create chat room 
5let newchatRoom = new ChatRoom("chat title", userA, userB, err => {
6	if (!err) console.log(" chat room created successfully");
7});

This class take 5 params as initial values

1. title the chat room title
2. userA one of the chat room members. object of {userId, username, photo}
3. userB second chat member. object of {userId, username, photo}
4. onComplete it's a callback function called after the chat room created successfully in firebase
5. fromRef create a class for chat room with it's firebase reference

Note: you can get created chat props also in the callback function through:

1var newchatRoom = new ChatRoom("chat title", userA, userB, err => {
2	// get the chat key
3	if (!err) console.log(newchatRoom.chatRoomRef.key);
4});

User Object is consists of

userId: the user unique id required
usename: username for this user not required
photo: url image for this user not required

Note: you can get all of title, members with their props and createdAt bt simply user the chat instance

1newchatRoom.members[0].username;
2newchatRoom.ctreatedAt;
3...

---

Change the chat title

1newchatRoom.setNewTitle("new title", title => {
2	console.log("the chat new title is " + title);
3});

This method is property of ChatRoom class. call with 2 params

1. title as a new string represent the new title
2. onComplete callback after changing the title passing the new title

---

Remove chat room

1newchatRoom.remove();

This method is property of ChatRoom class. call with 2 params

1. softRemove set flag isRemoved to true
2. onComplete callback after removing the chat room

---

Remove mutual chat rooms between two users

1ChatRoom.removeMutualChatRooms('userA Id', 'userB Id');

This method static function call with 2 params

1. userA The id of the user A
2. userB The id of the user B
3. softRemove set flag isRemoved to true

---

Send message in this chat room

You can use the ChatRoom instances to send messages to it.

1var message = newchatRoom.sendMessage("Hi", userA, err => {
2	if (!err) console.log("message sent");
3});

This method also member of ChatRoom class. with 3 params

1. body string is the message body
2. from represent the user how send the message could be user Id or the user object
3. onComplete callback after sending the message to the firbase

this method is return Message instance

---

Get chat rooms related to user

1ChatRoom.getUserChatRooms(userB, {start:5, limit:10}, (err, chats) => {
2	if (!err) console.log("Count of chats is :", chats.length);
3	chats.map(chat => {
4		console.log(chat.members[0].username);
5	});
6});

Note: This method is a static function

Chat rooms is ordered by last modified ones

Please add this rule in your project rules

1 "UsersChat": {
2	"$userId":{
3	".indexOn": "lastModified"
4	}
5}

call with 3 params

1. user the user could be user Id or the user object

2. pagination paginate the returned chat rooms Optional {start: *Number*, limit: *Number*}

3. onComplete callback function call after receiving all chats from firebase passing 2 params

   1. err is the error message if the call failed
   2. chats it's an array ( List ) of all the user chat room (ChatRoom instances)

---

Get messages

1newchatRoom.getMessages({start: 2, limit: 10}, messageList => {
2	messageList.map(m =>{
3		console.log(m.body);
4	})
5});

call 2 params

1. pagination paginate the returned messages Optional {start: *Number*, limit: *Number*}

2. action callback after receiving all messages

   Note : the massages come in list > > Fires only once

---

Listen for new messages coming

1newchatRoom.listenNewMessges( message => {
2	console.log(message.body);
3});

call 1 params

1. action callback function is the action that should happen when receiving a message

   Note : the massages come one after one not in list > This function fires after getting new message

---

Update message

1message.updateBody("new message", newBody => {
2	console.log("message text updated to" + newBody);
3});

This method member of Message class

call with 2 params

1. newBody is the new updated message
2. onComplete callback after update

---

Remove message

1var removedMessage = message.remove();

This method member of Message class

return the deleted message

call with 1 params

1. newMessage is the new updated message string
2. afterRemove callback after removing the message

---

You can get CreatedAt and updatedAt timestamps by message instance

1console.log(message.createdAt);
2// as the updatedAt property not available only after the message get updated
3if (message.updatedAt) {
4	console.log(message.updatedAt);
5}

return timestamp as you can easily format it using package like moment (for more formats)

or by simply use Date Class

1var date = new Date(createdAt);
2// like: 4:01:50 AM
3console.log(date.toLocaleTimeString());
4// like: 10/16/2018
5console.log(date.toLocaleDateString());
6// like: 110/16/2018, 4:01:50 AM
7console.log(date.toLocaleString());

createdAt property available also in ChatRoom instance

---

You can get also the chat room firebase reference(ref) and key. Like this :

1var reference = newchatRoom.chatRoomRef;
2var key = newchatRoom.chatRoomRef.key;

as newchatRoom is an instance of ChatRoom Class

---

Find chat by key (uid)

static function

1ChatRoom.findById("-LPK1Rr5mzwkuSDV9U9a", (err, chat) => {
2	if (!err) console.log(chat);
3});

call with 2 params

1. uid chat unique id (key)

2. onComplete callback function call after receiving all chats from firebase passing 2 params

   1. err is the error message if the call failed
   2. chat chat room (ChatRoom instance)

---

Tests

Tests are using Jest, to run the tests add your firebase config object in the test file and run:

1$ npm test

---

Roadmap

Check out our roadmap to get informed by the latest feature released and the upcoming ones. You can also give us insights and vote for a specific feature. And your are more than welcome to contribute.

---

Note: You probably should change the rules of the firbase to link it correctly

👀 see examples.js