dart_pusher_channels 0.2.8+1

Dart implementation of client of Pusher Channels protocol, instrument to work with real-time applications.

This package is an unofficial pure dart implementation of Pusher Channels.

Help in development

Author of the package currently needs help with testing the package on other OS platforms:

• Linux
• MacOS

Development and testing of:

• Presence channels
• Encrypted channels

Contributors

Maintainer:

Kerim Amansaryyev

Contributors:

Nicolas Britos - Pull requests #5, #6, #8

Description

Note: This package needs to be tested and accepting issues. It was tested on a few projects for production.

This package is built according to the official documentation of Pusher Channels protocol.

The package has flexibale API containing interfaces for building custom connection and authorization. By default, it supports connection to Web sockets over the web_socket_channel out of the box.

Supported platforms

This package was tested on:

• Anrdoid
• IOS
• Web
• Windows

Other platforms are in a test queue.

Usage

PusherChannelOptions

In order to get known to the parameters provided to PusherChannelOptions, it's highly recommended to read the informative API reference of PusherChannelOptions.

Also, see API references of the constructors to learn more about their parameters:

• PusherChannelOptions.new
• PusherChannelOptions.ws
• PusherChannelOptions.wss

PusherChannelsClient

Create an instance of PusherChannelsClient and use it to establish connection.

1. Create PusherChannelOptions

const options = PusherChannelOptions.wss(
      host: 'my.domain.com',
      port: 443,
      key: 'API_KEY',
      protocol: 7);

2. Create the client.

Use PusherChannelsClient.websocket constructor to create a client based on web sockets.

final client = PusherChannelsClient.websocket(
      reconnectTries: 2,
      options: options,
      // Handle the errors based on the web sockets connection
      onConnectionErrorHandle: (error, trace, refresh) {});

3. Create channels and listen for events.

// Ensure you implement your logic
  // after successfull connection to your server
  Channel? channel;
  StreamSubscription? eventSubscription;
  // This stream will recieve events and notify subscribers
  // whenever the client is connected or reconnected after potential error
  client.onConnectionEstablished.listen((_) async {
    channel ??= client.publicChannel('my_public_channel_name');
    await eventSubscription?.cancel();
    // Ensure you bind to the channel before subscribing,
    // otherwise - you will miss some events
    eventSubscription = channel?.bind('my_event').listen((event) {
      //listen for events form the channel here
    });
    channel!.subscribe();
  });
  client.connect();
  // unsubscribe when done with channel
  eventSubscription?.cancel();
  channel?.unsubscribe();
  //close when done with client
  client.close();

Channels and events

Note: For now, the package supports only reading (recieving) events. Triggering events is in the milestones.

The package supports 2 types of channels:

• Public
• Private

Milestones

• Triggering events (for now plugin supprts only reading events from channels)
• Presence channels
• Encrypted channels

Authorization

The package comes with the default delegate for authorizing to private channels over http.

final privateChannel ??= client.privateChannel(
        'my_private_channel',
        // This is a default authorization delegate
        // to authorize to the channels
        // You may implement your own authorization delegate
        // implementing [AuthorizationDelegate] interface
        // Use `http` or `https` scheme
        TokenAuthorizationDelegate(
            authorizationEndpoint: Uri.parse('http://my.auth.com/api/auth'),
            headers: {'Authorization': 'Bearer [YOUR_TOKEN]'}));

Enabling/disabling logs

By default, logs are disabled.

PusherChannelsPackageConfigs.enableLogs();
//or
PusherChannelsPackageConfigs.disableLogs();