jsdav-ext
Version:
jsDAV allows you to easily add WebDAV support to a NodeJS application. jsDAV is meant to cover the entire standard, and attempts to allow integration using an easy to understand API.
329 lines (303 loc) • 10.6 kB
JavaScript
/*
* @package jsDAV
* @subpackage DAVACL
* @copyright Copyright(c) 2013 Mike de Boer. <info AT mikedeboer DOT nl>
* @author Mike de Boer <info AT mikedeboer DOT nl>
* @author Wouter Vroege <wouter AT woutervroege DOT nl>
* @license http://github.com/mikedeboer/jsDAV/blob/master/LICENSE MIT License
*/
;
var jsDAVACL_iBackend = require("./../interfaces/iBackend");
var Db = require("./../../shared/backends/mongo");
var Exc = require("./../../shared/exceptions");
var Util = require("./../../shared/util");
var Async = require("asyncjs");
/**
* Mongo principal backend
*
* This backend assumes all principals are in a single collection. The default collection
* is 'principals/', but this can be overriden.
*/
var jsDAVACL_Backend_Mongo = module.exports = jsDAVACL_iBackend.extend({
/**
* Mongo
*
* @var mongo
*/
mongo: null,
/**
* PDO table name for 'principals'
*
* @var string
*/
tableName: null,
/**
* PDO table name for 'group members'
*
* @var string
*/
groupMembersTableName: null,
/**
* A list of additional fields to support
*
* @var array
*/
fieldMap: {
/**
* This property can be used to display the users' real name.
*/
"{DAV:}displayname": "displayname",
/**
* This property is actually used by the CardDAV plugin, where it gets
* mapped to {http://calendarserver.org/ns/}me-card.
*
* The reason we don't straight-up use that property, is because
* me-card is defined as a property on the users' addressbook
* collection.
*/
"{http://ajax.org/2005/aml}vcard-url": "vcardurl",
/**
* This is the users' primary email-address.
*/
"{http://ajax.org/2005/aml}email-address": "email",
},
/**
* Sets up the backend.
*
* @param Mongo mongo
* @param {String} tableName
* @param {String} groupMembersTableName
*/
initialize: function(mongo, tableName, groupMembersTableName) {
this.mongo = mongo;
this.tableName = tableName || "principals";
this.groupMembersTableName = groupMembersTableName || "groupmembers";
this.fieldMapReverse = {};
for (var prop in this.fieldMap)
this.fieldMapReverse[this.fieldMap[prop]] = prop;
},
/**
* Returns a list of principals based on a prefix.
*
* This prefix will often contain something like 'principals'. You are only
* expected to return principals that are in this base path.
*
* You are expected to return at least a 'uri' for every user, you can
* return any additional properties if you wish so. Common properties are:
* {DAV:}displayname
* {http://ajax.org/2005/aml}email-address - This is a custom jsDAV
* field that's actualy injected in a number of other properties. If
* you have an email address, use this property.
*
* @param {String} prefixPath
* @return array
*/
getPrincipalsByPrefix: function(prefixPath, callback) {
var self = this;
this.mongo.collection(this.tableName).find({}).toArray(function(err, docs) {
if (err)
return callback(err)
callback(null, docs);
});
},
/**
* Returns a specific principal, specified by it's path.
* The returned structure should be the exact same as from
* getPrincipalsByPrefix.
*
* @param {String} path
* @return array
*/
getPrincipalByPath: function(path, callback) {
this.mongo.collection(this.tableName).findOne({
uri: path
}, function(err, doc) {
if (err)
return callback(err)
callback(null, doc);
});
},
/**
* Updates one ore more webdav properties on a principal.
*
* The list of mutations is supplied as an array. Each key in the array is
* a propertyname, such as {DAV:}displayname.
*
* Each value is the actual value to be updated. If a value is null, it
* must be deleted.
*
* This method should be atomic. It must either completely succeed, or
* completely fail. Success and failure can simply be returned as 'true' or
* 'false'.
*
* It is also possible to return detailed failure information. In that case
* an array such as this should be returned:
*
* {
* "200": {
* "{DAV:}prop1": null
* },
* "201": {
* "{DAV:}prop2": null
* },
* "403": {
* "{DAV:}prop3": null
* },
* "424": {
* "{DAV:}prop4": null
* }
* }
*
* In this previous example prop1 was successfully updated or deleted, and
* prop2 was succesfully created.
*
* prop3 failed to update due to '403 Forbidden' and because of this prop4
* also could not be updated with '424 Failed dependency'.
*
* This last example was actually incorrect. While 200 and 201 could appear
* in 1 response, if there's any error (403) the other properties should
* always fail with 423 (failed dependency).
*
* But anyway, if you don't want to scratch your head over this, just
* return true or false.
*
* @param {String} path
* @param {Array} mutations
* @return array|bool
*/
updatePrincipal: function(path, mutations, callback) {
var updateAble = {};
var key, value, forbidden, failedDep, subKey;
for (key in mutations) {
value = mutations[key];
// We are not aware of this field, we must fail.
if (!this.fieldMap[key]) {
forbidden = {};
forbidden[key] = null;
failedDep = {};
// Adding the rest to the response as a 424
for (subKey in mutations) {
if (subKey !== key)
failedDep[subKey] = null;
}
return callback({
"403": forbidden,
"424": failedDep
}, false);
}
updateAble[this.fieldMap[key]] = value;
}
this.mongo.collection(this.tableName).update({
uri: path
},
{
$set: {
//setting vars
}
}, function(err, docs) {
if (err)
return callback(err);
callback(null, true);
});
},
/**
* This method is used to search for principals matching a set of
* properties.
*
* This search is specifically used by RFC3744's principal-property-search
* REPORT. You should at least allow searching on
* http://ajax.org/2005/aml}email-address.
*
* The actual search should be a unicode-non-case-sensitive search. The
* keys in searchProperties are the WebDAV property names, while the values
* are the property values to search on.
*
* If multiple properties are being searched on, the search should be
* AND'ed.
*
* This method should simply return an array with full principal uri's.
*
* If somebody attempted to search on a property the backend does not
* support, you should simply return 0 results.
*
* You can also just return 0 results if you choose to not support
* searching at all, but keep in mind that this may stop certain features
* from working.
*
* @param {String} prefixPath
* @param {Array} searchProperties
* @return array
*/
searchPrincipals: function(prefixPath, searchProperties, callback) {
// TODO: support search LATER
callback(null, []);
},
/**
* Returns the list of members for a group-principal
*
* @param {String} principal
* @return array
*/
getGroupMemberSet: function(principal, callback) {
var self = this;
this.getPrincipalByPath(principal, function(err, principal) {
if (err)
return callback(err);
if (!principal)
return callback(new Exc.jsDAV_Exception("Principal not found"));
self.mongo.collection(self.groupMembersTableName).find({principalId: principal}).toArray(function(err, docs) {
if (err)
return err;
callback(null, docs);
});
});
},
/**
* Returns the list of groups a principal is a member of
*
* @param {String} principal
* @return array
*/
getGroupMemberShip: function(principal, callback) {
var self = this;
this.getPrincipalByPath(principal, function(err, principal) {
if (err)
return callback(err);
if (!principal)
return callback(new Exc.jsDAV_Exception("Principal not found"));
self.mongo.collection(self.groupMembersTableName).find({principalId: principal}).toArray(function(err, docs) {
if (err)
return err;
callback(null, docs);
});
});
},
/**
* Updates the list of group members for a group principal.
*
* The principals should be passed as a list of uri's.
*
* @param {String} principal
* @param {Array} members
* @return void
*/
setGroupMemberSet: function(principal, members, callback) {
var self = this;
self.mongo.collection(self.groupMembersTableName).remove({
principalId: principal
}, function(err) {
if (err)
return callback(err)
Async.list(members)
.each(function(member, next) {
self.mongo.collection(self.groupMembersTableName).insert({
principalId: principal,
memberId: member
}, next);
})
.end(function(err) {
callback(err, !!err);
});
});
}
});