@pickleball/expo-sdk 0.1.1 → 1.0.0

package/dist/plugin.d.cts

@@ -1,10 +1,37 @@
 import { ConfigPlugin } from 'expo/config-plugins';
 
+/**
+ * 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).
+ */
+declare const PLUGIN_SCHEMA_VERSION = "1";
 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;
@@ -18,4 +45,4 @@ interface PickleballLivePluginProps {
 declare function injectHidVolumeMainActivity(source: string): string;
 declare const _default: ConfigPlugin<PickleballLivePluginProps | undefined>;
 
-export { type PickleballLivePluginProps, _default as default, injectHidVolumeMainActivity };
+export { PLUGIN_SCHEMA_VERSION, type PickleballLivePluginProps, _default as default, injectHidVolumeMainActivity };

package/dist/plugin.d.ts

@@ -1,10 +1,37 @@
 import { ConfigPlugin } from 'expo/config-plugins';
 
+/**
+ * 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).
+ */
+declare const PLUGIN_SCHEMA_VERSION = "1";
 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;
@@ -18,4 +45,4 @@ interface PickleballLivePluginProps {
 declare function injectHidVolumeMainActivity(source: string): string;
 declare const _default: ConfigPlugin<PickleballLivePluginProps | undefined>;
 
-export { type PickleballLivePluginProps, _default as default, injectHidVolumeMainActivity };
+export { PLUGIN_SCHEMA_VERSION, type PickleballLivePluginProps, _default as default, injectHidVolumeMainActivity };

package/dist/plugin.js

@@ -1,6 +1,4 @@
-import {
-  PICKLEBALL_EXPO_SDK_VERSION
-} from "./chunk-VHLUJQG5.js";
+import "./chunk-KFQGP6VL.js";
 
 // src/plugin.ts
 import {
@@ -8,24 +6,29 @@ import {
   createRunOncePlugin,
   withAndroidManifest,
   withDangerousMod,
-  withInfoPlist,
-  withPlugins
+  withInfoPlist
 } from "expo/config-plugins";
 import { readdir, readFile, writeFile } from "fs/promises";
 import { join } from "path";
-var ANDROID_PERMISSIONS = [
+var PLUGIN_SCHEMA_VERSION = "1";
+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.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"
 ];
+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,19 +63,18 @@ 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.";
-  config = withPlugins(config, [
-    ["@livekit/react-native-expo-plugin", props?.liveKit]
-  ]);
+  const remoteEnabled = props?.modules?.remote !== false;
+  const androidPermissions = remoteEnabled ? [...CORE_ANDROID_PERMISSIONS, ...REMOTE_ANDROID_PERMISSIONS] : [...CORE_ANDROID_PERMISSIONS];
   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"] ?? [];
@@ -89,7 +91,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 +99,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);
@@ -123,9 +125,10 @@ var withPickleballLive = (config, props = {}) => {
 var plugin_default = createRunOncePlugin(
   withPickleballLive,
   "@pickleball/expo-sdk",
-  PICKLEBALL_EXPO_SDK_VERSION
+  PLUGIN_SCHEMA_VERSION
 );
 export {
+  PLUGIN_SCHEMA_VERSION,
   plugin_default as default,
   injectHidVolumeMainActivity
 };

package/dist/realtime/index.cjs

@@ -0,0 +1,31 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunk6YE5BL3Acjs = require('../chunk-6YE5BL3A.cjs');
+require('../chunk-7OX2DSKI.cjs');
+
+// src/realtime/index.ts
+function createGrantCommandSubscription(getConvexUrl) {
+  const clients = /* @__PURE__ */ new Map();
+  return {
+    subscribe(credentials, sessionId, onCommands, onError) {
+      const url = getConvexUrl();
+      if (!url) return () => void 0;
+      let realtime = clients.get(url);
+      if (!realtime) {
+        realtime = _chunk6YE5BL3Acjs.createConvexDeviceRealtime.call(void 0, url);
+        clients.set(url, realtime);
+      }
+      return realtime.commandSubscription.subscribe(credentials, sessionId, onCommands, onError);
+    },
+    dispose() {
+      for (const realtime of clients.values()) realtime.dispose();
+      clients.clear();
+    }
+  };
+}
+
+
+
+
+exports.createConvexCommandSubscription = _chunk6YE5BL3Acjs.createConvexCommandSubscription; exports.createConvexDeviceRealtime = _chunk6YE5BL3Acjs.createConvexDeviceRealtime; exports.createGrantCommandSubscription = createGrantCommandSubscription;

package/dist/realtime/index.d.cts

@@ -0,0 +1,15 @@
+export { C as ConvexDeviceRealtime, c as createConvexCommandSubscription, a as createConvexDeviceRealtime } from '../convex-command-subscription-DUgpu75l.cjs';
+import { S as SessionCommandSubscription } from '../engine-BSvSdCSE.cjs';
+
+/**
+ * Subscription cho app dùng camera grant: URL Convex nằm TRONG grant
+ * (`grant.convexUrl`) nên chỉ biết sau khi start — đọc URL lúc engine subscribe
+ * (ngay sau khi vào phiên), dựng MỘT client mỗi origin và tái dùng qua các
+ * phiên. Không có URL (deployment không lộ origin chuẩn) → không subscribe,
+ * engine giữ poll HTTP như cũ.
+ *
+ * Dùng với createCameraGrantProvider: `() => provider.getActiveGrant()?.convexUrl`.
+ */
+declare function createGrantCommandSubscription(getConvexUrl: () => string | null | undefined): SessionCommandSubscription;
+
+export { createGrantCommandSubscription };

package/dist/realtime/index.d.ts

@@ -0,0 +1,15 @@
+export { C as ConvexDeviceRealtime, c as createConvexCommandSubscription, a as createConvexDeviceRealtime } from '../convex-command-subscription-Cabh9tND.js';
+import { S as SessionCommandSubscription } from '../engine-BSvSdCSE.js';
+
+/**
+ * Subscription cho app dùng camera grant: URL Convex nằm TRONG grant
+ * (`grant.convexUrl`) nên chỉ biết sau khi start — đọc URL lúc engine subscribe
+ * (ngay sau khi vào phiên), dựng MỘT client mỗi origin và tái dùng qua các
+ * phiên. Không có URL (deployment không lộ origin chuẩn) → không subscribe,
+ * engine giữ poll HTTP như cũ.
+ *
+ * Dùng với createCameraGrantProvider: `() => provider.getActiveGrant()?.convexUrl`.
+ */
+declare function createGrantCommandSubscription(getConvexUrl: () => string | null | undefined): SessionCommandSubscription;
+
+export { createGrantCommandSubscription };

package/dist/realtime/index.js

@@ -0,0 +1,31 @@
+import {
+  createConvexCommandSubscription,
+  createConvexDeviceRealtime
+} from "../chunk-6F3HN6US.js";
+import "../chunk-KFQGP6VL.js";
+
+// src/realtime/index.ts
+function createGrantCommandSubscription(getConvexUrl) {
+  const clients = /* @__PURE__ */ new Map();
+  return {
+    subscribe(credentials, sessionId, onCommands, onError) {
+      const url = getConvexUrl();
+      if (!url) return () => void 0;
+      let realtime = clients.get(url);
+      if (!realtime) {
+        realtime = createConvexDeviceRealtime(url);
+        clients.set(url, realtime);
+      }
+      return realtime.commandSubscription.subscribe(credentials, sessionId, onCommands, onError);
+    },
+    dispose() {
+      for (const realtime of clients.values()) realtime.dispose();
+      clients.clear();
+    }
+  };
+}
+export {
+  createConvexCommandSubscription,
+  createConvexDeviceRealtime,
+  createGrantCommandSubscription
+};

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 };