This package has been deprecated

Author message:

This artifact has been renamed to pusher-platform

TypeScript icon, indicating that this package has built-in type declarations

0.5.3 • Public • Published


This is the official Pusher Platform client library for web browsers. Use it to build SDKs for services running on Pusher Platform / Elements infrastructure.


If you have any issues please open an issue on Github. That is the main issue tracker. Even better, open a PR with a failing test. Even betterer, open a PR with a fix.


We assume you use yarn/npm in your development workflow. You can grab it from the npm/yarn repository:

yarn add 'pusher-platform-js'

The latest working version will always be published there.

If you like to live dangerously, you can check in the Releases tab on Github for the latest release, or clone a local version and refer to it using a relative path.

Usage and Features


We assume you use Webpack or something similar:

Currently there are two ways to import it - either import the whole thing:

import PusherPlatform from `pusher-platform`;
let app = new PusherPlatfrm.App(...);

Or import individual components: Currently you can access:

  • App
  • BaseClient
  • Subscription
  • ResumableSubscription
import { App, ResumableSubscription } from `pusher-platform`;
let app = new App(...);


note: App will be renamed soon, most likely to Instance

This is the main entry point - represents a single Elements app. Initialise with an AppOptions object that contains at least the serviceId.


    serviceIdstring; // Mandatory
    cluster?: string; // Defaults to ""
    encrypted?: boolean;
    client?: BaseClient; // You can provide custom implementation - this will probably be deprecated in the future
    tokenProvider?: TokenProvider; // You can provide custom implementation
    logger?: Logger; // You can provide custom implementation. Defaults to DefaultLogger

It has 3 methods of interest:

  • request(options: RequestOptions)

For regular HTTP requests. Relays to BaseClient. Returns Promise<any.


export interface RequestOptions {
  method: string;
  path: string;
  tokenProvider?: TokenProvider;
  jwt?: string;
  headers?: Headers;
  body?: any;
  retryStrategy?: RetryStrategy;
  • subscribe(options: SubscribeOptions)

A subscription to events. Creates a SUBSCRIBE call using baseclient. Returns Subscription

  • resumableSubscribe(options: ResumableSubscribeOptions)

Like a subscription, but allows you to specify a lastEventId that will return you all items from this ID. Example - Feeds. Returns ResumableSubscription

This is almost identical to Subscribe with the lastEventId and retryStrategy. By default it will use ExponentialBackoffRetryStrategy.


This makes all the requests and executes them. They are standard XHR objects. It also creates XHRs that are used to create instances of Subscription and ResumableSubscription



export interface SubscribeOptions {
    path: string;
    tokenProvider?: TokenProvider;
    jwt?: string;
    lastEventId?: string;
    onOpen?: () => void;
    onEvent?: (event: Event) => void;
    onEnd?: () => void;
    onError?: (error: Error) => void;
    logger: Logger;

There are standard callbacks for different subscription events onOpen, onEvent, onEnd, and onError.

Use unsubscribe(err?: Error) to close this subscription. It will either callback onEnd or onError depending on whether or not the Error object is passed to it as argument.



export interface ResumableSubscribeOptions {
    path: string;
    lastEventId?: string;
    tokenProvider?: TokenProvider;
    onOpening?: () => void;
    onOpen?: () => void;
    onEvent?: (event: Event) => void;
    onEnd?: () => void;
    onError?: (error: Error) => void;
    retryStrategy?: RetryStrategy;
    logger?: Logger;

Works the same as Subscription with the optional retryStrategy and lastEventId.


Note: currently this is not exported in the top-level.

This is a simple add-on to your error handling that hooks onto the onError callbacks of a Subscription. If the Error object is deemed retryable it will retry. Returns a Promise of Error

attemptRetry(error: Error): Promise<Error>;

We currently provide one implementation: ExponentialBackoffRetryStrategy that naively retries a given number of times.


    limitnumber = 6;
    initialBackoffMillisnumber = 1000;
    maxBackoffMillisnumber = 30000;
    loggerLogger = DefaultLogger;


It logs things. Interface:

export interface Logger {
    verbose(message: string, error?: Error);
    debug(message: string, error?: Error);
    info(message: string, error?: Error);
    warn(message: string, error?: Error);
    error(message: string, error?: Error);

You can pass it to the App object at startup. The default implementation is the ConsoleLogger. You initiate it with a threshold for the log level (defaults to LogLevel.DEBUG). It will log everything at or above this log level.

The default log levels are:

export enum LogLevel {
     VERBOSE = 1,
     DEBUG = 2,
     INFO = 3,
     WARNING = 4,
     ERROR = 5


DEPRECATED This will probably change.


yarn install
yarn build  # creates target/pusher-platform.js and target/index.d.ts 

This will create target/pusher-platform.js as the main library and target/index.d.ts as the typings file.


We have 2 types of tests - unit and integration.

Use yarn test-legacy and yarn test-jest for unit tests

Integration testing is trickier as it requires a testing service to be running. Currently it runs locally on your machine but this will eventually be deployed behind the Elements bridge.

The repository for it is here:, and it requires a working Go installation. Then hopefully just run from the main directory of that test library:

glide install

Then run tests (from this dir): yarn test-integration. This will run tests and watch the src/ and test/ dirs to rebuild every time a file is changed. Good for development.

Once we have some sort of CI setup we'll be able to run just yarn test to get everything going and run just once.

I need moar halp!

Ping someone in @pusher/sigsdk. Maybe @zmarkan.




Package Sidebar


npm i pusher-platform-js

Weekly Downloads






Last publish


  • jeremy.goldstein
  • fbenevides
  • marcelcorso
  • pushercom