@pickleball/expo-sdk 0.1.1 → 1.0.0

package/src/native-runtime.ts

@@ -1,99 +1,110 @@
-import type { EngineDependencies, SdkNetwork, SdkRuntime, SdkStorage, TelemetrySink } from "./engine";
-import { LiveKitRoomAdapter, type NativeLiveKitBindings } from "./livekit-room-adapter";
+import type {
+  EngineDependencies,
+  SdkNetwork,
+  SdkRuntime,
+  SdkStorage,
+  SessionCommandChannel,
+  TelemetrySink,
+} from "./engine";
+import type {
+  SessionCommandPollResult,
+  SessionCommandRecord,
+} from "./contracts";
+import { RtmpRoomAdapter, type NativeRtmpBindings } from "./rtmp-room-adapter";
 import { UnsupportedRuntimeError } from "./errors";
 
 declare const require: (name: string) => any;
 
-let globalsRegistered = false;
-
-export function createNativeLiveKitBindings(): NativeLiveKitBindings {
-  const reactNativeLiveKit = require("@livekit/react-native");
-  const liveKit = require("livekit-client");
-  return {
-    registerGlobals() {
-      if (!globalsRegistered) {
-        reactNativeLiveKit.registerGlobals();
-        globalsRegistered = true;
-      }
-    },
-    createRoom: () => new liveKit.Room({ adaptiveStream: false, dynacast: false }),
-    createLocalTracks: liveKit.createLocalTracks,
-    startAudioSession: () => reactNativeLiveKit.AudioSession.startAudioSession(),
-    stopAudioSession: () => reactNativeLiveKit.AudioSession.stopAudioSession(),
-    isLandscape() {
-      const { width, height } = require("react-native").Dimensions.get("window");
-      return width > height;
-    },
-    async listCameras() {
-      const { mediaDevices } = require("@livekit/react-native-webrtc");
-      const devices: Array<{
-        kind?: string;
-        deviceId?: string;
-        label?: string;
-        facing?: string;
-      }> = await mediaDevices.enumerateDevices();
-      return devices
-        .filter((device) => device.kind === "videoinput" && device.deviceId)
-        .map((device) => ({
-          deviceId: String(device.deviceId),
-          label: String(device.label ?? ""),
-          facing:
-            device.facing === "front" || device.facing === "environment"
-              ? device.facing
-              : ("unknown" as const),
-        }));
-    },
-    cameraSource: liveKit.Track.Source.Camera,
-    events: {
-      reconnecting: liveKit.RoomEvent.Reconnecting,
-      reconnected: liveKit.RoomEvent.Reconnected,
-      disconnected: liveKit.RoomEvent.Disconnected,
-      mediaDevicesError: liveKit.RoomEvent.MediaDevicesError,
-      dataReceived: liveKit.RoomEvent.DataReceived,
-    },
-  };
-}
-
-export function createDefaultRuntime(): SdkRuntime {
-  const { NativeModules, Platform } = require("react-native");
+/**
+ * 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.
+ */
+export function createRtmpRuntime(): SdkRuntime {
+  const { Platform, PermissionsAndroid } = require("react-native");
   return {
     assertSupported() {
-      if (
-        (Platform.OS !== "ios" && Platform.OS !== "android") ||
-        !NativeModules.LivekitReactNativeModule
-      ) {
+      if (Platform.OS !== "ios" && Platform.OS !== "android") {
         throw new UnsupportedRuntimeError();
       }
+      try {
+        require("@pickleball/rtmp-native");
+      } catch {
+        throw new UnsupportedRuntimeError(
+          "@pickleball/rtmp-native is required: install it and rebuild the Development Build",
+        );
+      }
     },
     async requestPermissions() {
+      if (Platform.OS === "android") {
+        try {
+          const granted = await PermissionsAndroid.requestMultiple([
+            PermissionsAndroid.PERMISSIONS.CAMERA,
+            PermissionsAndroid.PERMISSIONS.RECORD_AUDIO,
+          ]);
+          return (
+            granted[PermissionsAndroid.PERMISSIONS.CAMERA] ===
+              PermissionsAndroid.RESULTS.GRANTED &&
+            granted[PermissionsAndroid.PERMISSIONS.RECORD_AUDIO] ===
+              PermissionsAndroid.RESULTS.GRANTED
+          );
+        } catch {
+          return false;
+        }
+      }
       try {
-        const { mediaDevices } = require("@livekit/react-native-webrtc");
-        const stream = await mediaDevices.getUserMedia({ audio: true, video: true });
-        for (const track of stream.getTracks()) track.stop();
-        return true;
+        const native = require("@pickleball/rtmp-native").default;
+        if (typeof native?.requestPermissions === "function") {
+          return (await native.requestPermissions()) !== false;
+        }
       } catch {
-        return false;
+        // Binary cũ chưa có hàm → AVFoundation tự hỏi lúc prepare.
       }
+      return true;
     },
-    activateKeepAwake() {
-      return require("expo-keep-awake").activateKeepAwakeAsync(
-        "@pickleball/expo-sdk",
-      );
-    },
-    deactivateKeepAwake() {
-      return require("expo-keep-awake").deactivateKeepAwake(
-        "@pickleball/expo-sdk",
-      );
+    activateKeepAwake: () =>
+      Promise.resolve(
+        require("expo-keep-awake").activateKeepAwakeAsync("@pickleball/expo-sdk"),
+      ).catch(() => undefined),
+    // deactivate trả promise và REJECT khi activity đã chết (sau crash/reload) —
+    // không catch là thêm một "Uncaught (in promise)" gây nhiễu log.
+    deactivateKeepAwake: () => {
+      void Promise.resolve(
+        require("expo-keep-awake").deactivateKeepAwake("@pickleball/expo-sdk"),
+      ).catch(() => undefined);
     },
   };
 }
 
+/** Runtime mặc định của SDK 1.0 = RTMP (LiveKit đã gỡ khỏi SDK — ADR-0002). */
+export const createDefaultRuntime = createRtmpRuntime;
+
 export function createDefaultStorage(): SdkStorage {
-  require("expo-sqlite/localStorage/install");
+  // Cài localStorage của expo-sqlite ở LẦN DÙNG ĐẦU, không phải lúc gọi factory:
+  // app thường tạo storage ở module scope (root layout), và static-render web
+  // của expo-router nạp module đó trong Node nơi expo-sqlite không resolve được.
+  // Không có lời gọi get/set/remove nào khi render tĩnh nên require không chạy.
+  let installed = false;
+  const install = () => {
+    if (installed) return;
+    require("expo-sqlite/localStorage/install");
+    installed = true;
+  };
   return {
-    getItem: async (key) => globalThis.localStorage.getItem(key),
-    setItem: async (key, value) => globalThis.localStorage.setItem(key, value),
-    removeItem: async (key) => globalThis.localStorage.removeItem(key),
+    getItem: async (key) => {
+      install();
+      return globalThis.localStorage.getItem(key);
+    },
+    setItem: async (key, value) => {
+      install();
+      globalThis.localStorage.setItem(key, value);
+    },
+    removeItem: async (key) => {
+      install();
+      globalThis.localStorage.removeItem(key);
+    },
   };
 }
 
@@ -155,8 +166,152 @@ export function createDefaultTelemetry(
   };
 }
 
+/** roomFactory mặc định của SDK 1.0 = RTMP (fps/camera mặc định của native). */
 export function createDefaultRoomFactory(): EngineDependencies["roomFactory"] {
-  return () => new LiveKitRoomAdapter(createNativeLiveKitBindings());
+  return createRtmpRoomFactory();
+}
+
+/**
+ * Kênh poll lệnh cho phiên device-rtmp. URL suy từ telemetry endpoint
+ * (.../telemetry → .../commands) — cùng origin, cùng Bearer token, nên không
+ * cần thêm bất kỳ trường mới nào đi qua proxy của đối tác.
+ */
+export function createDefaultCommandChannel(
+  fetchImplementation = globalThis.fetch,
+  timeoutMs = 10_000,
+): SessionCommandChannel {
+  const controllers = new Set<AbortController>();
+  return {
+    async poll(credentials, after): Promise<SessionCommandPollResult> {
+      const endpoint = credentials.endpoint.replace(/\/telemetry$/, "/commands");
+      const controller = new AbortController();
+      controllers.add(controller);
+      const timeout = setTimeout(() => controller.abort(), timeoutMs);
+      try {
+        const response = await fetchImplementation(endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${credentials.token}`,
+          },
+          body: JSON.stringify({ after }),
+          signal: controller.signal,
+          redirect: "error",
+        });
+        if (!response.ok) {
+          if (typeof response.text === "function") await response.text();
+          throw Object.assign(new Error("Command poll rejected"), {
+            status: response.status,
+          });
+        }
+        const envelope = (await response.json()) as { data?: unknown };
+        return parseCommandPollResult(envelope?.data);
+      } finally {
+        clearTimeout(timeout);
+        controllers.delete(controller);
+      }
+    },
+    dispose() {
+      for (const controller of controllers) controller.abort();
+      controllers.clear();
+    },
+  };
+}
+
+function parseCommandPollResult(value: unknown): SessionCommandPollResult {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("Command poll returned an invalid payload");
+  }
+  const record = value as Record<string, unknown>;
+  const status = record.status;
+  if (status !== "scheduled" && status !== "live" && status !== "ended") {
+    throw new Error("Command poll returned an invalid status");
+  }
+  const commands: SessionCommandRecord[] = [];
+  if (Array.isArray(record.commands)) {
+    for (const item of record.commands) {
+      if (item === null || typeof item !== "object") continue;
+      const command = item as Record<string, unknown>;
+      if (
+        typeof command.id !== "string" ||
+        (command.action !== "start" &&
+          command.action !== "stop" &&
+          command.action !== "end") ||
+        typeof command.issuedAt !== "number" ||
+        !Number.isFinite(command.issuedAt)
+      ) {
+        continue;
+      }
+      commands.push({
+        id: command.id,
+        action: command.action,
+        issuedAt: command.issuedAt,
+      });
+    }
+  }
+  return { commands, status };
+}
+
+/**
+ * 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.
+ */
+export function createNativeRtmpBindings(): NativeRtmpBindings {
+  const native = require("@pickleball/rtmp-native").default;
+  const { Platform, PermissionsAndroid } = require("react-native");
+  return {
+    prepare: (options) => native.prepare(options),
+    // Android: xin quyền THUẦN, không mở camera như getUserMedia của WebRTC.
+    // Máy MediaTek (Xiaomi tanzanite) chỉ cho một camera mở cùng lúc — camera
+    // WebRTC chưa nhả (~400ms) là HaishinKit dính "Too many users (-87)" và
+    // preview đen. iOS không có giới hạn đó nên để engine fallback getUserMedia.
+    ...(Platform.OS === "android"
+      ? {
+          async requestPermissions() {
+            const granted = await PermissionsAndroid.requestMultiple([
+              PermissionsAndroid.PERMISSIONS.CAMERA,
+              PermissionsAndroid.PERMISSIONS.RECORD_AUDIO,
+            ]);
+            return (
+              granted[PermissionsAndroid.PERMISSIONS.CAMERA] ===
+                PermissionsAndroid.RESULTS.GRANTED &&
+              granted[PermissionsAndroid.PERMISSIONS.RECORD_AUDIO] ===
+                PermissionsAndroid.RESULTS.GRANTED
+            );
+          },
+        }
+      : {}),
+    isLandscape() {
+      const { width, height } = require("react-native").Dimensions.get("window");
+      return width > height;
+    },
+    connect: (options) => native.connect(options),
+    setPublishing: (enabled) => native.setPublishing(enabled),
+    disconnect: () => native.disconnect(),
+    switchCamera: () => native.switchCamera(),
+    listCameras: () => native.listCameras(),
+    selectCamera: (deviceId, facing) => native.selectCamera(deviceId, facing),
+    setMicrophoneEnabled: (enabled) => native.setMicrophoneEnabled(enabled),
+    setVideoBitrate: (bps) => native.setVideoBitrate(bps),
+    dispose: () => native.dispose(),
+    addStatusListener: (listener) => native.addListener("onStatusChanged", listener),
+    addBandwidthListener: (listener) => native.addListener("onBandwidth", listener),
+  };
+}
+
+/** roomFactory cho mode device-rtmp (thiết bị đẩy RTMP, không dùng LiveKit). */
+export 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"] {
+  return () => new RtmpRoomAdapter(createNativeRtmpBindings(), options);
 }
 
 /**
@@ -214,6 +369,21 @@ export function createDefaultDeviceMetrics(): NonNullable<
       /* expo-device chưa được cài */
     }
 
+    // Nhiệt máy + nhiệt pin: chỉ có đường native (không package Expo nào đọc
+    // được). Guard require như các nguồn khác — app không cài rtmp-native thì
+    // bỏ qua hai trường này thay vì gãy cả collector.
+    try {
+      const native = require("@pickleball/rtmp-native").default;
+      const health = await native.getDeviceHealth();
+      if (typeof health?.thermal === "number") metrics.thermal = health.thermal;
+      if (typeof health?.batteryTempC === "number") {
+        // Làm tròn 1 số lẻ: pin báo theo 1/10 °C, giữ nguyên là đủ chính xác.
+        metrics.batteryTempC = Math.round(health.batteryTempC * 10) / 10;
+      }
+    } catch (error) {
+      notes.push(`device health: ${String(error)}`);
+    }
+
     try {
       const NetInfo = require("@react-native-community/netinfo").default;
       const status = await NetInfo.fetch();
@@ -227,6 +397,42 @@ export function createDefaultDeviceMetrics(): NonNullable<
                 ).toUpperCase()
               : status.type;
       }
+      // Chi tiết mạng cho việc truy vết sự cố tại sân: máy còn bám router của
+      // giải hay đã rớt sang 4G, sóng yếu tới mức nào.
+      //
+      // CỐ Ý không đọc `details.ssid`/`bssid`: hai field đó bị khoá sau quyền
+      // VỊ TRÍ (Android cần ACCESS_FINE_LOCATION + bật GPS; iOS cần entitlement
+      // Access WiFi Information). Xin quyền vị trí cho mỗi máy đặt ở sân chỉ để
+      // hiện tên WiFi là cái giá quá đắt — IP nội bộ dưới đây phân biệt được
+      // router mà không cần quyền nào.
+      const details = status?.details as
+        | {
+            ipAddress?: unknown;
+            strength?: unknown;
+            linkSpeed?: unknown;
+            frequency?: unknown;
+          }
+        | undefined;
+      if (typeof details?.ipAddress === "string" && details.ipAddress) {
+        metrics.localIp = details.ipAddress;
+      }
+      // strength: 0-100 (%). CHỈ Android — iOS không mở cường độ sóng cho app.
+      if (typeof details?.strength === "number" && Number.isFinite(details.strength)) {
+        metrics.signalPct = Math.round(details.strength);
+      }
+      if (typeof details?.linkSpeed === "number" && Number.isFinite(details.linkSpeed)) {
+        metrics.linkMbps = Math.round(details.linkSpeed);
+      }
+      // Tần số kênh (Android) — phân biệt 2.4/5 GHz không cần quyền vị trí.
+      // Chỉ đi vào telemetry PHIÊN (dataJson tự do); heartbeat thiết bị lọc
+      // theo METRIC_FIELDS nên không đụng validator server.
+      if (
+        typeof details?.frequency === "number" &&
+        Number.isFinite(details.frequency) &&
+        details.frequency > 0
+      ) {
+        metrics.freqMhz = Math.round(details.frequency);
+      }
     } catch {
       /* netinfo không khả dụng */
     }

package/src/plugin.ts

@@ -4,38 +4,71 @@ import {
   withAndroidManifest,
   withDangerousMod,
   withInfoPlist,
-  withPlugins,
   type ConfigPlugin,
 } from "expo/config-plugins";
 import { readdir, readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { PICKLEBALL_EXPO_SDK_VERSION } from "./version";
+
+/**
+ * Version của SCHEMA plugin — tách khỏi version package có chủ ý. Giá trị này
+ * được inline vào dist/plugin.cjs, mà @expo/fingerprint băm file đó làm
+ * runtimeVersion của app fleet: gắn theo version package là MỖI lần bump SDK
+ * (kể cả patch JS-only) đổi fingerprint và toàn bộ máy ngoài sân mất OTA. Chỉ
+ * nâng khi plugin đổi hành vi native (permission, mod).
+ */
+export const PLUGIN_SCHEMA_VERSION = "1";
 
 export interface PickleballLivePluginProps {
   cameraPermission?: string;
   microphonePermission?: string;
   bluetoothPermission?: string;
   consumeHidVolumeKeys?: boolean;
+  /**
+   * Tắt phần cấu hình native của module không dùng để app gọn hơn:
+   * - remote: false → bỏ permission Bluetooth (Android + iOS usage string) và
+   *   không patch MainActivity nhận phím HID. Dùng khi app không import
+   *   "@pickleball/expo-sdk/match/remote".
+   * - voice: false → hiện chưa gate gì trong plugin (mic thuộc livestream);
+   *   nhận trước để tương thích về sau. Muốn loại hẳn native khỏi binary, thêm
+   *   expo.autolinking.exclude trong package.json của app (xem README).
+   * - livekit: KHÔNG còn tác dụng từ 1.0 (SDK RTMP-only, không compose plugin
+   *   LiveKit nữa). Vẫn nhận để app.config cũ của fleet không phải sửa — sửa
+   *   là đổi fingerprint OTA.
+   */
+  modules?: {
+    remote?: boolean;
+    voice?: boolean;
+    /** @deprecated bị bỏ qua từ 1.0 */
+    livekit?: boolean;
+  };
+  /** @deprecated bị bỏ qua từ 1.0 (SDK không còn LiveKit). */
   liveKit?: {
     android?: { audioType?: string; enableScreenShareService?: boolean };
     ios?: { enableMultitaskingCameraAccess?: boolean };
   };
 }
 
-const ANDROID_PERMISSIONS = [
+const CORE_ANDROID_PERMISSIONS = [
   "android.permission.ACCESS_NETWORK_STATE",
-  "android.permission.BLUETOOTH",
-  "android.permission.BLUETOOTH_ADMIN",
-  "android.permission.BLUETOOTH_SCAN",
-  "android.permission.BLUETOOTH_CONNECT",
-  "android.permission.ACCESS_FINE_LOCATION",
   "android.permission.CAMERA",
+  "android.permission.FOREGROUND_SERVICE",
+  "android.permission.FOREGROUND_SERVICE_CAMERA",
+  "android.permission.FOREGROUND_SERVICE_MICROPHONE",
   "android.permission.INTERNET",
   "android.permission.MODIFY_AUDIO_SETTINGS",
   "android.permission.RECORD_AUDIO",
   "android.permission.WAKE_LOCK",
 ] as const;
 
+// Chỉ cần cho remote BLE/HID (@pickleball/expo-sdk/match/remote)
+const REMOTE_ANDROID_PERMISSIONS = [
+  "android.permission.BLUETOOTH",
+  "android.permission.BLUETOOTH_ADMIN",
+  "android.permission.BLUETOOTH_SCAN",
+  "android.permission.BLUETOOTH_CONNECT",
+  "android.permission.ACCESS_FINE_LOCATION",
+] as const;
+
 export function injectHidVolumeMainActivity(source: string): string {
   if (source.includes("PickleballRemoteHidDispatcher.dispatch(event)")) return source;
   if (!/class\s+MainActivity\s*:\s*ReactActivity\(\)\s*\{/.test(source)) {
@@ -76,20 +109,21 @@ const withPickleballLive: ConfigPlugin<PickleballLivePluginProps | undefined> =
   const bluetoothPermission =
     props?.bluetoothPermission ??
     "Cho phép $(PRODUCT_NAME) dùng Bluetooth để nhận thao tác từ nút điều khiển trên sân.";
+  const remoteEnabled = props?.modules?.remote !== false;
+  const androidPermissions = remoteEnabled
+    ? [...CORE_ANDROID_PERMISSIONS, ...REMOTE_ANDROID_PERMISSIONS]
+    : [...CORE_ANDROID_PERMISSIONS];
 
-  config = withPlugins(config, [
-    ["@livekit/react-native-expo-plugin", props?.liveKit],
-  ]);
   config.ios = { ...config.ios, bitcode: false };
   config = withInfoPlist(config, (mod) => {
     mod.modResults.NSCameraUsageDescription = cameraPermission;
     mod.modResults.NSMicrophoneUsageDescription = microphonePermission;
-    mod.modResults.NSBluetoothAlwaysUsageDescription = bluetoothPermission;
+    if (remoteEnabled) {
+      mod.modResults.NSBluetoothAlwaysUsageDescription = bluetoothPermission;
+    }
     return mod;
   });
-  config = AndroidConfig.Permissions.withPermissions(config, [
-    ...ANDROID_PERMISSIONS,
-  ]);
+  config = AndroidConfig.Permissions.withPermissions(config, androidPermissions);
   config = withAndroidManifest(config, (mod) => {
     const manifest = mod.modResults.manifest;
     const existing = manifest["uses-permission"] ?? [];
@@ -106,7 +140,7 @@ const withPickleballLive: ConfigPlugin<PickleballLivePluginProps | undefined> =
       const name = entry.$?.["android:name"];
       if (name && !byName.has(name)) byName.set(name, entry);
     }
-    for (const permission of ANDROID_PERMISSIONS) {
+    for (const permission of androidPermissions) {
       const entry = byName.get(permission) ?? { $: { "android:name": permission } };
       entry.$ = {
         "android:name": permission,
@@ -114,17 +148,17 @@ const withPickleballLive: ConfigPlugin<PickleballLivePluginProps | undefined> =
       };
       byName.set(permission, entry);
     }
-    const requiredNames = new Set<string>(ANDROID_PERMISSIONS);
+    const requiredNames = new Set<string>(androidPermissions);
     manifest["uses-permission"] = [
       ...existing.filter((entry) => {
         const name = entry.$?.["android:name"];
         return !name || !requiredNames.has(name);
       }),
-      ...ANDROID_PERMISSIONS.map((name) => byName.get(name)!),
+      ...androidPermissions.map((name) => byName.get(name)!),
     ];
     return mod;
   });
-  if (props?.consumeHidVolumeKeys !== false) {
+  if (remoteEnabled && props?.consumeHidVolumeKeys !== false) {
     config = withDangerousMod(config, ["android", async (mod) => {
       const root = join(mod.modRequest.platformProjectRoot, "app", "src", "main", "java");
       const path = await findMainActivity(root);
@@ -141,5 +175,5 @@ const withPickleballLive: ConfigPlugin<PickleballLivePluginProps | undefined> =
 export default createRunOncePlugin(
   withPickleballLive,
   "@pickleball/expo-sdk",
-  PICKLEBALL_EXPO_SDK_VERSION,
+  PLUGIN_SCHEMA_VERSION,
 );