Skip to main content

Npm package version GitHub

Typescript Usage

The DevCycle Node.js SDK is written in Typescript and includes a full Typescript interface.

It is also possible to enhance the type safety of the SDK by using the Devcycle CLI to generate a type definition based on the complete set of variables defined in your project. Using this method, you can ensure that your code cannot access a variable key that is not defined in DevCycle, or treat a variable as a different type.

For example, if you have a variable with the key my-variable which is a string type, the following code would produce a type error:

const user = { user_id: 'my_user' }

// type error, can't use a boolean default value since we know it's a string
const myVariableValue = devcycleClient.variableValue('my-variable', user, false)

...

// type error, can't use the unknown key 'some-key'
const myVariableValue = devcycleClient.variableValue('some-key', user, 'default-value')

...

// this works, since we know this key exists and is a string
const myVariableValue = devcycleClient.variableValue('my-variable', user, 'default-value')

Usage

To use this enhanced type-safety, you can pass a type definition containing the variable keys and types to the initializeDevCycle function:

type VariableTypes = {
'my-variable': string
}

const dvcOptions = { logLevel: 'debug' }
const devcycleClient = await initializeDevCycle<VariableTypes>(
'<DEVCYCLE_SERVER_SDK_KEY>',
dvcOptions,
).onClientInitialized()

The keys of VariableTypes must match the keys of the variables defined in DevCycle, and the values must match the expected type of the variable.

You can write this definition manually, but it's recommended to generate it automatically as part of your build process by using the CLI.

CLI

To generate the type definitions with the CLI, you can use the generate types command like so:

dvc generate types

See the documentation for this command

Ensure that the CLI is properly setup and authenticated to your project before running this command. See the CLI docs for further instructions on setting up the CLI.

This command will generate a file called dvcVariableTypes.ts in the configured output directory. You can then import the generated types from this file, and pass them to the generic arg of the initializeDevCycle call as described above.

Consider configuring this command to run as part of your build process to keep your type definitions up to date with the latest configuration from DevCycle.