/**

 * This class provides access to the device contacts.

 * @constructor

 */

function Contacts() {

}

function Contact() {

	this.id = null;

	this.name = { 

		formatted: "",

		givenName: "",

		familyName: ""

	};

    this.phones = [];

    this.emails = [];

}

Contact.prototype.displayName = function()

{

    // TODO: can be tuned according to prefs

	return this.givenName + " " + this.familyName;

};

/*

 * @param {ContactsFilter} filter Object with filter properties. filter.name only for now.

 * @param {function} successCallback Callback function on success

 * @param {function} errorCallback Callback function on failure

 * @param {object} options Object with properties .page and .limit for paging

 */

Contacts.prototype.find = function(filter, successCallback, errorCallback, options) {

	try {

		this.contactsService = device.getServiceObject("Service.Contact", "IDataSource");

		if (typeof options == 'object')

			this.options = options;

		else

			this.options = {};

		var criteria = new Object();

		criteria.Type = "Contact";

		if (filter && filter.name) {

			var searchTerm = '';

			if (filter.name.givenName && filter.name.givenName.length > 0) {

				searchTerm += filter.name.givenName;

			}

			if (filter.name.familyName && filter.name.familyName.length > 0) {

				searchTerm += searchTerm.length > 0 ? ' ' + filter.name.familyName : filter.name.familyName;

			}

			if (!filter.name.familyName && !filter.name.givenName && filter.name.formatted) {

				searchTerm = filter.name.formatted;

			}

			criteria.Filter = { SearchVal: searchTerm };

		}

		if (typeof(successCallback) != 'function') 

			successCallback = function(){};

		if (typeof(errorCallback) != 'function') 

			errorCallback = function(){};

		if (isNaN(this.options.limit))

			this.options.limit = 200;

		if (isNaN(this.options.page))

			this.options.page = 1;

		//need a closure here to bind this method to this instance of the Contacts object

		this.global_success = successCallback;

		var obj = this;

		//WRT: result.ReturnValue is an iterator of contacts

		this.contactsService.IDataSource.GetList(criteria, function(transId, eventCode, result){

			obj.success_callback(result.ReturnValue);

		});

	} 

	catch (ex) {

		alert(ex.name + ": " + ex.message);

		errorCallback(ex);

	}

};

Contacts.prototype.success_callback = function(contacts_iterator) {

	try {

	var gapContacts = new Array();

	contacts_iterator.reset();

    var contact;

	var i = 0;

	var end = this.options.page * this.options.limit;

	var start = end - this.options.limit;

	while ((contact = contacts_iterator.getNext()) != undefined && i < end) {

		try {

			if (i >= start) {

				var gapContact = new Contact();

				gapContact.name.givenName = Contacts.GetValue(contact, "FirstName");

				gapContact.name.familyName = Contacts.GetValue(contact, "LastName");

				gapContact.name.formatted = gapContact.name.givenName + " " + gapContact.name.familyName;

				gapContact.emails = Contacts.getEmailsList(contact);

				gapContact.phones = Contacts.getPhonesList(contact);

				gapContact.address = Contacts.getAddress(contact);

				gapContact.id = Contacts.GetValue(contact, "id");

				gapContacts.push(gapContact);

			}

			i++;

		} catch (e) {

			alert("ContactsError (" + e.name + ": " + e.message + ")");

		}

	}

	this.contacts = gapContacts;

	this.global_success(gapContacts);

	} catch (ex) { alert(ex.name + ": " + ex.message); }

};

Contacts.getEmailsList = function(contact) {

	var emails = new Array();

	try {

			emails[0] = { type:"General", address: Contacts.GetValue(contact, "EmailGen") };

			emails[1] = { type:"Work", address: Contacts.GetValue(contact, "EmailWork") };		

			emails[2] = { type:"Home", address: Contacts.GetValue(contact, "EmailHome") };

	} catch (e) {

		emails = [];

	}

	return emails;

};

Contacts.getPhonesList = function(contact) {

	var phones = new Array();

	try {

			phones[0] = { type:"Mobile", number: Contacts.GetValue(contact, "MobilePhoneGen") };

			phones[1] = { type:"Home", number: Contacts.GetValue(contact, "LandPhoneGen") };

			phones[2] = { type:"Fax", number: Contacts.GetValue(contact, "FaxNumberGen") };

			phones[3] = { type:"Work", number: Contacts.GetValue(contact, "LandPhoneWork") };

			phones[4] = { type:"WorkMobile", number: Contacts.GetValue(contact, "MobilePhoneWork") };

	} catch (e) {

		phones = [];

	}

	return phones;

};

Contacts.getAddress = function(contact) {

	var address = "";

	try {

		address = Contacts.GetValue(contact, "AddrLabelHome") + ", " + Contacts.GetValue(contact, "AddrStreetHome") + ", " +

				Contacts.GetValue(contact, "AddrLocalHome") + ", " + Contacts.GetValue(contact, "AddrRegionHome") + ", " + 

				Contacts.GetValue(contact, "AddrPostCodeHome") + ", " + Contacts.GetValue(contact, "AddrCountryHome");

	} catch (e) {

		address = "";

	}

	return address;

};

Contacts.GetValue = function(contactObj, key) {

	try {

		return contactObj[key]["Value"];

	} catch (e) {

		return "";

	}

};

if (typeof navigator.contacts == "undefined") navigator.contacts = new Contacts();