getSection

Get an entire top-level configuration section with all ${VAR|default} environment-variable references substituted. Internally calls substituteVars() on the resolved value.

Returns an empty object ({}) if the section does not exist or is not an object. For single-value lookups, use get() instead.

Parameters

Returns

Record<string, unknown> — the configuration section, with env-var substitution applied; empty object if the section is missing or not an object.

Example

1
import { ConfigLoader } from '@signalwire/sdk';
2
3
// Given config.json:
4
//   { "server": { "host": "${HOST|0.0.0.0}", "port": "${PORT|3000}" } }
5
6
const loader = new ConfigLoader('config.json');
7
8
const serverCfg = loader.getSection('server');
9
console.log(serverCfg.host); // "0.0.0.0" (or HOST env var)
10
console.log(serverCfg.port); // 3000 (coerced to number)