Runtime client

import { MiniAppClient, createClientOrSSR } from 'i99dash';

const client = createClientOrSSR(); // null on SSR / no-host
if (!client) return null;

const ctx     = await client.getContext();
const climate = await client.car.list({ category: 'climate' });
const snap    = await client.car.read(['ac_cabin_temp', 'speed_kmh']);
const off     = await client.car.subscribe({
  names: ['speed_kmh'],
  onEvent: (e) => render(e.value),
});

Client

Reaching external APIs

There is no SDK proxy for HTTP. A mini-app calls external HTTPS APIs with plain fetch(), gated by the origins it declares in manifest.network — the host enforces the allow-list as a Content-Security-Policy. See Calling an external API.

Capabilities handshake

Car controller

v5 collapsed every per-family controller (climate, media, location, nav, …) into a single name-keyed CarController on client.car. The host owns one catalog per brand; mini-apps read by name, write by actionId. See the v5 migration for the rewrite of each call site.

const list = await client.car.list({ category: 'climate' });
const snap = await client.car.read(list.entries.slice(0, 4).map(e => e.name));
const off  = await client.car.subscribe({
  names: ['speed_kmh'],
  onEvent: (e) => render(e.value),
});
off();                                                   // idempotent

A consumer that calls client.car.* on a host build that doesn't ship the car.* bridge sees BridgeTransportError. Feature-detect with client.has('car.read') at app start.

Platform control families

Active families that change device state — list installed apps, launch them on a chosen display, draw cursors, inject gestures.

Errors

All concrete errors extend SDKError with a stable SDKErrorCode you can switch on. v5 removed every per-family *UnavailableError class — bridge-level failures (missing handler, transport, timeout) now surface as the generic transport / timeout errors below.

Bridge plumbing

You usually don't need these — the high-level MiniAppClient wraps them. Useful for tests that hand-roll a bridge or for advanced integrations.

• Bridge — base interface (getContext + capability handshake).
• HostBridge — production impl proxying to the host global.
• HOST_GLOBAL, LEGACY_HOST_GLOBAL, HOST_EVENTS_GLOBAL — global names the host injects.
• HostBridgeApi, WindowWithHost, resolveHostApi — types + helper for the global lookup.
• withTimeout — internal helper, exported so other workspace packages can share one timeout/abort implementation.

Related

• Concepts — the bridge, calling an external API, error model
• v5 migration — collapsing per-family controllers into client.car
• Guides — task-oriented walkthroughs
• i99dash/react — React bindings on top of this package