@voltkit-rtc/react-native 0.0.0-stage → 0.1.1

package/lib/typescript/module/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The errors this package raises. Every one is an RpcError with a code from the VoltKit error registry
+ * (@voltkit-rtc/client ERROR_CODES, checked code for code against every SDK by scripts/test/sdk-contract-sdks.mjs), so
+ * an app switches on `error.code` exactly as it does in a browser or the Android SDK. What is missing goes in `data`:
+ *
+ * - `media-unavailable` `{ reason: 'webrtc-missing' }`: react-native-webrtc's native module is not in the app (Expo Go,
+ *   or an app not rebuilt after installing it). The message says it needs a development build.
+ * - `media-unavailable` `{ reason: 'native-missing', feature }`: this package's own native module is not in the app.
+ * - `media-unavailable` `{ platform: 'ios', feature }`: not in the iOS preview (audio routing: setSpeakerphoneOn,
+ *   selectAudioOutput, switchDevice('audiooutput')). The call service and screen sharing do not raise it there: the
+ *   service is simply not declared (useCallService), and the client answers `screen-share-unsupported`.
+ * - `media-unavailable` `{ permission: 'camera' | 'microphone', status: 'denied' | 'blocked' }`: a refused permission,
+ *   the field names of the Android SDK.
+ * - `media-unavailable` `{ feature: 'callService' }`: the call service could not start or keep running.
+ */
+import { RpcError } from '@voltkit-rtc/client';
+export type MediaPermissionKind = 'camera' | 'microphone';
+/** react-native-webrtc's native module is missing: Expo Go, or the app was not rebuilt. */
+export declare function webrtcMissing(): RpcError;
+/** This package's own native module is missing: the app was not rebuilt after installing it. */
+export declare function nativeMissing(feature: string): RpcError;
+/** Not in the iOS preview of 0.1.0. */
+export declare function iosUnsupported(feature: string): RpcError;
+/** A camera or microphone permission the user refused: `blocked` when Android will not ask again. */
+export declare function permissionRefused(permission: MediaPermissionKind, status: 'denied' | 'blocked'): RpcError;
+/** The call service could not start, or Android stopped it. */
+export declare function callServiceFailed(message: string): RpcError;
+/** A failure a native module or react-native-webrtc reported, as an RpcError with a registry code. */
+export declare function nativeFailure(error: unknown, code?: 'media-unavailable' | 'camera-failed' | 'screen-share-failed', data?: Record<string, unknown>): RpcError;
+/** A readable message from anything thrown: an Error, react-native-webrtc's MediaStreamError (not an Error), a string. */
+export declare function describeError(error: unknown): string;
+/** Report a failure from code no caller awaits: the error listener's own errors never escape into the app. */
+export declare function logError(context: string, error: unknown): void;
+//# sourceMappingURL=errors.d.ts.map

package/lib/typescript/module/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE1D,2FAA2F;AAC3F,wBAAgB,aAAa,IAAI,QAAQ,CAMxC;AAED,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAMvD;AAED,uCAAuC;AACvC,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAExD;AAED,qGAAqG;AACrG,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,mBAAmB,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAMzG;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAE3D;AAED,sGAAsG;AACtG,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,mBAAmB,GAAG,eAAe,GAAG,qBAA2C,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAGjL;AAED,0HAA0H;AAC1H,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWpD;AAED,8GAA8G;AAC9G,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAG9D"}

package/lib/typescript/module/globals.d.ts

@@ -0,0 +1,16 @@
+import type * as WebRTC from 'react-native-webrtc';
+export type WebRTCModule = typeof WebRTC;
+/** Whether react-native-webrtc's native module is in this app. */
+export declare function webrtcAvailable(): boolean;
+/** react-native-webrtc, or null when its native module is not in the app (Expo Go, an app not rebuilt). */
+export declare function loadWebRTC(): WebRTCModule | null;
+/**
+ * Install react-native-webrtc's WebRTC classes as globals (RTCPeerConnection, MediaStream, ...), which mediasoup-client
+ * needs. Runs when the package is imported; calling it again does nothing. Returns false, without throwing, where
+ * react-native-webrtc's native module is missing: the provider then reports `media-unavailable` with
+ * `{ reason: 'webrtc-missing' }`.
+ */
+export declare function registerVoltkitGlobals(): boolean;
+/** The version of react-native-webrtc in the app, for getDiagnostics(); null when it cannot be read. */
+export declare function webrtcVersion(): string | null;
+//# sourceMappingURL=globals.d.ts.map

package/lib/typescript/module/globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../../../src/globals.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,KAAK,MAAM,MAAM,qBAAqB,CAAC;AAEnD,MAAM,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC;AAKzC,kEAAkE;AAClE,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,2GAA2G;AAC3G,wBAAgB,UAAU,IAAI,YAAY,GAAG,IAAI,CAMhD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAOhD;AAED,wGAAwG;AACxG,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAQ7C"}

package/lib/typescript/module/index.d.ts

@@ -0,0 +1,24 @@
+export { registerVoltkitGlobals } from './globals.js';
+export { createClient, reactNativeClientOptions } from './create-client.js';
+export type { BackgroundOptions, CreateClientOptions } from './create-client.js';
+export { preflight } from './preflight.js';
+export type { ReactNativePreflightOptions } from './preflight.js';
+export { reactNativePlatform } from './platform/index.js';
+export type { MediaStreamLike, MediaStreamTrackLike, MediaTrackSettingsLike } from './platform/common.js';
+export { VoltkitProvider } from './provider.js';
+export type { VoltkitProviderProps } from './provider.js';
+export { useCallService } from './native-session.js';
+export type { AudioSessionOptions, CallServiceState, CallServiceText } from './native-session.js';
+export { useLocalMedia } from './local-media.js';
+export type { LocalMedia, LocalPublishOptions } from './local-media.js';
+export { VideoTrack, AudioTrack } from './components.js';
+export type { VideoTrackProps, AudioTrackProps } from './components.js';
+export { useAudioOutput, setSpeakerphoneOn, selectAudioOutput } from './audio.js';
+export type { AudioOutput } from './audio.js';
+export { requestMediaPermissions, checkMediaPermissions, usePermissions } from './permissions.js';
+export type { PermissionKind, PermissionStatus, PermissionStatuses, Permissions } from './permissions.js';
+export { SDK_VERSION } from './native.js';
+export { useVoltkitClient, useRoom, useConnectionState, useParticipants, useRemoteTracks, useNetworkQuality, useWalletLow, useVoltkitEvent, useActiveSpeakers, useAudioLevels, useCpuConstrained, useDevices, useIsSpeaking, useMediaWarnings, usePublishFallback, useStreamFallback, } from '@voltkit-rtc/react';
+export type { RoomState, RemoteTrackFilter, WalletLowState } from '@voltkit-rtc/react';
+export type { AudioDeviceType, AudioQuality, CameraFacing, ChatMessage, ClientEvents, ClientOptions, ClientPlatform, ClosedReason, CodecPreference, ConnectionState, DeviceHandlerName, DeviceKind, ErrorCode, JoinResult, LayerCount, LocalMediaState, MediaDevice, MediaPermissions, NetworkQuality, NetworkQualityLevel, ParticipantInfo, PreflightReport, PublishOptions, RemoteTrack, Role, ScreenMode, ScreenPublishOptions, SendMessageOptions, StreamClient, TokenExpiringNotice, TrackSource, UsageLimitNotice, VideoQuality, WalletLowNotice, } from '@voltkit-rtc/client';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAW,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,oBAAiB,CAAC;AACzE,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oBAAiB,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAa,CAAC;AACxC,YAAY,EAAE,2BAA2B,EAAE,MAAM,gBAAa,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAY,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,sBAAmB,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,MAAM,eAAY,CAAC;AAC7C,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAY,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAkB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAe,CAAC;AAC9C,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,kBAAe,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAc,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAc,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAS,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,MAAM,YAAS,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,kBAAe,CAAC;AAC/F,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,kBAAe,CAAC;AACvG,OAAO,EAAE,WAAW,EAAE,MAAM,aAAU,CAAC;AAGvC,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGvF,YAAY,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,UAAU,EACV,UAAU,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,cAAc,EACd,WAAW,EACX,IAAI,EACJ,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,qBAAqB,CAAC"}

package/lib/typescript/module/local-media.d.ts

@@ -0,0 +1,86 @@
+import { type AudioQuality, type MediaPermissions, type PublishOptions, type ScreenPublishOptions, type StreamClient, type VideoQuality } from '@voltkit-rtc/client';
+import { type MediaStreamLike, type UserMediaConstraints } from './platform/common.js';
+/** A camera's or microphone's constraints, as the client declares them (this package compiles without the DOM library). */
+type TrackConstraints = Exclude<NonNullable<UserMediaConstraints['audio']>, boolean>;
+export interface LocalPublishOptions extends PublishOptions {
+    /** The microphone: true (the default) for VoltKit's settings, false for none, or your own constraints, used as given. */
+    audio?: boolean | TrackConstraints;
+    /** The camera: true (the default) for the quality's frame and frame rate, false for none, or your own constraints. */
+    video?: boolean | TrackConstraints;
+    /** Which camera: `'user'` (front, the default) or `'environment'` (back). Only with `video: true`. */
+    facingMode?: 'user' | 'environment';
+}
+export interface LocalMedia {
+    /**
+     * Your camera and microphone as published (`client.local`); null when not publishing them. react-native-webrtc's
+     * stream, typed by shape (`MediaStreamLike`): `stream.getVideoTracks()[0]` is the camera for a `VideoTrack`.
+     */
+    stream: MediaStreamLike | null;
+    /** True while anything is published: camera, microphone, screen or music. */
+    publishing: boolean;
+    micEnabled: boolean;
+    camEnabled: boolean;
+    /** What the microphone is sent at, after the project's limit. */
+    audioQuality: AudioQuality;
+    /** What the camera is sent at, after the project's limit. */
+    videoQuality: VideoQuality;
+    videoFrameRate: 30 | 60;
+    screenSharing: boolean;
+    /** The screen being shared, for a preview; null when not sharing. */
+    screenStream: MediaStreamLike | null;
+    /** What this project lets this client publish: offer only these. */
+    permissions: MediaPermissions;
+    /** The published camera faces you (`'user'`) or away (`'environment'`); null without a camera. */
+    facingMode: 'user' | 'environment' | null;
+    /**
+     * Open the camera and microphone and publish them, asking for their permissions first. Only hosts and cohosts may.
+     * A refused permission rejects with `media-unavailable` `{ permission: 'camera' | 'microphone', status: 'denied' |
+     * 'blocked' }` before any device opens.
+     */
+    publish(options?: LocalPublishOptions): Promise<void>;
+    /** Stop publishing everything, screen and music included, and release the devices. */
+    unpublish(): Promise<void>;
+    setMicEnabled(on: boolean): Promise<void>;
+    setCamEnabled(on: boolean): Promise<void>;
+    /** Resolves to the quality in use; rejects with `audio-quality-not-allowed` for HD where the project allows standard only. */
+    setAudioQuality(quality: AudioQuality): Promise<AudioQuality>;
+    /** Raises the camera's capture first when it is smaller than `quality`. Resolves to the quality used. */
+    setVideoQuality(quality: VideoQuality): Promise<VideoQuality>;
+    /** Resolves to the frame rate used: 30 where the project or the camera cannot do 60. */
+    setVideoFrameRate(frameRate: 30 | 60): Promise<30 | 60>;
+    /**
+     * Front to back or back to front, on the same track: viewers see no gap and the producer stays the same. Resolves
+     * true when the front camera is in use now (the contract's switchCamera). Rejects with `media-unavailable` when no
+     * camera is published. A device with one camera keeps it.
+     */
+    switchCamera(): Promise<boolean>;
+    /**
+     * Share the screen beside the camera (Android: react-native-webrtc's MediaProjection consent; the Expo plugin's
+     * android.screenShare must be on). `screen-share-denied` when the user cancels, `screen-share-service-required`
+     * without the plugin option, `screen-share-unsupported` on iOS.
+     */
+    startScreenShare(options?: ScreenPublishOptions): Promise<MediaStreamLike>;
+    stopScreenShare(): Promise<void>;
+}
+/**
+ * Per client: the screen being shared (only events tell it) and a signal for what changes without an event (publish,
+ * a camera switch). Recorded while held: the provider holds its client's for as long as it has the client.
+ */
+declare class LocalSession {
+    private readonly client;
+    screen: MediaStreamLike | null;
+    private readonly listeners;
+    private holders;
+    private stopListening;
+    constructor(client: StreamClient);
+    hold(): () => void;
+    subscribe(listener: () => void): () => void;
+    changed(): void;
+    private listen;
+    private endScreen;
+}
+export declare function localSessionOf(client: StreamClient): LocalSession;
+/** Your camera, microphone and screen: what is published, and the calls that change it. */
+export declare function useLocalMedia(): LocalMedia;
+export {};
+//# sourceMappingURL=local-media.d.ts.map

package/lib/typescript/module/local-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-media.d.ts","sourceRoot":"","sources":["../../../src/local-media.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/native-session.d.ts

@@ -0,0 +1,38 @@
+/** The call service's notification. */
+export interface CallServiceText {
+    /** Default "Call in progress". */
+    title?: string;
+    /** Default "Tap to return to the call". */
+    text?: string;
+    /** The Leave action's label. Default "Leave". */
+    leaveLabel?: string;
+}
+/** How the provider manages the call audio. */
+export interface AudioSessionOptions {
+    /** The loudspeaker (true, the default) or the earpiece when no headset is connected, unless setSpeakerphoneOn chose. */
+    speakerphone?: boolean;
+    /** Hold the call audio (mode, focus, routing) while the call is connected. Default true. */
+    manage?: boolean;
+}
+export interface CallServiceState {
+    /** The app's manifest declares the call service (VoltkitCallService). */
+    declared: boolean;
+    /** It runs now. */
+    running: boolean;
+    /** The foreground service types it runs with: `microphone`, `mediaPlayback`, `camera`, `mediaProjection`. */
+    types: string[];
+}
+/** The call service: whether the app declares it, whether it runs and with which types. */
+export declare function useCallService(): CallServiceState;
+export interface NativeSessionProps {
+    audio: AudioSessionOptions | false | undefined;
+    callService: boolean | CallServiceText | undefined;
+    /** The provider's background.pauseCamera: for a client whose own options cannot be read (see pausesCameraInBackground). */
+    pauseCamera: boolean;
+    onError: {
+        readonly current: ((error: Error) => void) | undefined;
+    };
+}
+/** Rendered by the provider inside @voltkit-rtc/react's provider: keeps the call audio and the call service for its client. */
+export declare function NativeSession({ audio, callService, pauseCamera, onError }: NativeSessionProps): null;
+//# sourceMappingURL=native-session.d.ts.map

package/lib/typescript/module/native-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-session.d.ts","sourceRoot":"","sources":["../../../src/native-session.tsx"],"names":[],"mappings":"AAyBA,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,wHAAwH;IACxH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAgBD,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,QAAQ,EAAE,OAAO,CAAC;IAClB,mBAAmB;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,6GAA6G;IAC7G,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AA2ND,2FAA2F;AAC3F,wBAAgB,cAAc,IAAI,gBAAgB,CAEjD;AAID,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,mBAAmB,GAAG,KAAK,GAAG,SAAS,CAAC;IAC/C,WAAW,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAAC;IACnD,2HAA2H;IAC3H,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;KAAE,CAAC;CACrE;AAED,+HAA+H;AAC/H,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,kBAAkB,GAAG,IAAI,CAkDpG"}

package/lib/typescript/module/native.d.ts

@@ -0,0 +1,18 @@
+import type { EventSubscription } from 'react-native';
+import { type AudioDevice, type Constants, type Spec } from './specs/NativeVoltkitRtc.js';
+import type { MediaDevice } from '@voltkit-rtc/client';
+/** The version of this package: what getDiagnostics() reports, and what the native side was built from. */
+export declare const SDK_VERSION = "0.1.1";
+/** The native module, or null where there is none (iOS, Expo Go, an app not rebuilt). */
+export declare function nativeModule(): Spec | null;
+/** The module's constants, read once: the audio mode, screen sharing, the call service as the manifest declares them. */
+export declare function nativeConstants(): Constants | null;
+/** The native module for `feature`, or the error that says why there is none. */
+export declare function requireNative(feature: string): Spec;
+/** Subscribe to one of the module's events; a listener that throws is logged and the others still run. */
+export declare function listen<T>(emitter: ((handler: (value: T) => void) => EventSubscription) | undefined, name: string, listener: (value: T) => void): () => void;
+/** A native audio device as the client's MediaDevice. */
+export declare function toMediaDevice(device: AudioDevice): MediaDevice;
+/** For tests: forget the cached constants. */
+export declare function resetNativeForTests(): void;
+//# sourceMappingURL=native.d.ts.map

package/lib/typescript/module/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../../src/native.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAyB,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,IAAI,EAAE,MAAM,6BAA0B,CAAC;AAEzG,OAAO,KAAK,EAA+B,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEpF,2GAA2G;AAC3G,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,yFAAyF;AACzF,wBAAgB,YAAY,IAAI,IAAI,GAAG,IAAI,CAG1C;AAKD,yHAAyH;AACzH,wBAAgB,eAAe,IAAI,SAAS,GAAG,IAAI,CAkBlD;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKnD;AAED,0GAA0G;AAC1G,wBAAgB,MAAM,CAAC,CAAC,EACtB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,KAAK,iBAAiB,CAAC,GAAG,SAAS,EACzE,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAC3B,MAAM,IAAI,CAUZ;AAKD,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAI9D;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}

package/lib/typescript/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/module/permissions.d.ts

@@ -0,0 +1,30 @@
+/** What can be asked for. */
+export type PermissionKind = 'camera' | 'microphone' | 'notifications';
+/** `granted`; `denied` (not granted yet: asking may still show the dialog); `blocked` (only the settings can grant it). */
+export type PermissionStatus = 'granted' | 'denied' | 'blocked';
+export type PermissionStatuses<K extends PermissionKind = PermissionKind> = {
+    [P in K]: PermissionStatus;
+};
+/**
+ * Ask for these permissions, showing the system's dialogs for those not granted yet. Resolves with each one's status;
+ * never rejects.
+ */
+export declare function requestMediaPermissions<K extends PermissionKind>(kinds: readonly K[]): Promise<PermissionStatuses<K>>;
+/** Each permission's status now, without asking. Never rejects. */
+export declare function checkMediaPermissions<K extends PermissionKind>(kinds: readonly K[]): Promise<PermissionStatuses<K>>;
+export interface Permissions<K extends PermissionKind = PermissionKind> {
+    /** Each permission's status; null until first checked. Checked again whenever the app comes back to the front. */
+    statuses: PermissionStatuses<K> | null;
+    /** Every one granted. */
+    granted: boolean;
+    /** Ask for those not granted (the system's dialogs); resolves with the statuses. */
+    request(): Promise<PermissionStatuses<K>>;
+    /** Check again without asking. */
+    refresh(): Promise<PermissionStatuses<K>>;
+}
+/**
+ * The status of these permissions, checked on mount and whenever the app returns to the front (the user may have
+ * changed them in the settings), with `request()` to ask for them.
+ */
+export declare function usePermissions<K extends PermissionKind>(kinds: readonly K[]): Permissions<K>;
+//# sourceMappingURL=permissions.d.ts.map

package/lib/typescript/module/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/permissions.ts"],"names":[],"mappings":"AAkBA,6BAA6B;AAC7B,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,YAAY,GAAG,eAAe,CAAC;AAEvE,2HAA2H;AAC3H,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhE,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,IAAI;KAAG,CAAC,IAAI,CAAC,GAAG,gBAAgB;CAAE,CAAC;AAa3G;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAmB3H;AAED,mEAAmE;AACnE,wBAAsB,qBAAqB,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAoBzH;AAoCD,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc;IACpE,kHAAkH;IAClH,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACvC,yBAAyB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,oFAAoF;IACpF,OAAO,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,kCAAkC;IAClC,OAAO,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAgC5F"}

package/lib/typescript/module/platform/android.d.ts

@@ -0,0 +1,4 @@
+import { type ClientPlatform } from '@voltkit-rtc/client';
+/** The Android platform. One per process (platform/index.ts). */
+export declare function androidPlatform(): ClientPlatform;
+//# sourceMappingURL=android.d.ts.map

package/lib/typescript/module/platform/android.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"android.d.ts","sourceRoot":"","sources":["../../../../src/platform/android.ts"],"names":[],"mappings":"AAQA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA4EpE,iEAAiE;AACjE,wBAAgB,eAAe,IAAI,cAAc,CA0ChD"}

package/lib/typescript/module/platform/common.d.ts

@@ -0,0 +1,101 @@
+import { type ClientPlatform, type DeviceEnv, type EncodingInfoProbe } from '@voltkit-rtc/client';
+import { type MediaPermissionKind } from '../errors.js';
+/**
+ * The DOM's media types as the client declares them. This package compiles without the DOM library (React Native has
+ * none), so they are taken from the client's own declarations rather than named.
+ */
+export type UserMediaConstraints = Parameters<NonNullable<ClientPlatform['getUserMedia']>>[0];
+export type ClientStream = ReturnType<ClientPlatform['createStream']>;
+export type ClientTrack = Parameters<ClientPlatform['stopTrack']>[0];
+/**
+ * `ClientPlatform.adoptAppStream` (optional in @voltkit-rtc/client 0.9.12; this platform always provides it): the
+ * client is taking tracks from `stream`, a stream the app gave it (`publish(stream)`, `publishScreen({ stream })`),
+ * and will stop and release those tracks but never the stream, which is the app's. This platform then takes each track
+ * out of that stream before releasing it, so the app can release its stream after unpublish() or close() without
+ * react-native-webrtc 155 killing the app (Phase 0 finding 1). useLocalMedia().publish() is safe either way (its
+ * capture is made and released here).
+ */
+export interface AppStreamHook {
+    adoptAppStream(stream: ClientStream): void;
+}
+/**
+ * The settings a track reports: react-native-webrtc's `MediaTrackSettings` (the web's has these fields too). A camera
+ * says its `width`, `height`, `frameRate`, `facingMode` (`'user'` or `'environment'`) and `deviceId`.
+ */
+export interface MediaTrackSettingsLike {
+    width?: number;
+    height?: number;
+    frameRate?: number;
+    facingMode?: string;
+    deviceId?: string;
+    groupId?: string;
+}
+/**
+ * A media track by shape: react-native-webrtc's `MediaStreamTrack`, which every track this package hands out is
+ * (`useLocalMedia().stream?.getVideoTracks()[0]`), and the web's `MediaStreamTrack` as `@voltkit-rtc/client` types a
+ * remote track's `track`, which fits the same shape, so either goes into `VideoTrack` and `AudioTrack` as it is. Typed by
+ * shape so an app compiles without the DOM library (`@react-native/typescript-config` leaves it out, and the only
+ * `MediaStream` it then knows is an empty stub). `remote` and `release` are react-native-webrtc's: a received track, and
+ * freeing the native track, which the SDK does for its own tracks.
+ */
+export interface MediaStreamTrackLike {
+    readonly id: string;
+    /** `'audio'` or `'video'`. */
+    readonly kind: string;
+    /** `'live'` or `'ended'`. */
+    readonly readyState: string;
+    enabled: boolean;
+    stop(): void;
+    getSettings(): MediaTrackSettingsLike;
+    getConstraints(): object;
+    applyConstraints(constraints?: object): Promise<void>;
+    readonly remote?: boolean;
+    release?(): void;
+}
+/**
+ * A media stream by shape: react-native-webrtc's `MediaStream`, which `useLocalMedia().stream` and `screenStream`
+ * are. Typed by shape for the same reason as `MediaStreamTrackLike`. `toURL()` is what an `RTCView` plays (`VideoTrack`
+ * does this), and `release()` frees the native stream: never call it on a stream the SDK made (see `VideoTrack`).
+ */
+export interface MediaStreamLike {
+    readonly id: string;
+    readonly active: boolean;
+    getTracks(): MediaStreamTrackLike[];
+    getAudioTracks(): MediaStreamTrackLike[];
+    getVideoTracks(): MediaStreamTrackLike[];
+    addTrack(track: MediaStreamTrackLike): void;
+    removeTrack(track: MediaStreamTrackLike): void;
+    toURL(): string;
+    release(releaseTracks?: boolean): void;
+}
+/** The client's own stream (`client.local`), typed as react-native-webrtc's. */
+export declare function localStream(client: {
+    readonly local: unknown;
+}): MediaStreamLike | null;
+/** getDiagnostics().userAgent: `ReactNative android 37; react-native-webrtc 155.0.1; @voltkit-rtc/react-native 0.1.1`. */
+export declare function describePlatform(): string;
+/**
+ * What the client reads to pick its defaults: a phone or tablet, so two simulcast layers and the H.264 decision
+ * (there is no user agent in React Native, which gave phones a computer's three layers).
+ */
+export declare function deviceEnv(): DeviceEnv;
+/**
+ * Whether H.264 is encoded in hardware, asked only for a phone whose WebRTC can send H.264 at all. On Android
+ * react-native-webrtc's libwebrtc has no software H.264 encoder (the emulator, without a hardware one, offers none), so
+ * a device that offers it encodes it in hardware: 'auto' then sends H.264, as the Android SDK does.
+ */
+export declare const hardwareH264: EncodingInfoProbe;
+/** The kinds a capture asks for, as permissions. */
+export declare function kindsOf(constraints: {
+    audio?: unknown;
+    video?: unknown;
+}): MediaPermissionKind[];
+/**
+ * Capture a camera and/or microphone through react-native-webrtc (ClientPlatform.getUserMedia). The permissions are
+ * checked first, without asking (a reconnect in the background must not open a dialog): one not granted rejects with
+ * `media-unavailable` `{ permission, status }` and nothing opens. react-native-webrtc drops a kind whose permission was
+ * refused without an error, so a stream missing a kind asked for is released and refused the same way. The stream is
+ * kept in the book, so it is released once its tracks are stopped.
+ */
+export declare function captureUserMedia(constraints: UserMediaConstraints): Promise<ClientStream>;
+//# sourceMappingURL=common.d.ts.map

package/lib/typescript/module/platform/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/platform/common.ts"],"names":[],"mappings":"AAKA,OAAO,EAAY,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG5G,OAAO,EAAmD,KAAK,mBAAmB,EAAE,MAAM,cAAW,CAAC;AAItG;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,WAAW,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9F,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAGrE;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,IAAI,IAAI,CAAC;IACb,WAAW,IAAI,sBAAsB,CAAC;IACtC,cAAc,IAAI,MAAM,CAAC;IACzB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,SAAS,IAAI,oBAAoB,EAAE,CAAC;IACpC,cAAc,IAAI,oBAAoB,EAAE,CAAC;IACzC,cAAc,IAAI,oBAAoB,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC5C,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC/C,KAAK,IAAI,MAAM,CAAC;IAChB,OAAO,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACxC;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,eAAe,GAAG,IAAI,CAEvF;AAED,0HAA0H;AAC1H,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,SAAS,CAGrC;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,iBAAyG,CAAC;AAErI,oDAAoD;AACpD,wBAAgB,OAAO,CAAC,WAAW,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,mBAAmB,EAAE,CAKhG;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6B/F"}

package/lib/typescript/module/platform/devices.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Cameras, microphones and audio outputs.
+ *
+ * Cameras come from react-native-webrtc (ids "0", "1", ... with a facing), named as the Android SDK names them ("Front
+ * camera", "Back camera 2"). On Android the audio devices come from this package's audio router (speaker, earpiece,
+ * wired and USB headsets, Bluetooth, each with its `type`), which also routes sound and picks the microphone natively;
+ * without the native module, and on iOS, from react-native-webrtc's list.
+ *
+ * A camera is switched on its own track (react-native-webrtc's applyConstraints with the deviceId): the same track and
+ * producer, so nothing can fail half-way. react-native-webrtc falls back to the facing mode, without an error, for an
+ * id it does not know, so the id is checked against the list first (`bad-params`) and the camera it ended up on is
+ * checked after (`camera-failed`); the old camera keeps capturing either way.
+ */
+import { type DeviceKind, type MediaDevice } from '@voltkit-rtc/client';
+import type { Spec } from '../specs/NativeVoltkitRtc.js';
+/** The cameras, front ones first, labelled as the Android SDK labels them. */
+export declare function listCameras(): Promise<MediaDevice[]>;
+/** Every device, or those of one kind (ClientPlatform.enumerateDevices). */
+export declare function enumerateDevices(module: Spec | null, kind?: DeviceKind): Promise<MediaDevice[]>;
+/** Hear audio devices come and go (Android's router); cameras cannot be watched. */
+export declare function onDeviceChange(module: Spec | null, listener: () => void): (() => void) | null;
+/**
+ * Route sound to an output, or record from a microphone, natively (ClientPlatform.routeAudio). Outputs: true when
+ * routed, false when it cannot be chosen (the client then rejects with `bad-params`). Microphones: true when the audio
+ * device module records from it now; `bad-params` for one the router does not list; false (the client captures it)
+ * where the module cannot choose.
+ */
+export declare function routeAudio(module: Spec, kind: 'audioinput' | 'audiooutput', deviceId: string): Promise<boolean>;
+/** react-native-webrtc's camera track, as far as switching needs it. */
+interface CameraTrack {
+    readonly kind: string;
+    getSettings(): {
+        deviceId?: unknown;
+        facingMode?: unknown;
+    };
+    getConstraints(): Record<string, unknown>;
+    applyConstraints(constraints: Record<string, unknown>): Promise<void>;
+}
+/** Turn the camera behind `track` to `deviceId`, on the same track (ClientPlatform.switchCameraInPlace). */
+export declare function switchCameraInPlace(track: CameraTrack, deviceId: string): Promise<void>;
+export {};
+//# sourceMappingURL=devices.d.ts.map

package/lib/typescript/module/platform/devices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.d.ts","sourceRoot":"","sources":["../../../../src/platform/devices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAA+B,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACrG,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA2B,CAAC;AA4BtD,8EAA8E;AAC9E,wBAAsB,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAa1D;AAyBD,4EAA4E;AAC5E,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CASrG;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAG7F;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,GAAG,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAarH;AAED,wEAAwE;AACxE,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,WAAW,IAAI;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5D,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,4GAA4G;AAC5G,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB7F"}

package/lib/typescript/module/platform/index.d.ts

@@ -0,0 +1,6 @@
+import type { ClientPlatform } from '@voltkit-rtc/client';
+/** The React Native platform for this app (Android, or the iOS preview). The same object every time. */
+export declare function reactNativePlatform(): ClientPlatform;
+export { streamBook } from './streams.js';
+export type { StreamBook, ViewHandle } from './streams.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/platform/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D,wGAAwG;AACxG,wBAAgB,mBAAmB,IAAI,cAAc,CAKpD;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,cAAW,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAW,CAAC"}

package/lib/typescript/module/platform/ios.d.ts

@@ -0,0 +1,4 @@
+import type { ClientPlatform } from '@voltkit-rtc/client';
+import { type AppStreamHook } from './common.js';
+export declare function iosPlatform(): ClientPlatform & AppStreamHook;
+//# sourceMappingURL=ios.d.ts.map

package/lib/typescript/module/platform/ios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios.d.ts","sourceRoot":"","sources":["../../../../src/platform/ios.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAiD,KAAK,aAAa,EAAuC,MAAM,aAAU,CAAC;AAMlI,wBAAgB,WAAW,IAAI,cAAc,GAAG,aAAa,CAgC5D"}

package/lib/typescript/module/platform/streams.d.ts

@@ -0,0 +1,82 @@
+/** What this module needs of a track: react-native-webrtc's MediaStreamTrack, or a test's stand-in. */
+export interface TrackLike {
+    readonly id: string;
+    readonly kind: string;
+    readonly remote?: boolean;
+    readonly readyState: string;
+    enabled: boolean;
+    stop(): void;
+    release?(): void;
+}
+/** What this module needs of a stream: react-native-webrtc's MediaStream. */
+export interface StreamLike {
+    getTracks(): TrackLike[];
+    removeTrack(track: TrackLike): void;
+    release(releaseTracks?: boolean): void;
+    toURL(): string;
+}
+/**
+ * Why a stream is kept: a capture (getUserMedia, getDisplayMedia), the client's own (createStream), a view, or the
+ * app's own that the client publishes (adoptAppStream: tracks taken out of it, never released here).
+ */
+export type StreamRole = 'capture' | 'client' | 'view' | 'app';
+/** One view's hold on a track's wrapper stream. */
+export interface ViewHandle {
+    /** The wrapper's URL, for RTCView's streamURL. */
+    readonly url: string;
+    /** Called when the wrapper goes before this view lets go of it (the track was stopped or detached). */
+    onEnd(listener: () => void): () => void;
+    /** This view is done; the wrapper is released when the last view of the track lets go. */
+    release(): void;
+}
+export declare class StreamBook {
+    private readonly makeStream;
+    private readonly live;
+    private readonly entries;
+    private readonly views;
+    /** Local tracks this package disposed (released). */
+    private readonly disposed;
+    /** Remote tracks whose connection is closing: no new view, their wrappers already released. */
+    private readonly detached;
+    private readonly stopped;
+    private readonly screens;
+    /** Streams left unreleased because releasing them would have crashed the app. */
+    leaked: number;
+    /** Called after a screen track is stopped and released (react-native-webrtc's MediaProjectionService then stops). */
+    onScreenStopped: (() => void) | null;
+    constructor(makeStream: (tracks: TrackLike[]) => StreamLike);
+    /** Keep `stream`, one the platform made (or the app's, `app`), to let go of in the right order. */
+    adopt(stream: StreamLike, role: StreamRole): void;
+    /** A stream of these tracks for the client's own use (ClientPlatform.createStream). */
+    create(tracks: TrackLike[]): StreamLike;
+    /** The tracks of `stream` are a screen capture's. */
+    markScreen(stream: StreamLike): void;
+    /** Release `stream` without its tracks (ClientPlatform.releaseStream). Again does nothing. */
+    release(stream: StreamLike): void;
+    /**
+     * Stop and release `track` (ClientPlatform.stopTrack): its view wrappers are released and it leaves every stream
+     * kept here first (made here, or the app's adopted), while the native track still exists. Again does nothing. A
+     * remote track is only let go of: its connection owns it.
+     */
+    stop(track: TrackLike): void;
+    /**
+     * The client is about to close what receives these remote tracks (ClientPlatform.detachTracks): release their
+     * wrappers now, while their peer connection still exists, and make no new ones.
+     */
+    detach(tracks: readonly TrackLike[]): void;
+    /** A view of `track` (VideoTrack), or null when it cannot be shown: ended, stopped or detached. */
+    view(track: TrackLike): ViewHandle | null;
+    /** How many streams made here are not released yet, how many tracks have views, and how many were left unreleased. */
+    stats(): {
+        live: number;
+        views: number;
+        leaked: number;
+    };
+    /** A track the native side may no longer have: disposed here, or remote and ended (its connection closed). */
+    private unsafe;
+    private dropViews;
+    private releaseEntry;
+}
+/** The process's book of streams (one for every client and view). */
+export declare function streamBook(): StreamBook;
+//# sourceMappingURL=streams.d.ts.map

package/lib/typescript/module/platform/streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../../../src/platform/streams.ts"],"names":[],"mappings":"AA6BA,uGAAuG;AACvG,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,SAAS,IAAI,SAAS,EAAE,CAAC;IACzB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,KAAK,IAAI,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAc/D,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,kDAAkD;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,uGAAuG;IACvG,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACxC,0FAA0F;IAC1F,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,qBAAa,UAAU;IAeT,OAAO,CAAC,QAAQ,CAAC,UAAU;IAdvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,+FAA+F;IAC/F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,iFAAiF;IACjF,MAAM,SAAK;IACX,qHAAqH;IACrH,eAAe,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;gBAEf,UAAU,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,UAAU;IAE5E,mGAAmG;IACnG,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAYjD,uFAAuF;IACvF,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU;IAMvC,qDAAqD;IACrD,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIpC,8FAA8F;IAC9F,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAUjC;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAyC5B;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI;IAO1C,mGAAmG;IACnG,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI;IAuCzC,sHAAsH;IACtH,KAAK,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAIxD,8GAA8G;IAC9G,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,YAAY;CAoBrB;AAID,qEAAqE;AACrE,wBAAgB,UAAU,IAAI,UAAU,CASvC"}

package/lib/typescript/module/platform/timers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The timers the client's own work runs on (reconnect backoff, socket liveness, request deadlines, sampling).
+ *
+ * React Native's JavaScript timers run on Choreographer frames, which stop when the app leaves the foreground, when
+ * the screen goes off even with the app in front, and while a permission dialog is open (Phase 0 S5): a call whose
+ * timers stop cannot notice a dead socket or reconnect. On Android they wait natively instead (the module's
+ * timerStart/timerStop on a thread of their own) and fire back through its onTimer event, which reaches JavaScript
+ * whether frames run or not. Without the native module (iOS, Expo Go) they are JavaScript's own.
+ */
+import type { PlatformTimers } from '@voltkit-rtc/client';
+import type { Spec } from '../specs/NativeVoltkitRtc.js';
+/** JavaScript's own timers, looked up at each call (a test's fake clock replaces them, and is used). */
+export declare const jsTimers: PlatformTimers;
+/**
+ * Timers that wait natively. Ids are this side's and never reused, so a fire already on its way for a timer stopped
+ * since is recognised and ignored. One onTimer subscription for the whole process.
+ */
+export declare function nativeTimers(module: Spec): PlatformTimers;
+//# sourceMappingURL=timers.d.ts.map

package/lib/typescript/module/platform/timers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../../../src/platform/timers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA2B,CAAC;AAItD,wGAAwG;AACxG,eAAO,MAAM,QAAQ,EAAE,cAKrB,CAAC;AAOH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,GAAG,cAAc,CAwCzD"}

package/lib/typescript/module/platform/visibility.d.ts

@@ -0,0 +1,11 @@
+import type { Spec } from '../specs/NativeVoltkitRtc.js';
+export interface Visibility {
+    visible(): boolean;
+    /** Hear every change; returns the function that stops. */
+    subscribe(listener: (visible: boolean) => void): () => void;
+}
+/** From the process lifecycle (Android). */
+export declare function nativeVisibility(module: Spec): Visibility;
+/** From AppState: `active` and `inactive` are visible, `background` is not. */
+export declare function appStateVisibility(): Visibility;
+//# sourceMappingURL=visibility.d.ts.map

package/lib/typescript/module/platform/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../../../src/platform/visibility.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA2B,CAAC;AAItD,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,OAAO,CAAC;IACnB,0DAA0D;IAC1D,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7D;AAID,4CAA4C;AAC5C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,IAAI,GAAG,UAAU,CAYzD;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,IAAI,UAAU,CAkB/C"}