@pickleball/expo-sdk 0.1.1 → 0.2.0

package/dist/match/index.d.cts

@@ -0,0 +1,253 @@
+import { M as MatchSnapshot, a as MatchEvent, C as CourtSide, l as MatchInputSource, R as RallyAwardedEvent, m as CourtSwitchConfirmedEvent, n as MatchCorrection, o as MatchCorrectedEvent, p as MatchCreateInput, q as MatchCreation, r as MatchEndedEvent, s as MatchEventUndoneEvent, c as VoiceRouteState, V as VoiceAudioMode, e as MatchVoiceService, d as VoiceTtsOptions } from '../types-CrmcX408.cjs';
+export { G as GameSnapshot, t as MatchCreatedEvent, u as MatchFormat, v as MatchPlayer, w as MatchScoringMode, x as MatchTeam, y as MatchTeamId, P as PendingCourtSwitch, S as ServeState, T as TeamScore } from '../types-CrmcX408.cjs';
+import { e as RemoteBinding, o as RemoteState, n as RemoteService, i as RemoteInputMode, d as RemoteActionMapping, a as RemoteHidGestureMapping } from '../types-DiKWjwvN.cjs';
+export { c as RemoteHidVolumeEvent, j as RemoteMappedAction, k as RemoteNativeState, m as RemoteScanAdvertisement } from '../types-DiKWjwvN.cjs';
+import React, { ReactNode } from 'react';
+
+declare function createMatch(input: MatchCreateInput, source?: MatchInputSource): MatchCreation;
+declare function applyMatchEvent(snapshot: MatchSnapshot, event: MatchEvent): MatchSnapshot;
+declare function awardRally(snapshot: MatchSnapshot, displaySide: CourtSide, source?: MatchInputSource): RallyAwardedEvent | null;
+declare function confirmCourtSwitch(snapshot: MatchSnapshot, source?: MatchInputSource): CourtSwitchConfirmedEvent;
+declare function correctMatch(snapshot: MatchSnapshot, correction: MatchCorrection, source?: MatchInputSource): MatchCorrectedEvent;
+declare function endMatch(snapshot: MatchSnapshot, reason: string, source?: MatchInputSource): MatchEndedEvent;
+
+declare function replayMatchEvents(events: readonly unknown[]): MatchSnapshot;
+declare function undoLastMatchEvent(events: readonly MatchEvent[], source?: MatchInputSource): MatchEventUndoneEvent | null;
+
+declare const MATCH_PERSISTENCE_SCHEMA_VERSION: 1;
+interface StoredMatchRow {
+    readonly matchId: string;
+    readonly schemaVersion: number;
+    readonly snapshotJson: string;
+    readonly snapshotSequence: number;
+    readonly status: MatchSnapshot["status"];
+    readonly updatedAt: number;
+}
+interface StoredMatchEventRow {
+    readonly matchId: string;
+    readonly sequence: number;
+    readonly eventId: string;
+    readonly schemaVersion: number;
+    readonly eventJson: string;
+    readonly createdAt: number;
+}
+interface MatchPersistenceTransaction {
+    getMatch(matchId: string): Promise<StoredMatchRow | null>;
+    getEvents(matchId: string): Promise<readonly StoredMatchEventRow[]>;
+    insertMatch(row: StoredMatchRow): Promise<void>;
+    insertEvent(row: StoredMatchEventRow): Promise<void>;
+    updateSnapshot(matchId: string, expectedSequence: number, row: Pick<StoredMatchRow, "schemaVersion" | "snapshotJson" | "snapshotSequence" | "status" | "updatedAt">): Promise<boolean>;
+    setActiveMatch(matchId: string | null): Promise<void>;
+    clearActiveMatch(matchId: string): Promise<void>;
+}
+interface MatchPersistenceDriver {
+    migrate(): Promise<void>;
+    transaction<T>(work: (transaction: MatchPersistenceTransaction) => Promise<T>): Promise<T>;
+    readMatch(matchId: string): Promise<{
+        readonly match: StoredMatchRow | null;
+        readonly events: readonly StoredMatchEventRow[];
+    }>;
+    getActiveMatchId(): Promise<string | null>;
+    readActiveMatch(): Promise<{
+        readonly activeMatchId: string | null;
+        readonly match: StoredMatchRow | null;
+        readonly events: readonly StoredMatchEventRow[];
+    }>;
+    readMatchList(): Promise<{
+        readonly matches: readonly StoredMatchRow[];
+        readonly activeMatchId: string | null;
+    }>;
+    getRemoteBinding?(): Promise<RemoteBinding | null>;
+    setRemoteBinding?(binding: RemoteBinding | null): Promise<void>;
+}
+interface PersistedMatch {
+    readonly snapshot: MatchSnapshot;
+    readonly events: readonly MatchEvent[];
+}
+interface MatchSummary {
+    readonly id: string;
+    readonly sequence: number;
+    readonly status: MatchSnapshot["status"];
+    readonly updatedAt: number;
+    readonly isActive: boolean;
+}
+type MatchPersistenceErrorCode = "not_found" | "already_exists" | "conflict" | "corrupt_data" | "unsupported_schema" | "sequence_mismatch" | "snapshot_mismatch" | "storage_failure";
+declare class MatchPersistenceError extends Error {
+    readonly code: MatchPersistenceErrorCode;
+    readonly name = "MatchPersistenceError";
+    readonly recoverable = true;
+    readonly retryable: boolean;
+    constructor(code: MatchPersistenceErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+
+declare const MATCH_SQL_SCHEMA_VERSION: 2;
+declare const MATCH_SQL_MIGRATIONS: readonly ["CREATE TABLE IF NOT EXISTS match_aggregates (\n    match_id TEXT PRIMARY KEY NOT NULL,\n    schema_version INTEGER NOT NULL CHECK (schema_version = 1),\n    snapshot_json TEXT NOT NULL,\n    snapshot_sequence INTEGER NOT NULL CHECK (snapshot_sequence >= 0),\n    status TEXT NOT NULL CHECK (status IN ('inProgress', 'completed', 'ended')),\n    updated_at INTEGER NOT NULL\n  )", "CREATE TABLE IF NOT EXISTS match_events (\n    match_id TEXT NOT NULL,\n    sequence INTEGER NOT NULL CHECK (sequence >= 0),\n    event_id TEXT NOT NULL UNIQUE,\n    schema_version INTEGER NOT NULL CHECK (schema_version = 1),\n    event_json TEXT NOT NULL,\n    created_at INTEGER NOT NULL,\n    PRIMARY KEY (match_id, sequence),\n    FOREIGN KEY (match_id) REFERENCES match_aggregates(match_id) ON DELETE RESTRICT\n  )", "CREATE TABLE IF NOT EXISTS match_active_pointer (\n    slot INTEGER PRIMARY KEY NOT NULL CHECK (slot = 1),\n    match_id TEXT NOT NULL UNIQUE,\n    FOREIGN KEY (match_id) REFERENCES match_aggregates(match_id) ON DELETE RESTRICT\n  )", "CREATE INDEX IF NOT EXISTS match_aggregates_recent\n    ON match_aggregates(updated_at DESC)", "CREATE TRIGGER IF NOT EXISTS match_events_no_update\n    BEFORE UPDATE ON match_events\n    BEGIN SELECT RAISE(ABORT, 'match events are immutable'); END", "CREATE TRIGGER IF NOT EXISTS match_events_no_delete\n    BEFORE DELETE ON match_events\n    BEGIN SELECT RAISE(ABORT, 'match events are immutable'); END", "CREATE TABLE IF NOT EXISTS remote_binding (\n    slot INTEGER PRIMARY KEY NOT NULL CHECK (slot = 1),\n    device_id TEXT NOT NULL CHECK (length(trim(device_id)) > 0),\n    label TEXT\n  )"];
+
+interface MemoryState {
+    migrationVersion: number;
+    remoteBinding: RemoteBinding | null;
+    activeMatchId: string | null;
+    matches: StoredMatchRow[];
+    events: StoredMatchEventRow[];
+    nextOrdinal: number;
+    ordinals: Record<string, number>;
+}
+declare class MemoryMatchPersistenceDriver implements MatchPersistenceDriver {
+    private state;
+    private eventInsertFailure;
+    private snapshotUpdateFailure;
+    private transactionTail;
+    migrate(): Promise<void>;
+    getRemoteBinding(): Promise<{
+        deviceId: string;
+        label?: string;
+    } | null>;
+    setRemoteBinding(binding: RemoteBinding | null): Promise<void>;
+    getMigrationVersion(): number;
+    transaction<T>(work: (transaction: MatchPersistenceTransaction) => Promise<T>): Promise<T>;
+    readMatch(matchId: string): Promise<{
+        match: StoredMatchRow | null;
+        events: StoredMatchEventRow[];
+    }>;
+    getActiveMatchId(): Promise<string | null>;
+    readActiveMatch(): Promise<{
+        activeMatchId: null;
+        match: null;
+        events: never[];
+    } | {
+        activeMatchId: string;
+        match: StoredMatchRow | null;
+        events: StoredMatchEventRow[];
+    }>;
+    readMatchList(): Promise<{
+        matches: StoredMatchRow[];
+        activeMatchId: string | null;
+    }>;
+    inspect(): MemoryState;
+    failNextSnapshotUpdate(error: Error): void;
+    failNextEventInsert(error: Error): void;
+    corruptSnapshotJson(matchId: string, snapshotJson: string): void;
+    corruptEventJson(matchId: string, sequence: number, eventJson: string): void;
+    corruptEventSchema(matchId: string, sequence: number, schemaVersion: number): void;
+    corruptEventSequence(matchId: string, sequence: number): void;
+    duplicateEventRow(matchId: string, sequence: number): void;
+    removeEventRow(matchId: string, sequence: number): void;
+    private mutateMatch;
+    private mutateEvent;
+}
+
+interface SqlRunResult {
+    readonly changes: number;
+    readonly lastInsertRowId: number;
+}
+interface SqlExecutor {
+    runAsync(sql: string, ...params: unknown[]): Promise<SqlRunResult>;
+    getFirstAsync<T>(sql: string, ...params: unknown[]): Promise<T | null>;
+    getAllAsync<T>(sql: string, ...params: unknown[]): Promise<T[]>;
+}
+interface ExpoSqliteDatabaseLike extends SqlExecutor {
+    execAsync(sql: string): Promise<void>;
+}
+/**
+ * Serializes adapters sharing this exact connection object. Separate
+ * connections to the same file rely on SQLite locking plus busy_timeout.
+ */
+declare function createExpoSqliteMatchDriver(database: ExpoSqliteDatabaseLike): MatchPersistenceDriver;
+
+interface MatchEventStoreOptions {
+    readonly now?: () => number;
+}
+declare class MatchEventStore {
+    private readonly driver;
+    private initialized;
+    private readonly now;
+    constructor(driver: MatchPersistenceDriver, options?: MatchEventStoreOptions);
+    initialize(): Promise<void>;
+    getRemoteBinding(): Promise<RemoteBinding | null>;
+    setRemoteBinding(binding: RemoteBinding | null): Promise<void>;
+    createMatch(input: MatchCreateInput, source?: MatchInputSource): Promise<PersistedMatch>;
+    appendEvent(currentSnapshot: MatchSnapshot, event: MatchEvent): Promise<PersistedMatch>;
+    resumeActiveMatch(): Promise<PersistedMatch | null>;
+    resumeMatch(matchId: string): Promise<PersistedMatch | null>;
+    listMatches(): Promise<readonly MatchSummary[]>;
+    archiveMatch(matchId: string): Promise<void>;
+}
+
+declare function createDefaultMatchEventStore(_databaseName?: string): Promise<MatchEventStore>;
+
+interface PickleballMatchStore {
+    initialize(): Promise<void>;
+    createMatch(input: MatchCreateInput, source?: MatchInputSource): Promise<PersistedMatch>;
+    appendEvent(currentSnapshot: MatchSnapshot, event: MatchEvent): Promise<PersistedMatch>;
+    resumeMatch(matchId: string): Promise<PersistedMatch | null>;
+    resumeActiveMatch(): Promise<PersistedMatch | null>;
+    listMatches(): Promise<readonly MatchSummary[]>;
+    archiveMatch(matchId: string): Promise<void>;
+    getRemoteBinding?(): Promise<RemoteBinding | null>;
+    setRemoteBinding?(binding: RemoteBinding | null): Promise<void>;
+}
+declare class NoActiveMatchError extends Error {
+    readonly name = "NoActiveMatchError";
+    readonly code = "NO_ACTIVE_MATCH";
+    constructor();
+}
+/**
+ * State-changing actions reject with NoActiveMatchError when no match is loaded.
+ * Commands the engine deems ineligible are ignored and resolve the current snapshot.
+ */
+interface PickleballMatchContextValue {
+    readonly snapshot: MatchSnapshot | null;
+    readonly events: readonly MatchEvent[];
+    readonly loading: boolean;
+    readonly error: Error | null;
+    readonly voiceError: Error | null;
+    readonly audioState: VoiceRouteState;
+    readonly remoteState: RemoteState;
+    createMatch(input: MatchCreateInput, source?: MatchInputSource): Promise<MatchSnapshot>;
+    resumeMatch(matchId?: string): Promise<MatchSnapshot | null>;
+    awardRallyToSide(side: CourtSide, source?: MatchInputSource): Promise<MatchSnapshot>;
+    undo(source?: MatchInputSource): Promise<MatchSnapshot>;
+    correctState(correction: MatchCorrection, source?: MatchInputSource): Promise<MatchSnapshot>;
+    confirmCourtSwitch(source?: MatchInputSource): Promise<MatchSnapshot>;
+    endMatch(reason: string, source?: MatchInputSource): Promise<MatchSnapshot>;
+    testSpeaker(): Promise<void>;
+    replayAnnouncement(): Promise<void>;
+    setVoiceAudioMode(mode: VoiceAudioMode): Promise<void>;
+    bindRemote(binding: RemoteBinding): Promise<void>;
+    unbindRemote(): Promise<void>;
+    startRemoteScan(): Promise<void>;
+    stopRemoteScan(): Promise<void>;
+    startHidCapture(): Promise<void>;
+    stopHidCapture(): Promise<void>;
+}
+interface PickleballMatchProviderProps {
+    readonly children?: ReactNode;
+    /** Fixed for this provider instance. Remount to use a different local store. */
+    readonly store?: PickleballMatchStore;
+    /** Fixed for this provider instance. Remount to use a different factory. */
+    readonly storeFactory?: () => Promise<PickleballMatchStore>;
+    /** Resumes the active local match on mount. Disable for hosts that resume explicitly. */
+    readonly autoResume?: boolean;
+    readonly onError?: (error: Error) => void | Promise<void>;
+    /** Fixed for this provider instance. Primarily useful for custom storage and tests. */
+    readonly voiceService?: MatchVoiceService;
+    /** Initial audio session mode. Defaults to live so mounting never disables capture. */
+    readonly voiceAudioMode?: VoiceAudioMode;
+    /** Cloud TTS endpoint for announcements. Without it only bundled WAVs play. Fixed for this provider instance. */
+    readonly voiceTts?: VoiceTtsOptions;
+    /** Fixed for this provider instance. Primarily useful for tests and custom native bridges. */
+    readonly remoteService?: RemoteService;
+    /** Foreground silence before a bound remote becomes outOfRange. */
+    readonly remoteOutOfRangeTimeoutMs?: number;
+    readonly remoteInputMode?: RemoteInputMode;
+    readonly remoteActionMapping?: Partial<RemoteActionMapping>;
+    /** Optional single/double/hold recognizer for one calibrated HID volume button. */
+    readonly hidGestureMapping?: RemoteHidGestureMapping;
+    readonly consumeHidVolumeKeys?: boolean;
+}
+declare function PickleballMatchProvider({ children, store, storeFactory, autoResume, onError, voiceService, voiceAudioMode, voiceTts, remoteService, remoteOutOfRangeTimeoutMs, remoteInputMode, remoteActionMapping, hidGestureMapping, consumeHidVolumeKeys, }: PickleballMatchProviderProps): React.JSX.Element;
+declare function usePickleballMatch(): PickleballMatchContextValue;
+
+export { CourtSide, CourtSwitchConfirmedEvent, type ExpoSqliteDatabaseLike, MATCH_PERSISTENCE_SCHEMA_VERSION, MATCH_SQL_MIGRATIONS, MATCH_SQL_SCHEMA_VERSION, MatchCorrectedEvent, MatchCorrection, MatchCreateInput, MatchCreation, MatchEndedEvent, MatchEvent, MatchEventStore, MatchEventUndoneEvent, MatchInputSource, type MatchPersistenceDriver, MatchPersistenceError, type MatchPersistenceErrorCode, type MatchPersistenceTransaction, MatchSnapshot, type MatchSummary, MatchVoiceService, MemoryMatchPersistenceDriver, NoActiveMatchError, type PersistedMatch, type PickleballMatchContextValue, PickleballMatchProvider, type PickleballMatchProviderProps, type PickleballMatchStore, RallyAwardedEvent, RemoteActionMapping, RemoteBinding, RemoteHidGestureMapping, RemoteInputMode, RemoteService, RemoteState, type StoredMatchEventRow, type StoredMatchRow, VoiceAudioMode, VoiceRouteState, VoiceTtsOptions, applyMatchEvent, awardRally, confirmCourtSwitch, correctMatch, createDefaultMatchEventStore, createExpoSqliteMatchDriver, createMatch, endMatch, replayMatchEvents, undoLastMatchEvent, usePickleballMatch };

package/dist/match/index.d.ts

@@ -0,0 +1,253 @@
+import { M as MatchSnapshot, a as MatchEvent, C as CourtSide, l as MatchInputSource, R as RallyAwardedEvent, m as CourtSwitchConfirmedEvent, n as MatchCorrection, o as MatchCorrectedEvent, p as MatchCreateInput, q as MatchCreation, r as MatchEndedEvent, s as MatchEventUndoneEvent, c as VoiceRouteState, V as VoiceAudioMode, e as MatchVoiceService, d as VoiceTtsOptions } from '../types-CrmcX408.js';
+export { G as GameSnapshot, t as MatchCreatedEvent, u as MatchFormat, v as MatchPlayer, w as MatchScoringMode, x as MatchTeam, y as MatchTeamId, P as PendingCourtSwitch, S as ServeState, T as TeamScore } from '../types-CrmcX408.js';
+import { e as RemoteBinding, o as RemoteState, n as RemoteService, i as RemoteInputMode, d as RemoteActionMapping, a as RemoteHidGestureMapping } from '../types-DiKWjwvN.js';
+export { c as RemoteHidVolumeEvent, j as RemoteMappedAction, k as RemoteNativeState, m as RemoteScanAdvertisement } from '../types-DiKWjwvN.js';
+import React, { ReactNode } from 'react';
+
+declare function createMatch(input: MatchCreateInput, source?: MatchInputSource): MatchCreation;
+declare function applyMatchEvent(snapshot: MatchSnapshot, event: MatchEvent): MatchSnapshot;
+declare function awardRally(snapshot: MatchSnapshot, displaySide: CourtSide, source?: MatchInputSource): RallyAwardedEvent | null;
+declare function confirmCourtSwitch(snapshot: MatchSnapshot, source?: MatchInputSource): CourtSwitchConfirmedEvent;
+declare function correctMatch(snapshot: MatchSnapshot, correction: MatchCorrection, source?: MatchInputSource): MatchCorrectedEvent;
+declare function endMatch(snapshot: MatchSnapshot, reason: string, source?: MatchInputSource): MatchEndedEvent;
+
+declare function replayMatchEvents(events: readonly unknown[]): MatchSnapshot;
+declare function undoLastMatchEvent(events: readonly MatchEvent[], source?: MatchInputSource): MatchEventUndoneEvent | null;
+
+declare const MATCH_PERSISTENCE_SCHEMA_VERSION: 1;
+interface StoredMatchRow {
+    readonly matchId: string;
+    readonly schemaVersion: number;
+    readonly snapshotJson: string;
+    readonly snapshotSequence: number;
+    readonly status: MatchSnapshot["status"];
+    readonly updatedAt: number;
+}
+interface StoredMatchEventRow {
+    readonly matchId: string;
+    readonly sequence: number;
+    readonly eventId: string;
+    readonly schemaVersion: number;
+    readonly eventJson: string;
+    readonly createdAt: number;
+}
+interface MatchPersistenceTransaction {
+    getMatch(matchId: string): Promise<StoredMatchRow | null>;
+    getEvents(matchId: string): Promise<readonly StoredMatchEventRow[]>;
+    insertMatch(row: StoredMatchRow): Promise<void>;
+    insertEvent(row: StoredMatchEventRow): Promise<void>;
+    updateSnapshot(matchId: string, expectedSequence: number, row: Pick<StoredMatchRow, "schemaVersion" | "snapshotJson" | "snapshotSequence" | "status" | "updatedAt">): Promise<boolean>;
+    setActiveMatch(matchId: string | null): Promise<void>;
+    clearActiveMatch(matchId: string): Promise<void>;
+}
+interface MatchPersistenceDriver {
+    migrate(): Promise<void>;
+    transaction<T>(work: (transaction: MatchPersistenceTransaction) => Promise<T>): Promise<T>;
+    readMatch(matchId: string): Promise<{
+        readonly match: StoredMatchRow | null;
+        readonly events: readonly StoredMatchEventRow[];
+    }>;
+    getActiveMatchId(): Promise<string | null>;
+    readActiveMatch(): Promise<{
+        readonly activeMatchId: string | null;
+        readonly match: StoredMatchRow | null;
+        readonly events: readonly StoredMatchEventRow[];
+    }>;
+    readMatchList(): Promise<{
+        readonly matches: readonly StoredMatchRow[];
+        readonly activeMatchId: string | null;
+    }>;
+    getRemoteBinding?(): Promise<RemoteBinding | null>;
+    setRemoteBinding?(binding: RemoteBinding | null): Promise<void>;
+}
+interface PersistedMatch {
+    readonly snapshot: MatchSnapshot;
+    readonly events: readonly MatchEvent[];
+}
+interface MatchSummary {
+    readonly id: string;
+    readonly sequence: number;
+    readonly status: MatchSnapshot["status"];
+    readonly updatedAt: number;
+    readonly isActive: boolean;
+}
+type MatchPersistenceErrorCode = "not_found" | "already_exists" | "conflict" | "corrupt_data" | "unsupported_schema" | "sequence_mismatch" | "snapshot_mismatch" | "storage_failure";
+declare class MatchPersistenceError extends Error {
+    readonly code: MatchPersistenceErrorCode;
+    readonly name = "MatchPersistenceError";
+    readonly recoverable = true;
+    readonly retryable: boolean;
+    constructor(code: MatchPersistenceErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+
+declare const MATCH_SQL_SCHEMA_VERSION: 2;
+declare const MATCH_SQL_MIGRATIONS: readonly ["CREATE TABLE IF NOT EXISTS match_aggregates (\n    match_id TEXT PRIMARY KEY NOT NULL,\n    schema_version INTEGER NOT NULL CHECK (schema_version = 1),\n    snapshot_json TEXT NOT NULL,\n    snapshot_sequence INTEGER NOT NULL CHECK (snapshot_sequence >= 0),\n    status TEXT NOT NULL CHECK (status IN ('inProgress', 'completed', 'ended')),\n    updated_at INTEGER NOT NULL\n  )", "CREATE TABLE IF NOT EXISTS match_events (\n    match_id TEXT NOT NULL,\n    sequence INTEGER NOT NULL CHECK (sequence >= 0),\n    event_id TEXT NOT NULL UNIQUE,\n    schema_version INTEGER NOT NULL CHECK (schema_version = 1),\n    event_json TEXT NOT NULL,\n    created_at INTEGER NOT NULL,\n    PRIMARY KEY (match_id, sequence),\n    FOREIGN KEY (match_id) REFERENCES match_aggregates(match_id) ON DELETE RESTRICT\n  )", "CREATE TABLE IF NOT EXISTS match_active_pointer (\n    slot INTEGER PRIMARY KEY NOT NULL CHECK (slot = 1),\n    match_id TEXT NOT NULL UNIQUE,\n    FOREIGN KEY (match_id) REFERENCES match_aggregates(match_id) ON DELETE RESTRICT\n  )", "CREATE INDEX IF NOT EXISTS match_aggregates_recent\n    ON match_aggregates(updated_at DESC)", "CREATE TRIGGER IF NOT EXISTS match_events_no_update\n    BEFORE UPDATE ON match_events\n    BEGIN SELECT RAISE(ABORT, 'match events are immutable'); END", "CREATE TRIGGER IF NOT EXISTS match_events_no_delete\n    BEFORE DELETE ON match_events\n    BEGIN SELECT RAISE(ABORT, 'match events are immutable'); END", "CREATE TABLE IF NOT EXISTS remote_binding (\n    slot INTEGER PRIMARY KEY NOT NULL CHECK (slot = 1),\n    device_id TEXT NOT NULL CHECK (length(trim(device_id)) > 0),\n    label TEXT\n  )"];
+
+interface MemoryState {
+    migrationVersion: number;
+    remoteBinding: RemoteBinding | null;
+    activeMatchId: string | null;
+    matches: StoredMatchRow[];
+    events: StoredMatchEventRow[];
+    nextOrdinal: number;
+    ordinals: Record<string, number>;
+}
+declare class MemoryMatchPersistenceDriver implements MatchPersistenceDriver {
+    private state;
+    private eventInsertFailure;
+    private snapshotUpdateFailure;
+    private transactionTail;
+    migrate(): Promise<void>;
+    getRemoteBinding(): Promise<{
+        deviceId: string;
+        label?: string;
+    } | null>;
+    setRemoteBinding(binding: RemoteBinding | null): Promise<void>;
+    getMigrationVersion(): number;
+    transaction<T>(work: (transaction: MatchPersistenceTransaction) => Promise<T>): Promise<T>;
+    readMatch(matchId: string): Promise<{
+        match: StoredMatchRow | null;
+        events: StoredMatchEventRow[];
+    }>;
+    getActiveMatchId(): Promise<string | null>;
+    readActiveMatch(): Promise<{
+        activeMatchId: null;
+        match: null;
+        events: never[];
+    } | {
+        activeMatchId: string;
+        match: StoredMatchRow | null;
+        events: StoredMatchEventRow[];
+    }>;
+    readMatchList(): Promise<{
+        matches: StoredMatchRow[];
+        activeMatchId: string | null;
+    }>;
+    inspect(): MemoryState;
+    failNextSnapshotUpdate(error: Error): void;
+    failNextEventInsert(error: Error): void;
+    corruptSnapshotJson(matchId: string, snapshotJson: string): void;
+    corruptEventJson(matchId: string, sequence: number, eventJson: string): void;
+    corruptEventSchema(matchId: string, sequence: number, schemaVersion: number): void;
+    corruptEventSequence(matchId: string, sequence: number): void;
+    duplicateEventRow(matchId: string, sequence: number): void;
+    removeEventRow(matchId: string, sequence: number): void;
+    private mutateMatch;
+    private mutateEvent;
+}
+
+interface SqlRunResult {
+    readonly changes: number;
+    readonly lastInsertRowId: number;
+}
+interface SqlExecutor {
+    runAsync(sql: string, ...params: unknown[]): Promise<SqlRunResult>;
+    getFirstAsync<T>(sql: string, ...params: unknown[]): Promise<T | null>;
+    getAllAsync<T>(sql: string, ...params: unknown[]): Promise<T[]>;
+}
+interface ExpoSqliteDatabaseLike extends SqlExecutor {
+    execAsync(sql: string): Promise<void>;
+}
+/**
+ * Serializes adapters sharing this exact connection object. Separate
+ * connections to the same file rely on SQLite locking plus busy_timeout.
+ */
+declare function createExpoSqliteMatchDriver(database: ExpoSqliteDatabaseLike): MatchPersistenceDriver;
+
+interface MatchEventStoreOptions {
+    readonly now?: () => number;
+}
+declare class MatchEventStore {
+    private readonly driver;
+    private initialized;
+    private readonly now;
+    constructor(driver: MatchPersistenceDriver, options?: MatchEventStoreOptions);
+    initialize(): Promise<void>;
+    getRemoteBinding(): Promise<RemoteBinding | null>;
+    setRemoteBinding(binding: RemoteBinding | null): Promise<void>;
+    createMatch(input: MatchCreateInput, source?: MatchInputSource): Promise<PersistedMatch>;
+    appendEvent(currentSnapshot: MatchSnapshot, event: MatchEvent): Promise<PersistedMatch>;
+    resumeActiveMatch(): Promise<PersistedMatch | null>;
+    resumeMatch(matchId: string): Promise<PersistedMatch | null>;
+    listMatches(): Promise<readonly MatchSummary[]>;
+    archiveMatch(matchId: string): Promise<void>;
+}
+
+declare function createDefaultMatchEventStore(_databaseName?: string): Promise<MatchEventStore>;
+
+interface PickleballMatchStore {
+    initialize(): Promise<void>;
+    createMatch(input: MatchCreateInput, source?: MatchInputSource): Promise<PersistedMatch>;
+    appendEvent(currentSnapshot: MatchSnapshot, event: MatchEvent): Promise<PersistedMatch>;
+    resumeMatch(matchId: string): Promise<PersistedMatch | null>;
+    resumeActiveMatch(): Promise<PersistedMatch | null>;
+    listMatches(): Promise<readonly MatchSummary[]>;
+    archiveMatch(matchId: string): Promise<void>;
+    getRemoteBinding?(): Promise<RemoteBinding | null>;
+    setRemoteBinding?(binding: RemoteBinding | null): Promise<void>;
+}
+declare class NoActiveMatchError extends Error {
+    readonly name = "NoActiveMatchError";
+    readonly code = "NO_ACTIVE_MATCH";
+    constructor();
+}
+/**
+ * State-changing actions reject with NoActiveMatchError when no match is loaded.
+ * Commands the engine deems ineligible are ignored and resolve the current snapshot.
+ */
+interface PickleballMatchContextValue {
+    readonly snapshot: MatchSnapshot | null;
+    readonly events: readonly MatchEvent[];
+    readonly loading: boolean;
+    readonly error: Error | null;
+    readonly voiceError: Error | null;
+    readonly audioState: VoiceRouteState;
+    readonly remoteState: RemoteState;
+    createMatch(input: MatchCreateInput, source?: MatchInputSource): Promise<MatchSnapshot>;
+    resumeMatch(matchId?: string): Promise<MatchSnapshot | null>;
+    awardRallyToSide(side: CourtSide, source?: MatchInputSource): Promise<MatchSnapshot>;
+    undo(source?: MatchInputSource): Promise<MatchSnapshot>;
+    correctState(correction: MatchCorrection, source?: MatchInputSource): Promise<MatchSnapshot>;
+    confirmCourtSwitch(source?: MatchInputSource): Promise<MatchSnapshot>;
+    endMatch(reason: string, source?: MatchInputSource): Promise<MatchSnapshot>;
+    testSpeaker(): Promise<void>;
+    replayAnnouncement(): Promise<void>;
+    setVoiceAudioMode(mode: VoiceAudioMode): Promise<void>;
+    bindRemote(binding: RemoteBinding): Promise<void>;
+    unbindRemote(): Promise<void>;
+    startRemoteScan(): Promise<void>;
+    stopRemoteScan(): Promise<void>;
+    startHidCapture(): Promise<void>;
+    stopHidCapture(): Promise<void>;
+}
+interface PickleballMatchProviderProps {
+    readonly children?: ReactNode;
+    /** Fixed for this provider instance. Remount to use a different local store. */
+    readonly store?: PickleballMatchStore;
+    /** Fixed for this provider instance. Remount to use a different factory. */
+    readonly storeFactory?: () => Promise<PickleballMatchStore>;
+    /** Resumes the active local match on mount. Disable for hosts that resume explicitly. */
+    readonly autoResume?: boolean;
+    readonly onError?: (error: Error) => void | Promise<void>;
+    /** Fixed for this provider instance. Primarily useful for custom storage and tests. */
+    readonly voiceService?: MatchVoiceService;
+    /** Initial audio session mode. Defaults to live so mounting never disables capture. */
+    readonly voiceAudioMode?: VoiceAudioMode;
+    /** Cloud TTS endpoint for announcements. Without it only bundled WAVs play. Fixed for this provider instance. */
+    readonly voiceTts?: VoiceTtsOptions;
+    /** Fixed for this provider instance. Primarily useful for tests and custom native bridges. */
+    readonly remoteService?: RemoteService;
+    /** Foreground silence before a bound remote becomes outOfRange. */
+    readonly remoteOutOfRangeTimeoutMs?: number;
+    readonly remoteInputMode?: RemoteInputMode;
+    readonly remoteActionMapping?: Partial<RemoteActionMapping>;
+    /** Optional single/double/hold recognizer for one calibrated HID volume button. */
+    readonly hidGestureMapping?: RemoteHidGestureMapping;
+    readonly consumeHidVolumeKeys?: boolean;
+}
+declare function PickleballMatchProvider({ children, store, storeFactory, autoResume, onError, voiceService, voiceAudioMode, voiceTts, remoteService, remoteOutOfRangeTimeoutMs, remoteInputMode, remoteActionMapping, hidGestureMapping, consumeHidVolumeKeys, }: PickleballMatchProviderProps): React.JSX.Element;
+declare function usePickleballMatch(): PickleballMatchContextValue;
+
+export { CourtSide, CourtSwitchConfirmedEvent, type ExpoSqliteDatabaseLike, MATCH_PERSISTENCE_SCHEMA_VERSION, MATCH_SQL_MIGRATIONS, MATCH_SQL_SCHEMA_VERSION, MatchCorrectedEvent, MatchCorrection, MatchCreateInput, MatchCreation, MatchEndedEvent, MatchEvent, MatchEventStore, MatchEventUndoneEvent, MatchInputSource, type MatchPersistenceDriver, MatchPersistenceError, type MatchPersistenceErrorCode, type MatchPersistenceTransaction, MatchSnapshot, type MatchSummary, MatchVoiceService, MemoryMatchPersistenceDriver, NoActiveMatchError, type PersistedMatch, type PickleballMatchContextValue, PickleballMatchProvider, type PickleballMatchProviderProps, type PickleballMatchStore, RallyAwardedEvent, RemoteActionMapping, RemoteBinding, RemoteHidGestureMapping, RemoteInputMode, RemoteService, RemoteState, type StoredMatchEventRow, type StoredMatchRow, VoiceAudioMode, VoiceRouteState, VoiceTtsOptions, applyMatchEvent, awardRally, confirmCourtSwitch, correctMatch, createDefaultMatchEventStore, createExpoSqliteMatchDriver, createMatch, endMatch, replayMatchEvents, undoLastMatchEvent, usePickleballMatch };