Bucketeer Server-Side SDK for Node.js

Bucketeer is an open-source platform created by CyberAgent to help teams make better decisions, reduce deployment lead time and release risk through feature flags. Bucketeer offers advanced features like dark launches and staged rollouts that perform limited releases based on user attributes, devices, and other segments.

Getting started using Bucketeer SDK.

Installation

See our documentation to install the SDK.

Contributing

We would ❤️ for you to contribute to Bucketeer and help improve it! Anyone can use and enjoy it!

Please follow our contribution guide here.

Example

Before building the example, please follow the following steps.

- Ensure that you have the yarn installed.
- Configure the host and the token info in the index.ts.
- Move to the example directory cd example.
- Install dependencies make init.

$3

``bash
make start
`

If you want to use a published SDK instead of a local one, replace the line where it imports the library in the example code

Development

$3

Install the prerequisite tools.

- nvm
- Yarn

#### Setup node version

Please look at the .nvmrc file to check the node version.

`bash
nvm use
`

#### Install dependencies

`bash
make init
`

$3

#### Format

`bash
make fmt
`

#### Lint & Type check

`bash
make lint
make type-check
`

#### Build

`bash
make build
`

#### Run unit tests

`bash
make test
`

#### Run e2e tests

Configure the host and the token info in the ava-e2e.config.mjs, then run the following command.

`bash
make e2e
`

$3

Add the version field to package.json, then run the following command.

`bash
export NPM_TOKEN=
make publish
`

$3


- Write tests in the src/__tests__ directory. The test files should following snake_case naming convention. Its differ from the library code which uses camelCase.
- Use ava as the test runner. You can find the configuration in the ava.config.mjs file.
- Run all tests using make test command.
- Run single test using make test-single ` command.

Note: The publishing process is automated using GitHub Actionshttps://github.com/bucketeer-io/node-server-sdk/blob/master/.github/workflows/release.yml to publish it when the released tag is created.