Host catalog status
What the v2 car catalog ships today versus what is deferred to v5.1, and how to gate on it instead of assuming a signal exists.
The v2 bridge is catalog-driven: the host declares which signal
categories it serves at runtime via client.car.list(). The SDK has
no compiled-in signal list, so "is this available?" is a runtime
question, not an SDK-version question. This page is the single place
that records what is live now versus deferred.
Shipping in v5.0
Today's BYD catalog serves these category values:
climate, dynamics, cabin, propulsion, safety,
charging, doors, lights, sensors, statistics.
client.car.list() echoes the bridge protocol version (2.0.0) on
every response.
Deferred to v5.1
| Category | Status | Until then |
|---|---|---|
location | Not in the v5.0 catalog | Use navigator.geolocation; see Location + heading |
navigation | Not in the v5.0 catalog | No host source yet |
media | Not in the v5.0 catalog | Sketch the shape now; see Now-playing widget |
These were removed as per-family controllers in the v5 cutover (see
v5 migration) and will reappear as
catalog categories on client.car, not as new SDK APIs.
Gate on the catalog, not the SDK version
Probe the category and degrade. Keeping the call in place means a v5.1 host lights the feature up with no redeploy:
import { createClientOrSSR } from 'i99dash';
const client = createClientOrSSR();
if (!client) return; // SSR / no host
const cat = await client.car.list({ category: 'location' });
if (cat.entries.length > 0) {
const off = await client.car.subscribe({
names: cat.entries.map((e) => e.name),
onEvent: render,
});
} else {
renderFallback(); // a default — never a blank screen
}A category that is absent must render a useful fallback, not an empty state. Treat "host doesn't serve it yet" exactly like "host without the family" — see Capability detection.
Related
- v5 migration — why the per-family controllers are gone.
- Location + heading — the location-specific path until v5.1.
- Build for L5 + L8 — where this fits in a resilient build.
- Capability detection — the host-family axis.
Trim × capability matrix
What every BYD trim seeds in `VehicleCapability` by default, plus the per-sub-trim action-support entries that aren't visible in the cap bitmask.
Raw host-bridge protocol
The window globals, calling conventions, and envelopes the SDK wraps — for debugging and for examples that call the bridge directly.