ble_peer_session 0.5.3 copy "ble_peer_session: ^0.5.3" to clipboard
ble_peer_session: ^0.5.3 copied to clipboard

Published 8 days ago
SDKFlutter
PlatformAndroid
→

Metadata

Offline 1:1 peer sessions over BLE for Flutter — host/client model, invitation handshake, and bidirectional messaging.

More...

0.5.3 #

  • Transport: a local adapter that can no longer carry GATT (poweredOff, unsupported, unauthorized) ends the active client and host link through the existing link-loss path. Android STATE_TURNING_OFF is reported by bluetooth_low_energy as poweredOn, so poweredOff (STATE_OFF) is the first distinct signal.
  • Transport: the central no longer waits for a GATT disconnect callback after the adapter has left poweredOn. That callback is not delivered on the client when Bluetooth is switched off, which left the session connected.
  • Transport: overlapping termination (adapter off, remote link loss, manual disconnect) publishes one disconnect.

0.5.2 #

  • Android: a missing or shrinker-stripped smallIcon falls back to the package status icon. It does not fail host advertising or client connect.
  • Android: a foreground-service start failure is logged. The BLE session stays up.

0.5.1 #

  • Discovery: scan without a hardware service-UUID ScanFilter. On Samsung Galaxy A01/A12 that filter matches nothing while the host is advertising.
  • Discovery: keep the last-seen peripheral across the discovery TTL so an invite can still connect while the UI snapshot shows the host.
  • Transport: if the discovery cache misses, resolve the peripheral from the device id (UUID.fromAddress node) and call connectGatt.

0.5.0 #

  • Plugin: package is now a Flutter plugin with an optional Android connected-device foreground service.
  • API: BlePeerConfig.androidForeground — null keeps FGS off for existing consumers.
  • API: BleAndroidForegroundConfig (title, body, optional smallIcon). smallIcon == null uses the package generic status-bar icon.
  • API: PeerClient.cancelPendingConnection() aborts an in-flight GATT connect.
  • Discovery: nearbyHostsStream is a live snapshot; scan start emits []; foreign apps never enter the registry; lastSeen refreshes on every observation; discoveryStaleAfter (default 3s) expires stale hosts.
  • Android: FGS starts on user-initiated establishment (host advertising / client connect), START_NOT_STICKY, task swipe tears down the transport then stops the service.
  • Docs: DECISIONS.md BPS-01…BPS-10.

0.4.4 #

  • Transport: retry transient GATT central writes up to 3 times before failing (BleGattWritePolicy).
  • Transport: do not reset the central link on IllegalStateException alone; only on GATT 133 / GATT_ERROR.
  • Transport: heartbeat ping/pong send failures no longer propagate as unhandled async errors; watchdog still detects real link loss.
  • Transport: SessionLivenessMonitor swallows transient ping send failures.

0.4.3 #

  • Android: reopen a fresh GATT server in BleLinkServerImpl.startAdvertisingAs before adding the service. Fixes IllegalStateException (addService) when a host session is started again after a previous host advertising was stopped and torn down (the singleton PeripheralManager only reopens GATT on adapter power-on transitions).

0.4.2 #

  • Android: lazy-init PeripheralManager on the server link so client-only sessions do not open a GATT server at peer creation.
  • Android: tear down GATT services and close the GATT server on server link dispose to avoid dual central/peripheral conflicts during host/client role switches (Samsung).
  • Transport: increase post-MTU settle delay on the central link from 300ms to 500ms.

0.4.1 #

  • Pub score: add standard example/ layout for pub.flutter-io.cn (160/160 pub points).
  • Documentation: library dartdoc and BlePeerConfig field comments.
  • Style: dart format across lib/ and test/; remove redundant dart:typed_data imports.

0.4.0 #

  • Transport: GATT disconnect detection (central/peripheral connection state callbacks).
  • Transport: Session heartbeat watchdog (5s ping, 15s inactivity timeout).
  • API: Peer.disconnectStream and PeerDisconnectReason for unified session-end events.

0.3.5 #

  • Documentation: fix README diagram on pub.flutter-io.cn — use absolute raw.githubusercontent.com URL (relative links break when default branch is main, not master).

0.3.4 #

  • Documentation: replace the ASCII host/client sequence diagram in the README with an illustrated connection-flow image (doc/assets/connection-flow.jpg).

0.3.3 #

  • Documentation: refined README — use cases, host/client diagrams, role-based quick start, compact core model, reordered sections (example app before errors), internals isolated for contributors.

0.3.2 #

  • Documentation: restructured README (TL;DR first, single connection flow, grouped sections); doc/README.md index; updated migration guides, error codes, and example/minimal_chat README.

0.3.1 #

  • Framing: logical messages larger than the BLE MTU are split and reassembled on the link layer (BleFrameCodec, BleFrameAssembler).
  • Limits: default chunk payload 480 bytes, max logical message 256 KiB; legacy unframed payloads still accepted on receive.
  • Tests: unit tests for fragment/reassemble, oversized payload, corrupt frames, legacy passthrough.
  • Example: example/minimal_chat — host/client role picker and bidirectional text chat.

0.3.0 #

  • Beginner API: Peer.create(appName: 'MyGame') with auto-generated stable UUIDs (BlePeerConfig.forApp).
  • PeerUser replaces manual PeerEndpoint setup for most apps; PeerNearby for discovered hosts.
  • Shortcuts: peer.host(localUser:) and peer.client(localUser:).
  • Client: invite(PeerNearby) alias; nearbyHostsStream over raw devices.
  • Messaging: sendText(), textMessages, sendJson(), jsonMessages; PeerMessage.text / PeerMessage.app.
  • SilentLogger when no logger is passed.
  • README: beginner API quick start.
  • 0.2 APIs preserved via startWithEndpoint, connect(device), explicit config.

0.2.0 #

  • Breaking: new public API — Peer, PeerHost, PeerClient, PeerMessage, PeerException, PeerErrorCode, PeerConnectionPhase, PeerAdapterStatus.
  • Breaking: removed exports of TransportFacade, TransportSession*, TransportSessionState, session message classes, and Bluetooth*Exception.
  • Unified errors into PeerException with PeerErrorCode.
  • Adapter status via Peer.adapterStatusStream (no auto-enable Bluetooth).
  • Documentation: mental model diagrams, connection/message flow, ERROR_CODES.md, MIGRATION.md.
  • 1:1 sessions only; second central rejected at link layer.

0.1.2 #

  • Fixed role switching in BleTransportFacadeImpl: skip disconnect() when the active session is uninitialized, preventing crashes on first startClientTransportSession / startServerTransportSession.
  • Added state-aware disconnect() for client and server sessions (discovery, awaiting decision, connected).
  • Added BleLinkReadiness to verify Bluetooth permissions and powered-on state before discovery/advertising.
  • Added BluetoothUnsupportedException, BluetoothPermissionsDeniedException, and BluetoothPeripheralUnavailableException.
  • Added tests for facade role switching.

0.1.1 #

  • Removed unused dependencies (json_annotation, build_runner, json_serializable).
  • Updated flutter_blue_plus and permission_handler.

0.1.0 #

  • Initial release: BLE P2P session transport for Flutter.
  • Discovery, invitation/acceptance handshake, bidirectional messaging.
  • PeerMessage envelope for app-level payloads.
  • BlePeerSessionModule factory and Bluetooth permission/state helpers.

← Metadata

2
likes
140
points
695
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

Metadata

Offline 1:1 peer sessions over BLE for Flutter — host/client model, invitation handshake, and bidirectional messaging.

Repository (GitHub)
View/report issues

Topics

#bluetooth #ble #flutter #p2p #peer-to-peer

License

MIT (license)

Dependencies

bluetooth_low_energy, bluetooth_low_energy_android, device_info_plus, flutter, flutter_blue_plus, meta, permission_handler, url_launcher

More

Packages that depend on ble_peer_session

Packages that implement ble_peer_session

Back