Function createTrueNasClient

Creates a version-specific TrueNAS API client.

1. Discovers the API version (GET /api/versions), asking every hostname in parallel. The first usable answer wins.
2. Selects the matching client implementation (v25.10.x -> TrueNasApiClientV2510, v26.x.y -> TrueNasApiClientV26).
3. Instantiates and returns it.

Resolves exactly once with a single client instance — dispose of it with client.close() when done.

Choosing D

The version is discovered at runtime; the query verbs are typed at compile time. Something has to bridge that, and D is where the caller says which API surface they are writing against:

const client = await createTrueNasClient(opts);
client.api.query('user.query');            // typed against v25.10

const client = await createTrueNasClient<ApiDirectoryV26_0_0>(opts);
client.api.query('container.query');       // v26-only methods reachable
Copy

It defaults to the oldest supported version's directory, which is the conservative direction: against a newer server the types understate what is available rather than promising methods that are not there. Move it in step with --min-version in the generate:api script.

Note this is a claim, not a guarantee — the connected server may be any supported version. Operations that must work across versions belong on client.ops, which resolves them at runtime.