@pickleball/expo-sdk 0.1.1 → 0.2.0

package/dist/plugin.d.cts

@@ -5,6 +5,19 @@ interface PickleballLivePluginProps {
     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).
+     */
+    modules?: {
+        remote?: boolean;
+        voice?: boolean;
+    };
     liveKit?: {
         android?: {
             audioType?: string;

package/dist/plugin.d.ts

@@ -5,6 +5,19 @@ interface PickleballLivePluginProps {
     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).
+     */
+    modules?: {
+        remote?: boolean;
+        voice?: boolean;
+    };
     liveKit?: {
         android?: {
             audioType?: string;

package/dist/plugin.js

@@ -1,6 +1,7 @@
 import {
   PICKLEBALL_EXPO_SDK_VERSION
-} from "./chunk-VHLUJQG5.js";
+} from "./chunk-6JOMESNT.js";
+import "./chunk-KFQGP6VL.js";
 
 // src/plugin.ts
 import {
@@ -13,19 +14,21 @@ import {
 } from "expo/config-plugins";
 import { readdir, readFile, writeFile } from "fs/promises";
 import { join } from "path";
-var ANDROID_PERMISSIONS = [
+var 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.INTERNET",
   "android.permission.MODIFY_AUDIO_SETTINGS",
   "android.permission.RECORD_AUDIO",
   "android.permission.WAKE_LOCK"
 ];
+var REMOTE_ANDROID_PERMISSIONS = [
+  "android.permission.BLUETOOTH",
+  "android.permission.BLUETOOTH_ADMIN",
+  "android.permission.BLUETOOTH_SCAN",
+  "android.permission.BLUETOOTH_CONNECT",
+  "android.permission.ACCESS_FINE_LOCATION"
+];
 function injectHidVolumeMainActivity(source) {
   if (source.includes("PickleballRemoteHidDispatcher.dispatch(event)")) return source;
   if (!/class\s+MainActivity\s*:\s*ReactActivity\(\)\s*\{/.test(source)) {
@@ -60,6 +63,8 @@ var withPickleballLive = (config, props = {}) => {
   const cameraPermission = props?.cameraPermission ?? "Allow $(PRODUCT_NAME) to use the camera for livestreaming.";
   const microphonePermission = props?.microphonePermission ?? "Allow $(PRODUCT_NAME) to use the microphone for livestreaming.";
   const bluetoothPermission = props?.bluetoothPermission ?? "Cho ph\xE9p $(PRODUCT_NAME) d\xF9ng Bluetooth \u0111\u1EC3 nh\u1EADn thao t\xE1c t\u1EEB n\xFAt \u0111i\u1EC1u khi\u1EC3n tr\xEAn s\xE2n.";
+  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]
   ]);
@@ -67,12 +72,12 @@ var withPickleballLive = (config, props = {}) => {
   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"] ?? [];
@@ -89,7 +94,7 @@ var withPickleballLive = (config, props = {}) => {
       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,
@@ -97,17 +102,17 @@ var withPickleballLive = (config, props = {}) => {
       };
       byName.set(permission, entry);
     }
-    const requiredNames = new Set(ANDROID_PERMISSIONS);
+    const requiredNames = new Set(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);

package/dist/types-CrmcX408.d.cts

@@ -0,0 +1,176 @@
+type MatchFormat = "singles" | "doubles";
+type MatchScoringMode = "rally" | "sideOut";
+type MatchTeamId = "A" | "B";
+type CourtSide = "left" | "right";
+type MatchInputSource = "local" | "remote" | "voice" | "ble" | "system";
+interface MatchPlayer {
+    readonly id: string;
+    readonly name: string;
+}
+interface MatchTeam {
+    readonly id: MatchTeamId;
+    readonly name?: string;
+    /** Defaults to the first player in the roster. */
+    readonly initialServerId?: string;
+    readonly players: readonly MatchPlayer[];
+}
+interface MatchCreateInput {
+    readonly id: string;
+    readonly format: MatchFormat;
+    readonly scoringMode: MatchScoringMode;
+    readonly targetScore?: number;
+    readonly initialServingTeam?: MatchTeamId;
+    readonly teams: Readonly<Record<MatchTeamId, MatchTeam>>;
+}
+interface TeamScore {
+    readonly A: number;
+    readonly B: number;
+}
+interface ServeState {
+    readonly teamId: MatchTeamId;
+    readonly playerId: string;
+    readonly serverNumber: 1 | 2;
+    readonly court: CourtSide;
+}
+interface GameSnapshot {
+    readonly number: 1 | 2 | 3;
+    readonly score: TeamScore;
+    readonly startingServingTeam: MatchTeamId;
+    readonly winner: MatchTeamId | null;
+    readonly midGameSwitchCompleted: boolean;
+}
+type PendingCourtSwitch = {
+    readonly reason: "gameEnd";
+    readonly game: 1 | 2;
+} | {
+    readonly reason: "gameThreeMidpoint";
+    readonly game: 3;
+};
+interface MatchSnapshot {
+    readonly id: string;
+    readonly format: MatchFormat;
+    readonly scoringMode: MatchScoringMode;
+    readonly targetScore: number;
+    readonly bestOf: 3;
+    readonly teams: Readonly<Record<MatchTeamId, MatchTeam>>;
+    readonly designatedServerByTeam: Readonly<Record<MatchTeamId, string>>;
+    readonly initialServingTeam: MatchTeamId;
+    readonly courtSides: Readonly<Record<CourtSide, MatchTeamId>>;
+    readonly playerCourts: Readonly<Record<string, CourtSide>>;
+    readonly games: readonly GameSnapshot[];
+    readonly currentGame: 1 | 2 | 3;
+    readonly gamesWon: TeamScore;
+    readonly serve: ServeState;
+    readonly pendingCourtSwitch: PendingCourtSwitch | null;
+    readonly status: "inProgress" | "completed" | "ended";
+    readonly winner: MatchTeamId | null;
+    readonly endReason: string | null;
+    readonly sequence: number;
+}
+interface MatchCorrection {
+    readonly score?: Partial<TeamScore>;
+    readonly serve?: ServeState;
+    readonly playerCourts?: Readonly<Record<string, CourtSide>>;
+}
+interface MatchEventBase {
+    readonly schemaVersion: 1;
+    readonly id: string;
+    readonly sequence: number;
+    readonly source: MatchInputSource;
+}
+interface MatchCreatedEvent extends MatchEventBase {
+    readonly type: "matchCreated";
+    readonly input: MatchCreateInput;
+    readonly snapshot: MatchSnapshot;
+}
+interface RallyAwardedEvent extends MatchEventBase {
+    readonly type: "rallyAwarded";
+    readonly displaySide: CourtSide;
+    readonly winnerTeamId: MatchTeamId;
+}
+interface CourtSwitchConfirmedEvent extends MatchEventBase {
+    readonly type: "courtSwitchConfirmed";
+    readonly pending: PendingCourtSwitch;
+}
+interface MatchCorrectedEvent extends MatchEventBase {
+    readonly type: "matchCorrected";
+    readonly correction: MatchCorrection;
+}
+interface MatchEndedEvent extends MatchEventBase {
+    readonly type: "matchEnded";
+    readonly reason: string;
+}
+interface MatchEventUndoneEvent extends MatchEventBase {
+    readonly type: "matchEventUndone";
+    readonly targetEventId: string;
+    readonly restoredSnapshot: MatchSnapshot;
+}
+type MatchEvent = MatchCreatedEvent | RallyAwardedEvent | CourtSwitchConfirmedEvent | MatchCorrectedEvent | MatchEndedEvent | MatchEventUndoneEvent;
+interface MatchCreation {
+    readonly snapshot: MatchSnapshot;
+    readonly events: readonly [MatchCreatedEvent];
+}
+
+type AnnouncementKind = "score" | "serviceChange" | "gamePoint" | "gameWon" | "courtSwitch" | "matchWon";
+type FallbackVoiceToken = `number-${number}` | "number-mot" | "number-lam" | `score-deu-${number}` | "score-deu-mot" | "score-deu-lam" | "server-1" | "server-2" | "court-left" | "court-right" | "service-change" | "game-point" | "game-won" | "court-switch" | "match-won" | "test-speaker";
+interface AnnouncementPlan {
+    readonly kind: AnnouncementKind;
+    readonly text: string;
+    readonly score?: readonly [number, number];
+    readonly fallbackTokens: readonly FallbackVoiceToken[];
+}
+type VoiceAudioRoute = "system" | "bluetoothA2DP" | "bluetoothHFP" | "speaker" | "headphones" | "unknown";
+type VoiceDisconnectReason = "oldDeviceUnavailable" | "becomingNoisy" | "unknown";
+interface VoiceRouteState {
+    readonly route: VoiceAudioRoute;
+    readonly interrupted: boolean;
+    readonly disconnectedReason: VoiceDisconnectReason | null;
+}
+type VoiceAudioMode = "offline" | "live";
+interface AudioPlayback {
+    configure(mode: VoiceAudioMode): Promise<void>;
+    play(source: string): Promise<void>;
+    stop(): Promise<void>;
+    dispose(): Promise<void>;
+    getRouteState(): VoiceRouteState;
+    subscribeToRouteChanges?(listener: (state: VoiceRouteState) => void): () => void;
+}
+type NeuralVoiceAvailability = "available" | "unavailable";
+interface NeuralVoiceEngine {
+    availability(): Promise<NeuralVoiceAvailability>;
+    prewarm(commonPhrases: readonly string[]): Promise<void>;
+    synthesize(text: string, signal: AbortSignal): Promise<string>;
+    cancel(): Promise<void>;
+    release?(filePath: string): Promise<void>;
+    dispose(): Promise<void>;
+}
+/** Cloud TTS endpoint the SDK posts announcement text to (see apps/proxy /voice/tts). */
+interface VoiceTtsOptions {
+    readonly url: string;
+    /** Extra request headers, e.g. partner bearer tokens. Re-evaluated per request. */
+    readonly headers?: () => Readonly<Record<string, string>> | Promise<Readonly<Record<string, string>>>;
+    readonly voiceName?: string;
+    readonly languageCode?: string;
+    readonly requestTimeoutMs?: number;
+}
+type VoiceErrorCode = "engine_unavailable" | "network_unavailable" | "synthesis_failed" | "storage_failure" | "playback_failed";
+declare class VoiceError extends Error {
+    readonly code: VoiceErrorCode;
+    readonly name = "VoiceError";
+    constructor(code: VoiceErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+interface MatchVoiceService {
+    readonly audioState: VoiceRouteState;
+    readonly lastError?: Error | null;
+    initialize(): Promise<void>;
+    subscribe(listener: () => void): () => void;
+    announce(previous: MatchSnapshot, current: MatchSnapshot, event: MatchEvent): void;
+    replayAnnouncement(): Promise<void>;
+    testSpeaker(): Promise<void>;
+    configureAudioMode?(mode: VoiceAudioMode): Promise<void>;
+    dispose(): Promise<void>;
+}
+
+export { type AnnouncementPlan as A, type CourtSide as C, type FallbackVoiceToken as F, type GameSnapshot as G, type MatchSnapshot as M, type NeuralVoiceEngine as N, type PendingCourtSwitch as P, type RallyAwardedEvent as R, type ServeState as S, type TeamScore as T, type VoiceAudioMode as V, type MatchEvent as a, type AudioPlayback as b, type VoiceRouteState as c, type VoiceTtsOptions as d, type MatchVoiceService as e, type AnnouncementKind as f, type NeuralVoiceAvailability as g, type VoiceAudioRoute as h, type VoiceDisconnectReason as i, VoiceError as j, type VoiceErrorCode as k, type MatchInputSource as l, type CourtSwitchConfirmedEvent as m, type MatchCorrection as n, type MatchCorrectedEvent as o, type MatchCreateInput as p, type MatchCreation as q, type MatchEndedEvent as r, type MatchEventUndoneEvent as s, type MatchCreatedEvent as t, type MatchFormat as u, type MatchPlayer as v, type MatchScoringMode as w, type MatchTeam as x, type MatchTeamId as y };

package/dist/types-CrmcX408.d.ts

@@ -0,0 +1,176 @@
+type MatchFormat = "singles" | "doubles";
+type MatchScoringMode = "rally" | "sideOut";
+type MatchTeamId = "A" | "B";
+type CourtSide = "left" | "right";
+type MatchInputSource = "local" | "remote" | "voice" | "ble" | "system";
+interface MatchPlayer {
+    readonly id: string;
+    readonly name: string;
+}
+interface MatchTeam {
+    readonly id: MatchTeamId;
+    readonly name?: string;
+    /** Defaults to the first player in the roster. */
+    readonly initialServerId?: string;
+    readonly players: readonly MatchPlayer[];
+}
+interface MatchCreateInput {
+    readonly id: string;
+    readonly format: MatchFormat;
+    readonly scoringMode: MatchScoringMode;
+    readonly targetScore?: number;
+    readonly initialServingTeam?: MatchTeamId;
+    readonly teams: Readonly<Record<MatchTeamId, MatchTeam>>;
+}
+interface TeamScore {
+    readonly A: number;
+    readonly B: number;
+}
+interface ServeState {
+    readonly teamId: MatchTeamId;
+    readonly playerId: string;
+    readonly serverNumber: 1 | 2;
+    readonly court: CourtSide;
+}
+interface GameSnapshot {
+    readonly number: 1 | 2 | 3;
+    readonly score: TeamScore;
+    readonly startingServingTeam: MatchTeamId;
+    readonly winner: MatchTeamId | null;
+    readonly midGameSwitchCompleted: boolean;
+}
+type PendingCourtSwitch = {
+    readonly reason: "gameEnd";
+    readonly game: 1 | 2;
+} | {
+    readonly reason: "gameThreeMidpoint";
+    readonly game: 3;
+};
+interface MatchSnapshot {
+    readonly id: string;
+    readonly format: MatchFormat;
+    readonly scoringMode: MatchScoringMode;
+    readonly targetScore: number;
+    readonly bestOf: 3;
+    readonly teams: Readonly<Record<MatchTeamId, MatchTeam>>;
+    readonly designatedServerByTeam: Readonly<Record<MatchTeamId, string>>;
+    readonly initialServingTeam: MatchTeamId;
+    readonly courtSides: Readonly<Record<CourtSide, MatchTeamId>>;
+    readonly playerCourts: Readonly<Record<string, CourtSide>>;
+    readonly games: readonly GameSnapshot[];
+    readonly currentGame: 1 | 2 | 3;
+    readonly gamesWon: TeamScore;
+    readonly serve: ServeState;
+    readonly pendingCourtSwitch: PendingCourtSwitch | null;
+    readonly status: "inProgress" | "completed" | "ended";
+    readonly winner: MatchTeamId | null;
+    readonly endReason: string | null;
+    readonly sequence: number;
+}
+interface MatchCorrection {
+    readonly score?: Partial<TeamScore>;
+    readonly serve?: ServeState;
+    readonly playerCourts?: Readonly<Record<string, CourtSide>>;
+}
+interface MatchEventBase {
+    readonly schemaVersion: 1;
+    readonly id: string;
+    readonly sequence: number;
+    readonly source: MatchInputSource;
+}
+interface MatchCreatedEvent extends MatchEventBase {
+    readonly type: "matchCreated";
+    readonly input: MatchCreateInput;
+    readonly snapshot: MatchSnapshot;
+}
+interface RallyAwardedEvent extends MatchEventBase {
+    readonly type: "rallyAwarded";
+    readonly displaySide: CourtSide;
+    readonly winnerTeamId: MatchTeamId;
+}
+interface CourtSwitchConfirmedEvent extends MatchEventBase {
+    readonly type: "courtSwitchConfirmed";
+    readonly pending: PendingCourtSwitch;
+}
+interface MatchCorrectedEvent extends MatchEventBase {
+    readonly type: "matchCorrected";
+    readonly correction: MatchCorrection;
+}
+interface MatchEndedEvent extends MatchEventBase {
+    readonly type: "matchEnded";
+    readonly reason: string;
+}
+interface MatchEventUndoneEvent extends MatchEventBase {
+    readonly type: "matchEventUndone";
+    readonly targetEventId: string;
+    readonly restoredSnapshot: MatchSnapshot;
+}
+type MatchEvent = MatchCreatedEvent | RallyAwardedEvent | CourtSwitchConfirmedEvent | MatchCorrectedEvent | MatchEndedEvent | MatchEventUndoneEvent;
+interface MatchCreation {
+    readonly snapshot: MatchSnapshot;
+    readonly events: readonly [MatchCreatedEvent];
+}
+
+type AnnouncementKind = "score" | "serviceChange" | "gamePoint" | "gameWon" | "courtSwitch" | "matchWon";
+type FallbackVoiceToken = `number-${number}` | "number-mot" | "number-lam" | `score-deu-${number}` | "score-deu-mot" | "score-deu-lam" | "server-1" | "server-2" | "court-left" | "court-right" | "service-change" | "game-point" | "game-won" | "court-switch" | "match-won" | "test-speaker";
+interface AnnouncementPlan {
+    readonly kind: AnnouncementKind;
+    readonly text: string;
+    readonly score?: readonly [number, number];
+    readonly fallbackTokens: readonly FallbackVoiceToken[];
+}
+type VoiceAudioRoute = "system" | "bluetoothA2DP" | "bluetoothHFP" | "speaker" | "headphones" | "unknown";
+type VoiceDisconnectReason = "oldDeviceUnavailable" | "becomingNoisy" | "unknown";
+interface VoiceRouteState {
+    readonly route: VoiceAudioRoute;
+    readonly interrupted: boolean;
+    readonly disconnectedReason: VoiceDisconnectReason | null;
+}
+type VoiceAudioMode = "offline" | "live";
+interface AudioPlayback {
+    configure(mode: VoiceAudioMode): Promise<void>;
+    play(source: string): Promise<void>;
+    stop(): Promise<void>;
+    dispose(): Promise<void>;
+    getRouteState(): VoiceRouteState;
+    subscribeToRouteChanges?(listener: (state: VoiceRouteState) => void): () => void;
+}
+type NeuralVoiceAvailability = "available" | "unavailable";
+interface NeuralVoiceEngine {
+    availability(): Promise<NeuralVoiceAvailability>;
+    prewarm(commonPhrases: readonly string[]): Promise<void>;
+    synthesize(text: string, signal: AbortSignal): Promise<string>;
+    cancel(): Promise<void>;
+    release?(filePath: string): Promise<void>;
+    dispose(): Promise<void>;
+}
+/** Cloud TTS endpoint the SDK posts announcement text to (see apps/proxy /voice/tts). */
+interface VoiceTtsOptions {
+    readonly url: string;
+    /** Extra request headers, e.g. partner bearer tokens. Re-evaluated per request. */
+    readonly headers?: () => Readonly<Record<string, string>> | Promise<Readonly<Record<string, string>>>;
+    readonly voiceName?: string;
+    readonly languageCode?: string;
+    readonly requestTimeoutMs?: number;
+}
+type VoiceErrorCode = "engine_unavailable" | "network_unavailable" | "synthesis_failed" | "storage_failure" | "playback_failed";
+declare class VoiceError extends Error {
+    readonly code: VoiceErrorCode;
+    readonly name = "VoiceError";
+    constructor(code: VoiceErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+interface MatchVoiceService {
+    readonly audioState: VoiceRouteState;
+    readonly lastError?: Error | null;
+    initialize(): Promise<void>;
+    subscribe(listener: () => void): () => void;
+    announce(previous: MatchSnapshot, current: MatchSnapshot, event: MatchEvent): void;
+    replayAnnouncement(): Promise<void>;
+    testSpeaker(): Promise<void>;
+    configureAudioMode?(mode: VoiceAudioMode): Promise<void>;
+    dispose(): Promise<void>;
+}
+
+export { type AnnouncementPlan as A, type CourtSide as C, type FallbackVoiceToken as F, type GameSnapshot as G, type MatchSnapshot as M, type NeuralVoiceEngine as N, type PendingCourtSwitch as P, type RallyAwardedEvent as R, type ServeState as S, type TeamScore as T, type VoiceAudioMode as V, type MatchEvent as a, type AudioPlayback as b, type VoiceRouteState as c, type VoiceTtsOptions as d, type MatchVoiceService as e, type AnnouncementKind as f, type NeuralVoiceAvailability as g, type VoiceAudioRoute as h, type VoiceDisconnectReason as i, VoiceError as j, type VoiceErrorCode as k, type MatchInputSource as l, type CourtSwitchConfirmedEvent as m, type MatchCorrection as n, type MatchCorrectedEvent as o, type MatchCreateInput as p, type MatchCreation as q, type MatchEndedEvent as r, type MatchEventUndoneEvent as s, type MatchCreatedEvent as t, type MatchFormat as u, type MatchPlayer as v, type MatchScoringMode as w, type MatchTeam as x, type MatchTeamId as y };

package/dist/types-DiKWjwvN.d.cts

@@ -0,0 +1,96 @@
+declare const BTHOME_SERVICE_UUID: "FCD2";
+type RemoteButtonAction = "single" | "double" | "long";
+type RemoteInputMode = "bthome" | "hidVolume" | "both";
+type RemoteMappedAction = "left" | "right" | "undo" | "announce" | "none";
+interface RemoteActionMapping {
+    readonly volumeUp: RemoteMappedAction;
+    readonly volumeDown: RemoteMappedAction;
+    readonly longPress: RemoteMappedAction;
+}
+declare const DEFAULT_REMOTE_ACTION_MAPPING: RemoteActionMapping;
+interface RemoteHidVolumeEvent {
+    readonly source: "hidVolume";
+    readonly direction: "volumeUp" | "volumeDown";
+    readonly repeat: boolean;
+    readonly longPress: boolean;
+    readonly timestamp: number;
+}
+type RemoteHidGesture = "single" | "double" | "triple" | "quadruple" | "hold";
+interface RemoteHidGestureMapping {
+    /** Raw HID direction emitted by the calibrated remote button, or "any" for single-button remotes that alternate directions. */
+    readonly direction: RemoteHidVolumeEvent["direction"] | "any";
+    /** Quiet window used to close one physical gesture burst. */
+    readonly settleMs: number;
+    /** Repeated volume changes required to classify a hold before the burst ends. */
+    readonly holdEventCount: number;
+    readonly single: RemoteMappedAction;
+    readonly double: RemoteMappedAction;
+    readonly triple?: RemoteMappedAction;
+    readonly quadruple?: RemoteMappedAction;
+    readonly hold: RemoteMappedAction;
+}
+interface RemoteBinding {
+    /** Stable identifier supplied by CoreBluetooth or BluetoothLeScanner. */
+    readonly deviceId: string;
+    readonly label?: string;
+}
+type RemotePermissionStatus = "unknown" | "granted" | "denied" | "restricted" | "unavailable";
+type RemoteStatus = "unavailable" | "poweredOff" | "idle" | "scanning" | "bound" | "outOfRange";
+interface RemoteCandidate {
+    readonly deviceId: string;
+    readonly label?: string;
+    readonly rssi: number;
+    readonly lastSeenAt: number;
+}
+interface RemoteState {
+    readonly status: RemoteStatus;
+    readonly permission: RemotePermissionStatus;
+    readonly binding: RemoteBinding | null;
+    readonly candidate: RemoteCandidate | null;
+    readonly lastSeenAt: number | null;
+    readonly error: RemoteError | null;
+    readonly hidCaptureArmed: boolean;
+    readonly lastInputSource: "bthome" | "hidVolume" | null;
+    readonly lastHidEvent: RemoteHidVolumeEvent | null;
+}
+type RemoteErrorCode = "permission_denied" | "permission_restricted" | "bluetooth_unavailable" | "bluetooth_powered_off" | "scan_failed" | "native_unavailable";
+declare class RemoteError extends Error {
+    readonly code: RemoteErrorCode;
+    readonly name = "RemoteError";
+    constructor(code: RemoteErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+interface RemoteScanAdvertisement {
+    readonly deviceId: string;
+    readonly name?: string;
+    readonly rssi: number;
+    readonly serviceUuid: string;
+    /** Base64 encoded FCD2 service-data payload, beginning with the device-info byte. */
+    readonly serviceData: string;
+    readonly timestamp: number;
+}
+type RemoteNativeState = {
+    readonly status: "permission";
+    readonly permission: RemotePermissionStatus;
+} | {
+    readonly status: "poweredOff" | "unavailable" | "scanning" | "idle";
+} | {
+    readonly status: "error";
+    readonly code: string;
+    readonly message: string;
+};
+interface RemoteService {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    dispose(): Promise<void>;
+    subscribeAdvertisement(listener: (event: RemoteScanAdvertisement) => void): () => void;
+    subscribeState(listener: (event: RemoteNativeState) => void): () => void;
+    startHidCapture(options?: {
+        consume?: boolean;
+    }): Promise<void>;
+    stopHidCapture(): Promise<void>;
+    subscribeHidVolume(listener: (event: RemoteHidVolumeEvent) => void): () => void;
+}
+
+export { BTHOME_SERVICE_UUID as B, DEFAULT_REMOTE_ACTION_MAPPING as D, type RemoteButtonAction as R, type RemoteHidGestureMapping as a, type RemoteHidGesture as b, type RemoteHidVolumeEvent as c, type RemoteActionMapping as d, type RemoteBinding as e, type RemoteCandidate as f, RemoteError as g, type RemoteErrorCode as h, type RemoteInputMode as i, type RemoteMappedAction as j, type RemoteNativeState as k, type RemotePermissionStatus as l, type RemoteScanAdvertisement as m, type RemoteService as n, type RemoteState as o, type RemoteStatus as p };

package/dist/types-DiKWjwvN.d.ts

@@ -0,0 +1,96 @@
+declare const BTHOME_SERVICE_UUID: "FCD2";
+type RemoteButtonAction = "single" | "double" | "long";
+type RemoteInputMode = "bthome" | "hidVolume" | "both";
+type RemoteMappedAction = "left" | "right" | "undo" | "announce" | "none";
+interface RemoteActionMapping {
+    readonly volumeUp: RemoteMappedAction;
+    readonly volumeDown: RemoteMappedAction;
+    readonly longPress: RemoteMappedAction;
+}
+declare const DEFAULT_REMOTE_ACTION_MAPPING: RemoteActionMapping;
+interface RemoteHidVolumeEvent {
+    readonly source: "hidVolume";
+    readonly direction: "volumeUp" | "volumeDown";
+    readonly repeat: boolean;
+    readonly longPress: boolean;
+    readonly timestamp: number;
+}
+type RemoteHidGesture = "single" | "double" | "triple" | "quadruple" | "hold";
+interface RemoteHidGestureMapping {
+    /** Raw HID direction emitted by the calibrated remote button, or "any" for single-button remotes that alternate directions. */
+    readonly direction: RemoteHidVolumeEvent["direction"] | "any";
+    /** Quiet window used to close one physical gesture burst. */
+    readonly settleMs: number;
+    /** Repeated volume changes required to classify a hold before the burst ends. */
+    readonly holdEventCount: number;
+    readonly single: RemoteMappedAction;
+    readonly double: RemoteMappedAction;
+    readonly triple?: RemoteMappedAction;
+    readonly quadruple?: RemoteMappedAction;
+    readonly hold: RemoteMappedAction;
+}
+interface RemoteBinding {
+    /** Stable identifier supplied by CoreBluetooth or BluetoothLeScanner. */
+    readonly deviceId: string;
+    readonly label?: string;
+}
+type RemotePermissionStatus = "unknown" | "granted" | "denied" | "restricted" | "unavailable";
+type RemoteStatus = "unavailable" | "poweredOff" | "idle" | "scanning" | "bound" | "outOfRange";
+interface RemoteCandidate {
+    readonly deviceId: string;
+    readonly label?: string;
+    readonly rssi: number;
+    readonly lastSeenAt: number;
+}
+interface RemoteState {
+    readonly status: RemoteStatus;
+    readonly permission: RemotePermissionStatus;
+    readonly binding: RemoteBinding | null;
+    readonly candidate: RemoteCandidate | null;
+    readonly lastSeenAt: number | null;
+    readonly error: RemoteError | null;
+    readonly hidCaptureArmed: boolean;
+    readonly lastInputSource: "bthome" | "hidVolume" | null;
+    readonly lastHidEvent: RemoteHidVolumeEvent | null;
+}
+type RemoteErrorCode = "permission_denied" | "permission_restricted" | "bluetooth_unavailable" | "bluetooth_powered_off" | "scan_failed" | "native_unavailable";
+declare class RemoteError extends Error {
+    readonly code: RemoteErrorCode;
+    readonly name = "RemoteError";
+    constructor(code: RemoteErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+interface RemoteScanAdvertisement {
+    readonly deviceId: string;
+    readonly name?: string;
+    readonly rssi: number;
+    readonly serviceUuid: string;
+    /** Base64 encoded FCD2 service-data payload, beginning with the device-info byte. */
+    readonly serviceData: string;
+    readonly timestamp: number;
+}
+type RemoteNativeState = {
+    readonly status: "permission";
+    readonly permission: RemotePermissionStatus;
+} | {
+    readonly status: "poweredOff" | "unavailable" | "scanning" | "idle";
+} | {
+    readonly status: "error";
+    readonly code: string;
+    readonly message: string;
+};
+interface RemoteService {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    dispose(): Promise<void>;
+    subscribeAdvertisement(listener: (event: RemoteScanAdvertisement) => void): () => void;
+    subscribeState(listener: (event: RemoteNativeState) => void): () => void;
+    startHidCapture(options?: {
+        consume?: boolean;
+    }): Promise<void>;
+    stopHidCapture(): Promise<void>;
+    subscribeHidVolume(listener: (event: RemoteHidVolumeEvent) => void): () => void;
+}
+
+export { BTHOME_SERVICE_UUID as B, DEFAULT_REMOTE_ACTION_MAPPING as D, type RemoteButtonAction as R, type RemoteHidGestureMapping as a, type RemoteHidGesture as b, type RemoteHidVolumeEvent as c, type RemoteActionMapping as d, type RemoteBinding as e, type RemoteCandidate as f, RemoteError as g, type RemoteErrorCode as h, type RemoteInputMode as i, type RemoteMappedAction as j, type RemoteNativeState as k, type RemotePermissionStatus as l, type RemoteScanAdvertisement as m, type RemoteService as n, type RemoteState as o, type RemoteStatus as p };