Mercurial > eldonilo > lightstring
annotate plugins.js @ 12:9fbd0e3678b5
add comments, jsdoc syntax + move the parser and the serializer to the Lightstring namespace so they don't get recreated at every new Lightstring.Connection
author | Sonny Piers <sonny.piers@gmail.com> |
---|---|
date | Sun, 15 Jan 2012 03:47:28 +0100 |
parents | 08a8d8c4c324 |
children | 6707f450549e |
rev | line source |
---|---|
0 | 1 'use strict'; |
2 | |
2 | 3 /** |
4 Copyright (c) 2011, Sonny Piers <sonny at fastmail dot net> | |
5 | |
6 Permission to use, copy, modify, and/or distribute this software for any | |
7 purpose with or without fee is hereby granted, provided that the above | |
8 copyright notice and this permission notice appear in all copies. | |
9 | |
10 THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES | |
11 WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF | |
12 MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR | |
13 ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES | |
14 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN | |
15 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF | |
16 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. | |
17 */ | |
18 | |
7 | 19 ////////// |
20 //Roster// | |
21 ////////// | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
22 Lightstring.NS.roster = 'jabber:iq:roster'; |
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
23 Lightstring.stanza.roster = { |
0 | 24 'get': function() { |
2 | 25 return "<iq type='get'><query xmlns='"+Lightstring.NS.roster+"'/></iq>"; |
0 | 26 }, |
27 add: function(aAddress, aGroups, aCustomName) { | |
2 | 28 var iq = $iq({type: 'set'}).c('query', {xmlns: Lightstring.NS.roster}).c('item', {jid: aAddress}).tree(); |
0 | 29 if(aCustomName) iq.querySelector('item').setAttribute(aCustomName); |
30 for (var i=0; i<aGroups.length; i++) { | |
31 if(i === 0) iq.querySelector('item').appendChild(document.createElement('group')); | |
32 iq.querySelector('group').appendChild(document.createElement(aGroups[i])); | |
33 } | |
34 return iq; | |
35 }, | |
36 remove: function(aAddress) { | |
2 | 37 return $iq({type: 'set'}).c('query', {xmlns: Lightstring.NS.roster}).c('item', {jid: aAddress, subscription: 'remove'}).tree(); |
0 | 38 } |
39 }; | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
40 Lightstring.getRoster = function(connection, aCallback) { |
0 | 41 connection.send(this.stanza.roster.get(), function(answer){ |
42 var contacts = []; | |
8 | 43 var elems = answer.querySelectorAll('item'); |
44 for(var i = 0; i<elms.length; i++) { | |
45 var item = elms[i]; | |
7 | 46 var jid = item.getAttribute('jid'); |
47 var name = item.getAttribute('name'); | |
48 var groups = item.querySelectorAll('group'); | |
49 var subscription = item.getAttribute('subscription'); | |
50 var contact = {}; | |
51 if(name) | |
52 contact.name = name; | |
53 if(jid) | |
54 contact.jid = jid; | |
55 if(subscription) | |
56 contact.subscription = subscription; | |
57 if(groups.length > 0) { | |
58 contact.groups = []; | |
59 groups.forEach(function(group) { | |
60 contact.groups.push(group.textContent); | |
61 }); | |
62 } | |
0 | 63 |
7 | 64 contacts.push(contact); |
65 }; | |
0 | 66 aCallback(contacts); |
67 }); | |
68 } | |
7 | 69 ///////// |
70 //vCard// | |
71 ///////// | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
72 Lightstring.NS.vcard = 'vcard-temp'; |
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
73 Lightstring.stanza.vcard = { |
0 | 74 'get': function(aTo) { |
75 if(aTo) | |
2 | 76 return "<iq type='get' to='"+aTo+"'><vCard xmlns='"+Lightstring.NS.vcard+"'/></iq>"; |
0 | 77 else |
2 | 78 return "<iq type='get'><vCard xmlns='"+Lightstring.NS.vcard+"'/></iq>"; |
0 | 79 } |
80 }; | |
81 //FIXME we should return a proper vcard, not an XMPP one | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
82 Lightstring.getVcard = function(aConnection, aTo, aCallback) { |
2 | 83 aConnection.send(Lightstring.stanza.vcard.get(aTo), function(answer, err){ |
0 | 84 if(answer) { |
85 var vcard = answer.querySelector('vCard'); | |
86 if(vcard) | |
87 aCallback(vcard); | |
88 } | |
89 else | |
90 aCallback(null); | |
91 }); | |
92 } | |
7 | 93 ///////// |
94 //Disco// | |
95 ///////// | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
96 Lightstring.NS['disco#info'] = "http://jabber.org/protocol/disco#info"; |
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
97 Lightstring.NS['disco#items'] = "http://jabber.org/protocol/disco#items"; |
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
98 Lightstring.stanza.disco = { |
0 | 99 items: function(aTo, aNode) { |
100 if(aTo) | |
101 var iq = "<iq type='get' to='"+aTo+"'>"; | |
102 else | |
103 var iq = "<iq type='get'>"; | |
104 | |
105 if(aNode) | |
2 | 106 var query = "<query xmlns='"+Lightstring.NS['disco#items']+"' node='"+aNode+"'/>"; |
0 | 107 else |
2 | 108 var query = "<query xmlns='"+Lightstring.NS['disco#items']+"'/>"; |
0 | 109 |
110 return iq+query+"</iq>"; | |
111 }, | |
112 info: function(aTo, aNode) { | |
113 if(aTo) | |
114 var iq = "<iq type='get' to='"+aTo+"'>"; | |
115 else | |
116 var iq = "<iq type='get'>"; | |
117 if(aNode) | |
2 | 118 var query = "<query xmlns='"+Lightstring.NS['disco#info']+"' node='"+aNode+"'/>"; |
0 | 119 else |
2 | 120 var query = "<query xmlns='"+Lightstring.NS['disco#info']+"'/>"; |
0 | 121 |
122 return iq+query+"</iq>"; | |
123 } | |
124 }; | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
125 Lightstring.discoItems = function(aConnection, aTo, aCallback) { |
2 | 126 aConnection.send(Lightstring.stanza.disco.items(aTo), function(answer){ |
0 | 127 var items = []; |
8 | 128 var elms = answer.querySelectorAll('item'); |
129 for(var i = 0; i < elms.length; i++) { | |
130 var node = elms[i]; | |
0 | 131 var item = { |
132 jid: node.getAttribute('jid'), | |
133 name: node.getAttribute('name'), | |
134 node: node.getAttribute('node') | |
135 } | |
136 items.push(item); | |
8 | 137 }; |
0 | 138 if(aCallback) |
139 aCallback(items); | |
140 }); | |
141 }; | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
142 Lightstring.discoInfo = function(aConnection, aTo, aNode, aCallback) { |
2 | 143 aConnection.send(Lightstring.stanza.disco.info(aTo, aNode), function(answer){ |
0 | 144 var field = answer.querySelector('field[var="pubsub#creator"] > value'); |
145 var creator = field ? field.textContent : ''; | |
146 //FIXME callback the entire data | |
147 aCallback(creator); | |
148 }); | |
149 }; | |
7 | 150 ////////// |
151 //PubSub// | |
152 ////////// | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
153 Lightstring.NS.x = "jabber:x:data"; |
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
154 Lightstring.NS.pubsub = "http://jabber.org/protocol/pubsub"; |
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
155 Lightstring.NS.pubsub_owner = "http://jabber.org/protocol/pubsub#owner"; |
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
156 Lightstring.stanza.pubsub = { |
0 | 157 getConfig: function(aTo, aNode) { |
2 | 158 return "<iq type='get' to='"+aTo+"'><pubsub xmlns='"+Lightstring.NS.pubsub_owner+"'><configure node='"+aNode+"'/></pubsub></iq>"; |
0 | 159 }, |
160 items: function(aTo, aNode) { | |
2 | 161 return "<iq type='get' to='"+aTo+"'><pubsub xmlns='"+Lightstring.NS.pubsub+"'><items node='"+aNode+"'/></pubsub></iq>"; |
0 | 162 }, |
163 affiliations: function(aTo, aNode) { | |
2 | 164 return "<iq type='get' to='"+aTo+"'><pubsub xmlns='"+Lightstring.NS.pubsub_owner+"'><affiliations node='"+aNode+"'/></pubsub></iq>"; |
0 | 165 }, |
166 publish: function(aTo, aNode, aItem, aId) { | |
2 | 167 return "<iq type='set' to='"+aTo+"'><pubsub xmlns='"+Lightstring.NS.pubsub+"'><publish node='"+aNode+"'><item id='"+aId+"'>"+aItem+"</item></publish></pubsub></iq>"; |
0 | 168 }, |
169 retract: function(aTo, aNode, aItem) { | |
2 | 170 return "<iq type='set' to='"+aTo+"'><pubsub xmlns='"+Lightstring.NS.pubsub+"'><retract node='"+aNode+"'><item id='"+aItem+"'/></retract></pubsub></iq>"; |
0 | 171 }, |
172 'delete': function(aTo, aNode, aURI) { | |
2 | 173 return "<iq type='set' to='"+aTo+"'><pubsub xmlns='"+Lightstring.NS.pubsub_owner+"'><delete node='"+aNode+"'/></pubsub></iq>"; |
0 | 174 }, |
175 create: function(aTo, aNode, aFields) { | |
2 | 176 var iq = "<iq type='set' to='"+aTo+"'><pubsub xmlns='"+Lightstring.NS.pubsub+"'><create node='"+aNode+"'/>"; |
0 | 177 if(aFields) { |
2 | 178 iq += "<configure><x xmlns='"+Lightstring.NS.x+"' type='submit'>" |
0 | 179 aFields.forEach(function(field) { |
180 iq += field; | |
181 }); | |
182 iq += "</x></configure>"; | |
183 } | |
184 iq += "</pubsub></iq>"; | |
185 return iq; | |
186 }, | |
187 setAffiliations: function(aTo, aNode, aAffiliations) { | |
2 | 188 var iq = "<iq type='set' to='"+aTo+"'><pubsub xmlns='"+Lightstring.NS.pubsub_owner+"'><affiliations node='"+aNode+"'>"; |
0 | 189 for(var i = 0; i < aAffiliations.length; i++) { |
190 iq += "<affiliation jid='"+aAffiliations[i][0]+"' affiliation='"+aAffiliations[i][1]+"'/>" | |
191 } | |
192 iq += "</affiliations></pubsub></iq>"; | |
193 return iq; | |
194 }, | |
195 }; | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
196 Lightstring.pubsubItems = function(aConnection, aTo, aNode, aCallback) { |
2 | 197 aConnection.send(Lightstring.stanza.pubsub.items(aTo, aNode), function(answer){ |
0 | 198 var items = []; |
8 | 199 var elms = answer.querySelectorAll('item'); |
200 for(var i = 0; i < elms.length; i++) { | |
201 var node = elms[i]; | |
0 | 202 var item = { |
203 id: node.getAttribute('id'), | |
204 name: node.querySelector('title').textContent, | |
205 src: node.querySelector('content').getAttribute('src'), | |
206 type: node.querySelector('content').getAttribute('type'), | |
207 } | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
208 var miniature = node.querySelector('link'); |
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
209 if(miniature) |
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
210 item.miniature = miniature.getAttribute('href'); |
0 | 211 items.push(item); |
8 | 212 }; |
0 | 213 if(aCallback) |
214 aCallback(items); | |
215 }); | |
216 } | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
217 Lightstring.pubsubCreate = function(aConnection, aTo, aNode, aFields, aCallback) { |
2 | 218 aConnection.send(Lightstring.stanza.pubsub.create(aTo, aNode, aFields), function(answer) { |
0 | 219 if(answer.getAttribute('type') === 'result') |
220 aCallback(null, answer); | |
221 else | |
222 aCallback(answer, null); | |
223 }); | |
224 }; | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
225 Lightstring.pubsubConfig = function(aConnection, aTo, aNode, aCallback) { |
2 | 226 aConnection.send(Lightstring.stanza.pubsub.getConfig(aTo, aNode), function(answer){ |
0 | 227 var accessmodel = answer.querySelector('field[var="pubsub#access_model"]').lastChild.textContent; |
228 if(accessmodel) | |
229 aCallback(accessmodel); | |
230 else | |
231 aCallback(null); | |
232 }); | |
233 } | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
234 Lightstring.pubsubRetract = function(aConnection, aTo, aNode, aItem, aCallback) { |
2 | 235 aConnection.send(Lightstring.stanza.pubsub.retract(aTo, aNode, aItem), function(answer){ |
0 | 236 if(aCallback) |
237 aCallback(answer); | |
238 }); | |
239 } | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
240 Lightstring.pubsubPublish = function(aConnection, aTo, aNode, aItem, aId, aCallback) { |
2 | 241 aConnection.send(Lightstring.stanza.pubsub.publish(aTo, aNode, aItem, aId), function(answer){ |
0 | 242 if(answer.getAttribute('type') === 'result') |
243 aCallback(null, answer); | |
244 else | |
245 aCallback(answer, null); | |
246 }); | |
247 } | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
248 Lightstring.pubsubDelete = function(aConnection, aTo, aNode, aCallback) { |
2 | 249 aConnection.send(Lightstring.stanza.pubsub.delete(aTo, aNode), function(answer){ |
0 | 250 if(aCallback) |
251 aCallback(answer); | |
252 }); | |
253 } | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
254 Lightstring.pubsubGetAffiliations = function(aConnection, aTo, aNode, aCallback) { |
2 | 255 aConnection.send(Lightstring.stanza.pubsub.affiliations(aTo, aNode), function(answer) { |
0 | 256 if((answer.getAttribute('type') === 'result') && aCallback) { |
257 var affiliations = {}; | |
258 answer.querySelectorAll('affiliation').forEach(function(affiliation) { | |
259 affiliations[affiliation.getAttribute("jid")] = affiliation.getAttribute("affiliation"); | |
260 }) | |
261 aCallback(affiliations); | |
262 } | |
263 }); | |
264 }; | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
265 Lightstring.pubsubSetAffiliations = function(aConnection, aTo, aNode, aAffiliations, aCallback) { |
2 | 266 aConnection.send(Lightstring.stanza.pubsub.setAffiliations(aTo, aNode, aAffiliations)); |
0 | 267 }; |
7 | 268 ////// |
269 //IM// | |
270 ////// | |
3
029c12b8f048
various bug fixes and improvements
Sonny Piers <sonny.piers@gmail.com>
parents:
2
diff
changeset
|
271 Lightstring.stanza.message = { |
0 | 272 normal: function(aTo, aSubject, aText) { |
273 return "<message type='normal' to='"+aTo+"'><subject>"+aSubject+"</subject><body>"+aText+"</body></message>"; | |
274 }, | |
275 chat: function(aTo, aText) { | |
276 return "<message type='chat' to='"+aTo+"'><body>"+aText+"</body></message>"; | |
277 } | |
278 }; | |
279 |