import type { AdvertisementObservation, ScanOptions } from '../backend-contract/advertisement.js';
import { type CleanupRecord } from '../backend-contract/errors.js';
import type { BackendIdentity } from '../backend-contract/identity.js';
import type { CharacteristicPath } from '../backend-contract/gatt.js';
import type { PublicOperationOptions, SubscriptionOptions } from '../backend-contract/operations.js';
import { type OwnedBytes, type PeerId, type Uuid } from '../backend-contract/primitives.js';
import { BleManager, Connection, DiscoveredGattDatabase } from './ble-manager.js';
type CurrentCharacteristicPath<Attachment extends string> = CharacteristicPath<Attachment, string, string, string, string, 'current'>;
/** The exact public scan request and observation predicate used by find and scanUntil. */
export interface ScanUntilOptions<Attachment extends string> {
    readonly scan: ScanOptions<Attachment, string>;
    readonly matches: (observation: AdvertisementObservation<Attachment>) => boolean;
}
/** A discovered, generation-bound GATT database that remains owned by its returned connection. */
export interface ConnectedGattDatabase<Attachment extends string, Identity extends BackendIdentity<Attachment>> {
    readonly connection: Connection<Attachment, Identity>;
    readonly database: DiscoveredGattDatabase<Attachment, Identity>;
    readonly snapshot: Awaited<ReturnType<DiscoveredGattDatabase<Attachment, Identity>['snapshot']>>;
}
/** Bounded collection configuration for collectNotifications. */
export interface CollectNotificationsOptions {
    readonly subscription: SubscriptionOptions;
    readonly maximumValues: number;
}
/**
 * Scans until a caller-owned predicate accepts an observation. The exact scan
 * request, including active AbortSignal and deadline behavior, is forwarded
 * unchanged to the public manager.
 */
export declare function scanUntil<Attachment extends string, Identity extends BackendIdentity<Attachment>>(manager: BleManager<Attachment, Identity>, options: ScanUntilOptions<Attachment>): Promise<AdvertisementObservation<Attachment>>;
/** Alias for scanUntil that keeps the public vocabulary compact. */
export declare function find<Attachment extends string, Identity extends BackendIdentity<Attachment>>(manager: BleManager<Attachment, Identity>, options: ScanUntilOptions<Attachment>): Promise<AdvertisementObservation<Attachment>>;
/** Connects and discovers through the public handles, releasing a partial connection if discovery fails. */
export declare function connectAndDiscover<Attachment extends string, Identity extends BackendIdentity<Attachment>>(manager: BleManager<Attachment, Identity>, peerId: PeerId<Attachment>, options: PublicOperationOptions): Promise<ConnectedGattDatabase<Attachment, Identity>>;
/** Resolves the first notification value and removes the subscription before returning. */
export declare function firstNotification<Attachment extends string, Identity extends BackendIdentity<Attachment>>(database: DiscoveredGattDatabase<Attachment, Identity>, path: CurrentCharacteristicPath<Attachment>, options: SubscriptionOptions): Promise<OwnedBytes>;
/** Collects no more than maximumValues notification payloads, then removes the subscription. */
export declare function collectNotifications<Attachment extends string, Identity extends BackendIdentity<Attachment>>(database: DiscoveredGattDatabase<Attachment, Identity>, path: CurrentCharacteristicPath<Attachment>, options: CollectNotificationsOptions): Promise<readonly OwnedBytes[]>;
/** Runs an operation with one connection lease and deterministically releases that lease on every exit. */
export declare function withConnection<Attachment extends string, Identity extends BackendIdentity<Attachment>, Value>(manager: BleManager<Attachment, Identity>, peerId: PeerId<Attachment>, options: PublicOperationOptions, operation: (connection: Connection<Attachment, Identity>) => Promise<Value>): Promise<Value>;
export declare function defaultScanDelivery(): Readonly<{
    itemCapacity: import("../backend-contract/primitives.js").Capacity;
    byteCapacity: import("../backend-contract/primitives.js").Capacity;
    reservedControlCapacity: import("../backend-contract/primitives.js").Capacity;
    overflowPolicy: "drop-oldest";
}>;
export declare function scanForServices<Attachment extends string, Identity extends BackendIdentity<Attachment>>(manager: BleManager<Attachment, Identity>, serviceUuids: readonly Uuid[], options: Omit<ScanUntilOptions<Attachment>, 'scan'> & {
    readonly scan?: Partial<ScanUntilOptions<Attachment>['scan']>;
}): Promise<AdvertisementObservation<Attachment>>;
export declare function withDiscoveredConnection<Attachment extends string, Identity extends BackendIdentity<Attachment>, Value>(manager: BleManager<Attachment, Identity>, peerId: PeerId<Attachment>, options: PublicOperationOptions, fn: (session: ConnectedGattDatabase<Attachment, Identity>) => Promise<Value>): Promise<Value>;
export declare function throwIfCleanupFailed(cleanup: CleanupRecord, operation: string): void;
export {};
//# sourceMappingURL=public-helpers.d.ts.map