npm.io
2.0.4 • Published 1 year ago

@spearly/sdk-js

Licence
Apache-2.0
Version
2.0.4
Deps
3
Size
279 kB
Vulns
1
Weekly
0

@spearly/sdk-js

Spec Test

It is a Development Kit that makes it easy to use Spearly CMS from JavaScript or NodeJS in API mode.

Getting Started

Install

// npm
$ npm install -S @spearly/sdk-js

// yarn
$ yarn add @spearly/sdk-js

Usage

Setup
import { SpearlyApiClient } from '@spearly/sdk-js'

const apiClient = new SpearlyApiClient(API_KEY)

You can specify the API Server as well using by optional.

import { SpearlyApiClient } from '@spearly/sdk-js'

const apiClient = new SpearlyApiClient(API_KEY, API_SERVER_DOMAIN)
Get Content Lists
async function() {
  // basic
  const contents =  await apiClient.getList(CONTENT_TYPE_ID)

  // when using some options
  const filteredContents =  await apiClient.getList(CONTENT_TYPE_ID, { limit: 10, offset: 20 })}
Get Content
async function() {
  const content = await apiClient.getContent(CONTENT_TYPE_ID, CONTENT_ID)
}
Get Form
async function() {
  const form = await apiClient.getFormLatest(FORM_ID)
}
Submit Form
async function() {
  const submit = await apiClient.postFormAnswers(FORM_VERSION_ID, { ...YOUR_FORM_FIRLD_ANSWERS, _spearly_gotcha: '' })
}
A/B Testing analytics

Warning
A/B Testing does not support Server side.
We are working on it now, so please wait for a while.

Page view

If you are using A/B testing, you can run the following code on page load to count impressions.

import { SpearlyAnalytics } from '@spearly/sdk-js'

const analytics = new SpearlyAnalytics()

analytics.pageView({
  patternName: PATTERN_NAME,
  contentId: CONTENT_ALIAS,
})
Conversion

If you are using A/B testing, you can count conversions by using the conversion method as follows

import { SpearlyAnalytics } from '@spearly/sdk-js'

const analytics = new SpearlyAnalytics()

document.querySelector('#submit').addEventListener('submit', () => {
  analytics.conversion({
    patternName: PATTERN_NAME,
    contentId: CONTENT_ALIAS,
  })
});

Support TypeScript

Type definitions are also included, so there is no need to add anything else.

  • GetParams : This is options that can be set when retrieving the ContentList.
  • List : The type of the content list returned by the API.
  • Content : The type of content returned by the API.
  • Form : The type of form returned by the API.