podchat-browser
Advanced tools
Fanap's POD Chat service
All notable changes to this project will be documented here.
In order to see complete list of changelog please visit ChangeLog
Create an Javascript file e.x index.js and put following code there:
var Chat = require('podchat-browser');
var params = {
appId: new Date().getTime(),
grantDeviceIdFromSSO: false,
enableCache: true, // Enable Client side caching
mapApiKey: "API_KEY_OF_NESHAN_MAP", // {**REQUIRED**} API Key of Neshan Map
socketAddress: "ws://172.16.106.26:8003/ws", // {**REQUIRED**} Socket Address
ssoHost: "http://172.16.110.76", // {**REQUIRED**} Socket Address
platformHost: "http://172.16.106.26:8080/hamsam", // {**REQUIRED**} Platform Core Address
fileServer: "http://172.16.106.26:8080/hamsam", // {**REQUIRED**} File Server Address
serverName: "chat-server", // {**REQUIRED**} Server to to register on
token: "SSO_TOKEN", // {**REQUIRED**} SSO Token
wsConnectionWaitTime: 500, // Time out to wait for socket to get ready after open
connectionRetryInterval: 5000, // Time interval to retry registering device or registering server
connectionCheckTimeout: 10000, // Socket connection live time on server
messageTtl: 24 * 60 * 60, // Message time to live (1 day in seonds)
reconnectOnClose: true, // auto connect to socket after socket close
asyncLogging: {
onFunction: true, // log main actions on console
onMessageReceive: true, // log received messages on console
onMessageSend: true, // log sent messaged on console
actualTiming: true // log actual functions running time
},
clientName: 'SDK Default example', // used for logging (Sentry)
};
var chatAgent = new Chat(params);
Listen on these events to get updated data on your client
This is the main Event which fires when your SDK has connected to ASYNC server and gets ready to chat. Write your code in chatReady's callback function
chatAgent.on("chatReady", function() {
/**
* Your code goes here
*/
});
You can get all the Errors here
/**
* Listen to Error Messages
*/
chatAgent.on("error", function(error) {
console.log("Error: ", error.code, error.message);
});
You'll get all the Message Events here
/**
* Listen to Message Events Listener
*/
chatAgent.on("messageEvents", function(event) {
var type = event.type,
message = event.result.message;
switch (type) {
case "MESSAGE_NEW":
/**
* Sending Message Seen to Sender after 5 secs
*/
setTimeout(function() {
chatAgent.seen({messageId: message.id, ownerId: message.ownerId});
}, 5000);
break;
case "MESSAGE_EDIT":
break;
case "MESSAGE_DELIVERY":
break;
case "MESSAGE_SEEN":
break;
default:
break;
}
});
You'll get all the Events which are related to Threads in threadEvents listener
/**
* Listen to Thread Events
*/
chatAgent.on("threadEvents", function(event) {
var type = event.type;
switch (type) {
case "THREAD_LAST_ACTIVITY_TIME":
break;
case "THREAD_NEW":
break;
case "THREAD_ADD_PARTICIPANTS":
break;
case "THREAD_REMOVE_PARTICIPANTS":
break;
case "THREAD_LEAVE_PARTICIPANT":
break;
case "THREAD_RENAME":
break;
case "THREAD_MUTE":
break;
case "THREAD_UNMUTE":
break;
case "THREAD_INFO_UPDATED":
break;
case "THREAD_UNREAD_COUNT_UPDATED":
break;
default:
break;
}
});
You'll get all the Events which are related to File Uploads in fileUploadEvents listener
/**
* Listen to File Uploads Events
*/
chatAgent.on("fileUploadEvents", function(event) {
console.log(event);
});
You'll get all the Events which are related to File Download Events in fileDownloadEvents listener
/**
* Listen to File Download Events
*/
chatAgent.on("fileDownloadEvents", function(event) {
console.log(event);
});
Returns current user's Profile Information
chatAgent.getUserInfo(function(userInfo) {
console.log(userInfo);
});
Takes an Array of user Ids and Returns the time which those users were away in miliseconds
/**
* Get Unseen Duration of users
*
* @param {list} usersIds An array of userIds
*/
chatAgent.getNotSeenDuration({
userIds: [122, 123]
}, function(result) {
console.log(result);
});
var createThreadTypes = {
NORMAL: 0,
OWNER_GROUP: 1,
PUBLIC_GROUP: 2,
CHANNEL_GROUP: 4,
CHANNEL: 8
}
chatAgent.createThread({
title: "Thread Title Sample",
type: "NORMAL",
invitees: [],
image: "http://yoursite.com/image.jpg",
description: "Thread Description",
metadata: {
key: value
}
}, function(createThreadResult) {
console.log(createThreadResult);
}
);
chatAgent.getThreads({
count: 50,
offset: 0,
name: "A String to search in thread titles and return result",
threadIds: [] // Array of threadIds to get
}, function(threadsResult) {
var threads = threadsResult.result.threads;
console.log(threads);
}
);
To get messages list of a thread, you can use getHistory() function. Accepted parameters are listed below:
requireddefault is 50default is 0default is DESC13 digits (like 1547972096473)9 digits (like 473533000)19 digits (like 1547972096473533000)13 digits (like 1547972096473)9 digits (like 473533000)19 digits (like 1547972096473533000)chatAgent.getHistory({
count: 50,
offset: 0,
threadId: threadId
}, function(historyResult) {
var history = historyResult.result.history;
console.log(history);
}
);
This functions clears history of a given thread.
/**
* CLEAR THREAD HISTORY
* @param threadId
*/
chatAgent.clearHistory({
threadId: 1431
}, function(result) {
console.log("Clear history result", result);
});
chatAgent.getThreadParticipants({
count: 50,
offset: 0,
threadId: threadId
}, function(participantsResult) {
var participants = participantsResult.result.participants;
console.log(participants);
}
);
Returns a list of thread admins
chatAgent.getThreadAdmins({
count: 50,
offset: 0,
threadId: threadId
}, function(adminsResult) {
var admins = adminsResult.result.participants;
console.log(admins);
}
);
You can make an user an admin for a thread who is already a participant of that thread. In order to change a participant into
an admin, all you have to do is to call setAdmin() and set parameters as needed.
One important point is that if you set roleOperation parameter as add, the user will grant the roles you gave, and if
you set roleOperation parameter as remove, those roles will be ungranted.
chatAgent.setAdmin({
threadId: 10349,
admins: [
{
userId: 123,
roleOperation: 'add',
roles: [
'post_channel_message',
'edit_message_of_others',
'delete_message_of_others',
'add_new_user',
'remove_user',
'thread_admin',
'add_rule_to_user',
'remove_role_from_user',
'read_thread',
'edit_thread'
]
}]
}, function(result) {
console.log(result);
});
These roles are currently available to be set or unset:
chatAgent.addParticipants({
threadId: threadId,
contacts: [contactId1, contactId2, ...]
}, function(result) {
console.log(result);
});
chatAgent.removeParticipants({
threadId: threadId,
participants: [participantId1, participantId2, ...]
}, function(result) {
console.log(result);
});
chatAgent.leaveThread({
threadId: threadId
}, function(result) {
console.log(result);
});
chatAgent.muteThread({
subjectId: threadId
}, function(result) {
console.log("Threaded has been successfully muted!");
}
);
chatAgent.unMuteThread({
subjectId: threadId
}, function(result) {
console.log("Threaded has been successfully unMuted!");
}
);
chatAgent.renameThread({
title: newName,
threadId: threadId
}, function(result) {
console.log("Threaded has been successfully Renamed!");
}
);
chatAgent.updateThreadInfo({
threadId: threadId,
image: imageUrl,
description: "This is a sample description for a thread",
title: "New title for thread",
metadata: {
name: "John Doe"
}
}, function(result) {
console.log(result);
});
If one who is not in your contacts list, creates a P2P thread including you. You can simply SPAM him/her by calling spamPvThread() and giving it the thread's ID. Notice that the thread must be a P2P thread and the thread owner should not be in your contacts list.
chatAgent.spamPvThread({
threadId: P2PThreadId
}, function(result) {
console.log(result);
});
chatAgent.getContacts({
count: 50,
offset: 0
}, function(contactsResult) {
var contacts = contactsResult.result.contacts;
console.log(contacts);
});
This function return a list of people who you have blocked already.
chatAgent.getBlocked({
count: 50,
offset: 0
}, function(contactsResult) {
if (!result.hasError) {
console.log(result);
}
});
In order to block a contact of yours, you can simply call block() function and give that contact's Id as a parameter.
chatAgent.block({
contactId: 2247,
// threadId: 1018,
// userId: 121
}, function(result) {
if (!result.hasError)
console.log("Contact has been successfully Blocked!");
});
To unblock an already blocked contact, call unblock() function with block Id of that blocked contact.
chatAgent.unblock({
blockId: 425,
// contactId: 2247,
// threadId: 1018,
// userId: 122
}, function(result) {
if (!result.hasError)
console.log("Contact has been successfully unBlocked!");
});
chatAgent.addContacts({
firstName: "Firstname",
lastName: "Lastname",
cellphoneNumber: "0999999999",
email: "mail@gmail.com"
}, function(result) {
console.log(result);
});
chatAgent.updateContacts({
id: 66, //contact's id
firstName: "Firstname", // new firstname
lastName: "Lastname",// new lastname
cellphoneNumber: "0999999999", // new cellphone number
email: "mail@gmail.com" //new email
}, function(result) {
console.log(result);
});
chatAgent.removeContacts({
id: 234 // contact's id
}, function(result) {
console.log(result);
});
To search in contacts list, you can use searchContacts() function. Accepted parameters to search are listed below:
chatAgent.searchContacts({
id: 234 // contact's id
}, function(result) {
console.log(result);
});
chatAgent.sendTextMessage({
threadId: threadId,
content: messageText
}, {
onSent: function(result) {
console.log("\nYour message has been Sent!\n");
console.log(result);
},
onDeliver: function(result) {
console.log("\nYour message has been Delivered!\n");
console.log(result);
},
onSeen: function(result) {
console.log("\nYour message has been Seen!\n");
console.log(result);
}
});
chatAgent.resendMessage(uniqueId, {
onSent: function(result) {
console.log("\nYour message has been Sent!\n");
console.log(result);
},
onDeliver: function(result) {
console.log("\nYour message has been Delivered!\n");
console.log(result);
},
onSeen: function(result) {
console.log("\nYour message has been Seen!\n");
console.log(result);
}
}); // unique id of message to be resent
chatAgent.cancelMessage(uniqueId); // unique id of message to be canceled
chatAgent.getMessageDeliveredList({
messageId: 19623
});
chatAgent.getMessageSeenList({
messageId: 19623
});
chatAgent.editMessage({
messageId: messageId,
content: newMessage
}, {
onSent: function(result) {
console.log("Edited Message has been Sent!");
console.log(result);
},
onDeliver: function(result) {
console.log("Edited Message has been Delivered!");
console.log(result);
},
onSeen: function(result) {
console.log("Edited Message has been Seen!");
console.log(result);
}
});
In order to delete a message for all, set deleteForAll parameter as TRUE.
/**
* DELETE MESSAGE IN THREAD
* @param {int} messageId
* @param {boolean} deleteForAll
*/
chatAgent.deleteMessage({
messageId: messageId,
deleteForAll: false
}, function(result) {
console.log(result);
});
In order to delete an array of messages for all, set deleteForAll parameter as TRUE.
/**
* DELETE MESSAGE IN THREAD
*
* @param {int} messageId
* @param {boolean} deleteForAll
*/
chatAgent.deleteMultipleMessages({
threadId: 10298,
messageIds: [47710, 47709, 47708],
deleteForAll: true
}, function(result) {
console.log("Delete Multiple Message Result", result);
});
chatAgent.replyMessage({
threadId: threadId,
repliedTo: messageId,
content: message
}, {
onSent: function(result) {
console.log("Your reply message has been Sent!");
console.log(result);
},
onDeliver: function(result) {
console.log("Your reply message has been Delivered!");
console.log(result);
},
onSeen: function(result) {
console.log("Your reply message has been Seen!");
console.log(result);
}
});
chatAgent.replyFileMessage({
threadId: threadId,
repliedTo: messageId,
file: file,
content: message
}, {
onSent: function(result) {
console.log("Your reply message has been Sent!");
console.log(result);
},
onDeliver: function(result) {
console.log("Your reply message has been Delivered!");
console.log(result);
},
onSeen: function(result) {
console.log("Your reply message has been Seen!");
console.log(result);
}
});
var messagesIds = [2539, 2538, 2537];
chatAgent.forwardMessage({
subjectId: threadId,
content: JSON.stringify(messagesIds)
}, {
onSent: function(result) {
console.log(result.uniqueId + " \t has been Sent! (FORWARD)");
},
onDeliver: function(result) {
console.log(result.uniqueId + " \t has been Delivered! (FORWARD)");
},
onSeen: function(result) {
console.log(result.uniqueId + " \t has been Seen! (FORWARD)");
}
});
<form>
<fieldset>
<legend>Send File Message</legend>
<input type="file" name="sendFileInput" id="sendFileInput">
<br>
<label for="sendFileDescription">Description: </label>
<input type="text" name="sendFileDescription" id="sendFileDescription">
<button type="button" name="button" id="sendFileMessage">Send</button>
</fieldset>
</form>
document.getElementById("sendFileMessage").addEventListener("click", function() {
var fileInput = document.getElementById("sendFileInput"),
image = fileInput.files[0],
content = document.getElementById("sendFileDescription").value;
chatAgent.sendFileMessage({
threadId: 293,
file: image,
content: content,
metaData: {custom_name: "John Doe"}
}, {
onSent: function(result) {
console.log(result.uniqueId + " \t has been Sent!");
},
onDeliver: function(result) {
console.log(result.uniqueId + " \t has been Delivered!");
},
onSeen: function(result) {
console.log(result.uniqueId + " \t has been Seen!");
}
});
});
If you want to cancel sending of the message with a file upload, You can get uploading file's uniqueId
immediately after calling sendFileMessage() and send it as a parameter to cancelFileUpload()
var instantResult = chatAgent.sendFileMessage({
threadId: 293,
file: image,
content: content
}, {
onSent: function(result) {},
onDeliver: function(result) {},
onSeen: function(result) {}
});
chatAgent.cancelFileUpload({
uniqueId: instantResult.content.file.uniqueId
}, function() {
console.log("File Upload has been Canceled!");
});
<form>
<fieldset>
<legend>Upload File</legend>
<input type="file" name="file" id="fileInput" value="">
<button type="button" name="button" id="uploadFile">Upload File</button>
<br>
<div id="uploadedFile"></div>
</fieldset>
</form>
document.getElementById("uploadFile").addEventListener("click", function() {
var fileInput = document.getElementById("fileInput"),
file = fileInput.files[0];
chatAgent.uploadFile({
file: file,
fileName: "Test Name"
}, function(result) {
if (!result.hasError) {
var file = result.result;
document.getElementById("uploadedFile").innerHTML = "<pre><br>Uploaded File Id: " + file.id + "<br>Uploaded File Name : " + file.name + "<br>Uploaded File HashCode : " + file.hashCode + "</pre>";
}
});
});
<form>
<fieldset>
<legend>Upload Image</legend>
<input type="file" name="image" id="imageInput" value="">
<button type="button" name="button" id="uploadImage">Upload Image</button>
<br>
<img id="uploadedImage" />
<div id="uploadedImageData"></div>
</fieldset>
</form>
document.getElementById("uploadImage").addEventListener("click", function() {
var imageInput = document.getElementById("imageInput"),
image = imageInput.files[0];
chatAgent.uploadImage({
image: image,
fileName: "Test Name",
xC: 0,
yC: 0,
hC: 800,
wC: 800
}, function(result) {
if (!result.hasError) {
var image = result.result;
document.getElementById("uploadedImage").src = "http://172.16.106.26:8080/hamsam/nzh/image?imageId=" + image.id + "&hashCode=" + image.hashCode;
document.getElementById("uploadedImageData").innerHTML = "<pre><br>Uploaded Image Id: " + image.id + "<br>Uploaded Image Name : " + image.name + "<br>Uploaded Image HashCode : " + image.hashCode + "</pre>";
}
});
});
chatAgent.getFile({
fileId: fileId,
hashCode: hashCode,
downloadable: true
}, function(result) {
if (!result.hasError) {
var file = result.result;
}
});
chatAgent.getImage({
imageId: imageId,
hashCode: hashCode,
downloadable: true,
actual: true
}, function(result) {
if (!result.hasError) {
var image = result.result;
}
});
To indicate that some one is currently typing in some specific thread, you can use startTyping() and stopTyping()
This function sets an interval and sends isTyping system message to server every 1 second
/**
* Sending isTyping message to server with an interval of 1 sec
*
* @param {int} threadId Id of thread that user is typing in
*/
chatAgent.startTyping({
threadId: 1431
});
Because user can only type in one thread at time, so there will be only one isTypingInterval available. This function clears it and stops sending the system messages.
/**
* Stops Sending isTyping message to server
*/
chatAgent.stopTyping();
This function takes a Geo Location and returns its address back
/**
* Get Address of a GeoLocation point
*
* @param {float} lat Latitute of the Location
* @param {float} lng Longtitute of the Location
*/
chatAgent.mapReverse({
lat: 35.7003508,
lng: 51.3376460
}, function(result) {
console.log(result);
});
This function takes a Geo Location and a Search term and returns an array of Nearby places containing that search term
/**
* Get nearby places names as "term" keyword
* around the given GeoLocation
*
* @param {float} lat Latitute of the Location
* @param {float} lng Longtitute of the Location
* @param {string} term Search term to be searched
*/
chatAgent.mapSearch({
lat: 35.7003508,
lng: 51.3376460,
term: "فروشگاه"
}, function(result) {
console.log(result);
});
This function takes two Geo Locations and returns the route between them
/**
* Get routing between two given GeoLocations
*
* @param {object} origin Lat & Lng of Origin as a JSON
* @param {object} destination Lat & Lng of Destination as a JSON
* @param {boolean} alternative Give Alternative Routs too
*/
chatAgent.mapRouting({
origin: {
lat: 35.7003508,
lng: 51.3376460
},
destination: {
lat: 35.7343510,
lng: 50.3376472
},
alternative: true
}, function(result) {
console.log(result);
});
This function takes a Geo Locations and returns the link of static map image related that area
/**
* Get Static Image of a GeoLocation
*
* @param {string} type Map style (default standard-night)
* @param {int} zoom Map zoom (default 15)
* @param {object} center Lat & Lng of Map center as a JSON
* @param {int} width width of image in pixels (default 800px)
* @param {int} height height of image in pixels (default 600px)
*/
chatAgent.mapStaticImage({
type: "standard-night",
zoom: 15,
center: {
lat: 35.7003508,
lng: 51.3376462
},
width: 800,
height: 500
}, function(result) {
console.log(result);
});
npm install podchat --save
npm test
You can send me your thoughts about making this repo great :) Email
Under MIT License.
A very special thanks to Ali Khanbabaei (khanbabaeifanap), who wrote the early version of chat service and helped me a lot with this repo.
FAQs
Javascript SDK to use POD's Chat Service - Browser Only
The npm package podchat-browser receives a total of 89 weekly downloads. As such, podchat-browser popularity was classified as not popular.
We found that podchat-browser demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
A malicious npm package disguised as a WhatsApp client is exploiting authentication flows with a remote kill switch to exfiltrate data and destroy files.
Security News
PyPI now supports digital attestations, enhancing security and trust by allowing package maintainers to verify the authenticity of Python packages.
Security News
GitHub removed 27 malicious pull requests attempting to inject harmful code across multiple open source repositories, in another round of low-effort attacks.