Mercurial > psgxs
annotate configuration.js @ 27:a36a514e8be8
Learned that “hg addremove” can be good, sometimes.
| author | Emmanuel Gil Peyrot <linkmauve@linkmauve.fr> |
|---|---|
| date | Mon, 01 Nov 2010 02:41:04 +0100 |
| parents | f2e9365bc8ec |
| children | bc717575e66a |
| rev | line source |
|---|---|
| 0 | 1 /* |
| 2 * Copyright (C) 2010 Emmanuel Gil Peyrot <linkmauve@linkmauve.fr> | |
| 3 * | |
| 4 * This file is part of PSĜS, a PubSub server written in JavaScript. | |
| 5 * | |
| 6 * PSĜS is free software: you can redistribute it and/or modify | |
| 7 * it under the terms of the GNU Affero General Public License as | |
| 8 * published by the Free Software Foundation, either version 3 of the | |
| 9 * License. | |
| 10 * | |
| 11 * PSĜS is distributed in the hope that it will be useful, | |
| 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
| 14 * GNU Affero General Public License for more details. | |
| 15 * | |
| 16 * You should have received a copy of the GNU Affero General Public License | |
| 17 * along with PSĜS. If not, see <http://www.gnu.org/licenses/>. | |
| 18 */ | |
| 19 | |
| 20 var config = exports; | |
| 21 | |
| 22 config.jid = 'pubsub.example.org'; | |
|
1
c2954a9e5665
Add a super-owner that has power over all nodes; add support for
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
0
diff
changeset
|
23 config.password = 'hellohello'; |
|
c2954a9e5665
Add a super-owner that has power over all nodes; add support for
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
0
diff
changeset
|
24 config.superOwner = ['you@example.com']; |
|
c2954a9e5665
Add a super-owner that has power over all nodes; add support for
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
0
diff
changeset
|
25 config.version = '0.1'; |
|
c2954a9e5665
Add a super-owner that has power over all nodes; add support for
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
0
diff
changeset
|
26 config.os = 'GNU/Linux'; |
|
7
781ac4f1e304
Allow others JIDs than super-owners to create nodes.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
1
diff
changeset
|
27 config.allowCreateNode = [/@example\.com$/]; // value is an array of RegExp JIDs. If only super-owner should be able to create nodes, use []. |
|
26
f2e9365bc8ec
Can use differents backends for node storage. Writing directory-based backend in top of file-based backend.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
14
diff
changeset
|
28 config.backend = 'directory'; // Put backends in “backends” directory. |
|
13
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
29 config.access = 'open'; // values include open, whitelist (by members) and authorize (owners of the node receive notification). presence and roster aren’t implemented yet. |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
30 |
| 0 | 31 config.activated = [ |
| 32 'auto-create', | |
| 33 //'auto-subscribe', // Impossible à utiliser dans un component | |
| 34 //'collections', //TODO | |
| 35 'config-node', | |
| 36 'create-and-configure', | |
| 37 'create-nodes', | |
| 38 'delete-items', | |
| 39 'delete-nodes', | |
| 40 //'filtered-notifications', // Impossible à utiliser dans un component | |
| 41 'get-pending', | |
| 42 'instant-nodes', | |
| 43 'item-ids', | |
| 44 'last-published', // Impossible de se baser sur la présence dans un component | |
| 45 //'leased-subscription', //TODO | |
| 46 'manage-subscriptions', | |
| 47 'member-affiliation', | |
| 48 'meta-data', | |
| 49 'modify-affiliations', | |
| 50 //'multi-collection', //TODO | |
| 51 //'multi-subscribe', //TODO | |
| 52 'outcast-affiliation', | |
| 53 'persistent-items', | |
| 54 //'presence-notifications', // Impossible à utiliser dans un component | |
| 55 //'presence-subscribe', // Impossible à utiliser dans un component | |
| 56 'publish', | |
| 57 'publish-options', | |
| 58 'publish-only-affiliation', | |
| 59 'publisher-affiliation', | |
| 60 'purge-nodes', | |
| 61 'retract-items', | |
| 62 'retrieve-affiliations', | |
| 63 'retrieve-default', | |
| 64 'retrieve-default-sub', | |
| 65 'retrieve-items', | |
| 66 'retrieve-subscriptions', | |
| 67 'subscribe', | |
| 68 'subscription-options', | |
| 69 'subscription-notifications', | |
| 70 ]; | |
| 71 | |
| 72 config.service_configuration = { | |
| 73 subscribe_authorization: { | |
| 74 FORM_TYPE: {type: 'hidden', value: 'http://jabber.org/protocol/pubsub#subscribe_authorization'}, | |
| 75 _TITLE: 'PubSub subscriber request', | |
| 76 _INSTRUCTIONS: 'To approve this entity’s subscription request,\nclick the OK button. To deny the request, click the\ncancel button.', | |
| 77 'pubsub#allow': {type: 'boolean', label: 'Whether to allow the subscription', value: false}, | |
| 78 'pubsub#node': {type: 'text-single', label: 'The NodeID of the relevant node'}, | |
| 79 'pubsub#subid': {type: 'hidden'}, | |
| 80 'pubsub#subscriber_jid': {type: 'jid-single', label: 'The address (JID) of the subscriber'}, | |
| 81 }, | |
| 82 subscribe_options: { | |
| 83 FORM_TYPE: {type: 'hidden', value: 'http://jabber.org/protocol/pubsub#subscribe_options'}, | |
| 84 'pubsub#deliver': {type: 'boolean', label: 'Whether an entity wants to receive or disable notifications', value: true}, | |
| 85 'pubsub#digest': {type: 'boolean', label: 'Whether an entity wants to receive digests (aggregations) of notifications or all notifications individually', value: false}, | |
|
1
c2954a9e5665
Add a super-owner that has power over all nodes; add support for
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
0
diff
changeset
|
86 'pubsub#digest_frequency': {type: 'text-single', label: 'The minimum number of milliseconds between sending any two notification digests', value: 24*60*60*1000}, |
| 0 | 87 // 'pubsub#expire': {type: 'text-single', label: 'The DateTime at which a leased subscription will end or has ended'}, |
| 88 // 'pubsub#include_body': {type: 'boolean', label: 'Whether an entity wants to receive an XMPP message body in addition to the payload format', value: false}, | |
| 89 // 'pubsub#show-values': {type: 'list-multi', label: 'The presence states for which an entity wants to receive notifications', options: { | |
| 90 // away: {label: 'XMPP Show Value of Away'}, | |
| 91 // chat: {label: 'XMPP Show Value of Chat'}, | |
| 92 // dnd: {label: 'XMPP Show Value of DND (Do Not Disturb)'}, | |
| 93 // online: {label: 'Mere Availability in XMPP (No Show Value)'}, | |
| 94 // xa: {label: 'XMPP Show Value of XA (Extended Away)'}, | |
| 95 // }, value: ['online', 'chat', 'away']}, | |
| 96 // 'pubsub#subscription_type': {type: 'list-single', options: { | |
| 97 // items: {label: 'Receive notification of new items only'}, | |
| 98 // nodes: {label: 'Receive notification of new nodes only'}, | |
| 99 // }}, | |
| 100 // 'pubsub#subscription_depth': {type: 'list-single', options: { | |
| 101 // '1': {label: 'Receive notification from direct child nodes only'}, | |
| 102 // all: {label: 'Receive notification from all descendent nodes'}, | |
| 103 // }}, | |
| 104 }, | |
| 105 node_metadata: { | |
| 106 FORM_TYPE: {type: 'hidden', value: 'http://jabber.org/protocol/pubsub#meta-data'}, | |
| 107 'pubsub#contact': {type: 'jid-multi', label: 'The JIDs of those to contact with questions'}, | |
| 108 'pubsub#creation_date': {type: 'text-single', label: 'The datetime when the node was created', value: function(){return new Date();}}, | |
| 109 'pubsub#creator': {type: 'jid-single', label: 'The JID of the node creator'}, | |
| 110 'pubsub#description': {type: 'text-single', label: 'A description of the node'}, | |
| 111 'pubsub#language': {type: 'list-single', label: 'The default language of the node'}, | |
| 112 'pubsub#num_subscribers': {type: 'text-single', label: 'The number of subscribers to the node', value: 0}, | |
| 113 'pubsub#owner': {type: 'jid-multi', label: 'The JIDs of those with an affiliation of owner'}, | |
| 114 'pubsub#publisher': {type: 'jid-multi', label: 'The JIDs of those with an affiliation of publisher'}, | |
| 115 'pubsub#title': {type: 'text-single', label: 'The name of the node'}, | |
| 116 'pubsub#type': {type: 'text-single', label: 'Payload type'}, | |
| 117 }, | |
| 118 node_config: { | |
| 119 FORM_TYPE: {type: 'hidden', value: 'http://jabber.org/protocol/pubsub#node_config'}, | |
| 120 'pubsub#access_model': {type: 'list-single', label: 'Who may subscribe and retrieve items', options: { | |
| 121 authorize: {label: 'Subscription requests must be approved and only subscribers may retrieve items'}, | |
| 122 open: {label: 'Anyone may subscribe and retrieve items'}, | |
| 123 // presence: {label: 'Anyone with a presence subscription of both or from may subscribe and retrieve items'}, | |
| 124 // roster: {label: 'Anyone in the specified roster group(s) may subscribe and retrieve items'}, | |
| 125 whitelist: {label: 'Only those on a whitelist may subscribe and retrieve items'}, | |
| 126 }}, | |
| 127 // 'pubsub#body_xslt': {type: 'text-single', label: 'The URL of an XSL transformation which can be applied to payloads in order to generate an appropriate message body element.'}, | |
| 128 // 'pubsub#children_association_policy': {type: 'list-single', label: 'Who may associate leaf nodes with a collection', options: { | |
| 129 // all: {label: 'Anyone may associate leaf nodes with the collection'}, | |
| 130 // owners: {label: 'Only collection node owners may associate leaf nodes with the collection'}, | |
| 131 // whitelist: {label: 'Only those on a whitelist may associate leaf nodes with the collection'}, | |
| 132 // }}, | |
| 133 // 'pubsub#children_association_whitelist': {type: 'jid-multi', label: 'The list of JIDs that may associate leaf nodes with a collection'}, | |
| 134 // 'pubsub#children': {type: 'text-multi', label: 'The child nodes (leaf or collection) associated with a collection'}, | |
| 135 // 'pubsub#children_max': {type: 'text-single', label: 'The maximum number of child nodes that can be associated with a collection'}, | |
| 136 // 'pubsub#collection': {type: 'text-multi', label: 'The collection(s) with which a node is affiliated'}, | |
| 137 'pubsub#contact': {type: 'jid-multi', label: 'The JIDs of those to contact with questions'}, | |
| 138 // 'pubsub#dataform_xslt': {type: 'text-single', label: 'The URL of an XSL transformation which can be applied to the payload format in order to generate a valid Data Forms result that the client could display using a generic Data Forms rendering engine'}, | |
| 139 'pubsub#deliver_notifications': {type: 'boolean', label: 'Whether to deliver event notifications', value: true}, | |
| 140 // 'pubsub#deliver_payloads': {type: 'boolean', label: 'Whether to deliver payloads with event notifications; applies only to leaf nodes'}, | |
| 141 'pubsub#description': {type: 'text-single', label: 'A description of the node'}, | |
| 142 // 'pubsub#item_expire': {type: 'text-single', label: 'Number of seconds after which to automatically purge items'}, | |
| 143 // 'pubsub#itemreply': {type: 'list-single', label: 'Whether owners or publisher should receive replies to items', options: { | |
| 144 // owner: {label: 'Statically specify a replyto of the node owner(s)'}, | |
| 145 // publisher: {label: 'Dynamically specify a replyto of the item publisher'}, | |
| 146 // }}, | |
| 147 'pubsub#language': {type: 'list-single', label: 'The default language of the node'}, | |
| 148 // 'pubsub#max_items': {type: 'text-single', label: 'The maximum number of items to persist'}, | |
| 149 // 'pubsub#max_payload_size': {type: 'text-single', label: 'The maximum payload size in bytes'}, | |
| 150 'pubsub#node_type': {type: 'list-single', label: 'Whether the node is a leaf (default) or a collection', options: { | |
| 151 leaf: {label: 'The node is a leaf node (default)'}, | |
| 152 collection: {label: 'The node is a collection node'}, | |
| 153 }, value: 'leaf'}, | |
| 154 // 'pubsub#notification_type': {type: 'list-single', label: 'Specify the delivery style for notifications', options: { | |
| 155 // normal: {label: 'Messages of type normal'}, | |
| 156 // headline: {label: 'Messages of type headline'}, | |
| 157 // iq: {label: 'IQ stanzas (works only with presence-based delivery)'}, | |
| 158 // }}, | |
| 159 // 'pubsub#notify_config': {type: 'boolean', label: 'Whether to notify subscribers when the node configuration changes'}, | |
| 160 // 'pubsub#notify_delete': {type: 'boolean', label: 'Whether to notify subscribers when the node is deleted'}, | |
| 161 // 'pubsub#notify_retract': {type: 'boolean', label: 'Whether to notify subscribers when items are removed from the node'}, | |
| 162 // 'pubsub#notify_sub': {type: 'boolean', label: 'Whether to notify owners about new subscribers and unsubscribes'}, | |
| 163 // 'pubsub#persist_items': {type: 'boolean', label: 'Whether to persist items to storage'}, | |
| 164 // 'pubsub#presence_based_delivery': {type: 'boolean', label: 'Whether to deliver notifications to available users only'}, | |
| 165 'pubsub#publish_model': {type: 'list-single', label: 'The publisher model', options: { | |
| 166 publishers: {label: 'Only publishers may publish'}, | |
| 167 subscribers: {label: 'Subscribers may publish'}, | |
| 168 open: {label: 'Anyone may publish'}, | |
| 169 }, value: 'publishers'}, | |
| 170 // 'pubsub#purge_offline': {type: 'boolean', label: 'Whether to purge all items when the relevant publisher goes offline'}, | |
| 171 // 'pubsub#roster_groups_allowed': {type: 'list-multi', label: 'The roster group(s) allowed to subscribe and retrieve items'}, | |
| 172 // 'pubsub#send_last_published_item': {type: 'list-single', label: 'When to send the last published item', options: { | |
| 173 // never: {label: 'Never'}, | |
| 174 // on_sub: {label: 'When a new subscription is processed'}, | |
| 175 // on_sub_and_presence: {label: 'When a new subscription is processed and whenever a subscriber comes online'}, | |
| 176 // }, value: 'never'}, | |
| 177 // 'pubsub#tempsub': {type: 'boolean', label: 'Whether to make all subscriptions temporary, based on subscriber presence'}, | |
| 178 'pubsub#subscribe': {type: 'boolean', label: 'Whether to allow subscriptions', value: true}, | |
| 179 'pubsub#title': {type: 'text-single', label: 'A friendly name for the node'}, | |
| 180 'pubsub#type': {type: 'text-single', label: 'The type of node data, usually specified by the namespace of the payload (if any)', value: 'http://www.w3.org/2005/Atom'}, | |
| 181 }, | |
| 182 'publish-options': { | |
| 183 FORM_TYPE: {type: 'hidden', value: 'http://jabber.org/protocol/pubsub#publish-options'}, | |
| 184 'pubsub#access_model': {type: 'list-single', label: 'Precondition: node configuration with the specified access model', options: { | |
| 185 authorize: {label: 'Access model of authorize'}, | |
| 186 open: {label: 'Access model of open'}, | |
| 187 // presence: {label: 'Access model of presence'}, | |
| 188 // roster: {label: 'Access model of roster'}, | |
| 189 whitelist: {label: 'Access model of whitelist'}, | |
| 190 }, value: 'open'}, | |
| 191 }, | |
| 192 }; | |
| 193 | |
| 194 config.Configuration = function(def, params) { | |
| 195 for (var i in def) { | |
| 196 if (typeof (def[i].value) != 'undefined') { | |
| 197 if (typeof (def[i].value) == 'function') | |
| 198 this[i] = def[i].value(); | |
| 199 else | |
| 200 this[i] = def[i].value; | |
| 201 } | |
| 202 } | |
| 203 if (params) | |
| 204 for (var i in params) | |
|
10
44889cfb2f8c
Fix getItem method.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
7
diff
changeset
|
205 if (typeof def[i] != 'undefined') |
|
44889cfb2f8c
Fix getItem method.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
7
diff
changeset
|
206 this[i] = params[i]; |
| 0 | 207 }; |
| 208 | |
| 209 config.enabled = function(feature) { | |
| 210 for (var i in config.activated) | |
| 211 if (typeof i == 'string' && feature == config.activated[i]) | |
| 212 return true; | |
| 213 return false; | |
| 214 }; | |
| 215 | |
|
13
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
216 config.enable = function(feature) { |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
217 config.activated.push(feature); |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
218 } |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
219 |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
220 config.disable = function(feature) { |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
221 if (typeof feature == 'string') |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
222 config.activated.splice(config.activated.indexOf(feature), 1); |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
223 else if (typeof feature == 'function') { |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
224 for (var i in config.activated) |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
225 if (feature(config.activated[i])) |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
226 config.disable(config.activated[i]); |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
227 } |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
228 } |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
229 |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
230 if (config.access == 'whitelist') { |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
231 config.disable(/access-.+/); |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
232 config.enable('access-whitelist'); |
| 0 | 233 config.service_configuration.node_config['pubsub#access_model'].value = 'whitelist'; |
| 234 config.service_configuration['publish-options']['pubsub#access_model'].value = 'whitelist'; | |
|
14
06abc804e2ab
Correct syntax error.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
13
diff
changeset
|
235 } else if (config.access == 'authorize') { |
|
13
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
236 config.disable(/access-.+/); |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
237 config.enable('access-authorize'); |
| 0 | 238 config.service_configuration.node_config['pubsub#access_model'].value = 'authorize'; |
| 239 config.service_configuration['publish-options']['pubsub#access_model'].value = 'authorize'; | |
|
14
06abc804e2ab
Correct syntax error.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
13
diff
changeset
|
240 } else if (config.access == 'open') { |
|
13
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
241 config.disable(/access-.+/); |
|
447db2e8c622
Better access mode handling.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
10
diff
changeset
|
242 config.enable('access-open'); |
| 0 | 243 config.service_configuration.node_config['pubsub#access_model'].value = 'open'; |
| 244 config.service_configuration['publish-options']['pubsub#access_model'].value = 'open'; | |
| 245 } |