Capability matrix
Which features each SDK supports today, which are partial or pending validation, and which are planned.
Last updated: 2026-11-13. A feature is listed as available only when it works end to end against the API.
| Mark | Meaning |
|---|---|
| Supported | Implemented; the feature is covered by integration tests against real local infrastructure (PostgreSQL, Redis, LiveKit, S3). SDK-level end-to-end coverage per method is tracked in program status |
| Pending validation | Implemented, pending validation: compiles and is unit-tested, but has not run on a device or real network |
| Partial | Partial: see the note |
| Use the LiveKit SDK | Use the LiveKit SDK directly: Lynkoria exposes the LiveKit Room and does not wrap this |
| Planned | Planned, not available |
| — | Not applicable or not supported |
Columns: Web @lynkoria/client (browsers), React @lynkoria/react, Node @lynkoria/server (product backends), RN @lynkoria/react-native, Android io.lynkoria:lynkoria-core + lynkoria-android, iOS LynkoriaCore + Lynkoria.
Authentication and connection
| Capability | Web | React | Node | RN | Android | iOS | Notes |
|---|---|---|---|---|---|---|---|
| Mint messaging tokens and call join tokens | — | — | Supported | — | — | — | Only product backends hold service keys |
| Short-lived token from your backend | Supported | Supported | — | Supported | Supported | Supported | Token provider callback; no SDK accepts a service key |
| Session refresh before expiry | Supported | Supported | — | Supported | Supported | Partial | iOS realtime path tested on macOS only after an Xcode run (Linux image lacks WebSockets) |
| Automatic reconnect, connection state | Supported | Supported | — | Supported | Supported | Partial | Same iOS note |
| Missed-event recovery after reconnect | Supported | Supported | — | Supported | Supported | Supported | Sequence numbers + after_seq resync |
| Typed errors with stable codes | Supported | Supported | Supported | Supported | Supported | Supported | Error codes |
| Webhook signature verification | — | — | Supported | — | — | — | Supports two secrets during rotation |
Calls
| Capability | Web | React | Node | RN | Android | iOS | Notes |
|---|---|---|---|---|---|---|---|
| Create rooms, end calls | — | — | Supported | — | — | — | Rooms exist only when the API creates them |
| Join, mic/camera on/off | Supported | Supported | — | Pending validation | Pending validation | Pending validation | Native layers compile; not device-tested |
| Screen sharing | Supported | Supported | — | Pending validation | Pending validation | Pending validation | Desktop browsers; mobile browsers generally cannot capture |
| Participant list, speaking, quality | Supported | Supported | — | Pending validation | Pending validation | Pending validation | useCallParticipants; StateFlow (Android); @Published (iOS) |
| Device listing and switching | Supported | Partial | — | Partial | Partial | Use the LiveKit SDK | React: through session.listDevices/switchDevice, no hook. Native: audio routes only |
| Audio output selection | Partial | Partial | — | Pending validation | Pending validation | Use the LiveKit SDK | Browsers that support setSinkId |
| Device hot-plug | Use the LiveKit SDK | Use the LiveKit SDK | — | Use the LiveKit SDK | Use the LiveKit SDK | Use the LiveKit SDK | LiveKit's MediaDevicesChanged / platform audio routing |
| Moderation: remove participant, change role | — | — | Supported | — | — | — | Removal does not revoke join tokens issued in the last 5 minutes |
| Call signaling (invite, ring, accept, end) | Supported | Partial | Supported | Supported | Supported | Supported | React: client.onCallStateChange, no hook. Delivered to connected devices |
| Calls continue in the background | — | — | — | Pending validation | Pending validation | Pending validation | Android: ongoing-call foreground service; iOS: audio background mode and CallKit audio activation |
| Incoming-call UI (CallKit, CallStyle) | — | — | — | Pending validation | Pending validation | Pending validation | Needs devices and push credentials |
| Recording (Egress) start/stop/download | — | — | Supported | — | — | — | API lifecycle tested with a stubbed Egress; no real Egress run (REC-01) |
| End-to-end encryption | Use the LiveKit SDK | Use the LiveKit SDK | — | Use the LiveKit SDK | Use the LiveKit SDK | Use the LiveKit SDK | LiveKit E2EE in the client; Lynkoria does not manage keys |
Livestreaming
| Capability | Web | React | Node | RN | Android | iOS | Notes |
|---|---|---|---|---|---|---|---|
| Host, speaker and viewer roles | Supported | Supported | Supported | Pending validation | Pending validation | Pending validation | Role is in the join token; viewers cannot publish |
| Promote a viewer to speaker | — | — | Supported | — | — | — | calls.setRole |
| Viewer count | Use the LiveKit SDK | Use the LiveKit SDK | — | Use the LiveKit SDK | Use the LiveKit SDK | Use the LiveKit SDK | From the LiveKit room's participants; no dedicated API |
| HLS / CDN delivery for large audiences | Planned | Planned | Planned | Planned | Planned | Planned | ARCH-02; viewers are WebRTC participants today |
Messaging and presence
| Capability | Web | React | Node | RN | Android | iOS | Notes |
|---|---|---|---|---|---|---|---|
| Create conversations, manage members | — | — | Supported | — | — | — | Server-side only |
| Send and receive, history | Supported | Supported | — | Supported | Supported | Supported | Sends are idempotent on clientMessageId |
| Edit, delete, reactions, threads | Supported | Partial | — | Supported | Supported | Supported | React: useConversation applies them; actions through client.messages |
| Read receipts | Supported | Supported | — | Supported | Supported | Supported | |
| Typing indicators | Supported | Supported | — | Supported | Supported | Supported | useTyping |
| Attachments (upload, scan, download) | Supported | Partial | — | Supported | Partial | Partial | React: through client.attachments. Native cores receive attachment metadata; no upload API |
| Presence and manual status | Supported | Supported | — | Supported | Supported | Supported | Tenant-wide audience |
| Offline send queue | Planned | Planned | — | Planned | Planned | Planned | FEAT-02; retry failed sends with the same clientMessageId |
Push notifications
| Capability | Web | React | Node | RN | Android | iOS | Notes |
|---|---|---|---|---|---|---|---|
| Register and unregister device | — | — | — | Supported | Supported | Supported | FCM, APNs, PushKit |
| Notification preferences | Supported | — | — | Supported | Supported | Supported | |
| Send notifications | — | — | Supported | — | — | — | Delivery tested against mock FCM/APNs only |
| Parse Lynkoria push payloads | — | — | — | Supported | Supported | Supported |
Media and effects
| Capability | Web | React | Node | RN | Android | iOS | Notes |
|---|---|---|---|---|---|---|---|
| Background blur and virtual backgrounds | Planned | Planned | — | Planned | Planned | Planned | To evaluate LiveKit track processors; until then apply them to session.room yourself |
| Custom video processor | Use the LiveKit SDK | Use the LiveKit SDK | — | Use the LiveKit SDK | Use the LiveKit SDK | Use the LiveKit SDK | LiveKit track processor APIs |
| Beauty filters, AR masks | — | — | — | — | — | — | Client-side responsibility (ADR 017) |
Framework integration
| Capability | Status | Notes |
|---|---|---|
| Expo (config plugin, development builds) | Pending validation | Plugin unit-tested; not yet run in a real expo prebuild. Expo Go cannot load custom native modules |
| Server-side rendering safety | Supported | Verified in a production Next.js build: server snapshot idle, hydration without errors, connection only in the browser |
| Next.js (App Router) | Supported | Guide; apps/example-nextjs with Playwright: SSR, hydration, one socket, chat, LiveKit call, bundle boundaries |
| TanStack Start / Router | Supported | Guide; apps/example-tanstack-start with Playwright: loader SSR, hydration, one connection across navigation, release on leaving the layout, chat, bundle boundaries |
| CommonJS consumers of the npm packages | Supported | ESM only; require() works on Node.js 22.12 and later (ADR 022) |
SDK versions and publishing status: platform status. Native validation status: testing completion criteria.