@smokeballdev/smokeball-client-sdk

Interface: Api

Entry point for contacts to Smokeball.

Methods

create()

create(request): Promise<Contact>
Create a new contact and returns the contact. Currently only Person and Company contacts are supported.

Parameters

request
CreateContactRequest the create request.

Returns

Promise<Contact>

Example

const request: CreateContactRequest = {
 // Specify the fields here.
};
const contact = await sdk.contacts.create(request);

get()

get(contactId): Promise<Contact>
Gets the contact associated to the specified contact id.

Parameters

contactId
string the contact to retrieve.

Returns

Promise<Contact> the specified contact.

Example

// Returns the contact with the specified contact id.
const contact = await sdk.contacts.get('e9b9084b-c9b4-4f3c-9f5a-4c83ed3ac265');

observe()

observe(callback): void
Creates a subscription for all contacts. Check against the contact you are interested in within your registered callback. To prevent doubling up of changes, notifications triggered by the contact update call will not be notified here. Only one subscription will be made per session. Regardless of how many times this function is called, the last registered callback will be used.

Parameters

callback
(contact) => void the function to execute when a change is made to contact(s) in Smokeball.

Returns

void

Example

sdk.contacts.observe(contacts => {
  for (let i = 0; i < contacts.length; i++) {
    let contacts = contacts[i];
    // Check the contact id here.
    if (contact.id = 'e9b9084b-c9b4-4f3c-9f5a-4c83ed3ac265') {
      // Perform syncing code here.
    }
  }
});

open()

open(contactId): void
Opens the contact associated to the specified contact id.

Parameters

contactId
string

Returns

void

Example

// Opens the contact with the specified id.
sdk.contacts.open('e9b9084b-c9b4-4f3c-9f5a-4c83ed3ac265');

update()

update(request): Promise<Contact>
Updates the contact associated to the specified contact id and returns the contact. Currently only Person and Company contacts are supported.

Parameters

request
UpdateContactRequest the update request.

Returns

Promise<Contact>

Example

const request: UpdateContactRequest = {
 id: 'e9b9084b-c9b4-4f3c-9f5a-4c83ed3ac265',
 // Specify the fields to update here.
};
const contact = await sdk.contacts.update(request);