// src/index.ts — PR1 final: application-only root
//
// Host-neutral public API for unified-ble-manager 4.0.
// Do not import a backend here — hosts select via explicit factories
// (/react-native, /expo, /web, /tauri, /node/*). Low-level contracts live in
// /advanced and backend authoring in /backend-sdk.

// --- Non-generic application façade ---
export type {
  BleManager,
  BlePeer,
  BleConnection,
  BleConnectionEvent,
  BleConnectionControls,
  BleControlObservationMetadata,
  BleControlObservationState,
  BleObservationSource,
  RssiObservation,
  MtuObservation,
  MtuNegotiation,
  MtuNegotiationState,
  MaximumWriteLengthObservation,
  ConnectionPriority,
  ConnectionPriorityResult,
  PhyPreference,
  PhyObservation,
  PhyUpdateResult,
  ConnectionParametersObservation,
  SubrateMode,
  SubrateResult,
  WriteMode,
  WriteReadinessEvent,
  RediscoverGattOptions,
  PublicScanObservation,
  DiscoveryEvent,
  AndroidScanMode,
  AndroidScanCallbackType,
  AndroidScanPhy,
  AndroidScanPlatformOptions,
  ScanPlatformOptions,
  ConnectionIntent,
  BlePhy,
  ConnectOptions,
  ScanSession,
  ScanPlan,
  GattDatabase,
  GattService,
  GattCharacteristic,
  GattDescriptor,
  GattSubscription,
  GattDatabaseSnapshot,
  GattValueEvent,
  GattValueStream,
  GattDatabaseChangedEvent,
  GattWriteReceipt,
  GattLongWriteReceipt,
  GattWriteOptions,
  LongWriteOptions,
  DescriptorWriteOptions,
  GattSubscribeOptions,
  GattCharacteristicProperties,
  GattAccessRequirements,
  GattServiceReference,
  OccurrenceSelector,
  GattPathSelector,
  UuidInput,
  GattSubscriptionValue,
  ScanOptions,
  ScanStateEvent,
  FindOptions,
  ChooseOptions,
  ChooseFilter,
  BleDiscoveryInfo,
  BlePeerDirectory,
  BlePeerState,
  KnownPeerQuery,
  PeerSource,
  BleSecurity,
  PairCancelResult,
  PairingAgent,
  PairingChallenge,
  PairingResponse,
  PairOptions,
  RequiredSecurityOptions,
  PairResult,
  PeerSecurityEvent,
  PeerSecurityState,
  SecurityAuthenticationState,
  SecurityBondState,
  SecurityEncryptionState,
  SecureConnectionsState,
  SecurityPeer,
  UnpairResult,
  SecurityRequirement,
  PeerReference,
  PeerReferenceScope,
  ScanQuery,
  ScanClause,
  ManufacturerDataPattern,
  ServiceDataPattern
} from './public/ble-manager'
export { BUILT_IN_FEATURE_CATALOG, BUILT_IN_FEATURE_IDS } from './backend-contract/capabilities'
export type { BleCapabilities, BuiltInFeatureId, CapabilityDescriptor, FeatureId } from './public/capabilities'
export type { BleAdapter, BleAdapterState, AdapterReadinessOptions } from './public/ble-adapter'
export type {
  BleDiagnosticTraceDocument,
  BleDiagnosticTraceRecord,
  BleDiagnostics,
  BleDiagnosticsSnapshot,
  BleResourceCounters
} from './public/diagnostics'
export type { PeerDirectoryRecord } from './public/peer-directory'
export { mergePeerDirectoryRecords } from './public/peer-directory'
export { encodePeerReference, decodePeerReference } from './public/peer-reference'
export { createConnectionSupervisor } from './public/connection-supervisor'
export { withRequiredSecurity } from './public/security'
export type {
  ConnectionGate,
  ConnectionGateContext,
  ConnectionGateDecision,
  ConnectionSupervisor,
  ConnectionSupervisorEvent,
  ConnectionSupervisorOptions,
  ConnectionSupervisorSnapshot,
  ConnectionSupervisorState,
  RetryPolicy
} from './public/connection-supervisor'

// --- Operation options & stream presets (public types only) ---
export type { OperationOptions } from './public/operation-options'
export type { StreamPreset, StreamPolicy, CustomStreamBudget } from './public/stream-presets'
export type {
  PublicBoundedAsyncStream,
  PublicBoundedAsyncStreamIterator,
  PublicStreamItem,
  PublicStreamLimits,
  PublicStreamOverflowNotice,
  PublicStreamOverflowPolicy,
  PublicStreamTerminalNotice,
  PublicStreamTerminalReason,
  PublicStreamValue
} from './public/streams'

// --- Host identity (ephemeral vs restoration) ---
export type { BleManagerCreateOptions, DiagnosticsOptions } from './public/host-identity'

// --- Errors & recovery (public) ---
export { BleError } from './public/errors'
export type { BleRecovery, BleRecoveryDisposition } from './public/errors'

// Re-export cleanup evidence types that are safe for app code (read-only)
export type {
  CleanupFailure,
  CleanupRecord,
  NormalizedBleError,
  PublicPlatformErrorDetail,
  PublicSerializableRecord,
  PublicSerializableValue
} from './public/cleanup'