From b48fd4789a4b1cd331429db9a9deb60cdbdb7154 Mon Sep 17 00:00:00 2001 From: Abe Haskins Date: Sat, 14 May 2016 15:57:24 -0700 Subject: [PATCH 01/22] Updates for SDK 3.0.0 --- README.md | 45 +++++++--------------------------- src/js/firechat.js | 56 +++++++++++++++++++++++++++++++++---------- website/docs/index.md | 50 ++++++++++++++++++-------------------- 3 files changed, 76 insertions(+), 75 deletions(-) diff --git a/README.md b/README.md index 541603d..743872c 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ [![Version](https://badge.fury.io/gh/firebase%2Ffirechat.svg)](http://badge.fury.io/gh/firebase%2Ffirechat) -Firechat is a simple, extensible chat widget powered by [Firebase](https://www.firebase.com/?utm_source=firechat). +Firechat is a simple, extensible chat widget powered by [Firebase](https://firebase.google.com/?utm_source=firechat). It is intended to serve as a concise, documented foundation for chat products built on Firebase. It works out of the box, and is easily extended. @@ -14,7 +14,7 @@ Visit [firechat.firebaseapp.com](https://firechat.firebaseapp.com/) to see a liv ## Setup -Firechat uses [Firebase](https://www.firebase.com/?utm_source=firechat) as a backend, so it requires no server-side +Firechat uses [Firebase](https://firebase.google.com/) as a backend, so it requires no server-side code. It can be added to any web app by including a few JavaScript files ```HTML @@ -22,39 +22,13 @@ code. It can be added to any web app by including a few JavaScript files - + - - + + ``` -giving your users a way to authenticate - -```HTML - - -Login with Twitter -``` - and initializing the chat. ```HTML @@ -73,12 +47,11 @@ For detailed integration instructions, see the [Firechat documentation](https:// ## Getting Started with Firebase Firechat requires Firebase in order to store data. You can -[sign up here](https://www.firebase.com/signup/?utm_source=firechat) for a free account. +[sign up here](https://firebase.google.com) for a free account. ## Getting Help -If you have a question about Firechat, search the -[Firebase tag on Stack Overflow](http://stackoverflow.com/questions/tagged/firebase) to see if it has already been -answered. If it hasn't been asked, post a [new question](http://stackoverflow.com/questions/ask?tags=firebase+firechat). +If you have a question about Firechat, search the +[Firebase tag on Stack Overflow](http://stackoverflow.com/questions/tagged/firebase) to see if it has already been +answered. If it hasn't been asked, post a [new question](http://stackoverflow.com/questions/ask?tags=firebase+firechat). We keep a close eye on those tags, and will answer your question soon. - diff --git a/src/js/firechat.js b/src/js/firechat.js index 4f62f6e..811e101 100644 --- a/src/js/firechat.js +++ b/src/js/firechat.js @@ -97,12 +97,12 @@ // Initialize Firebase listeners and callbacks for the supported bindings. _setupDataEvents: function() { // Monitor connection state so we can requeue disconnect operations if need be. - this._firebase.root().child('.info/connected').on('value', function(snapshot) { + this.getRoot(this._firebase).child('.info/connected').on('value', function(snapshot) { if (snapshot.val() === true) { // We're connected (or reconnected)! Set up our presence state. for (var i = 0; i < this._presenceBits; i++) { var op = this._presenceBits[i], - ref = this._firebase.root().child(op.ref); + ref = this.getRoot(this._firebase).child(op.ref); ref.onDisconnect().set(op.offlineValue); ref.set(op.onlineValue); @@ -112,7 +112,7 @@ // Generate a unique session id for the visit. var sessionRef = this._userRef.child('sessions').push(); - this._sessionId = sessionRef.key(); + this._sessionId = this.getKey(sessionRef); this._queuePresenceOperation(sessionRef, true, null); // Register our username in the public user listing. @@ -196,11 +196,11 @@ }, _onNewMessage: function(roomId, snapshot) { var message = snapshot.val(); - message.id = snapshot.key(); + message.id = Firechat.prototype.getKey(snapshot); this._invokeEventCallbacks('message-add', roomId, message); }, _onRemoveMessage: function(roomId, snapshot) { - var messageId = snapshot.key(); + var messageId = Firechat.prototype.getKey(snapshot); this._invokeEventCallbacks('message-remove', roomId, messageId); }, _onLeaveRoom: function(roomId) { @@ -212,7 +212,7 @@ var notification = snapshot.val(); if (!notification.read) { if (notification.notificationType !== 'suspension' || notification.data.suspendedUntil < new Date().getTime()) { - snapshot.ref().child('read').set(true); + snapshot.ref.child('read').set(true); } this._invokeEventCallbacks('notification', notification); } @@ -228,7 +228,7 @@ return; } - invite.id = invite.id || snapshot.key(); + invite.id = invite.id || self.getKey(snapshot); self.getRoom(invite.roomId, function(room) { invite.toRoomName = room.name; self._invokeEventCallbacks('room-invite', invite); @@ -238,7 +238,7 @@ var self = this, invite = snapshot.val(); - invite.id = invite.id || snapshot.key(); + invite.id = invite.id || self.getKey(snapshot); this._invokeEventCallbacks('room-invite-response', invite); } }; @@ -288,7 +288,7 @@ newRoomRef = this._roomRef.push(); var newRoom = { - id: newRoomRef.key(), + id: self.getKey(newRoomRef), name: roomName, type: roomType || 'public', createdByUserId: this._userId, @@ -302,10 +302,10 @@ newRoomRef.set(newRoom, function(error) { if (!error) { - self.enterRoom(newRoomRef.key()); + self.enterRoom(self.getKey(newRoomRef)); } if (callback) { - callback(newRoomRef.key()); + callback(self.getKey(newRoomRef)); } }); }; @@ -475,7 +475,7 @@ sendInvite = function() { var inviteRef = self._firebase.child('users').child(userId).child('invites').push(); inviteRef.set({ - id: inviteRef.key(), + id: self.getKey(inviteRef), fromUserId: self._userId, fromUserName: self._userName, roomId: roomId @@ -639,4 +639,36 @@ } } }; + + Firechat.prototype.getKey = function(snapshot) { + var key; + if (typeof snapshot.key === 'function') { + key = snapshot.key(); + } else if (typeof snapshot.key === 'string') { + key = snapshot.key; + } else { + key = snapshot.name(); + } + return key; + }; + + Firechat.prototype.getRef = (snapshotOrRef) { + var ref; + if (typeof snapshotOrRef.ref === 'function') { + ref = snapshotOrRef.ref(); + } else { + ref = snapshotOrRef.ref; + } + return ref; + }; + + Firechat.prototype.getRoot = (snapshotOrRef) { + var ref; + if (typeof snapshotOrRef.root === 'function') { + ref = snapshotOrRef.root(); + } else { + ref = snapshotOrRef.root; + } + return ref; + }; })(Firebase); diff --git a/website/docs/index.md b/website/docs/index.md index b4f9cd1..e29619a 100644 --- a/website/docs/index.md +++ b/website/docs/index.md @@ -5,7 +5,7 @@ layout: docs ### Overview -Firechat is a simple, extensible chat widget powered by [Firebase](https://firebase.com/?utm_source=docs&utm_medium=site&utm_campaign=firechat). +Firechat is a simple, extensible chat widget powered by [Firebase](https://firebase.google.com). It is intended to serve as a concise, documented foundation for chat products built on Firebase. It works out of the box, and is easily extended. @@ -26,17 +26,17 @@ In order to use Firechat in your project, you need to include the following file - + - - + + {% endhighlight %} Use the URLs above to download both the minified and non-minified versions of the Firechat JavaScript and CSS files from the Firebase CDN. You can also download them from the [releases page of the Firechat GitHub repository](https://github.com/firebase/firechat/releases). -[Firebase](https://www.firebase.com/docs/web/quickstart.html?utm_source=firechat) and +[Firebase Database](https://firebase.google.com/docs/database/web/start) and [jQuery](https://code.jquery.com/) can be downloaded directly from their respective websites. You can also install Firechat via npm or Bower and its dependencies will be downloaded @@ -50,10 +50,10 @@ $ npm install firechat --save $ bower install firechat --save ``` -#### Getting Started with Firebase +#### Getting Started with the Firebase Realtime Database Firechat requires Firebase in order to sync and store data. You can -[sign up here for a free account](https://www.firebase.com/signup/?utm_medium=web&utm_source=firechat). +[sign up here for a free account](https://firebase.google.com). #### Short Example @@ -72,16 +72,16 @@ Let's put it all together, using Twitter authentication in our example: - + - + - - - - - - - + + + + + + + + + - - -
- +
+ + From 38bb16abc90c28c70f0cbbce86cafc9af9f17c48 Mon Sep 17 00:00:00 2001 From: cmosguy Date: Mon, 30 May 2016 00:36:18 -0700 Subject: [PATCH 04/22] trying to get teh app to work in version 3.0.3 --- website/index.html | 2 -- 1 file changed, 2 deletions(-) diff --git a/website/index.html b/website/index.html index bd9e52d..440a044 100644 --- a/website/index.html +++ b/website/index.html @@ -225,8 +225,6 @@

Authenticate to continue

storageBucket: "firechat-2ed14.appspot.com", }; - Firebase = firebase; - // var chatRef = new Firebase('firechat-2ed14.firebaseio.com'), var chatRef = firebase.initializeApp(config), target = document.getElementById("firechat-container"), From 942b238620bc849ead6cfa4aa73c4ba44d3cab19 Mon Sep 17 00:00:00 2001 From: cmosguy Date: Mon, 30 May 2016 01:19:32 -0700 Subject: [PATCH 05/22] still fiddling with v3.0.3 sdk --- src/js/firechat.js | 12 ++++++------ website/firechat/firechat.js | 12 ++++++------ website/index.html | 15 +++++++++------ 3 files changed, 21 insertions(+), 18 deletions(-) diff --git a/src/js/firechat.js b/src/js/firechat.js index 90b16fb..1884296 100644 --- a/src/js/firechat.js +++ b/src/js/firechat.js @@ -45,12 +45,12 @@ // Commonly-used Firebase references. this._userRef = null; - this._messageRef = this._firebase.child('room-messages'); - this._roomRef = this._firebase.child('room-metadata'); - this._privateRoomRef = this._firebase.child('room-private-metadata'); - this._moderatorsRef = this._firebase.child('moderators'); - this._suspensionsRef = this._firebase.child('suspensions'); - this._usersOnlineRef = this._firebase.child('user-names-online'); + this._messageRef = this._firebase.database().ref().child('room-messages'); + this._roomRef = this._firebase.database().ref().child('room-metadata'); + this._privateRoomRef = this._firebase.database().ref().child('room-private-metadata'); + this._moderatorsRef = this._firebase.database().ref().child('moderators'); + this._suspensionsRef = this._firebase.database().ref().child('suspensions'); + this._usersOnlineRef = this._firebase.database().ref().child('user-names-online'); // Setup and establish default options. this._options = options || {}; diff --git a/website/firechat/firechat.js b/website/firechat/firechat.js index a16cf52..cd49d7c 100644 --- a/website/firechat/firechat.js +++ b/website/firechat/firechat.js @@ -122,12 +122,12 @@ this["FirechatDefaultTemplates"]["templates/user-search-list-item.html"] = funct // Commonly-used Firebase references. this._userRef = null; - this._messageRef = this._firebase.child('room-messages'); - this._roomRef = this._firebase.child('room-metadata'); - this._privateRoomRef = this._firebase.child('room-private-metadata'); - this._moderatorsRef = this._firebase.child('moderators'); - this._suspensionsRef = this._firebase.child('suspensions'); - this._usersOnlineRef = this._firebase.child('user-names-online'); + this._messageRef = this._firebase.database().ref().child('room-messages'); + this._roomRef = this._firebase.database().ref().child('room-metadata'); + this._privateRoomRef = this._firebase.database().ref().child('room-private-metadata'); + this._moderatorsRef = this._firebase.database().ref().child('moderators'); + this._suspensionsRef = this._firebase.database().ref().child('suspensions'); + this._usersOnlineRef = this._firebase.database().ref().child('user-names-online'); // Setup and establish default options. this._options = options || {}; diff --git a/website/index.html b/website/index.html index 440a044..3789761 100644 --- a/website/index.html +++ b/website/index.html @@ -226,10 +226,10 @@

Authenticate to continue

}; // var chatRef = new Firebase('firechat-2ed14.firebaseio.com'), - var chatRef = firebase.initializeApp(config), - target = document.getElementById("firechat-container"), - authModal = $('#auth-modal').modal({show: false}), - chat = new FirechatUI(chatRef, target); + var chatRef = firebase.initializeApp(config); + var target = document.getElementById("firechat-container"); + var authModal = $('#auth-modal').modal({show: false}); + var chat = new FirechatUI(chatRef, target); chat.on('auth-required', function () { authModal.modal('show'); @@ -263,8 +263,11 @@

Authenticate to continue

} function logout() { - chatRef.unauth(); - location.reload(); + chatRef.auth().signOut().then(function(){ + location.reload(); + }, function(error){ + console.log('could not logout' + error); + }); } From b8f4a2bdf8a0d791c337f2bf82f217f42713adf1 Mon Sep 17 00:00:00 2001 From: cmosguy Date: Mon, 30 May 2016 02:09:40 -0700 Subject: [PATCH 06/22] my final check in woo hoo! --- src/js/firechat.js | 26 +++++++++++++------------- website/firechat/firechat.js | 26 +++++++++++++------------- website/index.html | 35 +++++++++++++++++++++++------------ 3 files changed, 49 insertions(+), 38 deletions(-) diff --git a/src/js/firechat.js b/src/js/firechat.js index 1884296..e7de84a 100644 --- a/src/js/firechat.js +++ b/src/js/firechat.js @@ -97,12 +97,12 @@ // Initialize Firebase listeners and callbacks for the supported bindings. _setupDataEvents: function() { // Monitor connection state so we can requeue disconnect operations if need be. - this.getRoot(this._firebase).child('.info/connected').on('value', function(snapshot) { + this.getRoot(this._firebase.database().ref()).child('.info/connected').on('value', function(snapshot) { if (snapshot.val() === true) { // We're connected (or reconnected)! Set up our presence state. for (var i = 0; i < this._presenceBits; i++) { var op = this._presenceBits[i], - ref = this.getRoot(this._firebase).child(op.ref); + ref = this.getRoot(this._firebase.database().ref()).child(op.ref); ref.onDisconnect().set(op.offlineValue); ref.set(op.onlineValue); @@ -250,11 +250,11 @@ Firechat.prototype.setUser = function(userId, userName, callback) { var self = this; - self._firebase.onAuth(function(authData) { + self._firebase.auth().onAuthStateChanged(function(authData) { if (authData) { self._userId = userId.toString(); self._userName = userName.toString(); - self._userRef = self._firebase.child('users').child(self._userId); + self._userRef = self._firebase.database().ref().child('users').child(self._userId); self._loadUserMetadata(function() { root.setTimeout(function() { callback(self._user); @@ -301,7 +301,7 @@ name: roomName, type: roomType || 'public', createdByUserId: this._userId, - createdAt: Firebase.ServerValue.TIMESTAMP + createdAt: firebase.database.ServerValue.TIMESTAMP }; if (roomType === 'private') { @@ -343,7 +343,7 @@ }); // Set presence bit for the room and queue it for removal on disconnect. - var presenceRef = self._firebase.child('room-users').child(roomId).child(self._userId).child(self._sessionId); + var presenceRef = self._firebase.database().ref().child('room-users').child(roomId).child(self._userId).child(self._sessionId); self._queuePresenceOperation(presenceRef, { id: self._userId, name: self._userName @@ -372,7 +372,7 @@ // Leave a chat room. Firechat.prototype.leaveRoom = function(roomId) { var self = this, - userRoomRef = self._firebase.child('room-users').child(roomId); + userRoomRef = self._firebase.database().ref().child('room-users').child(roomId); // Remove listener for new messages to this room. self._messageRef.child(roomId).off(); @@ -398,7 +398,7 @@ message = { userId: self._userId, name: self._userName, - timestamp: Firebase.ServerValue.TIMESTAMP, + timestamp: firebase.database.ServerValue.TIMESTAMP, message: messageContent, type: messageType || 'default' }, @@ -413,7 +413,7 @@ } newMessageRef = self._messageRef.child(roomId).push(); - newMessageRef.setWithPriority(message, Firebase.ServerValue.TIMESTAMP, cb); + newMessageRef.setWithPriority(message, firebase.database.ServerValue.TIMESTAMP, cb); }; Firechat.prototype.deleteMessage = function(roomId, messageId, cb) { @@ -444,11 +444,11 @@ // Send a moderator notification to a specific user. Firechat.prototype.sendSuperuserNotification = function(userId, notificationType, data, cb) { var self = this, - userNotificationsRef = self._firebase.child('users').child(userId).child('notifications'); + userNotificationsRef = self._firebase.database().ref().child('users').child(userId).child('notifications'); userNotificationsRef.push({ fromUserId: self._userId, - timestamp: Firebase.ServerValue.TIMESTAMP, + timestamp: firebase.database.ServerValue.TIMESTAMP, notificationType: notificationType, data: data || {} }, cb); @@ -482,7 +482,7 @@ Firechat.prototype.inviteUser = function(userId, roomId) { var self = this, sendInvite = function() { - var inviteRef = self._firebase.child('users').child(userId).child('invites').push(); + var inviteRef = self._firebase.database().ref().child('users').child(userId).child('invites').push(); inviteRef.set({ id: self.getKey(inviteRef), fromUserId: self._userId, @@ -551,7 +551,7 @@ Firechat.prototype.getUsersByRoom = function() { var self = this, roomId = arguments[0], - query = self._firebase.child('room-users').child(roomId), + query = self._firebase.database().ref().child('room-users').child(roomId), cb = arguments[arguments.length - 1], limit = null; diff --git a/website/firechat/firechat.js b/website/firechat/firechat.js index cd49d7c..c48800d 100644 --- a/website/firechat/firechat.js +++ b/website/firechat/firechat.js @@ -174,12 +174,12 @@ this["FirechatDefaultTemplates"]["templates/user-search-list-item.html"] = funct // Initialize Firebase listeners and callbacks for the supported bindings. _setupDataEvents: function() { // Monitor connection state so we can requeue disconnect operations if need be. - this.getRoot(this._firebase).child('.info/connected').on('value', function(snapshot) { + this.getRoot(this._firebase.database().ref()).child('.info/connected').on('value', function(snapshot) { if (snapshot.val() === true) { // We're connected (or reconnected)! Set up our presence state. for (var i = 0; i < this._presenceBits; i++) { var op = this._presenceBits[i], - ref = this.getRoot(this._firebase).child(op.ref); + ref = this.getRoot(this._firebase.database().ref()).child(op.ref); ref.onDisconnect().set(op.offlineValue); ref.set(op.onlineValue); @@ -327,11 +327,11 @@ this["FirechatDefaultTemplates"]["templates/user-search-list-item.html"] = funct Firechat.prototype.setUser = function(userId, userName, callback) { var self = this; - self._firebase.onAuth(function(authData) { + self._firebase.auth().onAuthStateChanged(function(authData) { if (authData) { self._userId = userId.toString(); self._userName = userName.toString(); - self._userRef = self._firebase.child('users').child(self._userId); + self._userRef = self._firebase.database().ref().child('users').child(self._userId); self._loadUserMetadata(function() { root.setTimeout(function() { callback(self._user); @@ -378,7 +378,7 @@ this["FirechatDefaultTemplates"]["templates/user-search-list-item.html"] = funct name: roomName, type: roomType || 'public', createdByUserId: this._userId, - createdAt: Firebase.ServerValue.TIMESTAMP + createdAt: firebase.database.ServerValue.TIMESTAMP }; if (roomType === 'private') { @@ -420,7 +420,7 @@ this["FirechatDefaultTemplates"]["templates/user-search-list-item.html"] = funct }); // Set presence bit for the room and queue it for removal on disconnect. - var presenceRef = self._firebase.child('room-users').child(roomId).child(self._userId).child(self._sessionId); + var presenceRef = self._firebase.database().ref().child('room-users').child(roomId).child(self._userId).child(self._sessionId); self._queuePresenceOperation(presenceRef, { id: self._userId, name: self._userName @@ -449,7 +449,7 @@ this["FirechatDefaultTemplates"]["templates/user-search-list-item.html"] = funct // Leave a chat room. Firechat.prototype.leaveRoom = function(roomId) { var self = this, - userRoomRef = self._firebase.child('room-users').child(roomId); + userRoomRef = self._firebase.database().ref().child('room-users').child(roomId); // Remove listener for new messages to this room. self._messageRef.child(roomId).off(); @@ -475,7 +475,7 @@ this["FirechatDefaultTemplates"]["templates/user-search-list-item.html"] = funct message = { userId: self._userId, name: self._userName, - timestamp: Firebase.ServerValue.TIMESTAMP, + timestamp: firebase.database.ServerValue.TIMESTAMP, message: messageContent, type: messageType || 'default' }, @@ -490,7 +490,7 @@ this["FirechatDefaultTemplates"]["templates/user-search-list-item.html"] = funct } newMessageRef = self._messageRef.child(roomId).push(); - newMessageRef.setWithPriority(message, Firebase.ServerValue.TIMESTAMP, cb); + newMessageRef.setWithPriority(message, firebase.database.ServerValue.TIMESTAMP, cb); }; Firechat.prototype.deleteMessage = function(roomId, messageId, cb) { @@ -521,11 +521,11 @@ this["FirechatDefaultTemplates"]["templates/user-search-list-item.html"] = funct // Send a moderator notification to a specific user. Firechat.prototype.sendSuperuserNotification = function(userId, notificationType, data, cb) { var self = this, - userNotificationsRef = self._firebase.child('users').child(userId).child('notifications'); + userNotificationsRef = self._firebase.database().ref().child('users').child(userId).child('notifications'); userNotificationsRef.push({ fromUserId: self._userId, - timestamp: Firebase.ServerValue.TIMESTAMP, + timestamp: firebase.database.ServerValue.TIMESTAMP, notificationType: notificationType, data: data || {} }, cb); @@ -559,7 +559,7 @@ this["FirechatDefaultTemplates"]["templates/user-search-list-item.html"] = funct Firechat.prototype.inviteUser = function(userId, roomId) { var self = this, sendInvite = function() { - var inviteRef = self._firebase.child('users').child(userId).child('invites').push(); + var inviteRef = self._firebase.database().ref().child('users').child(userId).child('invites').push(); inviteRef.set({ id: self.getKey(inviteRef), fromUserId: self._userId, @@ -628,7 +628,7 @@ this["FirechatDefaultTemplates"]["templates/user-search-list-item.html"] = funct Firechat.prototype.getUsersByRoom = function() { var self = this, roomId = arguments[0], - query = self._firebase.child('room-users').child(roomId), + query = self._firebase.database().ref().child('room-users').child(roomId), cb = arguments[arguments.length - 1], limit = null; diff --git a/website/index.html b/website/index.html index 3789761..e806303 100644 --- a/website/index.html +++ b/website/index.html @@ -195,7 +195,7 @@

Authenticate to continue

- +

@@ -236,10 +236,12 @@

Authenticate to continue

return false; }); - chatRef.onAuth(function (authData) { + chatRef.auth().onAuthStateChanged(function(authData){ + console.log('onAuthStateChanged!'); + if (authData) { var userId = authData.uid, - username = authData[authData.provider].displayName; + username = authData.providerData[0].displayName; chat.setUser(userId, username); $('#user-name').text(username); @@ -253,20 +255,29 @@

Authenticate to continue

} }); - function login(provider) { + + function login() { authModal.modal('hide'); - chatRef.authWithOAuthPopup(provider, function (error, authData) { - if (error) { - console.log(error); - } - }); + + var provider = new firebase.auth.TwitterAuthProvider(); + chatRef.auth().signInWithPopup(provider) + .then(function(authData){ + console.log('logged in using twitter'); + + }) + .catch(function (error) { + if (error) { + console.log(error); + } + } + ); } function logout() { - chatRef.auth().signOut().then(function(){ + chatRef.auth().signOut().then(function () { location.reload(); - }, function(error){ - console.log('could not logout' + error); + }, function (error) { + console.log('could not logout' + error); }); } From 6c8f0f3e6ce93426b2f968ff4870326ca47f3ee0 Mon Sep 17 00:00:00 2001 From: Jacob Wenger Date: Mon, 13 Jun 2016 22:39:46 -0700 Subject: [PATCH 07/22] Removed support email from bower.json --- bower.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/bower.json b/bower.json index c4dfa5c..547ab5a 100644 --- a/bower.json +++ b/bower.json @@ -3,7 +3,7 @@ "description": "Realtime open source chat client powered by Firebase", "version": "0.0.0", "authors": [ - "Firebase (https://www.firebase.com/)" + "Firebase (https://firebase.google.com/)" ], "homepage": "https://firechat.firebaseapp.com/", "repository": { From caffa909451cbf99149b7216fb5c0806e2a8d990 Mon Sep 17 00:00:00 2001 From: Jacob Wenger Date: Mon, 13 Jun 2016 22:40:14 -0700 Subject: [PATCH 08/22] Removed support email from package.json --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index 8a7a986..4e358d7 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "firechat", "description": "Realtime open source chat client powered by Firebase", "version": "0.0.0", - "author": "Firebase (https://www.firebase.com/)", + "author": "Firebase (https://firebase.google.com/)", "homepage": "https://firechat.firebaseapp.com/", "repository": { "type": "git", From 6a7068f7c43dc527eeec3182ce87d1d50c482e39 Mon Sep 17 00:00:00 2001 From: "N. J. Perez" Date: Wed, 17 Aug 2016 09:09:01 +0300 Subject: [PATCH 09/22] Updated LICENSE to 2016 (#65) --- LICENSE | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/LICENSE b/LICENSE index b9b77e9..e2d638c 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ The MIT License (MIT) -Copyright (c) 2015 Firebase +Copyright (c) 2016 Firebase Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal From 946cd45a494ff37c7f775c5b43ecac66b2e24fbd Mon Sep 17 00:00:00 2001 From: jwngr Date: Tue, 16 Aug 2016 23:38:06 -0700 Subject: [PATCH 10/22] Cleaned up README.md --- README.md | 73 +++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 50 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index 743872c..8b25077 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,9 @@ -# Firechat +# Firechat [![Version](https://badge.fury.io/gh/firebase%2Ffirechat.svg)](http://badge.fury.io/gh/firebase%2Ffirechat) -[![Version](https://badge.fury.io/gh/firebase%2Ffirechat.svg)](http://badge.fury.io/gh/firebase%2Ffirechat) - -Firechat is a simple, extensible chat widget powered by [Firebase](https://firebase.google.com/?utm_source=firechat). -It is intended to serve as a concise, documented foundation for chat products built on Firebase. -It works out of the box, and is easily extended. +Firechat is a simple, extensible chat widget powered by +[Firebase](https://firebase.google.com/?utm_source=firechat). It is intended to serve as a concise, +documented foundation for chat products built on Firebase. It works out of the box, and is easily +extended. ## Live Demo @@ -14,29 +13,59 @@ Visit [firechat.firebaseapp.com](https://firechat.firebaseapp.com/) to see a liv ## Setup -Firechat uses [Firebase](https://firebase.google.com/) as a backend, so it requires no server-side -code. It can be added to any web app by including a few JavaScript files +Firechat uses the [Firebase Realtime Database](https://firebase.google.com/docs/database/?utm_source=firechat) +as a backend, so it requires no server-side code. It can be added to any web app by including a few +JavaScript files: ```HTML - + - + - - + + +``` + +giving your users a way to authenticate: + +```HTML + + + ``` -and initializing the chat. +and initializing the chat: ```HTML
@@ -46,12 +75,10 @@ For detailed integration instructions, see the [Firechat documentation](https:// ## Getting Started with Firebase -Firechat requires Firebase in order to store data. You can -[sign up here](https://firebase.google.com) for a free account. +Firechat requires Firebase in order to authenticate users and store data. You can +[sign up here](https://console.firebase.google.com/?utm_source=firechat) for a free account. ## Getting Help -If you have a question about Firechat, search the -[Firebase tag on Stack Overflow](http://stackoverflow.com/questions/tagged/firebase) to see if it has already been -answered. If it hasn't been asked, post a [new question](http://stackoverflow.com/questions/ask?tags=firebase+firechat). -We keep a close eye on those tags, and will answer your question soon. +If you have a question about Firechat, feel free to reach out through one of our +[official support channels](https://firebase.google.com/support/?utm_source=firechat). From 918167197b78a65197c68d803602d0187443ac11 Mon Sep 17 00:00:00 2001 From: jwngr Date: Tue, 16 Aug 2016 23:40:49 -0700 Subject: [PATCH 11/22] Updated bower.json and package.json --- bower.json | 4 ++-- package.json | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/bower.json b/bower.json index 5274c81..6310730 100644 --- a/bower.json +++ b/bower.json @@ -3,7 +3,7 @@ "description": "Realtime open source chat client powered by Firebase", "version": "0.0.0", "authors": [ - "Firebase (https://www.firebase.com/)" + "Firebase (https://firebase.google.com/)" ], "homepage": "https://firechat.firebaseapp.com/", "repository": { @@ -31,6 +31,6 @@ "changelog.txt" ], "dependencies": { - "firebase": "3.0.x" + "firebase": "3.x.x" } } diff --git a/package.json b/package.json index c13e74f..6c4ef83 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "firechat", "description": "Realtime open source chat client powered by Firebase", "version": "0.0.0", - "author": "Firebase (https://www.firebase.com/)", + "author": "Firebase (https://firebase.google.com/)", "homepage": "https://firechat.firebaseapp.com/", "repository": { "type": "git", @@ -33,7 +33,7 @@ "package.json" ], "dependencies": { - "firebase": "3.0.x" + "firebase": "3.x.x" }, "devDependencies": { "grunt": "~0.4.0", From 808ff5ca40f90eac736143151adcff52d0022b6b Mon Sep 17 00:00:00 2001 From: jwngr Date: Fri, 19 Aug 2016 21:41:44 -0700 Subject: [PATCH 12/22] Updated website/ folder --- website/LICENSE | 2 +- website/docs/index.md | 138 +-- website/firechat/firechat.js | 1913 ---------------------------------- website/index.html | 453 ++++---- 4 files changed, 274 insertions(+), 2232 deletions(-) delete mode 100644 website/firechat/firechat.js diff --git a/website/LICENSE b/website/LICENSE index 915fbfe..e2d638c 100644 --- a/website/LICENSE +++ b/website/LICENSE @@ -1,6 +1,6 @@ The MIT License (MIT) -Copyright (c) 2014 Firebase +Copyright (c) 2016 Firebase Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/website/docs/index.md b/website/docs/index.md index e29619a..e93ab54 100644 --- a/website/docs/index.md +++ b/website/docs/index.md @@ -5,9 +5,11 @@ layout: docs ### Overview -Firechat is a simple, extensible chat widget powered by [Firebase](https://firebase.google.com). +Firechat is a simple, extensible chat widget powered by +[Firebase](https://firebase.google.com/?utm_source=firechat). -It is intended to serve as a concise, documented foundation for chat products built on Firebase. It works out of the box, and is easily extended. +It is intended to serve as a concise, documented foundation for chat products built on Firebase. It +works out of the box, and is easily extended. @@ -23,22 +25,16 @@ In order to use Firechat in your project, you need to include the following file {% highlight html %} - + - + - - + + {% endhighlight %} -Use the URLs above to download both the minified and non-minified versions of the Firechat JavaScript -and CSS files from the Firebase CDN. You can also download them from the -[releases page of the Firechat GitHub repository](https://github.com/firebase/firechat/releases). -[Firebase Database](https://firebase.google.com/docs/database/web/start) and -[jQuery](https://code.jquery.com/) can be downloaded directly from their respective websites. - You can also install Firechat via npm or Bower and its dependencies will be downloaded automatically: @@ -50,10 +46,10 @@ $ npm install firechat --save $ bower install firechat --save ``` -#### Getting Started with the Firebase Realtime Database +#### Getting Started with Firebase -Firechat requires Firebase in order to sync and store data. You can -[sign up here for a free account](https://firebase.google.com). +Firechat requires Firebase in order to authenticate users and store data. You can +[sign up here](https://console.firebase.google.com/?utm_source=firechat) for a free account. #### Short Example @@ -69,36 +65,46 @@ Let's put it all together, using Twitter authentication in our example: - + - + - - + + - -
- Login + +
+
@@ -108,26 +114,31 @@ Let's put it all together, using Twitter authentication in our example: ### Authentication -Firechat uses Firebase [Authentication](https://firebase.google.com/docs/auth/) and [Security Rules](https://firebase.google.com/docs/database/security/), giving you the flexibility to authenticate with either your own custom authentication system or a number of built-in providers. +Firechat uses [Firebase Authentication](https://firebase.google.com/docs/auth/) and the +[Database Security Rules](https://firebase.google.com/docs/database/security/), giving you the +flexibility to authenticate with either your own custom authentication system or a number of +built-in providers. #### Integrate Your Own Authentication -If you already have authentication built into your application, you can integrate it with Firebase by generating your own JSON Web Tokens (JWT). - -Firebase provide helper libraries to generate these tokens for various languages, including: [.NET](https://github.com/firebase/firebase-token-generator-dotNet), [Java](https://github.com/firebase/firebase-token-generator-java), [Node.js](https://github.com/firebase/firebase-token-generator-node), [PHP](https://github.com/firebase/firebase-token-generator-php), [Python](https://github.com/firebase/firebase-token-generator-python), [Ruby](https://github.com/firebase/firebase-token-generator-ruby). +If you already have authentication built into your application, you can integrate it with Firebase +by generating your own JSON Web Tokens (JWT). You can learn how to generate these tokens in our +[custom token documentation](https://firebase.google.com/docs/auth/server/create-custom-tokens). -Each token should be generated with a `uid`: - - * The `uid` is the unique identifier for the user (*string*). - -After generating the JWT, authenticate your Firebase reference: +After generating the custom token, authenticate the Firebase SDK with it: {% highlight javascript %} -var firechatAuth = firebase().auth().ref(); -firechatAuth.signInWithCustomToken(); // TODO: CHECK ON THIS -{% endhighlight %} +firebase.auth().onAuthStateChanged(function(user) { + // Once authenticated, instantiate Firechat with the logged in user + if (user) { + initChat(user); + } +}); -For more information, check out the documentation for [Firebase Custom Login](https://firebase.google.com/docs/auth/web/custom-auth). +firebase.auth().signInWithCustomToken().catch(function(error) { + console.log("Error authenticating user:", error); +}); +{% endhighlight %} #### Delegate Authentication to Firebase @@ -138,17 +149,22 @@ Firebase has a built-in service that allows you to authenticate with [Facebook]( * Then authenticate the user on the client using your provider of choice: {% highlight javascript %} -var firechatAuth = firebase().auth(); -firechatAuth.onAuthStateChanged(function(authData) { ... }); -... -firechatAuth.signInWithPopup('twitter' /* or 'facebook', 'github, 'persona', 'password' */, function(error, authData) { - if (error) { - console.log(error); +firebase.auth().onAuthStateChanged(function(user) { + // Once authenticated, instantiate Firechat with the logged in user + if (user) { + initChat(user); } }); + +// Log the user in via Twitter (or Google or GitHub or email / password or etc.) +var provider = new firebase.auth.TwitterAuthProvider(); +firebase.auth().signInWithPopup(provider).catch(function(error) { + console.log("Error authenticating user:", error); +}); {% endhighlight %} -For more information, check out the documentation for [User Authentication](https://firebase.google.com/docs/auth/web/manage-users). +For more information, check out the documentation for +[Firebase Authentication](https://firebase.google.com/docs/auth/). @@ -188,6 +204,7 @@ Firechat exposes a number of useful methods and bindings to initiate chat, enter #### Instantiating Firechat {% highlight javascript %} +var firebaseRef = firebase.database().ref("firechat"); var chat = new Firechat(firebaseRef); chat.setUser(userId, userName, function(user) { chat.resumeSession(); @@ -282,7 +299,7 @@ To bind events to Firechat, invoke the public `on` method using an event ID and ### Data Structure -Firechat uses [Firebase](https://firebase.google.com) for its data storage and synchronization. This means (a) you don't need to run any server code and (b) you get access to all the the Firebase features, including first-class data security, automatic scaling, and data portability. +Firechat uses [Firebase](https://firebase.google.com/?utm_source=firechat) to authenticate users and store and synchronize data. This means (a) you don't need to run any server code and (b) you get access to all the the Firebase features, including first-class data security, automatic scaling, and data portability. You own all of the data and can interact with it in a variety of ways. Firechat stores your data at the Firebase location you specify using the following data structure: @@ -314,9 +331,10 @@ following data structure: * `muted` - A list of user ids currently muted by the user. * `rooms` - A list of currently active rooms, used for sessioning. -You may find it useful to interact directly with the Firebase data when building related features on your site. See the code or view the data in Forge (just enter your Firebase URL in a browser) for more details. +You may find it useful to interact directly with the Firebase data when building related features on your site. See the code or view the data (just enter your Firebase URL in a browser) for more details. ### Security -To lock down your Firechat data, you can use Firebase's builtin -[Security features](https://firebase.google.com/docs/database/security/). For some example -security rules for Firechat, see these [example rules on Github](https://github.com/firebase/firechat/tree/master/rules.json). +To lock down your Firechat data, you can use Firebase's built-in +[Database Security Rules](https://firebase.google.com/docs/database/security/?utm_source=firechat). +For some example Security Rules for Firechat, see these +[example rules on GitHub](https://github.com/firebase/firechat/tree/master/rules.json). diff --git a/website/firechat/firechat.js b/website/firechat/firechat.js deleted file mode 100644 index c48800d..0000000 --- a/website/firechat/firechat.js +++ /dev/null @@ -1,1913 +0,0 @@ -// Underscore.js 1.7.0 -// http://underscorejs.org -// (c) 2009-2014 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors -// Underscore may be freely distributed under the MIT license. -(function(){var n=this,t=n._,r=Array.prototype,e=Object.prototype,u=Function.prototype,i=r.push,a=r.slice,o=r.concat,l=e.toString,c=e.hasOwnProperty,f=Array.isArray,s=Object.keys,p=u.bind,h=function(n){return n instanceof h?n:this instanceof h?void(this._wrapped=n):new h(n)};"undefined"!=typeof exports?("undefined"!=typeof module&&module.exports&&(exports=module.exports=h),exports._=h):n._=h,h.VERSION="1.7.0";var g=function(n,t,r){if(t===void 0)return n;switch(null==r?3:r){case 1:return function(r){return n.call(t,r)};case 2:return function(r,e){return n.call(t,r,e)};case 3:return function(r,e,u){return n.call(t,r,e,u)};case 4:return function(r,e,u,i){return n.call(t,r,e,u,i)}}return function(){return n.apply(t,arguments)}};h.iteratee=function(n,t,r){return null==n?h.identity:h.isFunction(n)?g(n,t,r):h.isObject(n)?h.matches(n):h.property(n)},h.each=h.forEach=function(n,t,r){if(null==n)return n;t=g(t,r);var e,u=n.length;if(u===+u)for(e=0;u>e;e++)t(n[e],e,n);else{var i=h.keys(n);for(e=0,u=i.length;u>e;e++)t(n[i[e]],i[e],n)}return n},h.map=h.collect=function(n,t,r){if(null==n)return[];t=h.iteratee(t,r);for(var e,u=n.length!==+n.length&&h.keys(n),i=(u||n).length,a=Array(i),o=0;i>o;o++)e=u?u[o]:o,a[o]=t(n[e],e,n);return a};var v="Reduce of empty array with no initial value";h.reduce=h.foldl=h.inject=function(n,t,r,e){null==n&&(n=[]),t=g(t,e,4);var u,i=n.length!==+n.length&&h.keys(n),a=(i||n).length,o=0;if(arguments.length<3){if(!a)throw new TypeError(v);r=n[i?i[o++]:o++]}for(;a>o;o++)u=i?i[o]:o,r=t(r,n[u],u,n);return r},h.reduceRight=h.foldr=function(n,t,r,e){null==n&&(n=[]),t=g(t,e,4);var u,i=n.length!==+n.length&&h.keys(n),a=(i||n).length;if(arguments.length<3){if(!a)throw new TypeError(v);r=n[i?i[--a]:--a]}for(;a--;)u=i?i[a]:a,r=t(r,n[u],u,n);return r},h.find=h.detect=function(n,t,r){var e;return t=h.iteratee(t,r),h.some(n,function(n,r,u){return t(n,r,u)?(e=n,!0):void 0}),e},h.filter=h.select=function(n,t,r){var e=[];return null==n?e:(t=h.iteratee(t,r),h.each(n,function(n,r,u){t(n,r,u)&&e.push(n)}),e)},h.reject=function(n,t,r){return h.filter(n,h.negate(h.iteratee(t)),r)},h.every=h.all=function(n,t,r){if(null==n)return!0;t=h.iteratee(t,r);var e,u,i=n.length!==+n.length&&h.keys(n),a=(i||n).length;for(e=0;a>e;e++)if(u=i?i[e]:e,!t(n[u],u,n))return!1;return!0},h.some=h.any=function(n,t,r){if(null==n)return!1;t=h.iteratee(t,r);var e,u,i=n.length!==+n.length&&h.keys(n),a=(i||n).length;for(e=0;a>e;e++)if(u=i?i[e]:e,t(n[u],u,n))return!0;return!1},h.contains=h.include=function(n,t){return null==n?!1:(n.length!==+n.length&&(n=h.values(n)),h.indexOf(n,t)>=0)},h.invoke=function(n,t){var r=a.call(arguments,2),e=h.isFunction(t);return h.map(n,function(n){return(e?t:n[t]).apply(n,r)})},h.pluck=function(n,t){return h.map(n,h.property(t))},h.where=function(n,t){return h.filter(n,h.matches(t))},h.findWhere=function(n,t){return h.find(n,h.matches(t))},h.max=function(n,t,r){var e,u,i=-1/0,a=-1/0;if(null==t&&null!=n){n=n.length===+n.length?n:h.values(n);for(var o=0,l=n.length;l>o;o++)e=n[o],e>i&&(i=e)}else t=h.iteratee(t,r),h.each(n,function(n,r,e){u=t(n,r,e),(u>a||u===-1/0&&i===-1/0)&&(i=n,a=u)});return i},h.min=function(n,t,r){var e,u,i=1/0,a=1/0;if(null==t&&null!=n){n=n.length===+n.length?n:h.values(n);for(var o=0,l=n.length;l>o;o++)e=n[o],i>e&&(i=e)}else t=h.iteratee(t,r),h.each(n,function(n,r,e){u=t(n,r,e),(a>u||1/0===u&&1/0===i)&&(i=n,a=u)});return i},h.shuffle=function(n){for(var t,r=n&&n.length===+n.length?n:h.values(n),e=r.length,u=Array(e),i=0;e>i;i++)t=h.random(0,i),t!==i&&(u[i]=u[t]),u[t]=r[i];return u},h.sample=function(n,t,r){return null==t||r?(n.length!==+n.length&&(n=h.values(n)),n[h.random(n.length-1)]):h.shuffle(n).slice(0,Math.max(0,t))},h.sortBy=function(n,t,r){return t=h.iteratee(t,r),h.pluck(h.map(n,function(n,r,e){return{value:n,index:r,criteria:t(n,r,e)}}).sort(function(n,t){var r=n.criteria,e=t.criteria;if(r!==e){if(r>e||r===void 0)return 1;if(e>r||e===void 0)return-1}return n.index-t.index}),"value")};var m=function(n){return function(t,r,e){var u={};return r=h.iteratee(r,e),h.each(t,function(e,i){var a=r(e,i,t);n(u,e,a)}),u}};h.groupBy=m(function(n,t,r){h.has(n,r)?n[r].push(t):n[r]=[t]}),h.indexBy=m(function(n,t,r){n[r]=t}),h.countBy=m(function(n,t,r){h.has(n,r)?n[r]++:n[r]=1}),h.sortedIndex=function(n,t,r,e){r=h.iteratee(r,e,1);for(var u=r(t),i=0,a=n.length;a>i;){var o=i+a>>>1;r(n[o])t?[]:a.call(n,0,t)},h.initial=function(n,t,r){return a.call(n,0,Math.max(0,n.length-(null==t||r?1:t)))},h.last=function(n,t,r){return null==n?void 0:null==t||r?n[n.length-1]:a.call(n,Math.max(n.length-t,0))},h.rest=h.tail=h.drop=function(n,t,r){return a.call(n,null==t||r?1:t)},h.compact=function(n){return h.filter(n,h.identity)};var y=function(n,t,r,e){if(t&&h.every(n,h.isArray))return o.apply(e,n);for(var u=0,a=n.length;a>u;u++){var l=n[u];h.isArray(l)||h.isArguments(l)?t?i.apply(e,l):y(l,t,r,e):r||e.push(l)}return e};h.flatten=function(n,t){return y(n,t,!1,[])},h.without=function(n){return h.difference(n,a.call(arguments,1))},h.uniq=h.unique=function(n,t,r,e){if(null==n)return[];h.isBoolean(t)||(e=r,r=t,t=!1),null!=r&&(r=h.iteratee(r,e));for(var u=[],i=[],a=0,o=n.length;o>a;a++){var l=n[a];if(t)a&&i===l||u.push(l),i=l;else if(r){var c=r(l,a,n);h.indexOf(i,c)<0&&(i.push(c),u.push(l))}else h.indexOf(u,l)<0&&u.push(l)}return u},h.union=function(){return h.uniq(y(arguments,!0,!0,[]))},h.intersection=function(n){if(null==n)return[];for(var t=[],r=arguments.length,e=0,u=n.length;u>e;e++){var i=n[e];if(!h.contains(t,i)){for(var a=1;r>a&&h.contains(arguments[a],i);a++);a===r&&t.push(i)}}return t},h.difference=function(n){var t=y(a.call(arguments,1),!0,!0,[]);return h.filter(n,function(n){return!h.contains(t,n)})},h.zip=function(n){if(null==n)return[];for(var t=h.max(arguments,"length").length,r=Array(t),e=0;t>e;e++)r[e]=h.pluck(arguments,e);return r},h.object=function(n,t){if(null==n)return{};for(var r={},e=0,u=n.length;u>e;e++)t?r[n[e]]=t[e]:r[n[e][0]]=n[e][1];return r},h.indexOf=function(n,t,r){if(null==n)return-1;var e=0,u=n.length;if(r){if("number"!=typeof r)return e=h.sortedIndex(n,t),n[e]===t?e:-1;e=0>r?Math.max(0,u+r):r}for(;u>e;e++)if(n[e]===t)return e;return-1},h.lastIndexOf=function(n,t,r){if(null==n)return-1;var e=n.length;for("number"==typeof r&&(e=0>r?e+r+1:Math.min(e,r+1));--e>=0;)if(n[e]===t)return e;return-1},h.range=function(n,t,r){arguments.length<=1&&(t=n||0,n=0),r=r||1;for(var e=Math.max(Math.ceil((t-n)/r),0),u=Array(e),i=0;e>i;i++,n+=r)u[i]=n;return u};var d=function(){};h.bind=function(n,t){var r,e;if(p&&n.bind===p)return p.apply(n,a.call(arguments,1));if(!h.isFunction(n))throw new TypeError("Bind must be called on a function");return r=a.call(arguments,2),e=function(){if(!(this instanceof e))return n.apply(t,r.concat(a.call(arguments)));d.prototype=n.prototype;var u=new d;d.prototype=null;var i=n.apply(u,r.concat(a.call(arguments)));return h.isObject(i)?i:u}},h.partial=function(n){var t=a.call(arguments,1);return function(){for(var r=0,e=t.slice(),u=0,i=e.length;i>u;u++)e[u]===h&&(e[u]=arguments[r++]);for(;r=e)throw new Error("bindAll must be passed function names");for(t=1;e>t;t++)r=arguments[t],n[r]=h.bind(n[r],n);return n},h.memoize=function(n,t){var r=function(e){var u=r.cache,i=t?t.apply(this,arguments):e;return h.has(u,i)||(u[i]=n.apply(this,arguments)),u[i]};return r.cache={},r},h.delay=function(n,t){var r=a.call(arguments,2);return setTimeout(function(){return n.apply(null,r)},t)},h.defer=function(n){return h.delay.apply(h,[n,1].concat(a.call(arguments,1)))},h.throttle=function(n,t,r){var e,u,i,a=null,o=0;r||(r={});var l=function(){o=r.leading===!1?0:h.now(),a=null,i=n.apply(e,u),a||(e=u=null)};return function(){var c=h.now();o||r.leading!==!1||(o=c);var f=t-(c-o);return e=this,u=arguments,0>=f||f>t?(clearTimeout(a),a=null,o=c,i=n.apply(e,u),a||(e=u=null)):a||r.trailing===!1||(a=setTimeout(l,f)),i}},h.debounce=function(n,t,r){var e,u,i,a,o,l=function(){var c=h.now()-a;t>c&&c>0?e=setTimeout(l,t-c):(e=null,r||(o=n.apply(i,u),e||(i=u=null)))};return function(){i=this,u=arguments,a=h.now();var c=r&&!e;return e||(e=setTimeout(l,t)),c&&(o=n.apply(i,u),i=u=null),o}},h.wrap=function(n,t){return h.partial(t,n)},h.negate=function(n){return function(){return!n.apply(this,arguments)}},h.compose=function(){var n=arguments,t=n.length-1;return function(){for(var r=t,e=n[t].apply(this,arguments);r--;)e=n[r].call(this,e);return e}},h.after=function(n,t){return function(){return--n<1?t.apply(this,arguments):void 0}},h.before=function(n,t){var r;return function(){return--n>0?r=t.apply(this,arguments):t=null,r}},h.once=h.partial(h.before,2),h.keys=function(n){if(!h.isObject(n))return[];if(s)return s(n);var t=[];for(var r in n)h.has(n,r)&&t.push(r);return t},h.values=function(n){for(var t=h.keys(n),r=t.length,e=Array(r),u=0;r>u;u++)e[u]=n[t[u]];return e},h.pairs=function(n){for(var t=h.keys(n),r=t.length,e=Array(r),u=0;r>u;u++)e[u]=[t[u],n[t[u]]];return e},h.invert=function(n){for(var t={},r=h.keys(n),e=0,u=r.length;u>e;e++)t[n[r[e]]]=r[e];return t},h.functions=h.methods=function(n){var t=[];for(var r in n)h.isFunction(n[r])&&t.push(r);return t.sort()},h.extend=function(n){if(!h.isObject(n))return n;for(var t,r,e=1,u=arguments.length;u>e;e++){t=arguments[e];for(r in t)c.call(t,r)&&(n[r]=t[r])}return n},h.pick=function(n,t,r){var e,u={};if(null==n)return u;if(h.isFunction(t)){t=g(t,r);for(e in n){var i=n[e];t(i,e,n)&&(u[e]=i)}}else{var l=o.apply([],a.call(arguments,1));n=new Object(n);for(var c=0,f=l.length;f>c;c++)e=l[c],e in n&&(u[e]=n[e])}return u},h.omit=function(n,t,r){if(h.isFunction(t))t=h.negate(t);else{var e=h.map(o.apply([],a.call(arguments,1)),String);t=function(n,t){return!h.contains(e,t)}}return h.pick(n,t,r)},h.defaults=function(n){if(!h.isObject(n))return n;for(var t=1,r=arguments.length;r>t;t++){var e=arguments[t];for(var u in e)n[u]===void 0&&(n[u]=e[u])}return n},h.clone=function(n){return h.isObject(n)?h.isArray(n)?n.slice():h.extend({},n):n},h.tap=function(n,t){return t(n),n};var b=function(n,t,r,e){if(n===t)return 0!==n||1/n===1/t;if(null==n||null==t)return n===t;n instanceof h&&(n=n._wrapped),t instanceof h&&(t=t._wrapped);var u=l.call(n);if(u!==l.call(t))return!1;switch(u){case"[object RegExp]":case"[object String]":return""+n==""+t;case"[object Number]":return+n!==+n?+t!==+t:0===+n?1/+n===1/t:+n===+t;case"[object Date]":case"[object Boolean]":return+n===+t}if("object"!=typeof n||"object"!=typeof t)return!1;for(var i=r.length;i--;)if(r[i]===n)return e[i]===t;var a=n.constructor,o=t.constructor;if(a!==o&&"constructor"in n&&"constructor"in t&&!(h.isFunction(a)&&a instanceof a&&h.isFunction(o)&&o instanceof o))return!1;r.push(n),e.push(t);var c,f;if("[object Array]"===u){if(c=n.length,f=c===t.length)for(;c--&&(f=b(n[c],t[c],r,e)););}else{var s,p=h.keys(n);if(c=p.length,f=h.keys(t).length===c)for(;c--&&(s=p[c],f=h.has(t,s)&&b(n[s],t[s],r,e)););}return r.pop(),e.pop(),f};h.isEqual=function(n,t){return b(n,t,[],[])},h.isEmpty=function(n){if(null==n)return!0;if(h.isArray(n)||h.isString(n)||h.isArguments(n))return 0===n.length;for(var t in n)if(h.has(n,t))return!1;return!0},h.isElement=function(n){return!(!n||1!==n.nodeType)},h.isArray=f||function(n){return"[object Array]"===l.call(n)},h.isObject=function(n){var t=typeof n;return"function"===t||"object"===t&&!!n},h.each(["Arguments","Function","String","Number","Date","RegExp"],function(n){h["is"+n]=function(t){return l.call(t)==="[object "+n+"]"}}),h.isArguments(arguments)||(h.isArguments=function(n){return h.has(n,"callee")}),"function"!=typeof/./&&(h.isFunction=function(n){return"function"==typeof n||!1}),h.isFinite=function(n){return isFinite(n)&&!isNaN(parseFloat(n))},h.isNaN=function(n){return h.isNumber(n)&&n!==+n},h.isBoolean=function(n){return n===!0||n===!1||"[object Boolean]"===l.call(n)},h.isNull=function(n){return null===n},h.isUndefined=function(n){return n===void 0},h.has=function(n,t){return null!=n&&c.call(n,t)},h.noConflict=function(){return n._=t,this},h.identity=function(n){return n},h.constant=function(n){return function(){return n}},h.noop=function(){},h.property=function(n){return function(t){return t[n]}},h.matches=function(n){var t=h.pairs(n),r=t.length;return function(n){if(null==n)return!r;n=new Object(n);for(var e=0;r>e;e++){var u=t[e],i=u[0];if(u[1]!==n[i]||!(i in n))return!1}return!0}},h.times=function(n,t,r){var e=Array(Math.max(0,n));t=g(t,r,1);for(var u=0;n>u;u++)e[u]=t(u);return e},h.random=function(n,t){return null==t&&(t=n,n=0),n+Math.floor(Math.random()*(t-n+1))},h.now=Date.now||function(){return(new Date).getTime()};var _={"&":"&","<":"<",">":">",'"':""","'":"'","`":"`"},w=h.invert(_),j=function(n){var t=function(t){return n[t]},r="(?:"+h.keys(n).join("|")+")",e=RegExp(r),u=RegExp(r,"g");return function(n){return n=null==n?"":""+n,e.test(n)?n.replace(u,t):n}};h.escape=j(_),h.unescape=j(w),h.result=function(n,t){if(null==n)return void 0;var r=n[t];return h.isFunction(r)?n[t]():r};var x=0;h.uniqueId=function(n){var t=++x+"";return n?n+t:t},h.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g};var A=/(.)^/,k={"'":"'","\\":"\\","\r":"r","\n":"n","\u2028":"u2028","\u2029":"u2029"},O=/\\|'|\r|\n|\u2028|\u2029/g,F=function(n){return"\\"+k[n]};h.template=function(n,t,r){!t&&r&&(t=r),t=h.defaults({},t,h.templateSettings);var e=RegExp([(t.escape||A).source,(t.interpolate||A).source,(t.evaluate||A).source].join("|")+"|$","g"),u=0,i="__p+='";n.replace(e,function(t,r,e,a,o){return i+=n.slice(u,o).replace(O,F),u=o+t.length,r?i+="'+\n((__t=("+r+"))==null?'':_.escape(__t))+\n'":e?i+="'+\n((__t=("+e+"))==null?'':__t)+\n'":a&&(i+="';\n"+a+"\n__p+='"),t}),i+="';\n",t.variable||(i="with(obj||{}){\n"+i+"}\n"),i="var __t,__p='',__j=Array.prototype.join,"+"print=function(){__p+=__j.call(arguments,'');};\n"+i+"return __p;\n";try{var a=new Function(t.variable||"obj","_",i)}catch(o){throw o.source=i,o}var l=function(n){return a.call(this,n,h)},c=t.variable||"obj";return l.source="function("+c+"){\n"+i+"}",l},h.chain=function(n){var t=h(n);return t._chain=!0,t};var E=function(n){return this._chain?h(n).chain():n};h.mixin=function(n){h.each(h.functions(n),function(t){var r=h[t]=n[t];h.prototype[t]=function(){var n=[this._wrapped];return i.apply(n,arguments),E.call(this,r.apply(h,n))}})},h.mixin(h),h.each(["pop","push","reverse","shift","sort","splice","unshift"],function(n){var t=r[n];h.prototype[n]=function(){var r=this._wrapped;return t.apply(r,arguments),"shift"!==n&&"splice"!==n||0!==r.length||delete r[0],E.call(this,r)}}),h.each(["concat","join","slice"],function(n){var t=r[n];h.prototype[n]=function(){return E.call(this,t.apply(this._wrapped,arguments))}}),h.prototype.value=function(){return this._wrapped},"function"==typeof define&&define.amd&&define("underscore",[],function(){return h})}).call(this); - -this["FirechatDefaultTemplates"] = this["FirechatDefaultTemplates"] || {}; - -this["FirechatDefaultTemplates"]["templates/layout-full.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape;with (obj) {__p += '
Chat Rooms
    Visitors
        ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/layout-popout.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape;with (obj) {__p += '
          ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/message-context-menu.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape, __j = Array.prototype.join;function print() { __p += __j.call(arguments, '') }with (obj) {__p += '
          ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/message.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape, __j = Array.prototype.join;function print() { __p += __j.call(arguments, '') }with (obj) {__p += '
          '; if (!disableActions) { ;__p += ''; } ;__p += '
          ' +((__t = ( message )) == null ? '' : __t) +'
          ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/prompt-alert.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape;with (obj) {__p += '
          ' +__e( message ) +'

          ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/prompt-create-room.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape;with (obj) {__p += '
          Give your chat room a name:
          ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/prompt-invitation.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape;with (obj) {__p += '
          ' +__e( fromUserName ) +'

          invited you to join

          ' +__e( toRoomName ) +'

          ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/prompt-invite-private.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape;with (obj) {__p += '
          Invite ' +__e( userName ) +' to ' +__e( roomName ) +'?

          ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/prompt-invite-reply.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape, __j = Array.prototype.join;function print() { __p += __j.call(arguments, '') }with (obj) {__p += '
          ' +__e( toUserName ) +'

          '; if (status === 'accepted') { ;__p += ' accepted your invite. '; } else { ;__p += ' declined your invite. '; } ;__p += '

          ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/prompt-user-mute.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape;with (obj) {__p += '
          ' +__e( userName ) +'

          ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/prompt.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape;with (obj) {__p += '
          ' +__e( title ) +'X
          ' +((__t = ( content )) == null ? '' : __t) +'
          ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/room-list-item.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape, __j = Array.prototype.join;function print() { __p += __j.call(arguments, '') }with (obj) {__p += '
        • ' +__e( name ) +'
          • ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/room-user-list-item.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape, __j = Array.prototype.join;function print() { __p += __j.call(arguments, '') }with (obj) {__p += '
        • ' +__e( name ) +''; if (!disableActions) { ;__p += '  '; } ;__p += '
          • ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/room-user-search-list-item.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape, __j = Array.prototype.join;function print() { __p += __j.call(arguments, '') }with (obj) {__p += '
        • '; if (disableActions) { ;__p += '' +__e( name ) +''; } else { ;__p += '' +__e( name ) +'+'; } ;__p += '
          • ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/tab-content.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape;with (obj) {__p += '
          In Room
            +Invite
              ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/tab-menu-item.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape;with (obj) {__p += '
            • ' +__e( name ) +'
              • ';}return __p}; - -this["FirechatDefaultTemplates"]["templates/user-search-list-item.html"] = function(obj) {obj || (obj = {});var __t, __p = '', __e = _.escape, __j = Array.prototype.join;function print() { __p += __j.call(arguments, '') }with (obj) {__p += '
            • '; if (disableActions) { ;__p += '' +__e( name ) +''; } else { ;__p += '' +__e( name ) +' '; } ;__p += '
              • ';}return __p}; -(function($) { - - // Shim for Function.bind(...) - (Required by IE < 9, FF < 4, SF < 6) - if (!Function.prototype.bind) { - Function.prototype.bind = function(oThis) { - if (typeof this !== "function") { - throw new TypeError("Function.prototype.bind - what is trying to be bound is not callable"); - } - - var aArgs = Array.prototype.slice.call(arguments, 1), - fToBind = this, - fNOP = function() {}, - fBound = function() { - return fToBind.apply(this instanceof fNOP && oThis ? this : oThis, - aArgs.concat(Array.prototype.slice.call(arguments))); - }; - - fNOP.prototype = this.prototype; - fBound.prototype = new fNOP(); - return fBound; - }; - } - - // Shim for Object.keys(...) - (Required by IE < 9, FF < 4) - Object.keys = Object.keys || function(oObj) { - var result = []; - for (var name in oObj) { - if (oObj.hasOwnProperty(name)) { - result.push(name); - } - } - return result; - }; - -})(); - -// Firechat is a simple, easily-extensible data layer for multi-user, -// multi-room chat, built entirely on [Firebase](https://firebase.com). -// -// The Firechat object is the primary conduit for all underlying data events. -// It exposes a number of methods for binding event listeners, creating, -// entering, or leaving chat rooms, initiating chats, sending messages, -// and moderator actions such as warning, kicking, or suspending users. -// -// Firechat.js 0.0.0 -// https://firebase.com -// (c) 2014 Firebase -// License: MIT - -// Setup -// -------------- -(function(Firebase) { - - // Establish a reference to the `window` object, and save the previous value - // of the `Firechat` variable. - var root = this, - previousFirechat = root.Firechat; - - function Firechat(firebaseRef, options) { - - // Instantiate a new connection to Firebase. - this._firebase = firebaseRef; - - // User-specific instance variables. - this._user = null; - this._userId = null; - this._userName = null; - this._isModerator = false; - - // A unique id generated for each session. - this._sessionId = null; - - // A mapping of event IDs to an array of callbacks. - this._events = {}; - - // A mapping of room IDs to a boolean indicating presence. - this._rooms = {}; - - // A mapping of operations to re-queue on disconnect. - this._presenceBits = {}; - - // Commonly-used Firebase references. - this._userRef = null; - this._messageRef = this._firebase.database().ref().child('room-messages'); - this._roomRef = this._firebase.database().ref().child('room-metadata'); - this._privateRoomRef = this._firebase.database().ref().child('room-private-metadata'); - this._moderatorsRef = this._firebase.database().ref().child('moderators'); - this._suspensionsRef = this._firebase.database().ref().child('suspensions'); - this._usersOnlineRef = this._firebase.database().ref().child('user-names-online'); - - // Setup and establish default options. - this._options = options || {}; - - // The number of historical messages to load per room. - this._options.numMaxMessages = this._options.numMaxMessages || 50; - } - - // Run Firechat in *noConflict* mode, returning the `Firechat` variable to - // its previous owner, and returning a reference to the Firechat object. - Firechat.noConflict = function noConflict() { - root.Firechat = previousFirechat; - return Firechat; - }; - - // Export the Firechat object as a global. - root.Firechat = Firechat; - - // Firechat Internal Methods - // -------------- - Firechat.prototype = { - - // Load the initial metadata for the user's account and set initial state. - _loadUserMetadata: function(onComplete) { - var self = this; - - // Update the user record with a default name on user's first visit. - this._userRef.transaction(function(current) { - if (!current || !current.id || !current.name) { - return { - id: self._userId, - name: self._userName - }; - } - }, function(error, committed, snapshot) { - self._user = snapshot.val(); - self._moderatorsRef.child(self._userId).once('value', function(snapshot) { - self._isModerator = !!snapshot.val(); - root.setTimeout(onComplete, 0); - }); - }); - }, - - // Initialize Firebase listeners and callbacks for the supported bindings. - _setupDataEvents: function() { - // Monitor connection state so we can requeue disconnect operations if need be. - this.getRoot(this._firebase.database().ref()).child('.info/connected').on('value', function(snapshot) { - if (snapshot.val() === true) { - // We're connected (or reconnected)! Set up our presence state. - for (var i = 0; i < this._presenceBits; i++) { - var op = this._presenceBits[i], - ref = this.getRoot(this._firebase.database().ref()).child(op.ref); - - ref.onDisconnect().set(op.offlineValue); - ref.set(op.onlineValue); - } - } - }, this); - - // Generate a unique session id for the visit. - var sessionRef = this._userRef.child('sessions').push(); - this._sessionId = this.getKey(sessionRef); - this._queuePresenceOperation(sessionRef, true, null); - - // Register our username in the public user listing. - var usernameRef = this._usersOnlineRef.child(this._userName.toLowerCase()); - var usernameSessionRef = usernameRef.child(this._sessionId); - this._queuePresenceOperation(usernameSessionRef, { - id: this._userId, - name: this._userName - }, null); - - // Listen for state changes for the given user. - this._userRef.on('value', this._onUpdateUser, this); - - // Listen for chat invitations from other users. - this._userRef.child('invites').on('child_added', this._onFirechatInvite, this); - - // Listen for messages from moderators and adminstrators. - this._userRef.child('notifications').on('child_added', this._onNotification, this); - }, - - // Append the new callback to our list of event handlers. - _addEventCallback: function(eventId, callback) { - this._events[eventId] = this._events[eventId] || []; - this._events[eventId].push(callback); - }, - - // Retrieve the list of event handlers for a given event id. - _getEventCallbacks: function(eventId) { - if (this._events.hasOwnProperty(eventId)) { - return this._events[eventId]; - } - return []; - }, - - // Invoke each of the event handlers for a given event id with specified data. - _invokeEventCallbacks: function(eventId) { - var args = [], - callbacks = this._getEventCallbacks(eventId); - - Array.prototype.push.apply(args, arguments); - args = args.slice(1); - - for (var i = 0; i < callbacks.length; i += 1) { - callbacks[i].apply(null, args); - } - }, - - // Keep track of on-disconnect events so they can be requeued if we disconnect the reconnect. - _queuePresenceOperation: function(ref, onlineValue, offlineValue) { - ref.onDisconnect().set(offlineValue); - ref.set(onlineValue); - this._presenceBits[ref.toString()] = { - ref: ref, - onlineValue: onlineValue, - offlineValue: offlineValue - }; - }, - - // Remove an on-disconnect event from firing upon future disconnect and reconnect. - _removePresenceOperation: function(path, value) { - var ref = new Firebase(path); - ref.onDisconnect().cancel(); - ref.set(value); - delete this._presenceBits[path]; - }, - - // Event to monitor current user state. - _onUpdateUser: function(snapshot) { - this._user = snapshot.val(); - this._invokeEventCallbacks('user-update', this._user); - }, - - // Event to monitor current auth + user state. - _onAuthRequired: function() { - this._invokeEventCallbacks('auth-required'); - }, - - // Events to monitor room entry / exit and messages additional / removal. - _onEnterRoom: function(room) { - this._invokeEventCallbacks('room-enter', room); - }, - _onNewMessage: function(roomId, snapshot) { - var message = snapshot.val(); - message.id = Firechat.prototype.getKey(snapshot); - this._invokeEventCallbacks('message-add', roomId, message); - }, - _onRemoveMessage: function(roomId, snapshot) { - var messageId = Firechat.prototype.getKey(snapshot); - this._invokeEventCallbacks('message-remove', roomId, messageId); - }, - _onLeaveRoom: function(roomId) { - this._invokeEventCallbacks('room-exit', roomId); - }, - - // Event to listen for notifications from administrators and moderators. - _onNotification: function(snapshot) { - var notification = snapshot.val(); - if (!notification.read) { - if (notification.notificationType !== 'suspension' || notification.data.suspendedUntil < new Date().getTime()) { - snapshot.ref.child('read').set(true); - } - this._invokeEventCallbacks('notification', notification); - } - }, - - // Events to monitor chat invitations and invitation replies. - _onFirechatInvite: function(snapshot) { - var self = this, - invite = snapshot.val(); - - // Skip invites we've already responded to. - if (invite.status) { - return; - } - - invite.id = invite.id || self.getKey(snapshot); - self.getRoom(invite.roomId, function(room) { - invite.toRoomName = room.name; - self._invokeEventCallbacks('room-invite', invite); - }); - }, - _onFirechatInviteResponse: function(snapshot) { - var self = this, - invite = snapshot.val(); - - invite.id = invite.id || self.getKey(snapshot); - this._invokeEventCallbacks('room-invite-response', invite); - } - }; - - // Firechat External Methods - // -------------- - - // Initialize the library and setup data listeners. - Firechat.prototype.setUser = function(userId, userName, callback) { - var self = this; - - self._firebase.auth().onAuthStateChanged(function(authData) { - if (authData) { - self._userId = userId.toString(); - self._userName = userName.toString(); - self._userRef = self._firebase.database().ref().child('users').child(self._userId); - self._loadUserMetadata(function() { - root.setTimeout(function() { - callback(self._user); - self._setupDataEvents(); - }, 0); - }); - } else { - self.warn('Firechat requires an authenticated Firebase reference. Pass an authenticated reference before loading.'); - } - }); - }; - - // Resumes the previous session by automatically entering rooms. - Firechat.prototype.resumeSession = function() { - this._userRef.child('rooms').once('value', function(snapshot) { - var rooms = snapshot.val(); - for (var roomId in rooms) { - this.enterRoom(rooms[roomId].id); - } - }, /* onError */ function(){}, /* context */ this); - }; - - // Callback registration. Supports each of the following events: - Firechat.prototype.on = function(eventType, cb) { - this._addEventCallback(eventType, cb); - }; - - // Create and automatically enter a new chat room. - Firechat.prototype.createRoom = function(roomName, roomType, callback) { - var self = this, - newRoomRef = this._roomRef.push(); - - - if (!self._user) { - self._onAuthRequired(); - if (cb) { - cb(new Error('Not authenticated or user not set!')); - } - return; - } - - var newRoom = { - id: self.getKey(newRoomRef), - name: roomName, - type: roomType || 'public', - createdByUserId: this._userId, - createdAt: firebase.database.ServerValue.TIMESTAMP - }; - - if (roomType === 'private') { - newRoom.authorizedUsers = {}; - newRoom.authorizedUsers[this._userId] = true; - } - - newRoomRef.set(newRoom, function(error) { - if (!error) { - self.enterRoom(self.getKey(newRoomRef)); - } - if (callback) { - callback(self.getKey(newRoomRef)); - } - }); - }; - - // Enter a chat room. - Firechat.prototype.enterRoom = function(roomId) { - var self = this; - self.getRoom(roomId, function(room) { - var roomName = room.name; - - if (!roomId || !roomName) return; - - // Skip if we're already in this room. - if (self._rooms[roomId]) { - return; - } - - self._rooms[roomId] = true; - - if (self._user) { - // Save entering this room to resume the session again later. - self._userRef.child('rooms').child(roomId).set({ - id: roomId, - name: roomName, - active: true - }); - - // Set presence bit for the room and queue it for removal on disconnect. - var presenceRef = self._firebase.database().ref().child('room-users').child(roomId).child(self._userId).child(self._sessionId); - self._queuePresenceOperation(presenceRef, { - id: self._userId, - name: self._userName - }, null); - } - - // Invoke our callbacks before we start listening for new messages. - self._onEnterRoom({ id: roomId, name: roomName }); - - // Setup message listeners - self._roomRef.child(roomId).once('value', function(snapshot) { - self._messageRef.child(roomId).limitToLast(self._options.numMaxMessages).on('child_added', function(snapshot) { - self._onNewMessage(roomId, snapshot); - }, /* onCancel */ function() { - // Turns out we don't have permission to access these messages. - self.leaveRoom(roomId); - }, /* context */ self); - - self._messageRef.child(roomId).limitToLast(self._options.numMaxMessages).on('child_removed', function(snapshot) { - self._onRemoveMessage(roomId, snapshot); - }, /* onCancel */ function(){}, /* context */ self); - }, /* onFailure */ function(){}, self); - }); - }; - - // Leave a chat room. - Firechat.prototype.leaveRoom = function(roomId) { - var self = this, - userRoomRef = self._firebase.database().ref().child('room-users').child(roomId); - - // Remove listener for new messages to this room. - self._messageRef.child(roomId).off(); - - if (self._user) { - var presenceRef = userRoomRef.child(self._userId).child(self._sessionId); - - // Remove presence bit for the room and cancel on-disconnect removal. - self._removePresenceOperation(presenceRef.toString(), null); - - // Remove session bit for the room. - self._userRef.child('rooms').child(roomId).remove(); - } - - delete self._rooms[roomId]; - - // Invoke event callbacks for the room-exit event. - self._onLeaveRoom(roomId); - }; - - Firechat.prototype.sendMessage = function(roomId, messageContent, messageType, cb) { - var self = this, - message = { - userId: self._userId, - name: self._userName, - timestamp: firebase.database.ServerValue.TIMESTAMP, - message: messageContent, - type: messageType || 'default' - }, - newMessageRef; - - if (!self._user) { - self._onAuthRequired(); - if (cb) { - cb(new Error('Not authenticated or user not set!')); - } - return; - } - - newMessageRef = self._messageRef.child(roomId).push(); - newMessageRef.setWithPriority(message, firebase.database.ServerValue.TIMESTAMP, cb); - }; - - Firechat.prototype.deleteMessage = function(roomId, messageId, cb) { - var self = this; - - self._messageRef.child(roomId).child(messageId).remove(cb); - }; - - // Mute or unmute a given user by id. This list will be stored internally and - // all messages from the muted clients will be filtered client-side after - // receipt of each new message. - Firechat.prototype.toggleUserMute = function(userId, cb) { - var self = this; - - if (!self._user) { - self._onAuthRequired(); - if (cb) { - cb(new Error('Not authenticated or user not set!')); - } - return; - } - - self._userRef.child('muted').child(userId).transaction(function(isMuted) { - return (isMuted) ? null : true; - }, cb); - }; - - // Send a moderator notification to a specific user. - Firechat.prototype.sendSuperuserNotification = function(userId, notificationType, data, cb) { - var self = this, - userNotificationsRef = self._firebase.database().ref().child('users').child(userId).child('notifications'); - - userNotificationsRef.push({ - fromUserId: self._userId, - timestamp: firebase.database.ServerValue.TIMESTAMP, - notificationType: notificationType, - data: data || {} - }, cb); - }; - - // Warn a user for violating the terms of service or being abusive. - Firechat.prototype.warnUser = function(userId) { - var self = this; - - self.sendSuperuserNotification(userId, 'warning'); - }; - - // Suspend a user by putting the user into read-only mode for a period. - Firechat.prototype.suspendUser = function(userId, timeLengthSeconds, cb) { - var self = this, - suspendedUntil = new Date().getTime() + 1000*timeLengthSeconds; - - self._suspensionsRef.child(userId).set(suspendedUntil, function(error) { - if (error && cb) { - return cb(error); - } else { - self.sendSuperuserNotification(userId, 'suspension', { - suspendedUntil: suspendedUntil - }); - return cb(null); - } - }); - }; - - // Invite a user to a specific chat room. - Firechat.prototype.inviteUser = function(userId, roomId) { - var self = this, - sendInvite = function() { - var inviteRef = self._firebase.database().ref().child('users').child(userId).child('invites').push(); - inviteRef.set({ - id: self.getKey(inviteRef), - fromUserId: self._userId, - fromUserName: self._userName, - roomId: roomId - }); - - // Handle listen unauth / failure in case we're kicked. - inviteRef.on('value', self._onFirechatInviteResponse, function(){}, self); - }; - - if (!self._user) { - self._onAuthRequired(); - return; - } - - self.getRoom(roomId, function(room) { - if (room.type === 'private') { - var authorizedUserRef = self._roomRef.child(roomId).child('authorizedUsers'); - authorizedUserRef.child(userId).set(true, function(error) { - if (!error) { - sendInvite(); - } - }); - } else { - sendInvite(); - } - }); - }; - - Firechat.prototype.acceptInvite = function(inviteId, cb) { - var self = this; - - self._userRef.child('invites').child(inviteId).once('value', function(snapshot) { - var invite = snapshot.val(); - if (invite === null && cb) { - return cb(new Error('acceptInvite(' + inviteId + '): invalid invite id')); - } else { - self.enterRoom(invite.roomId); - self._userRef.child('invites').child(inviteId).update({ - 'status': 'accepted', - 'toUserName': self._userName - }, cb); - } - }, self); - }; - - Firechat.prototype.declineInvite = function(inviteId, cb) { - var self = this, - updates = { - 'status': 'declined', - 'toUserName': self._userName - }; - - self._userRef.child('invites').child(inviteId).update(updates, cb); - }; - - Firechat.prototype.getRoomList = function(cb) { - var self = this; - - self._roomRef.once('value', function(snapshot) { - cb(snapshot.val()); - }); - }; - - Firechat.prototype.getUsersByRoom = function() { - var self = this, - roomId = arguments[0], - query = self._firebase.database().ref().child('room-users').child(roomId), - cb = arguments[arguments.length - 1], - limit = null; - - if (arguments.length > 2) { - limit = arguments[1]; - } - - query = (limit) ? query.limitToLast(limit) : query; - - query.once('value', function(snapshot) { - var usernames = snapshot.val() || {}, - usernamesUnique = {}; - - for (var username in usernames) { - for (var session in usernames[username]) { - // Skip all other sessions for this user as we only need one. - usernamesUnique[username] = usernames[username][session]; - break; - } - } - - root.setTimeout(function() { - cb(usernamesUnique); - }, 0); - }); - }; - - Firechat.prototype.getUsersByPrefix = function(prefix, startAt, endAt, limit, cb) { - var self = this, - query = this._usersOnlineRef, - prefixLower = prefix.toLowerCase(); - - if (startAt) { - query = query.startAt(null, startAt); - } else if (endAt) { - query = query.endAt(null, endAt); - } else { - query = (prefixLower) ? query.startAt(null, prefixLower) : query.startAt(); - } - - query = (limit) ? query.limitToLast(limit) : query; - - query.once('value', function(snapshot) { - var usernames = snapshot.val() || {}, - usernamesFiltered = {}; - - for (var userNameKey in usernames) { - var sessions = usernames[userNameKey], - userName, userId, usernameClean; - - // Grab the user data from the first registered active session. - for (var sessionId in sessions) { - userName = sessions[sessionId].name; - userId = sessions[sessionId].id; - - // Skip all other sessions for this user as we only need one. - break; - } - - // Filter out any usernames that don't match our prefix and break. - if ((prefix.length > 0) && (userName.toLowerCase().indexOf(prefixLower) !== 0)) - continue; - - usernamesFiltered[userName] = { - name: userName, - id: userId - }; - } - - root.setTimeout(function() { - cb(usernamesFiltered); - }, 0); - }); - }; - - // Miscellaneous helper methods. - Firechat.prototype.getRoom = function(roomId, callback) { - this._roomRef.child(roomId).once('value', function(snapshot) { - callback(snapshot.val()); - }); - }; - - Firechat.prototype.userIsModerator = function() { - return this._isModerator; - }; - - Firechat.prototype.warn = function(msg) { - if (console) { - msg = 'Firechat Warning: ' + msg; - if (typeof console.warn === 'function') { - console.warn(msg); - } else if (typeof console.log === 'function') { - console.log(msg); - } - } - }; - - Firechat.prototype.getKey = function(snapshot) { - var key; - if (typeof snapshot.key === 'function') { - key = snapshot.key(); - } else if (typeof snapshot.key === 'string') { - key = snapshot.key; - } else { - key = snapshot.name(); - } - return key; - }; - - Firechat.prototype.getRef = function(snapshotOrRef) { - var ref; - if (typeof snapshotOrRef.ref === 'function') { - ref = snapshotOrRef.ref(); - } else { - ref = snapshotOrRef.ref; - } - return ref; - }; - - Firechat.prototype.getRoot = function(snapshotOrRef) { - var ref; - if (typeof snapshotOrRef.root === 'function') { - ref = snapshotOrRef.root(); - } else { - ref = snapshotOrRef.root; - } - return ref; - }; -})(firebase); - -(function($) { - - - if (!$ || (parseInt($().jquery.replace(/\./g, ""), 10) < 170)) { - throw new Error("jQuery 1.7 or later required!"); - } - - var root = this, - previousFirechatUI = root.FirechatUI; - - root.FirechatUI = FirechatUI; - - if (!self.FirechatDefaultTemplates) { - throw new Error("Unable to find chat templates!"); - } - - function FirechatUI(firebaseRef, el, options) { - var self = this; - - if (!firebaseRef) { - throw new Error('FirechatUI: Missing required argument `firebaseRef`'); - } - - if (!el) { - throw new Error('FirechatUI: Missing required argument `el`'); - } - - options = options || {}; - this._options = options; - - this._el = el; - this._user = null; - this._chat = new Firechat(firebaseRef, options); - - // A list of rooms to enter once we've made room for them (once we've hit the max room limit). - this._roomQueue = []; - - // Define some constants regarding maximum lengths, client-enforced. - this.maxLengthUsername = 15; - this.maxLengthUsernameDisplay = 15; - this.maxLengthRoomName = 24; - this.maxLengthMessage = 120; - this.maxUserSearchResults = 100; - - // Define some useful regexes. - this.urlPattern = /\b(?:https?|ftp):\/\/[a-z0-9-+&@#\/%?=~_|!:,.;]*[a-z0-9-+&@#\/%=~_|]/gim; - this.pseudoUrlPattern = /(^|[^\/])(www\.[\S]+(\b|$))/gim; - - this._renderLayout(); - - // Grab shortcuts to commonly used jQuery elements. - this.$wrapper = $('#firechat'); - this.$roomList = $('#firechat-room-list'); - this.$tabList = $('#firechat-tab-list'); - this.$tabContent = $('#firechat-tab-content'); - this.$messages = {}; - - // Rate limit messages from a given user with some defaults. - this.$rateLimit = { - limitCount: 10, // max number of events - limitInterval: 10000, // max interval for above count in milliseconds - limitWaitTime: 30000, // wait time if a user hits the wait limit - history: {} - }; - - // Setup UI bindings for chat controls. - this._bindUIEvents(); - - // Setup bindings to internal methods - this._bindDataEvents(); - } - - // Run FirechatUI in *noConflict* mode, returning the `FirechatUI` variable to - // its previous owner, and returning a reference to the FirechatUI object. - FirechatUI.noConflict = function noConflict() { - root.FirechatUI = previousFirechatUI; - return FirechatUI; - }; - - FirechatUI.prototype = { - - _bindUIEvents: function() { - // Chat-specific custom interactions and functionality. - this._bindForHeightChange(); - this._bindForTabControls(); - this._bindForRoomList(); - this._bindForUserRoomList(); - this._bindForUserSearch(); - this._bindForUserMuting(); - this._bindForChatInvites(); - this._bindForRoomListing(); - - // Generic, non-chat-specific interactive elements. - this._setupTabs(); - this._setupDropdowns(); - this._bindTextInputFieldLimits(); - }, - - _bindDataEvents: function() { - this._chat.on('user-update', this._onUpdateUser.bind(this)); - - // Bind events for new messages, enter / leaving rooms, and user metadata. - this._chat.on('room-enter', this._onEnterRoom.bind(this)); - this._chat.on('room-exit', this._onLeaveRoom.bind(this)); - this._chat.on('message-add', this._onNewMessage.bind(this)); - this._chat.on('message-remove', this._onRemoveMessage.bind(this)); - - // Bind events related to chat invitations. - this._chat.on('room-invite', this._onChatInvite.bind(this)); - this._chat.on('room-invite-response', this._onChatInviteResponse.bind(this)); - - // Binds events related to admin or moderator notifications. - this._chat.on('notification', this._onNotification.bind(this)); - }, - - _renderLayout: function() { - var template = FirechatDefaultTemplates["templates/layout-full.html"]; - $(this._el).html(template({ - maxLengthUsername: this.maxLengthUsername - })); - }, - - _onUpdateUser: function(user) { - // Update our current user state and render latest user name. - this._user = user; - - // Update our interface to reflect which users are muted or not. - var mutedUsers = this._user.muted || {}; - $('[data-event="firechat-user-mute-toggle"]').each(function(i, el) { - var userId = $(this).closest('[data-user-id]').data('user-id'); - $(this).toggleClass('red', !!mutedUsers[userId]); - }); - - // Ensure that all messages from muted users are removed. - for (var userId in mutedUsers) { - $('.message[data-user-id="' + userId + '"]').fadeOut(); - } - }, - - _onEnterRoom: function(room) { - this.attachTab(room.id, room.name); - }, - _onLeaveRoom: function(roomId) { - this.removeTab(roomId); - - // Auto-enter rooms in the queue - if ((this._roomQueue.length > 0)) { - this._chat.enterRoom(this._roomQueue.shift(roomId)); - } - }, - _onNewMessage: function(roomId, message) { - var userId = message.userId; - if (!this._user || !this._user.muted || !this._user.muted[userId]) { - this.showMessage(roomId, message); - } - }, - _onRemoveMessage: function(roomId, messageId) { - this.removeMessage(roomId, messageId); - }, - - // Events related to chat invitations. - _onChatInvite: function(invitation) { - var self = this; - var template = FirechatDefaultTemplates["templates/prompt-invitation.html"]; - var $prompt = this.prompt('Invite', template(invitation)); - $prompt.find('a.close').click(function() { - $prompt.remove(); - self._chat.declineInvite(invitation.id); - return false; - }); - - $prompt.find('[data-toggle=accept]').click(function() { - $prompt.remove(); - self._chat.acceptInvite(invitation.id); - return false; - }); - - $prompt.find('[data-toggle=decline]').click(function() { - $prompt.remove(); - self._chat.declineInvite(invitation.id); - return false; - }); - }, - _onChatInviteResponse: function(invitation) { - if (!invitation.status) return; - - var self = this, - template = FirechatDefaultTemplates["templates/prompt-invite-reply.html"], - $prompt; - - if (invitation.status && invitation.status === 'accepted') { - $prompt = this.prompt('Accepted', template(invitation)); - this._chat.getRoom(invitation.roomId, function(room) { - self.attachTab(invitation.roomId, room.name); - }); - } else { - $prompt = this.prompt('Declined', template(invitation)); - } - - $prompt.find('a.close').click(function() { - $prompt.remove(); - return false; - }); - }, - - // Events related to admin or moderator notifications. - _onNotification: function(notification) { - if (notification.notificationType === 'warning') { - this.renderAlertPrompt('Warning', 'You are being warned for inappropriate messaging. Further violation may result in temporary or permanent ban of service.'); - } else if (notification.notificationType === 'suspension') { - var suspendedUntil = notification.data.suspendedUntil, - secondsLeft = Math.round((suspendedUntil - new Date().getTime()) / 1000), - timeLeft = ''; - - if (secondsLeft > 0) { - if (secondsLeft > 2*3600) { - var hours = Math.floor(secondsLeft / 3600); - timeLeft = hours + ' hours, '; - secondsLeft -= 3600*hours; - } - timeLeft += Math.floor(secondsLeft / 60) + ' minutes'; - this.renderAlertPrompt('Suspended', 'A moderator has suspended you for violating site rules. You cannot send messages for another ' + timeLeft + '.'); - } - } - } - }; - - /** - * Initialize an authenticated session with a user id and name. - * This method assumes that the underlying Firebase reference has - * already been authenticated. - */ - FirechatUI.prototype.setUser = function(userId, userName) { - var self = this; - - // Initialize data events - self._chat.setUser(userId, userName, function(user) { - self._user = user; - - if (self._chat.userIsModerator()) { - self._bindSuperuserUIEvents(); - } - - self._chat.resumeSession(); - }); - }; - - /** - * Exposes internal chat bindings via this external interface. - */ - FirechatUI.prototype.on = function(eventType, cb) { - var self = this; - - this._chat.on(eventType, cb); - }; - - /** - * Binds a custom context menu to messages for superusers to warn or ban - * users for violating terms of service. - */ - FirechatUI.prototype._bindSuperuserUIEvents = function() { - var self = this, - parseMessageVars = function(event) { - var $this = $(this), - messageId = $this.closest('[data-message-id]').data('message-id'), - userId = $('[data-message-id="' + messageId + '"]').closest('[data-user-id]').data('user-id'), - roomId = $('[data-message-id="' + messageId + '"]').closest('[data-room-id]').data('room-id'); - - return { messageId: messageId, userId: userId, roomId: roomId }; - }, - clearMessageContextMenus = function() { - // Remove any context menus currently showing. - $('[data-toggle="firechat-contextmenu"]').each(function() { - $(this).remove(); - }); - - // Remove any messages currently highlighted. - $('#firechat .message.highlighted').each(function() { - $(this).removeClass('highlighted'); - }); - }, - showMessageContextMenu = function(event) { - var $this = $(this), - $message = $this.closest('[data-message-id]'), - template = FirechatDefaultTemplates["templates/message-context-menu.html"], - messageVars = parseMessageVars.call(this, event), - $template; - - event.preventDefault(); - - // Clear existing menus. - clearMessageContextMenus(); - - // Highlight the relevant message. - $this.addClass('highlighted'); - - self._chat.getRoom(messageVars.roomId, function(room) { - // Show the context menu. - $template = $(template({ - id: $message.data('message-id') - })); - $template.css({ - left: event.clientX, - top: event.clientY - }).appendTo(self.$wrapper); - }); - }; - - // Handle dismissal of message context menus (any non-right-click click event). - $(document).bind('click', { self: this }, function(event) { - if (!event.button || event.button != 2) { - clearMessageContextMenus(); - } - }); - - // Handle display of message context menus (via right-click on a message). - $(document).delegate('[data-class="firechat-message"]', 'contextmenu', showMessageContextMenu); - - // Handle click of the 'Warn User' contextmenu item. - $(document).delegate('[data-event="firechat-user-warn"]', 'click', function(event) { - var messageVars = parseMessageVars.call(this, event); - self._chat.warnUser(messageVars.userId); - }); - - // Handle click of the 'Suspend User (1 Hour)' contextmenu item. - $(document).delegate('[data-event="firechat-user-suspend-hour"]', 'click', function(event) { - var messageVars = parseMessageVars.call(this, event); - self._chat.suspendUser(messageVars.userId, /* 1 Hour = 3600s */ 60*60); - }); - - // Handle click of the 'Suspend User (1 Day)' contextmenu item. - $(document).delegate('[data-event="firechat-user-suspend-day"]', 'click', function(event) { - var messageVars = parseMessageVars.call(this, event); - self._chat.suspendUser(messageVars.userId, /* 1 Day = 86400s */ 24*60*60); - }); - - // Handle click of the 'Delete Message' contextmenu item. - $(document).delegate('[data-event="firechat-message-delete"]', 'click', function(event) { - var messageVars = parseMessageVars.call(this, event); - self._chat.deleteMessage(messageVars.roomId, messageVars.messageId); - }); - }; - - /** - * Binds to height changes in the surrounding div. - */ - FirechatUI.prototype._bindForHeightChange = function() { - var self = this, - $el = $(this._el), - lastHeight = null; - - setInterval(function() { - var height = $el.height(); - if (height != lastHeight) { - lastHeight = height; - $('.chat').each(function(i, el) { - - }); - } - }, 500); - }; - - /** - * Binds custom inner-tab events. - */ - FirechatUI.prototype._bindForTabControls = function() { - var self = this; - - // Handle click of tab close button. - $(document).delegate('[data-event="firechat-close-tab"]', 'click', function(event) { - var roomId = $(this).closest('[data-room-id]').data('room-id'); - self._chat.leaveRoom(roomId); - return false; - }); - }; - - /** - * Binds room list dropdown to populate room list on-demand. - */ - FirechatUI.prototype._bindForRoomList = function() { - var self = this; - - $('#firechat-btn-rooms').bind('click', function() { - if ($(this).parent().hasClass('open')) { - return; - } - - var $this = $(this), - template = FirechatDefaultTemplates["templates/room-list-item.html"], - selectRoomListItem = function() { - var parent = $(this).parent(), - roomId = parent.data('room-id'), - roomName = parent.data('room-name'); - - if (self.$messages[roomId]) { - self.focusTab(roomId); - } else { - self._chat.enterRoom(roomId, roomName); - } - return false; - }; - - self._chat.getRoomList(function(rooms) { - self.$roomList.empty(); - for (var roomId in rooms) { - var room = rooms[roomId]; - if (room.type != "public") continue; - room.isRoomOpen = !!self.$messages[room.id]; - var $roomItem = $(template(room)); - $roomItem.children('a').bind('click', selectRoomListItem); - self.$roomList.append($roomItem.toggle(true)); - } - }); - }); - }; - - /** - * Binds user list dropdown per room to populate user list on-demand. - */ - FirechatUI.prototype._bindForUserRoomList = function() { - var self = this; - - // Upon click of the dropdown, autofocus the input field and trigger list population. - $(document).delegate('[data-event="firechat-user-room-list-btn"]', 'click', function(event) { - event.stopPropagation(); - - var $this = $(this), - roomId = $this.closest('[data-room-id]').data('room-id'), - template = FirechatDefaultTemplates["templates/room-user-list-item.html"], - targetId = $this.data('target'), - $target = $('#' + targetId); - - $target.empty(); - self._chat.getUsersByRoom(roomId, function(users) { - for (var username in users) { - user = users[username]; - user.disableActions = (!self._user || user.id === self._user.id); - user.nameTrimmed = self.trimWithEllipsis(user.name, self.maxLengthUsernameDisplay); - user.isMuted = (self._user && self._user.muted && self._user.muted[user.id]); - $target.append($(template(user))); - } - self.sortListLexicographically('#' + targetId); - }); - }); - }; - - /** - * Binds user search buttons, dropdowns, and input fields for searching all - * active users currently in chat. - */ - FirechatUI.prototype._bindForUserSearch = function() { - var self = this, - handleUserSearchSubmit = function(event) { - var $this = $(this), - targetId = $this.data('target'), - controlsId = $this.data('controls'), - templateId = $this.data('template'), - prefix = $this.val() || $this.data('prefix') || '', - startAt = $this.data('startAt') || null, - endAt = $this.data('endAt') || null; - - event.preventDefault(); - - userSearch(targetId, templateId, controlsId, prefix, startAt, endAt); - }, - userSearch = function(targetId, templateId, controlsId, prefix, startAt, endAt) { - var $target = $('#' + targetId), - $controls = $('#' + controlsId), - template = FirechatDefaultTemplates[templateId]; - - // Query results, filtered by prefix, using the defined startAt and endAt markets. - self._chat.getUsersByPrefix(prefix, startAt, endAt, self.maxUserSearchResults, function(users) { - var numResults = 0, - $prevBtn, $nextBtn, username, firstResult, lastResult; - - $target.empty(); - - for (username in users) { - var user = users[username]; - - // Disable buttons for . - user.disableActions = (!self._user || user.id === self._user.id); - - numResults += 1; - - $target.append(template(user)); - - // If we've hit our result limit, the additional value signifies we should paginate. - if (numResults === 1) { - firstResult = user.name.toLowerCase(); - } else if (numResults >= self.maxUserSearchResults) { - lastResult = user.name.toLowerCase(); - break; - } - } - - if ($controls) { - $prevBtn = $controls.find('[data-toggle="firechat-pagination-prev"]'); - $nextBtn = $controls.find('[data-toggle="firechat-pagination-next"]'); - - // Sort out configuration for the 'next' button - if (lastResult) { - $nextBtn - .data('event', 'firechat-user-search') - .data('startAt', lastResult) - .data('prefix', prefix) - .removeClass('disabled').removeAttr('disabled'); - } else { - $nextBtn - .data('event', null) - .data('startAt', null) - .data('prefix', null) - .addClass('disabled').attr('disabled', 'disabled'); - } - } - }); - }; - - $(document).delegate('[data-event="firechat-user-search"]', 'keyup', handleUserSearchSubmit); - $(document).delegate('[data-event="firechat-user-search"]', 'click', handleUserSearchSubmit); - - // Upon click of the dropdown, autofocus the input field and trigger list population. - $(document).delegate('[data-event="firechat-user-search-btn"]', 'click', function(event) { - event.stopPropagation(); - var $input = $(this).next('div.firechat-dropdown-menu').find('input'); - $input.focus(); - $input.trigger(jQuery.Event('keyup')); - }); - - // Ensure that the dropdown stays open despite clicking on the input element. - $(document).delegate('[data-event="firechat-user-search"]', 'click', function(event) { - event.stopPropagation(); - }); - }; - - /** - * Binds user mute toggles and removes all messages for a given user upon mute. - */ - FirechatUI.prototype._bindForUserMuting = function() { - var self = this; - $(document).delegate('[data-event="firechat-user-mute-toggle"]', 'click', function(event) { - var $this = $(this), - userId = $this.closest('[data-user-id]').data('user-id'), - userName = $this.closest('[data-user-name]').data('user-name'), - isMuted = $this.hasClass('red'), - template = FirechatDefaultTemplates["templates/prompt-user-mute.html"]; - - event.preventDefault(); - - // Require user confirmation for muting. - if (!isMuted) { - var $prompt = self.prompt('Mute User?', template({ - userName: userName - })); - - $prompt.find('a.close').first().click(function() { - $prompt.remove(); - return false; - }); - - $prompt.find('[data-toggle=decline]').first().click(function() { - $prompt.remove(); - return false; - }); - - $prompt.find('[data-toggle=accept]').first().click(function() { - self._chat.toggleUserMute(userId); - $prompt.remove(); - return false; - }); - } else { - self._chat.toggleUserMute(userId); - } - }); - }; - - /** - * Binds to elements with the data-event='firechat-user-(private)-invite' and - * handles invitations as well as room creation and entering. - */ - FirechatUI.prototype._bindForChatInvites = function() { - var self = this, - renderInvitePrompt = function(event) { - var $this = $(this), - userId = $this.closest('[data-user-id]').data('user-id'), - roomId = $this.closest('[data-room-id]').data('room-id'), - userName = $this.closest('[data-user-name]').data('user-name'), - template = FirechatDefaultTemplates["templates/prompt-invite-private.html"], - $prompt; - - self._chat.getRoom(roomId, function(room) { - $prompt = self.prompt('Invite', template({ - userName: userName, - roomName: room.name - })); - - $prompt.find('a.close').click(function() { - $prompt.remove(); - return false; - }); - - $prompt.find('[data-toggle=decline]').click(function() { - $prompt.remove(); - return false; - }); - - $prompt.find('[data-toggle=accept]').first().click(function() { - $prompt.remove(); - self._chat.inviteUser(userId, roomId, room.name); - return false; - }); - return false; - }); - return false; - }, - renderPrivateInvitePrompt = function(event) { - var $this = $(this), - userId = $this.closest('[data-user-id]').data('user-id'), - userName = $this.closest('[data-user-name]').data('user-name'), - template = FirechatDefaultTemplates["templates/prompt-invite-private.html"], - $prompt; - - if (userId && userName) { - $prompt = self.prompt('Private Invite', template({ - userName: userName, - roomName: 'Private Chat' - })); - - $prompt.find('a.close').click(function() { - $prompt.remove(); - return false; - }); - - $prompt.find('[data-toggle=decline]').click(function() { - $prompt.remove(); - return false; - }); - - $prompt.find('[data-toggle=accept]').first().click(function() { - $prompt.remove(); - var roomName = 'Private Chat'; - self._chat.createRoom(roomName, 'private', function(roomId) { - self._chat.inviteUser(userId, roomId, roomName); - }); - return false; - }); - } - return false; - }; - - $(document).delegate('[data-event="firechat-user-chat"]', 'click', renderPrivateInvitePrompt); - $(document).delegate('[data-event="firechat-user-invite"]', 'click', renderInvitePrompt); - }; - - /** - * Binds to room dropdown button, menu items, and create room button. - */ - FirechatUI.prototype._bindForRoomListing = function() { - var self = this, - $createRoomPromptButton = $('#firechat-btn-create-room-prompt'), - $createRoomButton = $('#firechat-btn-create-room'), - renderRoomList = function(event) { - var type = $(this).data('room-type'); - - self.sortListLexicographically('#firechat-room-list'); - }; - - // Handle click of the create new room prompt-button. - $createRoomPromptButton.bind('click', function(event) { - self.promptCreateRoom(); - return false; - }); - - // Handle click of the create new room button. - $createRoomButton.bind('click', function(event) { - var roomName = $('#firechat-input-room-name').val(); - $('#firechat-prompt-create-room').remove(); - self._chat.createRoom(roomName); - return false; - }); - }; - - /** - * A stripped-down version of bootstrap-tab.js. - * - * Original bootstrap-tab.js Copyright 2012 Twitter, Inc.,licensed under the Apache v2.0 - */ - FirechatUI.prototype._setupTabs = function() { - var self = this, - show = function($el) { - var $this = $el, - $ul = $this.closest('ul:not(.firechat-dropdown-menu)'), - selector = $this.attr('data-target'), - previous = $ul.find('.active:last a')[0], - $target, - e; - - if (!selector) { - selector = $this.attr('href'); - selector = selector && selector.replace(/.*(?=#[^\s]*$)/, ''); - } - - if ($this.parent('li').hasClass('active')) return; - - e = $.Event('show', { relatedTarget: previous }); - - $this.trigger(e); - - if (e.isDefaultPrevented()) return; - - $target = $(selector); - - activate($this.parent('li'), $ul); - activate($target, $target.parent(), function () { - $this.trigger({ - type: 'shown', - relatedTarget: previous - }); - }); - }, - activate = function (element, container, callback) { - var $active = container.find('> .active'), - transition = callback && $.support.transition && $active.hasClass('fade'); - - function next() { - $active - .removeClass('active') - .find('> .firechat-dropdown-menu > .active') - .removeClass('active'); - - element.addClass('active'); - - if (transition) { - element.addClass('in'); - } else { - element.removeClass('fade'); - } - - if (element.parent('.firechat-dropdown-menu')) { - element.closest('li.firechat-dropdown').addClass('active'); - } - - if (callback) { - callback(); - } - } - - if (transition) { - $active.one($.support.transition.end, next); - } else { - next(); - } - - $active.removeClass('in'); - }; - - $(document).delegate('[data-toggle="firechat-tab"]', 'click', function(event) { - event.preventDefault(); - show($(this)); - }); - }; - - /** - * A stripped-down version of bootstrap-dropdown.js. - * - * Original bootstrap-dropdown.js Copyright 2012 Twitter, Inc., licensed under the Apache v2.0 - */ - FirechatUI.prototype._setupDropdowns = function() { - var self = this, - toggle = '[data-toggle=firechat-dropdown]', - toggleDropdown = function(event) { - var $this = $(this), - $parent = getParent($this), - isActive = $parent.hasClass('open'); - - if ($this.is('.disabled, :disabled')) return; - - clearMenus(); - - if (!isActive) { - $parent.toggleClass('open'); - } - - $this.focus(); - - return false; - }, - clearMenus = function() { - $('[data-toggle=firechat-dropdown]').each(function() { - getParent($(this)).removeClass('open'); - }); - }, - getParent = function($this) { - var selector = $this.attr('data-target'), - $parent; - - if (!selector) { - selector = $this.attr('href'); - selector = selector && /#/.test(selector) && selector.replace(/.*(?=#[^\s]*$)/, ''); - } - - $parent = selector && $(selector); - - if (!$parent || !$parent.length) $parent = $this.parent(); - - return $parent; - }; - - $(document) - .bind('click', clearMenus) - .delegate('.firechat-dropdown-menu', 'click', function(event) { event.stopPropagation(); }) - .delegate('[data-toggle=firechat-dropdown]', 'click', toggleDropdown); - }; - - /** - * Binds to any text input fields with data-provide='limit' and - * data-counter='', and upon value change updates the selector - * content to reflect the number of characters remaining, as the 'maxlength' - * attribute less the current value length. - */ - FirechatUI.prototype._bindTextInputFieldLimits = function() { - $('body').delegate('input[data-provide="limit"], textarea[data-provide="limit"]', 'keyup', function(event) { - var $this = $(this), - $target = $($this.data('counter')), - limit = $this.attr('maxlength'), - count = $this.val().length; - - $target.html(Math.max(0, limit - count)); - }); - }; - - /** - * Given a title and message content, show an alert prompt to the user. - * - * @param {string} title - * @param {string} message - */ - FirechatUI.prototype.renderAlertPrompt = function(title, message) { - var template = FirechatDefaultTemplates["templates/prompt-alert.html"], - $prompt = this.prompt(title, template({ message: message })); - - $prompt.find('.close').click(function() { - $prompt.remove(); - return false; - }); - return; - }; - - /** - * Toggle input field s if we want limit / unlimit input fields. - */ - FirechatUI.prototype.toggleInputs = function(isEnabled) { - $('#firechat-tab-content textarea').each(function() { - var $this = $(this); - if (isEnabled) { - $(this).val(''); - } else { - $(this).val('You have exceeded the message limit, please wait before sending.'); - } - $this.prop('disabled', !isEnabled); - }); - $('#firechat-input-name').prop('disabled', !isEnabled); - }; - - /** - * Given a room id and name, attach the tab to the interface and setup events. - * - * @param {string} roomId - * @param {string} roomName - */ - FirechatUI.prototype.attachTab = function(roomId, roomName) { - var self = this; - - // If this tab already exists, give it focus. - if (this.$messages[roomId]) { - this.focusTab(roomId); - return; - } - - var room = { - id: roomId, - name: roomName - }; - - // Populate and render the tab content template. - var tabTemplate = FirechatDefaultTemplates["templates/tab-content.html"]; - var $tabContent = $(tabTemplate(room)); - this.$tabContent.prepend($tabContent); - var $messages = $('#firechat-messages' + roomId); - - // Keep a reference to the message listing for later use. - this.$messages[roomId] = $messages; - - // Attach on-enter event to textarea. - var $textarea = $tabContent.find('textarea').first(); - $textarea.bind('keydown', function(e) { - var message = self.trimWithEllipsis($textarea.val(), self.maxLengthMessage); - if ((e.which === 13) && (message !== '')) { - $textarea.val(''); - self._chat.sendMessage(roomId, message); - return false; - } - }); - - // Populate and render the tab menu template. - var tabListTemplate = FirechatDefaultTemplates["templates/tab-menu-item.html"]; - var $tab = $(tabListTemplate(room)); - this.$tabList.prepend($tab); - - // Attach on-shown event to move tab to front and scroll to bottom. - $tab.bind('shown', function(event) { - $messages.scrollTop($messages[0].scrollHeight); - }); - - // Dynamically update the width of each tab based upon the number open. - var tabs = this.$tabList.children('li'); - var tabWidth = Math.floor($('#firechat-tab-list').width() / tabs.length); - this.$tabList.children('li').css('width', tabWidth); - - // Update the room listing to reflect that we're now in the room. - this.$roomList.children('[data-room-id=' + roomId + ']').children('a').addClass('highlight'); - - // Sort each item in the user list alphabetically on click of the dropdown. - $('#firechat-btn-room-user-list-' + roomId).bind('click', function() { - self.sortListLexicographically('#firechat-room-user-list-' + roomId); - return false; - }); - - // Automatically select the new tab. - this.focusTab(roomId); - }; - - /** - * Given a room id, focus the given tab. - * - * @param {string} roomId - */ - FirechatUI.prototype.focusTab = function(roomId) { - if (this.$messages[roomId]) { - var $tabLink = this.$tabList.find('[data-room-id=' + roomId + ']').find('a'); - if ($tabLink.length) { - $tabLink.first().trigger('click'); - } - } - }; - - /** - * Given a room id, remove the tab and all child elements from the interface. - * - * @param {string} roomId - */ - FirechatUI.prototype.removeTab = function(roomId) { - delete this.$messages[roomId]; - - // Remove the inner tab content. - this.$tabContent.find('[data-room-id=' + roomId + ']').remove(); - - // Remove the tab from the navigation menu. - this.$tabList.find('[data-room-id=' + roomId + ']').remove(); - - // Dynamically update the width of each tab based upon the number open. - var tabs = this.$tabList.children('li'); - var tabWidth = Math.floor($('#firechat-tab-list').width() / tabs.length); - this.$tabList.children('li').css('width', tabWidth); - - // Automatically select the next tab if there is one. - this.$tabList.find('[data-toggle="firechat-tab"]').first().trigger('click'); - - // Update the room listing to reflect that we're now in the room. - this.$roomList.children('[data-room-id=' + roomId + ']').children('a').removeClass('highlight'); - }; - - /** - * Render a new message in the specified chat room. - * - * @param {string} roomId - * @param {string} message - */ - FirechatUI.prototype.showMessage = function(roomId, rawMessage) { - var self = this; - - // Setup defaults - var message = { - id : rawMessage.id, - localtime : self.formatTime(rawMessage.timestamp), - message : rawMessage.message || '', - userId : rawMessage.userId, - name : rawMessage.name, - type : rawMessage.type || 'default', - isSelfMessage : (self._user && rawMessage.userId == self._user.id), - disableActions : (!self._user || rawMessage.userId == self._user.id) - }; - - // While other data is escaped in the Underscore.js templates, escape and - // process the message content here to add additional functionality (add links). - // Also trim the message length to some client-defined maximum. - var messageConstructed = ''; - message.message = _.map(message.message.split(' '), function(token) { - if (self.urlPattern.test(token) || self.pseudoUrlPattern.test(token)) { - return self.linkify(encodeURI(token)); - } else { - return _.escape(token); - } - }).join(' '); - message.message = self.trimWithEllipsis(message.message, self.maxLengthMessage); - - // Populate and render the message template. - var template = FirechatDefaultTemplates["templates/message.html"]; - var $message = $(template(message)); - var $messages = self.$messages[roomId]; - if ($messages) { - - var scrollToBottom = false; - if ($messages.scrollTop() / ($messages[0].scrollHeight - $messages[0].offsetHeight) >= 0.95) { - // Pinned to bottom - scrollToBottom = true; - } else if ($messages[0].scrollHeight <= $messages.height()) { - // Haven't added the scrollbar yet - scrollToBottom = true; - } - - $messages.append($message); - - if (scrollToBottom) { - $messages.scrollTop($messages[0].scrollHeight); - } - } - }; - - /** - * Remove a message by id. - * - * @param {string} roomId - * @param {string} messageId - */ - FirechatUI.prototype.removeMessage = function(roomId, messageId) { - $('.message[data-message-id="' + messageId + '"]').remove(); - }; - - /** - * Given a selector for a list element, sort the items alphabetically. - * - * @param {string} selector - */ - FirechatUI.prototype.sortListLexicographically = function(selector) { - $(selector).children("li").sort(function(a, b) { - var upA = $(a).text().toUpperCase(); - var upB = $(b).text().toUpperCase(); - return (upA < upB) ? -1 : (upA > upB) ? 1 : 0; - }).appendTo(selector); - }; - - /** - * Remove leading and trailing whitespace from a string and shrink it, with - * added ellipsis, if it exceeds a specified length. - * - * @param {string} str - * @param {number} length - * @return {string} - */ - FirechatUI.prototype.trimWithEllipsis = function(str, length) { - str = str.replace(/^\s\s*/, '').replace(/\s\s*$/, ''); - return (length && str.length <= length) ? str : str.substring(0, length) + '...'; - }; - - /** - * Given a timestamp, format it in the form hh:mm am/pm. Defaults to now - * if the timestamp is undefined. - * - * @param {Number} timestamp - * @param {string} date - */ - FirechatUI.prototype.formatTime = function(timestamp) { - var date = (timestamp) ? new Date(timestamp) : new Date(), - hours = date.getHours() || 12, - minutes = '' + date.getMinutes(), - ampm = (date.getHours() >= 12) ? 'pm' : 'am'; - - hours = (hours > 12) ? hours - 12 : hours; - minutes = (minutes.length < 2) ? '0' + minutes : minutes; - return '' + hours + ':' + minutes + ampm; - }; - - /** - * Launch a prompt to allow the user to create a new room. - */ - FirechatUI.prototype.promptCreateRoom = function() { - var self = this; - var template = FirechatDefaultTemplates["templates/prompt-create-room.html"]; - - var $prompt = this.prompt('Create Public Room', template({ - maxLengthRoomName: this.maxLengthRoomName, - isModerator: self._chat.userIsModerator() - })); - $prompt.find('a.close').first().click(function() { - $prompt.remove(); - return false; - }); - - - $prompt.find('[data-toggle=submit]').first().click(function() { - var name = $prompt.find('[data-input=firechat-room-name]').first().val(); - if (name !== '') { - self._chat.createRoom(name, 'public'); - $prompt.remove(); - } - return false; - }); - - $prompt.find('[data-input=firechat-room-name]').first().focus(); - $prompt.find('[data-input=firechat-room-name]').first().bind('keydown', function(e) { - if (e.which === 13) { - var name = $prompt.find('[data-input=firechat-room-name]').first().val(); - if (name !== '') { - self._chat.createRoom(name, 'public'); - $prompt.remove(); - return false; - } - } - }); - }; - - /** - * Inner method to launch a prompt given a specific title and HTML content. - * @param {string} title - * @param {string} content - */ - FirechatUI.prototype.prompt = function(title, content) { - var template = FirechatDefaultTemplates["templates/prompt.html"], - $prompt; - - $prompt = $(template({ - title: title, - content: content - })).css({ - top: this.$wrapper.position().top + (0.333 * this.$wrapper.height()), - left: this.$wrapper.position().left + (0.125 * this.$wrapper.width()), - width: 0.75 * this.$wrapper.width() - }); - this.$wrapper.append($prompt.removeClass('hidden')); - return $prompt; - }; - - // see http://stackoverflow.com/questions/37684/how-to-replace-plain-urls-with-links - FirechatUI.prototype.linkify = function(str) { - var self = this; - return str - .replace(self.urlPattern, '$&') - .replace(self.pseudoUrlPattern, '$1$2'); - }; - -})(jQuery); diff --git a/website/index.html b/website/index.html index e806303..76c63c7 100644 --- a/website/index.html +++ b/website/index.html @@ -2,316 +2,253 @@ - - Firechat - open source chat built on Firebase - - - - - - - - - - + + Firechat - open source chat built on Firebase + + + + + + + + + + - + Fork me on GitHub - + -
              +
              -
              -
              -
              - Home - Documentation -
              -
              Firechat
              -
              Open-source real-time chat, built on Firebase
              +
              +
              +
              + Home + Documentation
              +
              Firechat
              +
              Open-source real-time chat, built on Firebase
              +
              -
              -
              -
              - - - -
              -
              -
              -
              -
              -
              - Logged in as . - Logout -
              -
              +
              +
              +
              + + + +
              +
              +
              +
              +
              +
              + Logged in as . + Logout
              +
              -
              +
              + -
              +
              -
              - +
              + +
              -
              -
              Real-time chat with no server code.
              -
              -
              -
              -

              What is Firechat?

              -

              - Firechat is an open-source, real-time chat widget built on Firebase. It offers fully secure - multi-user, multi-room chat with flexible authentication, moderator features, user presence - and search, private messaging, chat invitations, and more. -

              -
              -
              -

              Which technologies does Firechat use?

              -

              - The core data layer under Firechat uses Firebase - for real-time data synchronization and persistence. -

              - The default interface uses jQuery, Underscore.js, and Bootstrap. Icons by Glyphicons. Build and compilation - managed with Grunt and code hosted by GitHub. -

              -
              -
              -
              -
              -

              What can I do with Firechat?

              -

              - With Firechat, you get full-featured chat in your application with a few simple script - includes. Additionally, Firechat is easy to modify and extend. Based upon it's simple - underlying data model and Firebase-powered - data synchronization, it's easy to add new features, modify the UI, and customize to fit - your specific needs. -

              -

              - If Firechat doesn't currently meet your needs, feel free to fork the repo and tweak the - code! -

              -
              -
              -

              Who's behind Firechat?

              -

              - Firechat was built by the folks at Firebase - in San Francisco, California. -

              - Community submissions are encouraged! Star Firechat on GitHub and - send a pull request when you're ready to contribute! -

              -
              -
              -
              -
              -

              Who's using Firechat?

              -

              -

              - - CBS Big Brother Live Feeds -
              -

              -
              -
              -

              How is Firechat Licensed?

              -

              - Firechat is published under the MIT - license. -

              -
              -
              +
              +
              Real-time chat with no server code.
              +
              +
              +
              +

              What is Firechat?

              +

              + Firechat is an open-source, real-time chat widget built on Firebase. It offers fully secure multi-user, multi-room chat with flexible authentication, moderator features, user presence and search, private messaging, chat invitations, and more. +

              +
              +
              +

              Which technologies does Firechat use?

              +

              + The core data layer under Firechat uses Firebase for real-time data synchronization and persistence. +

              + The default interface uses jQuery, Underscore.js, and Bootstrap. Icons by Glyphicons. Build and compilation managed with Grunt and code hosted by GitHub. +

              +
              +
              +
              +
              +

              What can I do with Firechat?

              +

              + With Firechat, you get full-featured chat in your application with a few simple script includes. Additionally, Firechat is easy to modify and extend. Based upon it's simple underlying data model and Firebase-powered data synchronization, it's easy to add new features, modify the UI, and customize to fit your specific needs. +

              +

              + If Firechat doesn't currently meet your needs, feel free to fork the repo and tweak the code! +

              +
              +
              +

              Who's behind Firechat?

              +

              + Firechat was built by the folks at Firebase in San Francisco, California. +

              + Community submissions are encouraged! Star Firechat on GitHub and send a pull request when you're ready to contribute! +

              +
              +
              +
              +
              +

              Who's using Firechat?

              +

              +

              + + CBS Big Brother Live Feeds +
              +

              +
              +
              +

              How is Firechat Licensed?

              +

              + Firechat is published under the MIT license. +

              +
              +
              +
              -
              -
              +
              - -