Unofficial Nodejs SDK for Intellipush

This SDK is actively developed and maintained by Prek AS - an official Intellipush partner.

For compatibility with Node.js versions < 12, please install the globalThis polyfill.

Installation

Add @prek-no/intellipush-sdk dependency to your project:

npm install @prek-no/intellipush-sdk

or using Yarn

yarn add @prek-no/intellipush-sdk

TypeScript

This package delivers its own typings. If you have any problems with typings, add the package to the types array in your tsconfig.json:

{
  "compilerOptions": {
    "types": [
      "@prek-no/intellipush-sdk"
    ]
  }
}

Initialize client

Initialize the Intellipush Client by passing in the credentials:

// const globalThis = require('globalthis')(); // uncomment if NodeJS < NodeJS versions < 12
import { Intellipush } from '@prek-no/intellipush-sdk'

const intellipush = new Intellipush({
    clientId: '<client_id>', // e.g process.env.INTELLIPUSH_CLIENT_ID
    clientSecret: '<client_secret>', // e.g process.env.INTELLIPUSH_CLIENT_SECRET
    proxyUrl: '<proxy_url>' // Optional Proxy URL
})

Authentication

You can sign in using OAuth2 (Client Credentials) by calling the authenticate method:

// Async
try {
    await intellipush.authenticate()
} catch(err: any) {
    console.log(err)
}

// Promise
intellipush.authenticate().then(() => {
    console.log('Authenticated!')
}).catch(() => {
    console.log('Authentication failed!')
})

Models

This SDK provides you with some convenient data models. All models accepts an object in the constructor as well as some setter functions. See example below.

Initialize model with an object.

const contact = new ContactModel({
    name: 'Tim Cook',
    countrycode: '0047',
    phonenumber: '12345678'
})

const result: IContactResponse = await intellipush.contact.create(contact)

console.log(result.data.name)

Initialize without object, use setters

const contact = new ContactModel()

contact.setName('Tim cook')
    .setCountrycode('0047')
    .setPhonenumber('12345678')
    .setEmail('[email protected]')

const result: IContactResponse = await intellipush.contact.create(contact)

console.log(result.data.name)

Initialize with object and override with setters

const contact = new ContactModel({
    name: 'Tim Cook',
    countrycode: '0047',
    phonenumber: '12345678'
})

contact.setName('Howard Stewart')

const result: IContactResponse = await intellipush.contact.create(contact)

console.log(result.data.name)

Run without using data model

Since the Data Models is really just an object, you can also pass an object directly to the API methods:

const result: IContactResponse = await intellipush.contact.create({
    name: 'Tim Cook',
    countrycode: '0047',
    phonenumber: '12345678'
})

console.log(result.data.name)

Development status

• [X] Authentication
  • [X] authenticate
  • [X] getToken
  • [X] setToken
• [X] API Resources
  • [X] Contact
    • [X] create
    • [X] update
    • [X] get
    • [X] getContacts
    • [X] delete
  • [X] ContactList
    • [X] create
    • [X] update
    • [X] get
    • [X] getContactLists
    • [X] getContactsInList
    • [X] addContact
    • [X] removeContact
    • [X] delete
  • [X] SMS
    • [X] create
    • [X] createScheduled
    • [X] createBatch
    • [X] getPlanned
    • [X] getSent
    • [X] getUnsent
    • [X] getReceived
    • [X] status
    • [X] delete
  • [X] TwoFactor
    • [X] generate
    • [X] validate
  • [X] Url
    • [X] generate
    • [X] generateChild
    • [X] details
  • [X] User
    • [X] me

Need help? Feel free to contact us.