ConfigLoader | SignalWire

ConfigLoader loads JSON configuration files and substitutes environment variables using ${VAR|default} syntax. It provides dot-notation access for nested values and supports method chaining.

1 import { ConfigLoader } from '@signalwire/sdk';
2 
3 const config = new ConfigLoader('./config.json');
4 const port = config.get<number>('server.port', 3000);

Constructor

filePath

string

Path to a JSON config file to load on construction. If omitted, use load() or loadFromObject() later.

Methods

load

Load configuration from a JSON file with env var interpolation.

Static method to find and load a config file from standard locations.

get

Get a value by dot-notation path.

set

Set a value at a dot-notation path.

has

Check whether a dot-notation path exists.

getAll

Return a shallow copy of the entire configuration object.

getFilePath

Return the absolute path of the loaded config file.

loadFromObject

Load configuration from a plain object instead of a file.

Example

1 import { ConfigLoader } from '@signalwire/sdk';
2 
3 // Load from a specific file
4 const config = new ConfigLoader('./config.json');
5 console.log('File:', config.getFilePath());
6 
7 const port = config.get<number>('server.port', 3000);
8 const host = config.get<string>('server.host', '0.0.0.0');
9 console.log(`Listening on ${host}:${port}`);