import type { CharacteristicPath, GattDatabaseSnapshot } from '../backend-contract/gatt.js';
import type { BackendIdentity } from '../backend-contract/identity.js';
import type { PublicOperationOptions, SubscriptionOptions, WritePolicy, WriteReceipt } from '../backend-contract/operations.js';
import type { OwnedBytes, Uuid } from '../backend-contract/primitives.js';
import type { Connection, DiscoveredGattDatabase, Subscription } from '../manager/index.js';
type CurrentCharacteristicPath<Attachment extends string> = CharacteristicPath<Attachment, string, string, string, string, 'current'>;
/** A duplicate-safe selector for an attribute in one discovered GATT database. */
export interface CharacteristicSelector {
    readonly serviceUuid: Uuid;
    readonly characteristicUuid: Uuid;
    readonly serviceOccurrence: string | null;
    readonly characteristicOccurrence: string | null;
}
export interface CharacteristicSelectorOptions {
    readonly serviceOccurrence?: string;
    readonly characteristicOccurrence?: string;
}
export declare function characteristicSelector(serviceUuid: Uuid, characteristicUuid: Uuid, options?: CharacteristicSelectorOptions): CharacteristicSelector;
/** Thin public command for discovery; cancellation and deadlines stay with the public connection primitive. */
export declare function discoverGatt<Attachment extends string, Identity extends BackendIdentity<Attachment>>(connection: Connection<Attachment, Identity>, options: PublicOperationOptions): Promise<DiscoveredGattDatabase<Attachment, Identity>>;
/**
 * Resolves one exact characteristic path from an ordered snapshot. UUID-only
 * lookup is intentionally rejected when an occurrence is duplicated.
 */
export declare function resolveCharacteristicPath<Attachment extends string>(snapshot: GattDatabaseSnapshot<Attachment, string, string>, selector: CharacteristicSelector): Promise<CurrentCharacteristicPath<Attachment>>;
export declare function readCharacteristic<Attachment extends string, Identity extends BackendIdentity<Attachment>>(database: DiscoveredGattDatabase<Attachment, Identity>, selector: CharacteristicSelector, options: PublicOperationOptions): Promise<OwnedBytes>;
export declare function writeCharacteristic<Attachment extends string, Identity extends BackendIdentity<Attachment>>(database: DiscoveredGattDatabase<Attachment, Identity>, selector: CharacteristicSelector, value: Readonly<Uint8Array>, options: WritePolicy): Promise<WriteReceipt<Attachment, string>>;
export declare function subscribeCharacteristic<Attachment extends string, Identity extends BackendIdentity<Attachment>>(database: DiscoveredGattDatabase<Attachment, Identity>, selector: CharacteristicSelector, options: SubscriptionOptions): Promise<Subscription<Attachment, Identity>>;
export {};
//# sourceMappingURL=commands.d.ts.map