@xorgate/react-native 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+## 0.1.0
+
+First release: live telemetry and live video on React Native, over
+`@xorgate/react` 0.2.0's platform slot.
+
+- `nativePlatform()` — three of `@xorgate/react`'s four platform slots: a
+  `WebRtcPlatform` whose peer connection is `react-native-webrtc`'s
+  (`iceTransportPolicy: "all"`, because a viewer on a carrier NAT often has no
+  path but the TURN relay), the `AppState` foreground edge as the wake source,
+  and id entropy from `expo-crypto`. `mqttConnect` is deliberately left unset:
+  mqtt.js 5 runs on React Native's global WebSocket unmodified. The three AWS
+  bodies — signaling endpoints, ICE servers, the lazy signaling facade — are
+  `@xorgate/react`'s own.
+- `XorgateNativeProvider` — `XorgateProvider` with that platform already in it,
+  plus `randomId` / `wake` / `mqttConnect` props and a `platform` escape hatch.
+- `useLiveVideo(channel)` / `<LiveVideo channel …/>` over `RTCView`. The
+  component holds the outgoing picture across a reconnect until the incoming
+  stream reports its first frame, so a blip does not flash black the way a new
+  `streamURL` on a bare `RTCView` would; it gives the hold up after 3 s rather
+  than pin a stale frame.
+- `appStateWake` / `composeWake` — the foreground edge, and a way to add "the
+  network came back" without this package depending on a network library.
+- `@xorgate/react-native/polyfills` — `getRandomValues` and `randomUUID` from
+  `expo-crypto` onto `globalThis.crypto`. **Required for live video**, though
+  not by this package: `nativePlatform()` covers the SDK's own entropy and
+  telemetry needs no polyfill, but `@smithy/core`'s React Native serde bundle
+  dereferences a BARE `crypto` in the very fallback it takes when `crypto` is
+  undefined, so the first KVS call throws `Property 'crypto' doesn't exist` on
+  Hermes (smithy-typescript#2276). A separate entry point so the polyfill is a deliberate line in the
+  consumer's entry file rather than an import side effect — and the WebRTC
+  platform checks for the global at its first AWS call and says so by name,
+  because the raw symptom is a `ReferenceError` the session retries forever.
+- Live telemetry, the data hooks, the live-block policy, the replay timeline,
+  lanes, clock and telemetry math are re-exported unchanged from
+  `@xorgate/react`; its browser-only hooks deliberately are not.
+- `@xorgate/react-native/webcrypto` — the WebCrypto subset the KVS signaling
+  client's SigV4 signer needs (`digest`, `importKey`, `sign`, all SHA-256),
+  for Metro to alias `isomorphic-webcrypto` at; that package's own React
+  Native build evaluates to `undefined` on Hermes.
+
+Metro needs four resolver rules for the AWS / KVS tree; they are in the README
+and nothing else (`buffer`, `process`, `events`, `url`, stream or URL
+polyfills) was necessary on Expo SDK 57 / Hermes.
+
+Replay over `expo-video` is 0.2.0.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Epye Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `@xorgate/react-native` — the React Native half of `@xorgate/react`.
+ *
+ * Everything that is pure or platform-neutral lives in `@xorgate/react` and is
+ * re-exported here, so an app imports from ONE package: the data hooks, live
+ * telemetry, the live-block policy, the replay timeline and clock, the
+ * telemetry math, the types. What this package adds is the runtime underneath
+ * them (`nativePlatform`, `XorgateNativeProvider`) and the two pieces that
+ * cannot be neutral because they are pixels: `useLiveVideo` / `LiveVideo` over
+ * react-native-webrtc's `RTCView`.
+ *
+ * The browser-only exports of `@xorgate/react` — its `useLiveVideo`,
+ * `LiveVideo`, `useReplayPlayer`, `ReplayVideo` and the `browser*` platform
+ * helpers — are deliberately NOT re-exported: they need `HTMLVideoElement`,
+ * `window` or Media Source Extensions, none of which exist here. Importing
+ * `@xorgate/react` directly still works and is how you reach them on web.
+ */
+export { nativePlatform, type NativePlatformOptions } from "./platform.js";
+export { createNativeWebRtcPlatform } from "./webrtc-platform.js";
+export { appStateWake, composeWake, type WakeSource } from "./wake.js";
+export { XorgateNativeProvider, type XorgateNativeProviderProps, } from "./provider.js";
+export { useLiveVideo, type UseLiveVideo, type UseLiveVideoOptions, } from "./use-live-video.js";
+export { LiveVideo, type LiveVideoProps } from "./live-video.js";
+export { XorgateProvider, useXorgate, useXorgateTenancy, DEFAULT_BASE_URL, type XorgateProviderProps, type XorgateConfig, type XorgateAuth, type FirstPartyAuth, type SessionTokenAuth, type ApiKeyAuth, type LiveCredentialsAuth, type LiveCredentials, type LiveUnavailableReason, type Awaitable, type XorgatePlatform, XorgateError, isXorgateError, type Device, type DeviceModel, type LatestByMetric, type LatestReading, type MediaSession, type Me, type MetricName, type Organization, type PageMeta, type RecordingRun, type ReplayGap, type ReplayManifest, type ReplaySegment, type ReplaySession, type StreamKey, type TelemetryHistory, type TelemetryReading, type VideoChannel, type Workspace, type XorgateClient, useMe, useOrganizations, useWorkspaces, useDevices, useDevice, useDeviceModel, useTelemetryLatest, useTelemetryHistory, useVideoChannels, useRecordingRuns, useSessions, type QueryResult, type QueryOptions, type UseDevicesParams, type UseDevicesResult, type UseTelemetryHistoryParams, type UseSessionsParams, type UseRunsResult, type UseSessionsResult, useLiveTelemetry, useLivePlane, useLiveCredentials, parseTelemetryPayload, presignIotWssUrl, type UseLiveTelemetry, type UseLiveTelemetryOptions, type LiveStatus, type TelemetryPoint, type TelemetrySnapshot, type TelemetryFeedDeps, type MqttLikeClient, type MqttConnectionSpec, type ResolvedLiveCredentials, type ParsedTelemetryPayload, type TelemetryRecordingStatus, type TelemetryMediaStatus, type TelemetryStreamStatus, type LiveBlockPayload, useLiveBlock, resolveLiveBlock, liveBlockElapsedMs, LIVE_BLOCK_STALE_MS, type LiveBlockReason, type LiveBlockOpenReason, type LiveBlockState, type ResolveLiveBlockInput, useLiveVideoSession, type UseLiveVideoSession, type UseLiveVideoSessionOptions, type LiveVideoStatus, type LiveVideoStats, type WebRtcPlatform, type PeerConnectionLike, type SignalingLike, type TimerHost, useReplayManifest, useReplayPlayerCore, useReplayTelemetry, buildTimeline, segmentEnd, segmentAt, hasCoverageAt, gapAt, nextSegmentAfter, prevBoundary, nextBoundary, clampTs, buildLanes, buildClockTimeline, segmentUrlKey, ReplayClock, REPLAY_RATES, parseSegmentMediaInfo, seriesFromReadings, floorIndex, latestWithin, metricGroup, stalenessMs, overviewStalenessMs, chooseIntervalSeconds, windowBoundsFor, windowNeedsRefetch, buildTrace, traceLines, traveledLines, positionAt, GROUP_STALENESS_MS, DEFAULT_STALENESS_MS, WINDOW_SPAN_MS, WINDOW_MIN_SPAN_MS, type UseReplayManifestParams, type UseReplayManifestResult, type UseReplayPlayerCore, type UseReplayTelemetry, type UseReplayTelemetryOptions, type ReplayEngine, type ReplayEngineOptions, type ReplayEngineFactory, type ReplayTimeline, type ReplayLane, type LaneSegment, type ReplayClockState, type ReplayRate, type PacerCandidate, type GapSkipEvent, type SegmentMediaInfo, type MetricSeries, type GpsTrace, type WindowBounds, type PositionResolution, } from "@xorgate/react";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EACL,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,eAAe,CAAC;AAMvB,OAAO,EACL,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMjE,OAAO,EAEL,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,eAAe,EAGpB,YAAY,EACZ,cAAc,EACd,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,EAAE,EACP,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,aAAa,EAGlB,KAAK,EACL,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EAGtB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EAGrB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAG1B,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,SAAS,EAGd,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,SAAS,EACT,aAAa,EACb,KAAK,EACL,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,48 @@
+/**
+ * `@xorgate/react-native` — the React Native half of `@xorgate/react`.
+ *
+ * Everything that is pure or platform-neutral lives in `@xorgate/react` and is
+ * re-exported here, so an app imports from ONE package: the data hooks, live
+ * telemetry, the live-block policy, the replay timeline and clock, the
+ * telemetry math, the types. What this package adds is the runtime underneath
+ * them (`nativePlatform`, `XorgateNativeProvider`) and the two pieces that
+ * cannot be neutral because they are pixels: `useLiveVideo` / `LiveVideo` over
+ * react-native-webrtc's `RTCView`.
+ *
+ * The browser-only exports of `@xorgate/react` — its `useLiveVideo`,
+ * `LiveVideo`, `useReplayPlayer`, `ReplayVideo` and the `browser*` platform
+ * helpers — are deliberately NOT re-exported: they need `HTMLVideoElement`,
+ * `window` or Media Source Extensions, none of which exist here. Importing
+ * `@xorgate/react` directly still works and is how you reach them on web.
+ */
+// ---------------------------------------------------------------------------
+// The React Native runtime
+// ---------------------------------------------------------------------------
+export { nativePlatform } from "./platform.js";
+export { createNativeWebRtcPlatform } from "./webrtc-platform.js";
+export { appStateWake, composeWake } from "./wake.js";
+export { XorgateNativeProvider, } from "./provider.js";
+// ---------------------------------------------------------------------------
+// Live video (RTCView)
+// ---------------------------------------------------------------------------
+export { useLiveVideo, } from "./use-live-video.js";
+export { LiveVideo } from "./live-video.js";
+// ---------------------------------------------------------------------------
+// Re-exported unchanged from `@xorgate/react`
+// ---------------------------------------------------------------------------
+export { 
+// Provider and tenancy
+XorgateProvider, useXorgate, useXorgateTenancy, DEFAULT_BASE_URL, 
+// Errors and the backend vocabulary
+XorgateError, isXorgateError, 
+// Data hooks
+useMe, useOrganizations, useWorkspaces, useDevices, useDevice, useDeviceModel, useTelemetryLatest, useTelemetryHistory, useVideoChannels, useRecordingRuns, useSessions, 
+// Live telemetry and the live plane
+useLiveTelemetry, useLivePlane, useLiveCredentials, parseTelemetryPayload, presignIotWssUrl, 
+// Live-block policy
+useLiveBlock, resolveLiveBlock, liveBlockElapsedMs, LIVE_BLOCK_STALE_MS, 
+// The video session core and its platform boundary
+useLiveVideoSession, 
+// Replay: pure timeline, lanes, clock and telemetry math (the engine is N3)
+useReplayManifest, useReplayPlayerCore, useReplayTelemetry, buildTimeline, segmentEnd, segmentAt, hasCoverageAt, gapAt, nextSegmentAfter, prevBoundary, nextBoundary, clampTs, buildLanes, buildClockTimeline, segmentUrlKey, ReplayClock, REPLAY_RATES, parseSegmentMediaInfo, seriesFromReadings, floorIndex, latestWithin, metricGroup, stalenessMs, overviewStalenessMs, chooseIntervalSeconds, windowBoundsFor, windowNeedsRefetch, buildTrace, traceLines, traveledLines, positionAt, GROUP_STALENESS_MS, DEFAULT_STALENESS_MS, WINDOW_SPAN_MS, WINDOW_MIN_SPAN_MS, } from "@xorgate/react";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,OAAO,EAAE,cAAc,EAA8B,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAmB,MAAM,WAAW,CAAC;AACvE,OAAO,EACL,qBAAqB,GAEtB,MAAM,eAAe,CAAC;AAEvB,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,OAAO,EACL,YAAY,GAGb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAuB,MAAM,iBAAiB,CAAC;AAEjE,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E,OAAO;AACL,uBAAuB;AACvB,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,gBAAgB;AAahB,oCAAoC;AACpC,YAAY,EACZ,cAAc;AAsBd,aAAa;AACb,KAAK,EACL,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW;AAUX,oCAAoC;AACpC,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB;AAgBhB,oBAAoB;AACpB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB;AAMnB,mDAAmD;AACnD,mBAAmB;AAUnB,4EAA4E;AAC5E,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,SAAS,EACT,aAAa,EACb,KAAK,EACL,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,GAqBnB,MAAM,gBAAgB,CAAC"}

package/dist/live-video.d.ts

@@ -0,0 +1,46 @@
+import type { ReactNode } from "react";
+import type { ViewProps } from "react-native";
+import type { RTCVideoViewProps } from "react-native-webrtc";
+import type { VideoChannel, XorgateError } from "@xorgate/react";
+import type { LiveVideoStats, LiveVideoStatus, UseLiveVideoOptions } from "./use-live-video.js";
+export interface LiveVideoProps extends Omit<ViewProps, "children"> {
+    channel: VideoChannel | null;
+    options?: UseLiveVideoOptions;
+    /** Defaults to "cover", matching the web component's object-fit. */
+    objectFit?: RTCVideoViewProps["objectFit"];
+    zOrder?: RTCVideoViewProps["zOrder"];
+    mirror?: RTCVideoViewProps["mirror"];
+    /** Called on every transition. The component renders no status chrome of its own. */
+    onStatusChange?: (status: LiveVideoStatus, error: XorgateError | null) => void;
+    /** Each inbound-rtp sample, for a stats row. Null between sessions. */
+    onStats?: (stats: LiveVideoStats | null) => void;
+    /** The encoded size of the picture on screen, as the renderer reports it. */
+    onVideoDimensions?: (dimensions: {
+        width: number;
+        height: number;
+    }) => void;
+    /**
+     * The stream actually ON SCREEN, which during a reconnect lags the session's
+     * by the length of the hold below. Null while nothing is displayed.
+     */
+    onDisplayedStreamChange?: (streamURL: string | null) => void;
+}
+/**
+ * `useLiveVideo` plus the native video view, and nothing else: no card, no
+ * spinner, no status text, no aspect ratio. It exists so the 90% case is one
+ * line, not so it can be your player — the web `LiveVideo` makes the same
+ * promise.
+ *
+ * What it does add over a bare `RTCView` is the reconnect hold. Every
+ * reconnect produces a new `MediaStream` with a new `streamURL`, and an
+ * `RTCView` pointed at a stream that has not decoded a frame yet is black —
+ * so a 2 s blip on a phone would blank the picture, where the browser's
+ * `<video>` simply keeps its last frame. Here the new stream is mounted
+ * underneath at zero opacity and only promoted once the renderer reports its
+ * dimensions, which is the first-frame signal; until then the outgoing view
+ * stays on screen. If the new stream never produces a frame the swap happens
+ * anyway after {@link HOLD_TIMEOUT_MS}, so a dead stream cannot pin a stale
+ * frame forever.
+ */
+export declare function LiveVideo(props: LiveVideoProps): ReactNode;
+//# sourceMappingURL=live-video.d.ts.map

package/dist/live-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-video.d.ts","sourceRoot":"","sources":["../src/live-video.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAK7B,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IACjE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,oEAAoE;IACpE,SAAS,CAAC,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACrC,qFAAqF;IACrF,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/E,uEAAuE;IACvE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAC;IACjD,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC5E;;;OAGG;IACH,uBAAuB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CA+F1D"}

package/dist/live-video.js

@@ -0,0 +1,83 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { StyleSheet, View } from "react-native";
+import { RTCView } from "react-native-webrtc";
+import { useLiveVideo } from "./use-live-video.js";
+/** How long to keep the outgoing picture if the incoming stream never reports a frame. */
+const HOLD_TIMEOUT_MS = 3000;
+/**
+ * `useLiveVideo` plus the native video view, and nothing else: no card, no
+ * spinner, no status text, no aspect ratio. It exists so the 90% case is one
+ * line, not so it can be your player — the web `LiveVideo` makes the same
+ * promise.
+ *
+ * What it does add over a bare `RTCView` is the reconnect hold. Every
+ * reconnect produces a new `MediaStream` with a new `streamURL`, and an
+ * `RTCView` pointed at a stream that has not decoded a frame yet is black —
+ * so a 2 s blip on a phone would blank the picture, where the browser's
+ * `<video>` simply keeps its last frame. Here the new stream is mounted
+ * underneath at zero opacity and only promoted once the renderer reports its
+ * dimensions, which is the first-frame signal; until then the outgoing view
+ * stays on screen. If the new stream never produces a frame the swap happens
+ * anyway after {@link HOLD_TIMEOUT_MS}, so a dead stream cannot pin a stale
+ * frame forever.
+ */
+export function LiveVideo(props) {
+    const { channel, options, objectFit = "cover", zOrder, mirror, onStatusChange, onStats, onVideoDimensions, onDisplayedStreamChange, style, ...viewProps } = props;
+    const { streamURL, status, error, stats } = useLiveVideo(channel, options);
+    const onStatusChangeRef = useRef(onStatusChange);
+    onStatusChangeRef.current = onStatusChange;
+    useEffect(() => {
+        onStatusChangeRef.current?.(status, error);
+    }, [status, error]);
+    const onStatsRef = useRef(onStats);
+    onStatsRef.current = onStats;
+    useEffect(() => {
+        onStatsRef.current?.(stats);
+    }, [stats]);
+    const onVideoDimensionsRef = useRef(onVideoDimensions);
+    onVideoDimensionsRef.current = onVideoDimensions;
+    // `shown` is the picture on screen; `incoming` is a newer stream warming up
+    // behind it. A first stream goes straight to `shown` — there is nothing to
+    // hold on to and no reason to make the viewer wait.
+    const [shown, setShown] = useState(null);
+    const [incoming, setIncoming] = useState(null);
+    useEffect(() => {
+        if (streamURL === null) {
+            setShown(null);
+            setIncoming(null);
+            return;
+        }
+        setShown((current) => {
+            if (current === null)
+                return streamURL;
+            if (current !== streamURL)
+                setIncoming(streamURL);
+            return current;
+        });
+    }, [streamURL]);
+    useEffect(() => {
+        if (incoming === null)
+            return;
+        const timer = setTimeout(() => {
+            setShown(incoming);
+            setIncoming(null);
+        }, HOLD_TIMEOUT_MS);
+        return () => clearTimeout(timer);
+    }, [incoming]);
+    const promote = (url) => {
+        setShown(url);
+        setIncoming((current) => (current === url ? null : current));
+    };
+    const onDisplayedStreamChangeRef = useRef(onDisplayedStreamChange);
+    onDisplayedStreamChangeRef.current = onDisplayedStreamChange;
+    useEffect(() => {
+        onDisplayedStreamChangeRef.current?.(shown);
+    }, [shown]);
+    return (_jsxs(View, { style: style, ...viewProps, children: [shown !== null && (_jsx(RTCView, { streamURL: shown, objectFit: objectFit, ...(zOrder !== undefined ? { zOrder } : {}), ...(mirror !== undefined ? { mirror } : {}), style: StyleSheet.absoluteFill, onDimensionsChange: (event) => onVideoDimensionsRef.current?.(event.nativeEvent) })), incoming !== null && (_jsx(RTCView, { streamURL: incoming, objectFit: objectFit, ...(zOrder !== undefined ? { zOrder } : {}), ...(mirror !== undefined ? { mirror } : {}), style: [StyleSheet.absoluteFill, styles.warming], onDimensionsChange: () => promote(incoming) }))] }));
+}
+const styles = StyleSheet.create({
+    // Mounted so the renderer decodes, invisible so the outgoing frame stands.
+    warming: { opacity: 0 },
+});
+//# sourceMappingURL=live-video.js.map

package/dist/live-video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-video.js","sourceRoot":"","sources":["../src/live-video.tsx"],"names":[],"mappings":"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"}

package/dist/platform.d.ts

@@ -0,0 +1,32 @@
+import type { XorgatePlatform } from "@xorgate/react";
+import { type WakeSource } from "./wake.js";
+export interface NativePlatformOptions {
+    /**
+     * Client-id entropy for MQTT and KVS signaling. Default: `expo-crypto`'s
+     * `randomUUID()`. Hermes has no `crypto` global, so there is nothing else
+     * to default to; pass your own only to use a different source.
+     */
+    randomId?: () => string;
+    /**
+     * Extra wake sources, merged with the foreground edge. "The network came
+     * back" belongs here; the README has the expo-network and NetInfo recipes.
+     */
+    wake?: WakeSource[];
+    /**
+     * Replace the MQTT transport. Leave unset: mqtt.js 5 runs unmodified on
+     * React Native's global WebSocket (its `react-native` export condition
+     * resolves to a self-contained ESM build), which is what the telemetry
+     * plane was measured on.
+     */
+    mqttConnect?: XorgatePlatform["mqttConnect"];
+}
+/**
+ * The React Native half of `@xorgate/react`: pass it to the provider once and
+ * every neutral hook in that package — telemetry, live video, the data hooks'
+ * refetch-on-focus — runs on this runtime instead of a browser's.
+ *
+ * `XorgateNativeProvider` calls this for you; call it yourself only when you
+ * are composing the platform with slots of your own.
+ */
+export declare function nativePlatform(options?: NativePlatformOptions): XorgatePlatform;
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvE,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACxB;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;IACpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;CAC9C;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,eAAe,CAUnF"}

package/dist/platform.js

@@ -0,0 +1,23 @@
+import { randomUUID } from "expo-crypto";
+import { createNativeWebRtcPlatform } from "./webrtc-platform.js";
+import { appStateWake, composeWake } from "./wake.js";
+/**
+ * The React Native half of `@xorgate/react`: pass it to the provider once and
+ * every neutral hook in that package — telemetry, live video, the data hooks'
+ * refetch-on-focus — runs on this runtime instead of a browser's.
+ *
+ * `XorgateNativeProvider` calls this for you; call it yourself only when you
+ * are composing the platform with slots of your own.
+ */
+export function nativePlatform(options = {}) {
+    const randomId = options.randomId ?? randomUUID;
+    return {
+        createWebRtcPlatform: () => createNativeWebRtcPlatform(randomId),
+        subscribeWake: options.wake?.length
+            ? composeWake(appStateWake, ...options.wake)
+            : appStateWake,
+        randomId,
+        ...(options.mqttConnect ? { mqttConnect: options.mqttConnect } : {}),
+    };
+}
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAmB,MAAM,WAAW,CAAC;AAuBvE;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,UAAiC,EAAE;IAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC;IAChD,OAAO;QACL,oBAAoB,EAAE,GAAG,EAAE,CAAC,0BAA0B,CAAC,QAAQ,CAAC;QAChE,aAAa,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM;YACjC,CAAC,CAAC,WAAW,CAAC,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAC5C,CAAC,CAAC,YAAY;QAChB,QAAQ;QACR,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC;AACJ,CAAC"}

package/dist/polyfills.d.ts

@@ -0,0 +1,3 @@
+/** What this module installed, for diagnostics screens. Empty = nothing was missing. */
+export declare const INSTALLED_POLYFILLS: string[];
+//# sourceMappingURL=polyfills.d.ts.map

package/dist/polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfills.d.ts","sourceRoot":"","sources":["../src/polyfills.ts"],"names":[],"mappings":"AAyCA,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,EAAE,MAAM,EAAO,CAAC"}

package/dist/polyfills.js

@@ -0,0 +1,56 @@
+/**
+ * `@xorgate/react-native/polyfills` — the one runtime shim React Native needs
+ * for the live plane. Import it for its side effect, once, at the very top of
+ * your entry file, before anything that reaches the SDK:
+ *
+ * ```ts
+ * import "@xorgate/react-native/polyfills"
+ * ```
+ *
+ * Hermes on Expo SDK 57 has NO `crypto` global — measured, not assumed: not
+ * `randomUUID`, not `getRandomValues`, not `subtle`.
+ *
+ * **Live video does not work without this import**, though not because of
+ * this package: `nativePlatform()` covers the SDK's own client ids through
+ * the `randomId` slot, and live telemetry runs with no polyfill at all. It is
+ * the AWS SDK underneath the KVS viewer. `@smithy/core`'s React Native serde
+ * bundle ends its UUID v4 path in `(array) => crypto.getRandomValues(array)`
+ * with a BARE `crypto`, and that is the fallback `bindV4` selects precisely
+ * when `typeof crypto === "undefined"` — so the guard hands control to the
+ * one line that cannot survive the case it guards for (the same bug was fixed
+ * for the Node build in smithy-typescript#2022; the native build was not —
+ * smithy-typescript#2276). `createNativeWebRtcPlatform` checks for the global
+ * at its first AWS call so the message names this import rather than leaving
+ * a `ReferenceError` to be retried forever.
+ *
+ * It is additive — an existing `crypto` keeps every function it already has —
+ * and it is a separate entry point so the polyfill is a deliberate line in
+ * your entry file rather than a side effect of importing the package.
+ *
+ * NOTE this is entropy and UUIDs only. `crypto.subtle` is NOT installed: the
+ * one place the SDK needs WebCrypto is SigV4 signing inside the KVS signaling
+ * client, and that is a Metro resolver rule (`isomorphic-webcrypto`), not a
+ * global. See README "Metro setup".
+ */
+import * as Crypto from "expo-crypto";
+/** What this module installed, for diagnostics screens. Empty = nothing was missing. */
+export const INSTALLED_POLYFILLS = [];
+const g = globalThis;
+if (!g.crypto) {
+    g.crypto = {
+        getRandomValues: Crypto.getRandomValues,
+        randomUUID: Crypto.randomUUID,
+    };
+    INSTALLED_POLYFILLS.push("crypto.getRandomValues", "crypto.randomUUID");
+}
+else {
+    if (typeof g.crypto.getRandomValues !== "function") {
+        g.crypto.getRandomValues = Crypto.getRandomValues;
+        INSTALLED_POLYFILLS.push("crypto.getRandomValues");
+    }
+    if (typeof g.crypto.randomUUID !== "function") {
+        g.crypto.randomUUID = Crypto.randomUUID;
+        INSTALLED_POLYFILLS.push("crypto.randomUUID");
+    }
+}
+//# sourceMappingURL=polyfills.js.map

package/dist/polyfills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfills.js","sourceRoot":"","sources":["../src/polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAOtC,wFAAwF;AACxF,MAAM,CAAC,MAAM,mBAAmB,GAAa,EAAE,CAAC;AAEhD,MAAM,CAAC,GAAG,UAAuC,CAAC;AAElD,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACd,CAAC,CAAC,MAAM,GAAG;QACT,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC;IACF,mBAAmB,CAAC,IAAI,CAAC,wBAAwB,EAAE,mBAAmB,CAAC,CAAC;AAC1E,CAAC;KAAM,CAAC;IACN,IAAI,OAAO,CAAC,CAAC,MAAM,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QACnD,CAAC,CAAC,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAClD,mBAAmB,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC9C,CAAC,CAAC,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACxC,mBAAmB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from "react";
+import type { XorgatePlatform, XorgateProviderProps } from "@xorgate/react";
+import { type NativePlatformOptions } from "./platform.js";
+export interface XorgateNativeProviderProps extends Omit<XorgateProviderProps, "platform">, NativePlatformOptions {
+    /**
+     * Slots merged OVER the native defaults, for the rare case where one of
+     * them is wrong for your app. Everything you leave out stays native.
+     */
+    platform?: XorgatePlatform;
+}
+/**
+ * `XorgateProvider` with the React Native platform already in it. Use it
+ * exactly where a web app uses `XorgateProvider` — same `auth`,
+ * `organizationId`, `workspaceId`, `config` and `onError` props, same rule
+ * that remounting on the organization (`key={orgId}`) is how you switch
+ * tenants.
+ */
+export declare function XorgateNativeProvider(props: XorgateNativeProviderProps): ReactNode;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3E,MAAM,WAAW,0BACf,SAAQ,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC,EAC5C,qBAAqB;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,SAAS,CAuBlF"}

package/dist/provider.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { XorgateProvider } from "@xorgate/react";
+import { nativePlatform } from "./platform.js";
+/**
+ * `XorgateProvider` with the React Native platform already in it. Use it
+ * exactly where a web app uses `XorgateProvider` — same `auth`,
+ * `organizationId`, `workspaceId`, `config` and `onError` props, same rule
+ * that remounting on the organization (`key={orgId}`) is how you switch
+ * tenants.
+ */
+export function XorgateNativeProvider(props) {
+    const { randomId, wake, mqttConnect, platform, children, ...providerProps } = props;
+    const merged = useMemo(() => ({
+        ...nativePlatform({
+            ...(randomId ? { randomId } : {}),
+            ...(wake ? { wake } : {}),
+            ...(mqttConnect ? { mqttConnect } : {}),
+        }),
+        ...platform,
+    }), 
+    // The wake array is read once per subscription; an inline literal must not
+    // rebuild the platform on every render.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [randomId, mqttConnect, platform]);
+    return (_jsx(XorgateProvider, { ...providerProps, platform: merged, children: children }));
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAA8B,MAAM,eAAe,CAAC;AAY3E;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAiC;IACrE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,aAAa,EAAE,GAAG,KAAK,CAAC;IAEpF,MAAM,MAAM,GAAG,OAAO,CACpB,GAAG,EAAE,CAAC,CAAC;QACL,GAAG,cAAc,CAAC;YAChB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC;QACF,GAAG,QAAQ;KACZ,CAAC;IACF,2EAA2E;IAC3E,wCAAwC;IACxC,uDAAuD;IACvD,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAClC,CAAC;IAEF,OAAO,CACL,KAAC,eAAe,OAAK,aAAa,EAAE,QAAQ,EAAE,MAAM,YACjD,QAAQ,GACO,CACnB,CAAC;AACJ,CAAC"}

package/dist/use-live-video.d.ts

@@ -0,0 +1,38 @@
+import type { LiveUnavailableReason, LiveVideoStats, LiveVideoStatus, UseLiveVideoSessionOptions, VideoChannel, XorgateError } from "@xorgate/react";
+import type { MediaStream } from "react-native-webrtc";
+export type { LiveVideoStatus, LiveVideoStats } from "@xorgate/react";
+export interface UseLiveVideo {
+    /**
+     * The received remote stream, or null while idle. A reconnect delivers a
+     * NEW stream object: the previous one is dead, not resumable.
+     */
+    stream: MediaStream | null;
+    /** `stream.toURL()`, the only thing `RTCView` takes. Null while idle. */
+    streamURL: string | null;
+    status: LiveVideoStatus;
+    unavailableReason: LiveUnavailableReason | null;
+    error: XorgateError | null;
+    /** Null until the first sample lands. Reset to null on every reconnect. */
+    stats: LiveVideoStats | null;
+}
+export type UseLiveVideoOptions = Omit<UseLiveVideoSessionOptions, "onStream">;
+/**
+ * Run a KVS WebRTC VIEWER for one signaling channel and hand back the
+ * received stream for an `RTCView`. Pass `null` to stay idle.
+ *
+ * This is the React Native wrapper over `@xorgate/react`'s
+ * `useLiveVideoSession`: the session itself — generation counter, per-step and
+ * whole-attempt deadlines, the disconnect grace, backoff, the ~50 minute
+ * credential cycle, the wake nudge — is the same code the web app runs, and it
+ * was earned against real LTE devices. What differs on a phone is the
+ * platform underneath it (`nativePlatform()`) and the fact that the picture
+ * goes to a native view instead of an element.
+ *
+ * Unlike the browser, where a reconnect leaves the last frame in the `<video>`
+ * element, `streamURL` changes on every reconnect and an `RTCView` handed a
+ * new URL has nothing to show until the first frame decodes. `LiveVideo`
+ * holds the outgoing picture across that swap; if you render `RTCView`
+ * yourself and care, do the same.
+ */
+export declare function useLiveVideo(channel: VideoChannel | null, options?: UseLiveVideoOptions): UseLiveVideo;
+//# sourceMappingURL=use-live-video.d.ts.map

package/dist/use-live-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-live-video.d.ts","sourceRoot":"","sources":["../src/use-live-video.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,0BAA0B,EAC1B,YAAY,EACZ,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,yEAAyE;IACzE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,eAAe,CAAC;IACxB,iBAAiB,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAChD,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,2EAA2E;IAC3E,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,0BAA0B,EAAE,UAAU,CAAC,CAAC;AAE/E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,OAAO,GAAE,mBAAwB,GAChC,YAAY,CA8Bd"}

package/dist/use-live-video.js

@@ -0,0 +1,49 @@
+import { useCallback, useEffect, useState } from "react";
+import { useLiveVideoSession } from "@xorgate/react";
+/**
+ * Run a KVS WebRTC VIEWER for one signaling channel and hand back the
+ * received stream for an `RTCView`. Pass `null` to stay idle.
+ *
+ * This is the React Native wrapper over `@xorgate/react`'s
+ * `useLiveVideoSession`: the session itself — generation counter, per-step and
+ * whole-attempt deadlines, the disconnect grace, backoff, the ~50 minute
+ * credential cycle, the wake nudge — is the same code the web app runs, and it
+ * was earned against real LTE devices. What differs on a phone is the
+ * platform underneath it (`nativePlatform()`) and the fact that the picture
+ * goes to a native view instead of an element.
+ *
+ * Unlike the browser, where a reconnect leaves the last frame in the `<video>`
+ * element, `streamURL` changes on every reconnect and an `RTCView` handed a
+ * new URL has nothing to show until the first frame decodes. `LiveVideo`
+ * holds the outgoing picture across that swap; if you render `RTCView`
+ * yourself and care, do the same.
+ */
+export function useLiveVideo(channel, options = {}) {
+    const [stream, setStream] = useState(null);
+    const [streamURL, setStreamURL] = useState(null);
+    const onStream = useCallback((next) => {
+        const ms = next;
+        setStream(ms);
+        setStreamURL(ms.toURL());
+    }, []);
+    const session = useLiveVideoSession(channel, {
+        onStream,
+        ...(options.enabled !== undefined ? { enabled: options.enabled } : {}),
+        ...(options.statsIntervalMs !== undefined
+            ? { statsIntervalMs: options.statsIntervalMs }
+            : {}),
+    });
+    // Drop the stream when the session goes away (channel change, disable,
+    // unmount) — never on a reconnect, which replaces it through `onStream`.
+    const active = channel !== null && options.enabled !== false;
+    useEffect(() => {
+        if (!active)
+            return;
+        return () => {
+            setStream(null);
+            setStreamURL(null);
+        };
+    }, [active, channel?.channelRef, channel?.region]);
+    return { stream, streamURL, ...session };
+}
+//# sourceMappingURL=use-live-video.js.map

package/dist/use-live-video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-live-video.js","sourceRoot":"","sources":["../src/use-live-video.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AA8BrD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,YAAY,CAC1B,OAA4B,EAC5B,UAA+B,EAAE;IAEjC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IAC/D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAEhE,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,IAAa,EAAE,EAAE;QAC7C,MAAM,EAAE,GAAG,IAAmB,CAAC;QAC/B,SAAS,CAAC,EAAE,CAAC,CAAC;QACd,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,EAAE;QAC3C,QAAQ;QACR,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS;YACvC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IAEH,uEAAuE;IACvE,yEAAyE;IACzE,MAAM,MAAM,GAAG,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC;IAC7D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,YAAY,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAEnD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,CAAC;AAC3C,CAAC"}

package/dist/wake.d.ts

@@ -0,0 +1,25 @@
+/** `XorgatePlatform["subscribeWake"]`: call `onWake`, get an unsubscribe back. */
+export type WakeSource = (onWake: () => void) => () => void;
+/**
+ * The foreground edge. This is the wake source a phone actually needs: iOS
+ * suspends the app's sockets within seconds of it leaving the screen, so both
+ * the MQTT connection and the peer connection are usually dead by the time the
+ * user comes back — and the live plane would otherwise sit out a backoff of up
+ * to 30 s in front of them. A browser tab has the same problem in miniature;
+ * `visibilitychange` is the web's version of this listener.
+ *
+ * Only the `active` edge counts. "inactive" is the app switcher or a system
+ * sheet over the app, where nothing has been torn down yet.
+ */
+export declare function appStateWake(onWake: () => void): () => void;
+/**
+ * Fan one `onWake` out over several sources. Used to add "the network came
+ * back" to the foreground edge; see the README for the expo-network and
+ * NetInfo recipes, which are four lines each and stay in the consumer so this
+ * package needs neither as a dependency.
+ *
+ * A wake is a hint, never a command: the feeds and the video session ignore
+ * one while they are connected or mid-connect, so firing twice costs nothing.
+ */
+export declare function composeWake(...sources: WakeSource[]): WakeSource;
+//# sourceMappingURL=wake.d.ts.map