mortend / fuse-contacts

Fuse Contacts bindings

Library to use contacts in Fuse.

https://www.fusetools.com/community/forums/feature_requests/contacts_api

Issues, feature request and pull request are welcomed.

Installation

Using fusepm

$ fusepm install https://github.com/bolav/fuse-contacts

Usage:

UX

<Contacts ux:Global="Contacts" />

JS

contacts.authorize().then(function (status) {
	console.log(status);
	if (status === 'AuthorizationAuthorized') {
		console.log(JSON.stringify(contacts.getAll()));
	}
})

API

require

var contacts = require('Contacts');

authorize

Returns a promise with the status of authorization

var auth = contacts.authorize();
auth.then(function (status) {
	console.log(status);
})

status can be:

• AuthorizationDenied
• AuthorizationRestricted
• AuthorizationAuthorized

(and some error results)

getAll

Returns an array of hashes of contacts

console.log(JSON.stringify(contacts.getAll()));

getPage

Returns an array of hashes of contacts, split by pages

readInLoop(0); // call the function, starting with page 0

function readInLoop(page) {
    var numEntries = 30; // number of entries per page
	var proceed = true; // boolean to track state of recursion
	var contactsPageList = contacts.getPage(numEntries, page); // retrieves the numEntries contacts objects, offset by (page * numEntries)
	if (contactsPageList.length < numEntries) proceed = false; // if the current page returned less results than numEntries, we have reached the end of all contacts
	// ... do something with contactsPageList here!
	if (proceed) readInLoop(page+1); // call ourselves recursively with next page
}