@pickleball/expo-sdk 0.2.0 → 1.0.0

package/dist/advanced-DeQwg7MK.d.cts

@@ -0,0 +1,300 @@
+import { R as RoomAdapter, a1 as RoomConnection, e as CameraDeviceInfo, g as CaptureOrientation, a2 as RoomEvent, r as SdkBootstrap, C as CameraGrant, b as SdkSessionGrant, y as SdkSessionRefresh, z as SdkTelemetryCredentials, a3 as EngineDependencies, w as SdkNetwork, x as SdkRuntime, a as SdkStorage, T as TelemetrySink, a0 as LivestreamEngine, B as BootstrapInput, m as LivestreamSnapshot, c as StartLivestreamInput, i as EndReason, L as LivestreamSessionProvider, H as SessionCommandChannel, S as SessionCommandSubscription, o as PickleballExpoError } from './engine-BSvSdCSE.cjs';
+import React, { ReactNode } from 'react';
+
+/**
+ * Trạng thái từ tầng RTMP native (trùng NativeRtmpStatus của @pickleball/rtmp-native).
+ */
+type RtmpStatus = {
+    readonly status: "idle" | "connecting" | "connected" | "publishing";
+} | {
+    readonly status: "disconnected";
+    readonly reason?: string;
+} | {
+    readonly status: "error";
+    readonly code: string;
+    readonly message: string;
+};
+/** Phản hồi băng thông từ native (trùng NativeRtmpBandwidth của rtmp-native). */
+interface RtmpBandwidth {
+    /** false = encoder đang đẩy nhanh hơn đường truyền chịu được. */
+    readonly sufficient: boolean;
+    readonly videoBitrate: number;
+}
+/**
+ * Dấu hiệu để UI biết render nguồn nào. LiveKit trả về một track object; RTMP
+ * không có "track" ở JS (khung hình đi thẳng trong native), nên trả marker này
+ * — nếu trả undefined thì UI tưởng chưa có preview và vẽ màn TỐI ĐEN.
+ */
+interface RtmpPreviewMarker {
+    readonly kind: "rtmp";
+}
+/** Bề mặt native mà adapter cần — tiêm vào để test được không cần thiết bị thật. */
+interface NativeRtmpBindings {
+    prepare(options: {
+        quality: 720 | 1080;
+        landscape: boolean;
+        /** fps mong muốn (24 tiết kiệm băng thông, 30 mặc định) — thiếu = native tự chọn. */
+        frameRate?: 24 | 30 | 60;
+        /**
+         * Camera mở ngay từ đầu. Thiếu = native dùng camera sau mặc định. Đặt ở đây
+         * thay vì gọi selectCamera sau prepare để không phải mở camera hai lần.
+         */
+        cameraId?: string;
+    }): Promise<void>;
+    /**
+     * Xin quyền camera/mic bằng API quyền thuần (PermissionsAndroid, ...).
+     * Không có thì engine rơi về getUserMedia của WebRTC — thứ mở camera thật
+     * và đụng HaishinKit trên máy Android chỉ cho một camera mở cùng lúc.
+     */
+    requestPermissions?(): Promise<boolean>;
+    /** Hướng cầm máy hiện tại — cùng nguồn mà LiveKitRoomAdapter dùng. */
+    isLandscape?(): boolean;
+    connect(options: {
+        url: string;
+        videoBitrate: number;
+        publish: boolean;
+    }): Promise<void>;
+    setPublishing(enabled: boolean): Promise<void>;
+    disconnect(): Promise<void>;
+    switchCamera(): Promise<void>;
+    listCameras(): Array<{
+        deviceId: string;
+        label: string;
+        facing: string;
+    }>;
+    selectCamera(deviceId: string, facing: string): Promise<void>;
+    setMicrophoneEnabled(enabled: boolean): Promise<void>;
+    setVideoBitrate(bitsPerSecond: number): Promise<void>;
+    dispose(): Promise<void>;
+    addStatusListener(listener: (event: RtmpStatus) => void): {
+        remove(): void;
+    };
+    /** Optional: bản native cũ chưa phát onBandwidth thì adapter bỏ qua thích ứng. */
+    addBandwidthListener?(listener: (event: RtmpBandwidth) => void): {
+        remove(): void;
+    };
+}
+/**
+ * Adapter cho mode deliveryMode="device-rtmp".
+ *
+ * Thiết bị mã hoá H.264 bằng phần cứng MỘT lần rồi đẩy thẳng RTMP; server chỉ
+ * remux sang HLS. Không có phòng LiveKit, không egress → $0 transcode.
+ *
+ * Khác LiveKitRoomAdapter ở một điểm quan trọng: RTMP **không có kênh dữ liệu**,
+ * nên adapter này không bao giờ phát RoomEvent "command". Lệnh điều khiển từ
+ * dashboard đi đường khác (deviceControl trên Convex) — xem device-agent.
+ */
+declare class RtmpRoomAdapter implements RoomAdapter {
+    private readonly bindings;
+    private readonly options;
+    /**
+     * RTMP không tự hồi: native chỉ phát hiện đứt (watchdog iOS / onDisconnect
+     * Android) và báo "disconnected" — không tự quay số lại. Engine thấy cờ này
+     * là chạy vòng redial backoff. Thiếu cờ: phiên ngồi chờ "reconnected" không
+     * bao giờ tới rồi chết network_timeout sau 30s (prod 17/08/2026).
+     */
+    readonly needsManualReconnect = true;
+    private readonly listeners;
+    private nativeSubscription?;
+    private bandwidthSubscription?;
+    private quality;
+    private connected;
+    private prepared;
+    /** Khung người dùng chọn trên UI (9:16/16:9) — ưu tiên hơn hướng cầm máy. */
+    private captureOrientation?;
+    private bitrateState?;
+    /**
+     * Chỉ tồn tại khi bindings hỗ trợ — engine kiểm tra truthiness để quyết định
+     * fallback về runtime.requestPermissions() (getUserMedia), nên KHÔNG được
+     * khai báo method luôn-có rồi tự fallback bên trong.
+     */
+    readonly requestPermissions?: () => Promise<boolean>;
+    constructor(bindings: NativeRtmpBindings, options?: {
+        frameRate?: 24 | 30 | 60;
+        cameraId?: string;
+    });
+    /**
+     * Phần tuỳ chọn của prepare(). Giữ dạng spread có điều kiện: truyền
+     * `frameRate: undefined` xuống Expo Record là ghi đè mặc định của native
+     * bằng null chứ không phải "bỏ qua trường".
+     */
+    private prepareOverrides;
+    preparePreview(quality: 720 | 1080): Promise<RtmpPreviewMarker>;
+    connect(input: RoomConnection): Promise<void>;
+    setPublishing(enabled: boolean): Promise<void>;
+    disconnect(_stopTracks?: boolean): Promise<void>;
+    switchCamera(): Promise<void>;
+    /** Ống kính vật lý (0.5x siêu rộng · 1x · tele) — không có thì UI kẹt ở mặc định. */
+    listCameras(): Promise<CameraDeviceInfo[]>;
+    selectCamera(deviceId: string, facing: CameraDeviceInfo["facing"]): Promise<void>;
+    setMicrophoneEnabled(enabled: boolean): Promise<void>;
+    /** Hạ chất lượng khi mạng yếu — thay cho BWE mà WebRTC cho sẵn. */
+    setVideoBitrate(bitsPerSecond: number): Promise<void>;
+    setCaptureOrientation(orientation: CaptureOrientation): Promise<void>;
+    subscribe(listener: (event: RoomEvent) => void): () => void;
+    dispose(): Promise<void>;
+    private handleBandwidth;
+    private emit;
+}
+
+/**
+ * Validator + helper HTTP dùng chung cho hai session provider:
+ * - createHttpSessionProvider (proxy đối tác / first-party device-app)
+ * - createCameraGrantProvider (điện thoại đối tác, grant từ backend đối tác)
+ *
+ * Tách ra để hai provider không chép luật "grant thế nào là hợp lệ" ra hai nơi
+ * rồi lệch nhau; engine chỉ tin `isSdkRemoteConfig`, còn hình dạng grant là
+ * việc của lớp này.
+ */
+type Fetch = typeof globalThis.fetch;
+declare function isBootstrap(value: unknown): value is SdkBootstrap;
+declare function isTelemetryCredentials(value: unknown): value is SdkTelemetryCredentials;
+/**
+ * Grant phiên. SDK 1.0 là RTMP-only: `serverUrl` phải là rtmp(s):// (ingest).
+ * Grant LiveKit (wss://) của mô hình cũ bị từ chối ngay ở đây — lỗi
+ * INVALID_RESPONSE rõ ràng thay vì HaishinKit ném lúc connect.
+ */
+declare function isSessionGrant(value: unknown): value is SdkSessionGrant;
+/**
+ * Camera grant (điện thoại đối tác): superset của SdkSessionGrant, BẮT BUỘC là
+ * RTMP và mang `status` để đường nhận lại biết phiên cũ đang phát hay đang chờ.
+ */
+declare function isCameraGrant(value: unknown): value is CameraGrant;
+declare function isSessionRefresh(value: unknown): value is SdkSessionRefresh;
+/**
+ * Gốc API của phiên suy từ endpoint telemetry trong grant: `…/sessions/{id}/telemetry`
+ * → `…/sessions/{id}`. Đây là cách duy nhất SDK biết namespace (sdk / camera /
+ * device-app) mà không cần app cấu hình URL PickLive nào.
+ */
+declare function sessionApiBaseFromTelemetryEndpoint(endpoint: string): string;
+
+/**
+ * Runtime cho app RTMP-only (KHÔNG có LiveKit/WebRTC): assert bằng module
+ * @pickleball/rtmp-native, xin quyền bằng API quyền thuần (Android) hoặc hàm
+ * native `requestPermissions` (iOS, rtmp-native ≥ 0.2; thiếu thì AVFoundation
+ * hỏi lúc mở camera). Chuyển từ apps/device-streamer (createRtmpOnlyRuntime).
+ * Không dùng getUserMedia: máy MediaTek chỉ cho một camera mở cùng lúc.
+ */
+declare function createRtmpRuntime(): SdkRuntime;
+/** Runtime mặc định của SDK 1.0 = RTMP (LiveKit đã gỡ khỏi SDK — ADR-0002). */
+declare const createDefaultRuntime: typeof createRtmpRuntime;
+declare function createDefaultStorage(): SdkStorage;
+declare function createDefaultNetwork(): SdkNetwork;
+declare function createDefaultTelemetry(fetchImplementation?: typeof fetch, timeoutMs?: number): TelemetrySink;
+/** roomFactory mặc định của SDK 1.0 = RTMP (fps/camera mặc định của native). */
+declare function createDefaultRoomFactory(): EngineDependencies["roomFactory"];
+/**
+ * Bindings native RTMP. `require` động: app chưa cài @pickleball/rtmp-native
+ * chỉ lỗi khi thật sự mở camera (UnsupportedRuntimeError rõ ràng), không gãy
+ * lúc import SDK — static-render web của expo-router vẫn nạp được module.
+ */
+declare function createNativeRtmpBindings(): NativeRtmpBindings;
+/** roomFactory cho mode device-rtmp (thiết bị đẩy RTMP, không dùng LiveKit). */
+declare function createRtmpRoomFactory(options?: {
+    /**
+     * fps capture + encode (24 tiết kiệm băng thông, 30 mặc định của native).
+     * 60 chỉ nên truyền khi `getCameraCapabilities().supportedFrameRates` có nó —
+     * native bỏ qua trong im lặng nếu ống kính đang gắn không chạy được.
+     */
+    frameRate?: 24 | 30 | 60;
+    /** Camera mở sẵn lúc prepare — thiếu = camera sau mặc định của native. */
+    cameraId?: string;
+}): EngineDependencies["roomFactory"];
+/**
+ * Thu chỉ số thiết bị cho heartbeat. Mỗi nguồn là optional — thiếu package
+ * (expo-battery/expo-device/expo-file-system) thì bỏ qua trường đó thay vì lỗi.
+ */
+declare function createDefaultDeviceMetrics(): NonNullable<EngineDependencies["deviceMetrics"]>;
+
+interface LivestreamTheme {
+    background: string;
+    foreground: string;
+    accent: string;
+    danger: string;
+    /** Chữ phụ mờ nhất (labels, chú thích). */
+    muted: string;
+    overlay: string;
+    radius: number;
+    /** Token FintechX — đồng bộ với dashboard web. */
+    surface: string;
+    elevated: string;
+    hairline: string;
+    /** Màu chữ đặt trên nền accent. */
+    ink: string;
+    textSecondary: string;
+    radiusSm: number;
+    fontFamily?: string;
+    fontFamilyBold?: string;
+    displayFontFamily?: string;
+}
+/** FintechX design tokens — trùng bộ token trong apps/web/globals.css. */
+declare const defaultLivestreamTheme: LivestreamTheme;
+interface PickleballLiveProviderProps {
+    children?: ReactNode;
+    sessionProvider: LivestreamSessionProvider;
+    bootstrapInput: BootstrapInput;
+    /**
+     * Phiên phải SỐNG TIẾP khi app biến mất giữa chừng (sụp nguồn, bị vuốt tắt,
+     * component remount), để lần mở sau nhận lại đúng phiên cũ — giữ nguyên link
+     * xem và VOD liền một mạch.
+     *
+     * Mặc định false = hành vi cũ: mở app lại là dọn sạch phiên cũ. App gác sân bật
+     * cờ này khi máy đang được gán sân; máy không gán sân vẫn dọn như cũ để không
+     * để lại phiên treo trong các ca ngoài giải.
+     *
+     * Nhận boolean HOẶC hàm (được phép async). App nên truyền HÀM ĐỌC THẲNG ĐĨA:
+     * engine hỏi cờ này đúng lúc khởi động, thường TRƯỚC khi state React kịp
+     * restore — truyền boolean suy từ state là dính race keep=false oan (đã dính
+     * thật 18/08/2026, sinh phiên chờ thứ hai đè phiên live cũ).
+     */
+    keepSessionOnRestart?: boolean | (() => boolean | Promise<boolean>);
+    runtime?: SdkRuntime;
+    storage?: SdkStorage;
+    network?: SdkNetwork;
+    telemetry?: TelemetrySink;
+    /** Kênh poll lệnh cho mode device-rtmp — mặc định suy từ telemetry endpoint. */
+    commandChannel?: SessionCommandChannel;
+    /**
+     * Kênh nhận lệnh qua websocket (first-party nối thẳng Convex). Có thì lệnh về
+     * tức thì và poll tụt về nhịp reconcile chậm — cắt phần lớn function call của
+     * đường poll. Thiếu (máy đối tác qua proxy) thì chỉ dùng poll HTTP như cũ.
+     */
+    commandSubscription?: SessionCommandSubscription;
+    roomFactory?: () => RoomAdapter;
+    deviceMetrics?: EngineDependencies["deviceMetrics"];
+    theme?: Partial<LivestreamTheme>;
+    locale?: "vi" | "en";
+    onError?: (error: PickleballExpoError) => void;
+}
+/**
+ * Context nội bộ cho các module opt-in (VD PickleballDeviceAgent) cần truy cập
+ * engine trực tiếp — export qua "./advanced", không thuộc API tích hợp cơ bản.
+ */
+interface LivestreamHostContextValue {
+    engine: LivestreamEngine;
+    bootstrapInput: BootstrapInput;
+    deviceMetrics: NonNullable<EngineDependencies["deviceMetrics"]>;
+}
+declare function useLivestreamHost(): LivestreamHostContextValue;
+interface LivestreamContextValue extends LivestreamSnapshot {
+    locale: "vi" | "en";
+    theme: LivestreamTheme;
+    prepare(): Promise<void>;
+    start(input: StartLivestreamInput, options?: {
+        autoPublish?: boolean;
+    }): Promise<void>;
+    /** Bắt đầu phát khi đang standby. */
+    startPublishing(): Promise<void>;
+    /** Tạm dừng phát về standby (không kết thúc phiên). */
+    stopPublishing(): Promise<void>;
+    stop(reason?: EndReason): Promise<void>;
+    retry(): Promise<void>;
+    switchCamera(): Promise<void>;
+    setMicrophoneEnabled(enabled: boolean): Promise<void>;
+    setCaptureOrientation(orientation: "portrait" | "landscape"): Promise<void>;
+    selectCamera(deviceId: string): Promise<void>;
+}
+declare function PickleballLiveProvider(props: PickleballLiveProviderProps): React.JSX.Element;
+declare function useLivestream(): LivestreamContextValue;
+
+export { type Fetch as F, type LivestreamContextValue as L, type NativeRtmpBindings as N, PickleballLiveProvider as P, RtmpRoomAdapter as R, type LivestreamTheme as a, type PickleballLiveProviderProps as b, createDefaultStorage as c, createRtmpRoomFactory as d, createRtmpRuntime as e, defaultLivestreamTheme as f, type LivestreamHostContextValue as g, type RtmpStatus as h, createDefaultDeviceMetrics as i, createDefaultNetwork as j, createDefaultRoomFactory as k, createDefaultRuntime as l, createDefaultTelemetry as m, createNativeRtmpBindings as n, isBootstrap as o, isCameraGrant as p, isSessionGrant as q, isSessionRefresh as r, isTelemetryCredentials as s, sessionApiBaseFromTelemetryEndpoint as t, useLivestream as u, useLivestreamHost as v };

package/dist/advanced.cjs

@@ -5,6 +5,7 @@
 
 
 
+var _chunk62YV3PCDcjs = require('./chunk-62YV3PCD.cjs');
 
 
 
@@ -14,7 +15,13 @@
 
 
 
-var _chunkTBPR2QNDcjs = require('./chunk-TBPR2QND.cjs');
+
+
+
+
+
+
+var _chunkIUIRVKJIcjs = require('./chunk-IUIRVKJI.cjs');
 require('./chunk-7OX2DSKI.cjs');
 
 
@@ -32,4 +39,9 @@ require('./chunk-7OX2DSKI.cjs');
 
 
 
-exports.LEGAL_LIVESTREAM_TRANSITIONS = _chunkTBPR2QNDcjs.LEGAL_LIVESTREAM_TRANSITIONS; exports.LiveKitRoomAdapter = _chunkTBPR2QNDcjs.LiveKitRoomAdapter; exports.LivestreamEngine = _chunkTBPR2QNDcjs.LivestreamEngine; exports.PENDING_END_KEY = _chunkTBPR2QNDcjs.PENDING_END_KEY; exports.RtmpRoomAdapter = _chunkTBPR2QNDcjs.RtmpRoomAdapter; exports.createDefaultDeviceMetrics = _chunkTBPR2QNDcjs.createDefaultDeviceMetrics; exports.createDefaultNetwork = _chunkTBPR2QNDcjs.createDefaultNetwork; exports.createDefaultRoomFactory = _chunkTBPR2QNDcjs.createDefaultRoomFactory; exports.createDefaultRuntime = _chunkTBPR2QNDcjs.createDefaultRuntime; exports.createDefaultStorage = _chunkTBPR2QNDcjs.createDefaultStorage; exports.createDefaultTelemetry = _chunkTBPR2QNDcjs.createDefaultTelemetry; exports.createNativeLiveKitBindings = _chunkTBPR2QNDcjs.createNativeLiveKitBindings; exports.createNativeRtmpBindings = _chunkTBPR2QNDcjs.createNativeRtmpBindings; exports.createRtmpRoomFactory = _chunkTBPR2QNDcjs.createRtmpRoomFactory; exports.useLivestreamHost = _chunkTBPR2QNDcjs.useLivestreamHost;
+
+
+
+
+
+exports.LEGAL_LIVESTREAM_TRANSITIONS = _chunkIUIRVKJIcjs.LEGAL_LIVESTREAM_TRANSITIONS; exports.LivestreamEngine = _chunkIUIRVKJIcjs.LivestreamEngine; exports.PENDING_END_KEY = _chunkIUIRVKJIcjs.PENDING_END_KEY; exports.RtmpRoomAdapter = _chunkIUIRVKJIcjs.RtmpRoomAdapter; exports.createDefaultDeviceMetrics = _chunkIUIRVKJIcjs.createDefaultDeviceMetrics; exports.createDefaultNetwork = _chunkIUIRVKJIcjs.createDefaultNetwork; exports.createDefaultRoomFactory = _chunkIUIRVKJIcjs.createDefaultRoomFactory; exports.createDefaultRuntime = _chunkIUIRVKJIcjs.createDefaultRuntime; exports.createDefaultStorage = _chunkIUIRVKJIcjs.createDefaultStorage; exports.createDefaultTelemetry = _chunkIUIRVKJIcjs.createDefaultTelemetry; exports.createNativeRtmpBindings = _chunkIUIRVKJIcjs.createNativeRtmpBindings; exports.createRtmpRoomFactory = _chunkIUIRVKJIcjs.createRtmpRoomFactory; exports.createRtmpRuntime = _chunkIUIRVKJIcjs.createRtmpRuntime; exports.isBootstrap = _chunk62YV3PCDcjs.isBootstrap; exports.isCameraGrant = _chunk62YV3PCDcjs.isCameraGrant; exports.isSessionGrant = _chunk62YV3PCDcjs.isSessionGrant; exports.isSessionRefresh = _chunk62YV3PCDcjs.isSessionRefresh; exports.isTelemetryCredentials = _chunk62YV3PCDcjs.isTelemetryCredentials; exports.sessionApiBaseFromTelemetryEndpoint = _chunk62YV3PCDcjs.sessionApiBaseFromTelemetryEndpoint; exports.useLivestreamHost = _chunkIUIRVKJIcjs.useLivestreamHost;

package/dist/advanced.d.cts

@@ -1,3 +1,3 @@
-export { C as CameraDeviceInfo, a as CaptureOrientation, D as DeviceMetricsSample, X as EngineDependencies, Y as LEGAL_LIVESTREAM_TRANSITIONS, Q as LivestreamEngine, g as LivestreamSnapshot, Z as PENDING_END_KEY, j as RoomAdapter, V as RoomConnection, W as RoomEvent, p as SdkNetwork, r as SdkRuntime, u as SdkStorage, T as TelemetrySink } from './engine-CCSSqPbZ.cjs';
-export { e as LiveKitRoomAdapter, f as LivestreamHostContextValue, g as LocalPreviewReference, N as NativeLiveKitBindings, h as NativeRtmpBindings, R as RtmpRoomAdapter, i as RtmpStatus, j as createDefaultDeviceMetrics, k as createDefaultNetwork, l as createDefaultRoomFactory, m as createDefaultRuntime, c as createDefaultStorage, n as createDefaultTelemetry, o as createNativeLiveKitBindings, p as createNativeRtmpBindings, q as createRtmpRoomFactory, r as useLivestreamHost } from './advanced-BdAa2Erv.cjs';
+export { e as CameraDeviceInfo, g as CaptureOrientation, D as DeviceMetricsSample, a3 as EngineDependencies, a4 as LEGAL_LIVESTREAM_TRANSITIONS, a0 as LivestreamEngine, m as LivestreamSnapshot, a5 as PENDING_END_KEY, R as RoomAdapter, a1 as RoomConnection, a2 as RoomEvent, w as SdkNetwork, x as SdkRuntime, a as SdkStorage, H as SessionCommandChannel, T as TelemetrySink } from './engine-BSvSdCSE.cjs';
+export { g as LivestreamHostContextValue, N as NativeRtmpBindings, R as RtmpRoomAdapter, h as RtmpStatus, i as createDefaultDeviceMetrics, j as createDefaultNetwork, k as createDefaultRoomFactory, l as createDefaultRuntime, c as createDefaultStorage, m as createDefaultTelemetry, n as createNativeRtmpBindings, d as createRtmpRoomFactory, e as createRtmpRuntime, o as isBootstrap, p as isCameraGrant, q as isSessionGrant, r as isSessionRefresh, s as isTelemetryCredentials, t as sessionApiBaseFromTelemetryEndpoint, v as useLivestreamHost } from './advanced-DeQwg7MK.cjs';
 import 'react';

package/dist/advanced.d.ts

@@ -1,3 +1,3 @@
-export { C as CameraDeviceInfo, a as CaptureOrientation, D as DeviceMetricsSample, X as EngineDependencies, Y as LEGAL_LIVESTREAM_TRANSITIONS, Q as LivestreamEngine, g as LivestreamSnapshot, Z as PENDING_END_KEY, j as RoomAdapter, V as RoomConnection, W as RoomEvent, p as SdkNetwork, r as SdkRuntime, u as SdkStorage, T as TelemetrySink } from './engine-CCSSqPbZ.js';
-export { e as LiveKitRoomAdapter, f as LivestreamHostContextValue, g as LocalPreviewReference, N as NativeLiveKitBindings, h as NativeRtmpBindings, R as RtmpRoomAdapter, i as RtmpStatus, j as createDefaultDeviceMetrics, k as createDefaultNetwork, l as createDefaultRoomFactory, m as createDefaultRuntime, c as createDefaultStorage, n as createDefaultTelemetry, o as createNativeLiveKitBindings, p as createNativeRtmpBindings, q as createRtmpRoomFactory, r as useLivestreamHost } from './advanced-BXDrDl1h.js';
+export { e as CameraDeviceInfo, g as CaptureOrientation, D as DeviceMetricsSample, a3 as EngineDependencies, a4 as LEGAL_LIVESTREAM_TRANSITIONS, a0 as LivestreamEngine, m as LivestreamSnapshot, a5 as PENDING_END_KEY, R as RoomAdapter, a1 as RoomConnection, a2 as RoomEvent, w as SdkNetwork, x as SdkRuntime, a as SdkStorage, H as SessionCommandChannel, T as TelemetrySink } from './engine-BSvSdCSE.js';
+export { g as LivestreamHostContextValue, N as NativeRtmpBindings, R as RtmpRoomAdapter, h as RtmpStatus, i as createDefaultDeviceMetrics, j as createDefaultNetwork, k as createDefaultRoomFactory, l as createDefaultRuntime, c as createDefaultStorage, m as createDefaultTelemetry, n as createNativeRtmpBindings, d as createRtmpRoomFactory, e as createRtmpRuntime, o as isBootstrap, p as isCameraGrant, q as isSessionGrant, r as isSessionRefresh, s as isTelemetryCredentials, t as sessionApiBaseFromTelemetryEndpoint, v as useLivestreamHost } from './advanced-DcbHBCGb.js';
 import 'react';

package/dist/advanced.js

@@ -1,6 +1,13 @@
+import {
+  isBootstrap,
+  isCameraGrant,
+  isSessionGrant,
+  isSessionRefresh,
+  isTelemetryCredentials,
+  sessionApiBaseFromTelemetryEndpoint
+} from "./chunk-ZSKSXOCZ.js";
 import {
   LEGAL_LIVESTREAM_TRANSITIONS,
-  LiveKitRoomAdapter,
   LivestreamEngine,
   PENDING_END_KEY,
   RtmpRoomAdapter,
@@ -10,15 +17,14 @@ import {
   createDefaultRuntime,
   createDefaultStorage,
   createDefaultTelemetry,
-  createNativeLiveKitBindings,
   createNativeRtmpBindings,
   createRtmpRoomFactory,
+  createRtmpRuntime,
   useLivestreamHost
-} from "./chunk-FODE2W2H.js";
+} from "./chunk-XGP2MN5R.js";
 import "./chunk-KFQGP6VL.js";
 export {
   LEGAL_LIVESTREAM_TRANSITIONS,
-  LiveKitRoomAdapter,
   LivestreamEngine,
   PENDING_END_KEY,
   RtmpRoomAdapter,
@@ -28,8 +34,14 @@ export {
   createDefaultRuntime,
   createDefaultStorage,
   createDefaultTelemetry,
-  createNativeLiveKitBindings,
   createNativeRtmpBindings,
   createRtmpRoomFactory,
+  createRtmpRuntime,
+  isBootstrap,
+  isCameraGrant,
+  isSessionGrant,
+  isSessionRefresh,
+  isTelemetryCredentials,
+  sessionApiBaseFromTelemetryEndpoint,
   useLivestreamHost
 };

package/dist/camera-controls-By8tHigY.d.cts

@@ -0,0 +1,97 @@
+import { a as SdkStorage, R as RoomAdapter } from './engine-BSvSdCSE.cjs';
+
+/**
+ * Cấu hình camera LOCAL — không phụ thuộc server, sống qua OTA (chuyển từ
+ * apps/device-streamer/src/local-config.ts). Resolution override videoQuality
+ * qua withLocalVideoQuality; fps + cameraId đi vào createRtmpRoomFactory. Đổi
+ * resolution/fps/cameraId → remount provider (dùng cameraSettingsKey làm `key`)
+ * để engine re-prepare.
+ */
+type AntiFlickerMode = "auto" | "50hz" | "60hz";
+interface CameraSettings {
+    resolution: 720 | 1080;
+    /** 60 chỉ chọn được khi capabilities của lens đang gắn báo hỗ trợ. */
+    fps: 24 | 30 | 60;
+    /**
+     * Chống chớp đèn. Mặc định "50hz" (lưới điện VN) chứ KHÔNG phải "auto": để
+     * auto là giao cho HAL đoán tần số, HyperOS đoán trật 60Hz thường xuyên → đèn
+     * LED trong nhà vằn trên sóng. Android-only hiện tại.
+     */
+    antiFlicker: AntiFlickerMode;
+    /**
+     * Camera mặc định mỗi lần mở app. null = camera sau mặc định của native. Cần
+     * vì máy thật có nhiều camera trùng nhãn (Redmi Note 15: hai "Back Camera").
+     */
+    cameraId: string | null;
+}
+declare const CAMERA_SETTINGS_STORAGE_KEY = "@pickleball/expo-sdk/camera-settings";
+declare const DEFAULT_CAMERA_SETTINGS: CameraSettings;
+/** Parse thuần — giá trị lạ/thiếu rơi về mặc định (config cũ chưa có field vẫn đọc được). */
+declare function parseCameraSettings(raw: string | null, defaults?: CameraSettings): CameraSettings;
+interface CameraSettingsStore {
+    readonly key: string;
+    get(): CameraSettings;
+    set(patch: Partial<CameraSettings>): void;
+    subscribe(listener: () => void): () => void;
+    /** Nạp từ đĩa; gọi một lần lúc app khởi động. */
+    restore(): Promise<void>;
+    isRestored(): boolean;
+}
+interface CameraSettingsStoreOptions {
+    storage?: SdkStorage;
+    /** Khoá lưu — app fleet giữ khoá cũ để setting sống qua OTA. */
+    key?: string;
+    defaults?: Partial<CameraSettings>;
+}
+declare function createCameraSettingsStore(options?: CameraSettingsStoreOptions): CameraSettingsStore;
+declare function useCameraSettings(store: CameraSettingsStore): CameraSettings;
+/** `key` cho PickleballLiveProvider: đổi giá trị → remount → engine re-prepare đúng cấu hình. */
+declare function cameraSettingsKey(settings: CameraSettings): string;
+/** roomFactory RTMP theo cấu hình (fps + camera mặc định). */
+declare function rtmpRoomFactoryFor(settings: CameraSettings): () => RoomAdapter;
+
+/**
+ * Điều khiển camera RUNTIME (zoom, EV, khoá nét/sáng, đèn pin, chống chớp) —
+ * gọi THẲNG native module @pickleball/rtmp-native (singleton), chủ ý bypass
+ * engine/adapter vì đây là tinh chỉnh camera, không phải lifecycle phiên.
+ *
+ * Mọi hàm `typeof`-guard: binary cũ (rtmp-native 0.1.0 trên fleet 1.0.2) thiếu
+ * vài hàm thì trả null/no-op thay vì ném — UI ẩn control tương ứng.
+ */
+interface CameraCapabilityRange {
+    min: number;
+    max: number;
+    supported: boolean;
+}
+interface CameraCapabilities {
+    zoom: CameraCapabilityRange;
+    exposureBias: CameraCapabilityRange & {
+        step?: number;
+    };
+    torch: {
+        supported: boolean;
+    };
+    focusLock: {
+        supported: boolean;
+    };
+    exposureLock: {
+        supported: boolean;
+    };
+    supportedFrameRates?: number[];
+}
+/** Bounds + cờ hỗ trợ của lens đang gắn; null khi module/hàm chưa có. */
+declare function getCameraCapabilities(): Promise<CameraCapabilities | null>;
+declare function setZoom(factor: number): Promise<void>;
+declare function setExposureBias(ev: number): Promise<void>;
+declare function setFocusLocked(locked: boolean): Promise<void>;
+declare function setExposureLocked(locked: boolean): Promise<void>;
+declare function setTorch(enabled: boolean): Promise<void>;
+/** Android-only: iOS/binary cũ thiếu hàm → no-op. Native tự áp lại mỗi lần mở camera/đổi lens. */
+declare function applyAntiFlicker(mode: "auto" | "50hz" | "60hz"): Promise<void>;
+/**
+ * Xin quyền camera/mic qua native (iOS, rtmp-native ≥ 0.2). null = native chưa
+ * có hàm → caller tự quyết (AVFoundation sẽ hỏi lúc mở camera).
+ */
+declare function requestNativePermissions(): Promise<boolean | null>;
+
+export { type AntiFlickerMode as A, CAMERA_SETTINGS_STORAGE_KEY as C, DEFAULT_CAMERA_SETTINGS as D, type CameraCapabilities as a, type CameraCapabilityRange as b, type CameraSettings as c, type CameraSettingsStore as d, type CameraSettingsStoreOptions as e, applyAntiFlicker as f, cameraSettingsKey as g, createCameraSettingsStore as h, getCameraCapabilities as i, rtmpRoomFactoryFor as j, setExposureLocked as k, setFocusLocked as l, setTorch as m, setZoom as n, parseCameraSettings as p, requestNativePermissions as r, setExposureBias as s, useCameraSettings as u };

package/dist/camera-controls-rCBUGGPC.d.ts

@@ -0,0 +1,97 @@
+import { a as SdkStorage, R as RoomAdapter } from './engine-BSvSdCSE.js';
+
+/**
+ * Cấu hình camera LOCAL — không phụ thuộc server, sống qua OTA (chuyển từ
+ * apps/device-streamer/src/local-config.ts). Resolution override videoQuality
+ * qua withLocalVideoQuality; fps + cameraId đi vào createRtmpRoomFactory. Đổi
+ * resolution/fps/cameraId → remount provider (dùng cameraSettingsKey làm `key`)
+ * để engine re-prepare.
+ */
+type AntiFlickerMode = "auto" | "50hz" | "60hz";
+interface CameraSettings {
+    resolution: 720 | 1080;
+    /** 60 chỉ chọn được khi capabilities của lens đang gắn báo hỗ trợ. */
+    fps: 24 | 30 | 60;
+    /**
+     * Chống chớp đèn. Mặc định "50hz" (lưới điện VN) chứ KHÔNG phải "auto": để
+     * auto là giao cho HAL đoán tần số, HyperOS đoán trật 60Hz thường xuyên → đèn
+     * LED trong nhà vằn trên sóng. Android-only hiện tại.
+     */
+    antiFlicker: AntiFlickerMode;
+    /**
+     * Camera mặc định mỗi lần mở app. null = camera sau mặc định của native. Cần
+     * vì máy thật có nhiều camera trùng nhãn (Redmi Note 15: hai "Back Camera").
+     */
+    cameraId: string | null;
+}
+declare const CAMERA_SETTINGS_STORAGE_KEY = "@pickleball/expo-sdk/camera-settings";
+declare const DEFAULT_CAMERA_SETTINGS: CameraSettings;
+/** Parse thuần — giá trị lạ/thiếu rơi về mặc định (config cũ chưa có field vẫn đọc được). */
+declare function parseCameraSettings(raw: string | null, defaults?: CameraSettings): CameraSettings;
+interface CameraSettingsStore {
+    readonly key: string;
+    get(): CameraSettings;
+    set(patch: Partial<CameraSettings>): void;
+    subscribe(listener: () => void): () => void;
+    /** Nạp từ đĩa; gọi một lần lúc app khởi động. */
+    restore(): Promise<void>;
+    isRestored(): boolean;
+}
+interface CameraSettingsStoreOptions {
+    storage?: SdkStorage;
+    /** Khoá lưu — app fleet giữ khoá cũ để setting sống qua OTA. */
+    key?: string;
+    defaults?: Partial<CameraSettings>;
+}
+declare function createCameraSettingsStore(options?: CameraSettingsStoreOptions): CameraSettingsStore;
+declare function useCameraSettings(store: CameraSettingsStore): CameraSettings;
+/** `key` cho PickleballLiveProvider: đổi giá trị → remount → engine re-prepare đúng cấu hình. */
+declare function cameraSettingsKey(settings: CameraSettings): string;
+/** roomFactory RTMP theo cấu hình (fps + camera mặc định). */
+declare function rtmpRoomFactoryFor(settings: CameraSettings): () => RoomAdapter;
+
+/**
+ * Điều khiển camera RUNTIME (zoom, EV, khoá nét/sáng, đèn pin, chống chớp) —
+ * gọi THẲNG native module @pickleball/rtmp-native (singleton), chủ ý bypass
+ * engine/adapter vì đây là tinh chỉnh camera, không phải lifecycle phiên.
+ *
+ * Mọi hàm `typeof`-guard: binary cũ (rtmp-native 0.1.0 trên fleet 1.0.2) thiếu
+ * vài hàm thì trả null/no-op thay vì ném — UI ẩn control tương ứng.
+ */
+interface CameraCapabilityRange {
+    min: number;
+    max: number;
+    supported: boolean;
+}
+interface CameraCapabilities {
+    zoom: CameraCapabilityRange;
+    exposureBias: CameraCapabilityRange & {
+        step?: number;
+    };
+    torch: {
+        supported: boolean;
+    };
+    focusLock: {
+        supported: boolean;
+    };
+    exposureLock: {
+        supported: boolean;
+    };
+    supportedFrameRates?: number[];
+}
+/** Bounds + cờ hỗ trợ của lens đang gắn; null khi module/hàm chưa có. */
+declare function getCameraCapabilities(): Promise<CameraCapabilities | null>;
+declare function setZoom(factor: number): Promise<void>;
+declare function setExposureBias(ev: number): Promise<void>;
+declare function setFocusLocked(locked: boolean): Promise<void>;
+declare function setExposureLocked(locked: boolean): Promise<void>;
+declare function setTorch(enabled: boolean): Promise<void>;
+/** Android-only: iOS/binary cũ thiếu hàm → no-op. Native tự áp lại mỗi lần mở camera/đổi lens. */
+declare function applyAntiFlicker(mode: "auto" | "50hz" | "60hz"): Promise<void>;
+/**
+ * Xin quyền camera/mic qua native (iOS, rtmp-native ≥ 0.2). null = native chưa
+ * có hàm → caller tự quyết (AVFoundation sẽ hỏi lúc mở camera).
+ */
+declare function requestNativePermissions(): Promise<boolean | null>;
+
+export { type AntiFlickerMode as A, CAMERA_SETTINGS_STORAGE_KEY as C, DEFAULT_CAMERA_SETTINGS as D, type CameraCapabilities as a, type CameraCapabilityRange as b, type CameraSettings as c, type CameraSettingsStore as d, type CameraSettingsStoreOptions as e, applyAntiFlicker as f, cameraSettingsKey as g, createCameraSettingsStore as h, getCameraCapabilities as i, rtmpRoomFactoryFor as j, setExposureLocked as k, setFocusLocked as l, setTorch as m, setZoom as n, parseCameraSettings as p, requestNativePermissions as r, setExposureBias as s, useCameraSettings as u };