/**
 * Shared connect/disconnect bookkeeping for the "auxiliary" device kinds
 * (Opossum, paw-prints, civet-edging) on Tauri, mirroring DG-Agent's
 * `device-webbluetooth` package's `connectAuxDevice`/`disconnectAuxDevice`
 * (browser/Web Bluetooth) almost exactly — the only real difference is how
 * a device gets picked and connected: Web Bluetooth uses
 * `navigator.bluetooth.requestDevice()`, this uses `scanAndSelectDevice()`
 * (plugin-blec scan + host-supplied picker) followed by `api.connect()` and
 * `createGattShim()`. Once a `(device, server)` pair exists, both sides feed
 * it into `@dg-kit/protocol`'s adapters identically, since `createGattShim`
 * synthesizes the same Web-Bluetooth-shaped `BluetoothDeviceLike` (complete
 * with a working `gattserverdisconnected` event and `gatt.disconnect()`).
 *
 * Deliberately does NOT replicate `TauriBlecDeviceClient`'s `autoReconnect`
 * option, matching the Web Bluetooth version's same choice — none of the
 * three aux device kinds need it.
 *
 * Every plugin-blec call this makes is scoped to the address of the device
 * being connected/disconnected, so this can run for several device kinds
 * concurrently (e.g. a Coyote via `TauriBlecDeviceClient` plus an Opossum
 * via `TauriBlecOpossumClient`) without one interfering with another.
 */
import type { BluetoothDeviceLike, BluetoothRemoteGATTServerLike, WebBluetoothConnectionContext } from '@dg-kit/protocol';
import { type GattReadyRetryOptions } from './gatt-ready.js';
import { type DeviceSelectionController } from './scan.js';
/** Minimal shape both `OpossumVibrateAdapter` and the sensor adapters satisfy. */
export interface ConnectableAdapter {
    onConnected(context: WebBluetoothConnectionContext): Promise<void>;
    onDisconnected(): Promise<void>;
}
export interface TauriAuxDeviceConnectOptions extends GattReadyRetryOptions {
    /** Called immediately after scan starts; resolves with the picked address or `null` to cancel. */
    selectDevice: (controller: DeviceSelectionController) => Promise<string | null>;
    /** Client-side filter applied to scan results before they reach `selectDevice`. */
    namePrefixes?: string[];
    /** Scan window in milliseconds. Defaults to 8000. */
    scanDurationMs?: number;
}
/**
 * Scans, lets the host UI pick a device, connects it via plugin-blec, and
 * hands the resulting `(device, server)` pair to `adapter.onConnected()`.
 * Mirrors `connectAuxDevice`'s "replace the previous device only after the
 * new one succeeds" ordering: if `onConnected()` throws (a flaky/wrong
 * device picked mid-swap), whatever this client was already connected to
 * stays intact rather than already torn down with nothing to fall back to.
 *
 * Returns the newly connected device; the caller is responsible for storing
 * it and passing it back in on the next call (as `previousDevice`) and to
 * `disconnectTauriAuxDevice`.
 */
export declare function connectTauriAuxDevice(options: TauriAuxDeviceConnectOptions, adapter: ConnectableAdapter, previousDevice: BluetoothDeviceLike | null, onGattDisconnected: (event: Event) => void): Promise<BluetoothDeviceLike>;
/**
 * Attaches to an already-obtained `(device, server)` pair instead of running
 * this helper's own scan + `selectDevice()` + plugin-blec connect — the
 * Tauri counterpart to `@dg-kit/transport-webbluetooth`'s
 * `WebBluetoothDeviceClient.connectDevice()`. Lets a caller that already ran
 * ONE shared scan+picker across every DG-Lab device kind (see
 * `requestDgLabDeviceTauri()`) and identified the picked device's kind via
 * `detectDeviceKind()` hand it straight to the matching aux client, instead
 * of needing a second, kind-scoped scan+picker. `api.connect()` must already
 * have been called (i.e. `device`/`server` came from `createGattShim()`
 * after a successful plugin-blec connect); this only runs the adapter
 * handshake and the same replace-previous-device bookkeeping
 * `connectTauriAuxDevice()` does.
 */
export declare function attachTauriAuxDevice(nextDevice: BluetoothDeviceLike, server: BluetoothRemoteGATTServerLike, adapter: ConnectableAdapter, previousDevice: BluetoothDeviceLike | null, onGattDisconnected: (event: Event) => void, retryOptions?: GattReadyRetryOptions): Promise<BluetoothDeviceLike>;
/**
 * User-initiated disconnect: removes the listener BEFORE calling
 * `gatt.disconnect()` so the resulting `gattserverdisconnected` event never
 * reaches `onGattDisconnected` a second time.
 */
export declare function disconnectTauriAuxDevice(device: BluetoothDeviceLike | null, adapter: ConnectableAdapter, onGattDisconnected: (event: Event) => void): Promise<void>;
//# sourceMappingURL=aux-connect.d.ts.map