Fetches split definitions and segments from Split.io and serializes them into a set of strings that the JavaScript SDK can consume.

Install via npm:

$ npm i @godaddy/split-node-serializer --save

Use this package in your server-side Node.js environment. The serializer exposes:

1. a Poller that periodically requests raw experiment configuration data from Split.io. Requests happen in the background and the poller caches the latest data in local memory.
2. a DataSerializer that reads from the poller's cache, serializes the data, and returns it in a script to be injected into a client's HTML.

Create an instance of Poller and DataSerializer:

const { Poller, DataSerializer } = require('@godaddy/split-node-serializer')

const poller = new Poller({
  splitioApiKey: 'YOUR_API_KEY',
  pollingRateSeconds: 600,
  serializeSegments: false
})

const dataSerializer = new DataSerializer({ poller })

The following option properties are available to the Poller:

Segments are pre-defined groups of customers that features can be targeted to. More info here.

Note: Requesting serialized segments will increase the size of your response. Segments can be very large if they include all company employees, for example.

Make an initial request for changes and start polling for raw configuration data every pollingRateSeconds:

poller.start()

To stop the poller:

poller.stop()

The poller emits an error event on errors from the Split.io API.

generateSerializedDataScript is an async method that will read the latest data from the cache and return a script that adds serialized data to the window.__splitCachePreload object. The serialized data will be used to determine cohort allocations.

generateSerializedDataScript accepts the following arguments:

const serializedDataScript = await dataSerializer.generateSerializedDataScript()

console.log(serializedDataScript)

//<script>
//  window.__splitCachePreload = {
//    splitsData: {"split-1-name":'{"name":"split-1-name","status":"bar"}',"split-2-name":'{"name":"split-2-name","status":"baz"}'},
//    since: 1,
//    segmentsData: {"test-segment":'{"name":"test-segment","added":["foo","bar"]}'},
//    usingSegmentsCount: 2
//  };
//</script>

Note: Though this is an async method, there will only be a Split.io API call if you have serializeSegments set to true and are passing in a unique splits parameter that this instance's method has not received before.

Run the linter:

$ npm run lint

Run unit tests:

$ npm test

Generate a coverage report:

$ npm run coverage

MIT