cent 0.0.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 47ce99ab8c4bbdc34e55ed10c59c5cc88f8dc94114f57cb0cc6a2114f504da07
-  data.tar.gz: 8ed06495a1b706309ee0797522a20e60b7a2be89c8ce139d4a78a1c10f539fae
+  metadata.gz: ccda06fa2a0da286f06e74761175bb6e822930267d8bd6edf0058359c8a8efe4
+  data.tar.gz: 7a4f9398de445b0853edbdbb464339692af7a35e3777d1b71240159073f39134
 SHA512:
-  metadata.gz: 3257d7b4bb382e9937148e21d920978df68aba42b697e3214f1eb1f64c73538dcf041ece277ebdec64349486a524c5b047a350a71e0e97df94873980a764356b
-  data.tar.gz: a31e53c242a2b58594cd4583982281e79bd7795d535d3e18b23f48b559e31cba19a1a73ac1f6536b870487b2e34b87a309cc6b63db3b7995c14048de1c8fbb5d
+  metadata.gz: 7b53b22a81d6d8ef2f9cb02af14ed35675713e77a040be770e07f6f5f1c166eed649fa0b5937e0424a877067b7ffdc31a4e0e22010eb00e85536b86f02cf3830
+  data.tar.gz: 21d2c90b9e905d40611f6ba0010042a8ffbef7bf13ed13abce683b003a5bfcddc3bf52db0b34d5d72c5e050855041f563b487e85ec4071c332be1362659033b4

data/.github/workflows/main.yml

@@ -0,0 +1,18 @@
+name: Ruby
+
+on: [push,pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 2.7.1
+    - name: Run the default task
+      run: |
+        gem install bundler -v 2.2.10
+        bundle install
+        bundle exec rake

data/.github/workflows/release.yml

@@ -0,0 +1,33 @@
+name: Release Ruby Gem
+
+on:
+  # Manually publish
+  workflow_dispatch:
+jobs:
+  build-and-release:
+    name: Release
+    runs-on: ubuntu-latest
+    permissions:
+      packages: write
+      contents: read
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Set up Ruby 2.6
+        uses: ruby/setup-ruby@477b21f02be01bcb8030d50f37cfec92bfa615b6
+        with:
+          ruby-version: 2.6
+      - run: bundle install
+
+      - name: Publish to RubyGems
+        run: |
+          mkdir -p $HOME/.gem
+          touch $HOME/.gem/credentials
+          chmod 0600 $HOME/.gem/credentials
+          printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+          gem build *.gemspec
+          gem push *.gem
+        env:
+          GEM_HOST_API_KEY: "${{secrets.RUBYGEMS_API_KEY}}"

data/.gitignore

@@ -0,0 +1,20 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+.ruby-gemset
+.ruby-versions
+*.iml
+.idea/
+.rspec_status
+

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,11 @@
+require:
+  - rubocop-rspec
+  - rubocop-rake
+AllCops:
+  TargetRubyVersion: 2.5
+  NewCops: enable
+RSpec/ExampleLength:
+  Max: 15
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'

data/CHANGELOG.md

@@ -0,0 +1,9 @@
+2.0.0
+=====
+
+* Complete rewrite of a Ruby Client to work with Centrifugo V2 Server API
+
+1.2.0
+=====
+
+* update assets to latest library versions: SockJS to 1.1.1 and centrifuge-js to 1.3.7

data/Gemfile

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in cent.gemspec
+gemspec
+
+gem 'rake', '~> 13.0'
+
+gem 'rspec', '~> 3.0'
+gem 'webmock', '~> 3.7.5'
+
+gem 'rubocop', '~> 1.7'
+gem 'rubocop-rake'
+gem 'rubocop-rspec'
+
+gem 'pry'

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Centrifugal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,282 @@
+# Cent
+[![Code Climate](https://codeclimate.com/github/centrifugal/centrifuge-ruby/badges/gpa.svg)](https://codeclimate.com/github/centrifugal/centrifuge-ruby)
+![Build Status](https://github.com/centrifugal/rubycent/actions/workflows/main.yml/badge.svg)
+
+[Centrifugo HTTP API v2](https://centrifugal.github.io/centrifugo/server/http_api/) client in Ruby.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'cent' 
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install cent
+
+## Usage
+
+Functionality is split between two classes:
+ - `Cent::Client` to call API methods
+ - `Cent::Notary` to generate tokens
+
+### Token Generation
+
+```ruby
+notary = Cent::Notary.new(secret: 'secret')
+```
+
+By default it uses HS256 to generate tokens, but you can set it to one of the HMAC, RSA or ECDSA family. 
+
+#### RSA
+
+```ruby
+secret = OpenSSL::PKey::RSA.new(File.read('./rsa_secret.pem'))
+notary = Cent::Notary.new(secret: secret, algorithm: 'RS256')
+```
+
+#### ECDSA
+
+```ruby
+secret = OpenSSL::PKey::EC.new(File.read('./ecdsa_secret.pem'))
+notary = Cent::Notary.new(secret: secret, algorithm: 'ES256')
+```
+
+#### Connection token
+
+When connecting to Centrifugo client [must provide connection JWT token](https://centrifugal.github.io/centrifugo/server/authentication/) with several predefined credential claims.
+
+```ruby
+notary.issue_connection_token(sub: '42') 
+
+#=> "eyJhbGciOiJIUzI1NiJ9..."
+```
+
+`info` and `exp` are supported as well: 
+
+```ruby
+notary.issue_connection_token(sub: '42', info: { scope: 'admin' }, exp: 1629050099) 
+
+#=> "eyJhbGciOiJIUzI1NiJ9..."
+```
+
+### Private channel token
+
+All channels starting with $ considered private and require a **channel token** to subscribe. 
+Private channel subscription token is also JWT([see the claims](https://centrifugal.github.io/centrifugo/server/private_channels/))
+
+```ruby
+notary.issue_channel_token(client: 'client', channel: 'channel', exp: 1629050099, info: { scope: 'admin' }) 
+
+#=> "eyJhbGciOiJIUzI1NiJ9..."
+```
+ 
+### API Client
+
+A client requires your Centrifugo API key to execute all requests.
+
+```ruby
+client = Cent::Client.new(api_key: 'key')
+```
+
+you can customize your connection as you wish, just remember it's a [Faraday::Connection](https://lostisland.github.io/faraday/usage/#customizing-faradayconnection) instance:
+
+```ruby
+client = Cent::Client.new(api_key: 'key', endpoint: 'https://centrifu.go/api') do |connection|
+  connection.headers['User-Agent'] = 'Centrifugo Ruby Client'
+  connection.options.open_timeout = 3
+  connection.options.timeout = 7
+  connection.adapter :typhoeus
+end
+```
+
+#### Publish
+
+Send data to the channel.
+
+[https://centrifugal.github.io/centrifugo/server/http_api/#publish](https://centrifugal.github.io/centrifugo/server/http_api/#publish)
+
+```ruby
+client.publish(channel: 'chat', data: 'hello') # => {}
+```
+
+#### Broadcast
+
+Sends data to multiple channels.
+
+[https://centrifugal.github.io/centrifugo/server/http_api/#broadcast](https://centrifugal.github.io/centrifugo/server/http_api/#broadcast)
+
+```ruby
+client.broadcast(channels: ["clients", "staff"], data: 'hello') # => {}
+```
+
+#### Unsubscribe
+
+Unsubscribe user from channel. Receives to arguments: channel and user (user ID you want to unsubscribe)
+
+[https://centrifugal.github.io/centrifugo/server/http_api/#unsubscribe](https://centrifugal.github.io/centrifugo/server/http_api/#unsubscribe)
+
+```ruby
+client.unsubscribe(channel: 'chat', user: '1') # => {}
+```
+
+#### Disconnect
+
+Allows to disconnect user by it's ID. Receives user ID as an argument.
+
+[https://centrifugal.github.io/centrifugo/server/http_api/#disconnect](https://centrifugal.github.io/centrifugo/server/http_api/#disconnect)
+
+```ruby
+# Disconnect user with `id = 1`
+# 
+client.disconnect(user: '1') # => {}
+```
+
+#### Presence
+
+Get channel presence information(all clients currently subscribed on this channel).
+
+[https://centrifugal.github.io/centrifugo/server/http_api/#presence](https://centrifugal.github.io/centrifugo/server/http_api/#presence)
+
+```ruby
+client.presence(channel: 'chat') 
+
+# {
+#   'result' => {
+#     'presence' => {
+#       'c54313b2-0442-499a-a70c-051f8588020f' => {
+#         'client' => 'c54313b2-0442-499a-a70c-051f8588020f',
+#         'user' => '42'
+#       },
+#       'adad13b1-0442-499a-a70c-051f858802da' => {
+#         'client' => 'adad13b1-0442-499a-a70c-051f858802da',
+#         'user' => '42'
+#       }
+#     }
+#   }
+# }
+``` 
+
+#### Presence stats
+
+Get short channel presence information.
+
+[https://centrifugal.github.io/centrifugo/server/http_api/#presence_stats](https://centrifugal.github.io/centrifugo/server/http_api/#precence_stats)
+
+```ruby
+client.presence_stats(channel: 'chat')
+
+# {
+#   "result" => {
+#     "num_clients" => 0,
+#     "num_users" => 0
+#   }
+# }
+```
+
+#### History
+
+Get channel history information (list of last messages published into channel).
+
+[https://centrifugal.github.io/centrifugo/server/http_api/#history](https://centrifugal.github.io/centrifugo/server/http_api/#hisotry)
+
+```ruby
+client.history(channel: 'chat') 
+
+# {
+#   'result' => {
+#     'publications' => [
+#       {
+#         'data' => {
+#           'text' => 'hello'
+#         }
+#       },
+#       {
+#         'data' => {
+#           'text' => 'hi!'
+#         }
+#       }
+#     ]
+#   }
+# }
+```
+
+#### Channels
+
+Get list of active(with one or more subscribers) channels.
+
+[https://centrifugal.github.io/centrifugo/server/http_api/#channels](https://centrifugal.github.io/centrifugo/server/http_api/#channels)
+
+```ruby
+client.channels
+
+# {
+#   'result' => {
+#     'channels' => [
+#       'chat'
+#     ]
+#   }
+# }
+```
+
+#### Info
+
+Get running Centrifugo nodes information.
+
+[https://centrifugal.github.io/centrifugo/server/http_api/#info](https://centrifugal.github.io/centrifugo/server/http_api/#info)
+
+```ruby
+client.info
+
+# {
+#   'result' => {
+#     'nodes' => [
+#       {
+#         'name' => 'Alexanders-MacBook-Pro.local_8000',
+#         'num_channels' => 0,
+#         'num_clients' => 0,
+#         'num_users' => 0,
+#         'uid' => 'f844a2ed-5edf-4815-b83c-271974003db9',
+#         'uptime' => 0,
+#         'version' => ''
+#       }
+#     ]
+#   }
+# }
+```
+
+### Errors
+
+Network errors are not wrapped and will raise `Faraday::ClientError`.
+
+In cases when Centrifugo returns 200 with `error` key in the body we wrap it and return custom error:
+
+```ruby
+# Raised when response from Centrifugo contains any error as result of API command execution.
+#
+begin
+  client.publish(channel: 'channel', data: { foo: :bar })
+rescue Cent::ResponseError => ex
+  ex.message # => "Invalid format"
+end
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/centrifugal/rubycent. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'cent'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'pry'
+Pry.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/cent.gemspec

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative 'lib/cent/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'cent'
+  spec.version       = Cent::VERSION
+  spec.authors       = ['Sergey Prikhodko']
+  spec.email         = ['prikha@gmail.com']
+
+  spec.summary       = 'Centrifugo API V2 Ruby Client'
+  spec.description   = <<~DESC
+    Provides helper classes Cent::Client and Cent::Notary.
+
+    `Cent::Client` is made to communicate to the server API
+    `Client::Notary` is a simple JWT wrapper to generate authorization tokens for the frontend
+  DESC
+  spec.homepage      = 'https://github.com/centrifugal/rubycent'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.5.0')
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/centrifugal/rubycent'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:spec|Gemfile)/}) }
+  end
+
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'faraday', '<2.0.0', '~> 1.7.0'
+  spec.add_dependency 'faraday_middleware', '<2.0.0', '~> 1.0'
+  spec.add_dependency 'jwt', '~> 2.2.1'
+end

data/lib/cent.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require 'cent/version'
+require 'cent/notary'
+require 'cent/client'
+
+# Centrifugo Ruby Client
+module Cent
+  # Here will be code...
+end

data/lib/cent/client.rb

@@ -0,0 +1,273 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'faraday_middleware'
+require 'cent/http'
+
+module Cent
+  # Cent::Client
+  #
+  #   Main object that handles configuration and requests to centrifugo API
+  #
+  class Client
+    # @param endpoint [String]
+    #   (default: 'http://localhost:8000/api') Centrifugo HTTP API URL
+    #
+    # @param api_key [String]
+    #   Centrifugo API key(used to perform requests)
+    #
+    # @yield [Faraday::Connection] yields connection object so that it can be configured
+    #
+    # @example Construct new client instance
+    #   Cent::Client.new(
+    #     endpoint: 'http://localhost:8000/api',
+    #     api_key: 'api key'
+    #   )
+    #
+    def initialize(api_key:, endpoint: 'http://localhost:8000/api')
+      headers = {
+        'Content-Type' => 'application/json',
+        'Authorization' => "apikey #{api_key}"
+      }
+
+      @connection = Faraday.new(endpoint, headers: headers) do |conn|
+        conn.request :json # encode req bodies as JSON
+
+        conn.response :json # decode response bodies as JSON
+        conn.response :raise_error
+
+        yield conn if block_given?
+      end
+    end
+
+    # Publish data into channel
+    #
+    # @param channel [String]
+    #   Name of the channel to publish
+    #
+    # @param data [Hash]
+    #   Data for publication in the channel
+    #
+    # @example Publish `content: 'hello'` into `chat` channel
+    #   client.publish(channel: 'chat', data: 'hello') #=> {}
+    #
+    # @see (https://centrifugal.github.io/centrifugo/server/http_api/#publish)
+    #
+    # @raise [Cent::Error, Cent::ResponseError]
+    #
+    # @return [Hash] Return empty hash in case of successful publish
+    #
+    def publish(channel:, data:)
+      execute('publish', channel: channel, data: data)
+    end
+
+    # Publish data into multiple channels
+    #   (Similar to `#publish` but allows to send the same data into many channels)
+    #
+    # @param channels [Array<String>] Collection of channels names to publish
+    # @param data [Hash] Data for publication in the channels
+    #
+    # @example Broadcast `content: 'hello'` into `channel_1`, 'channel_2' channels
+    #   client.broadcast(channels: ['channel_1', 'channel_2'], data: 'hello') #=> {}
+    #
+    # @see (https://centrifugal.github.io/centrifugo/server/http_api/#broadcast)
+    #
+    # @raise [Cent::Error, Cent::ResponseError]
+    #
+    # @return [Hash] Return empty hash in case of successful broadcast
+    #
+    def broadcast(channels:, data:)
+      execute('broadcast', channels: channels, data: data)
+    end
+
+    # Unsubscribe user from channel
+    #
+    # @param channel [String]
+    #   Channel name to unsubscribe from
+    #
+    # @param user [String, Integer]
+    #   User ID you want to unsubscribe
+    #
+    # @example Unsubscribe user with `id = 1` from `chat` channel
+    #   client.unsubscribe(channel: 'chat', user: '1') #=> {}
+    #
+    # @see (https://centrifugal.github.io/centrifugo/server/http_api/#unsubscribe)
+    #
+    # @raise [Cent::Error, Cent::ResponseError]
+    #
+    # @return [Hash] Return empty hash in case of successful unsubscribe
+    #
+    def unsubscribe(channel:, user:)
+      execute('unsubscribe', channel: channel, user: user)
+    end
+
+    # Disconnect user by it's ID
+    #
+    # @param user [String, Integer]
+    #   User ID you want to disconnect
+    #
+    # @example Disconnect user with `id = 1`
+    #   client.disconnect(user: '1') #=> {}
+    #
+    # @see (https://centrifugal.github.io/centrifugo/server/http_api/#disconnect)
+    #
+    # @raise [Cent::Error, Cent::ResponseError]
+    #
+    # @return [Hash] Return empty hash in case of successful disconnect
+    #
+    def disconnect(user:)
+      execute('disconnect', user: user)
+    end
+
+    # Get channel presence information
+    #   (all clients currently subscribed on this channel)
+    #
+    # @param channel [String] Name of the channel
+    #
+    # @example Get presence information for channel `chat`
+    #   client.presence(channel: 'chat') #=> {
+    #     "result" => {
+    #       "presence" => {
+    #         "c54313b2-0442-499a-a70c-051f8588020f" => {
+    #           "client" => "c54313b2-0442-499a-a70c-051f8588020f",
+    #           "user" => "42"
+    #         },
+    #         "adad13b1-0442-499a-a70c-051f858802da" => {
+    #           "client" => "adad13b1-0442-499a-a70c-051f858802da",
+    #           "user" => "42"
+    #         }
+    #       }
+    #     }
+    #   }
+    #
+    # @see (https://centrifugal.github.io/centrifugo/server/http_api/#presence)
+    #
+    # @raise [Cent::Error, Cent::ResponseError]
+    #
+    # @return [Hash]
+    #   Return hash with information about all clients currently subscribed on this channel
+    #
+    def presence(channel:)
+      execute('presence', channel: channel)
+    end
+
+    # Get short channel presence information
+    #
+    # @param channel [String] Name of the channel
+    #
+    # @example Get short presence information for channel `chat`
+    #   client.presence_stats(channel: 'chat') #=> {
+    #     "result" => {
+    #       "num_clients" => 0,
+    #       "num_users" => 0
+    #     }
+    #   }
+    #
+    # @see (https://centrifugal.github.io/centrifugo/server/http_api/#presence_stats)
+    #
+    # @raise [Cent::Error, Cent::ResponseError]
+    #
+    # @return [Hash]
+    #   Return hash with short presence information about channel
+    #
+    def presence_stats(channel:)
+      execute('presence_stats', channel: channel)
+    end
+
+    # Get channel history information
+    #   (list of last messages published into channel)
+    #
+    # @param channel [String] Name of the channel
+    #
+    # @example Get history for channel `chat`
+    #   client.history(channel: 'chat') #=> {
+    #     "result" => {
+    #       "publications" => [
+    #         {
+    #           "data" => {
+    #             "text" => "hello"
+    #           },
+    #           "uid" => "BWcn14OTBrqUhTXyjNg0fg"
+    #         },
+    #         {
+    #           "data" => {
+    #             "text" => "hi!"
+    #           },
+    #           "uid" => "Ascn14OTBrq14OXyjNg0hg"
+    #         }
+    #       ]
+    #     }
+    #   }
+    #
+    # @see (https://centrifugal.github.io/centrifugo/server/http_api/#history)
+    #
+    # @raise [Cent::Error, Cent::ResponseError]
+    #
+    # @return [Hash]
+    #   Return hash with a list of last messages published into channel
+    #
+    def history(channel:)
+      execute('history', channel: channel)
+    end
+
+    # Get list of active(with one or more subscribers) channels.
+    #
+    # @example Get active channels list
+    #   client.channels #=> {
+    #     "result" => {
+    #       "channels" => [
+    #         "chat"
+    #       ]
+    #     }
+    #   }
+    #
+    # @see (https://centrifugal.github.io/centrifugo/server/http_api/#channels)
+    #
+    # @raise [Cent::Error, Cent::ResponseError]
+    #
+    # @return [Hash]
+    #   Return hash with a list of active channels
+    #
+    def channels
+      execute('channels', {})
+    end
+
+    # Get information about running Centrifugo nodes
+    #
+    # @example Get running centrifugo nodes list
+    #   client.info #=> {
+    #     "result" => {
+    #       "nodes" => [
+    #         {
+    #           "name" => "Alexanders-MacBook-Pro.local_8000",
+    #           "num_channels" => 0,
+    #           "num_clients" => 0,
+    #           "num_users" => 0,
+    #           "uid" => "f844a2ed-5edf-4815-b83c-271974003db9",
+    #           "uptime" => 0,
+    #           "version" => ""
+    #         }
+    #       ]
+    #     }
+    #   }
+    #
+    # @see (https://centrifugal.github.io/centrifugo/server/http_api/#info)
+    #
+    # @raise [Cent::Error, Cent::ResponseError]
+    #
+    # @return [Hash]
+    #   Return hash with a list of last messages published into channel
+    #
+    def info
+      execute('info', {})
+    end
+
+    private
+
+    def execute(method, data)
+      body = { method: method, params: data }
+
+      Cent::HTTP.new(connection: @connection).post(body: body)
+    end
+  end
+end

data/lib/cent/error.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Cent
+  # Cent::Error
+  #
+  #   Wrapper for all errors(failures).
+  #
+  class Error < StandardError; end
+end

data/lib/cent/http.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'cent/error'
+
+module Cent
+  # Cent::ResponseError
+  #
+  #   Raised when response from Centrifugo contains any error as result of API command execution.
+  #
+  class ResponseError < Error
+    attr_reader :code
+
+    def initialize(code:, message:)
+      @code = code
+      super message
+    end
+  end
+
+  # Cent::HTTP
+  #
+  #   Holds request call and response handling logic
+  #
+  class HTTP
+    attr_reader :connection
+
+    # @param connection [Faraday::Connection] HTTP Connection object
+    #
+    def initialize(connection:)
+      @connection = connection
+    end
+
+    # Perform POST request to centrifugo API
+    # @param body [Hash] Request body(non serialized)
+    #
+    # @raise [Cent::ResponseError]
+    #
+    # @return [Hash] Parsed response body
+    #
+    def post(body: nil)
+      response = connection.post(nil, body)
+
+      raise ResponseError, response.body['error'].transform_keys(&:to_sym) if response.body.key?('error')
+
+      response.body
+    end
+  end
+end

data/lib/cent/notary.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require 'jwt'
+require 'cent/error'
+
+module Cent
+  # Cent::Notary
+  #
+  #   Handle token generation
+  #
+  class Notary
+    # @param secret [String | OpenSSL::PKey::RSA | OpenSSL::PKey::EC] Secret key for the algorithm of your choice.
+    # @param algorithm [String] Specify algorithm(one from HMAC, RSA or ECDSA family). Default is HS256.
+    #
+    # @example Construct new client instance
+    #   notary = Cent::Notary.new(secret: 'secret')
+    #
+    def initialize(secret:, algorithm: 'HS256')
+      raise Error, 'Secret can not be nil' if secret.nil?
+
+      @secret = secret
+      @algorithm = algorithm
+    end
+
+    # Generate connection JWT for the given user
+    #
+    # @param sub [String]
+    #   Standard JWT claim which must contain an ID of current application user.
+    #
+    # @option channel [String]
+    #   Channel that client tries to subscribe to (string).
+    #
+    # @param exp [Integer]
+    #   (default: nil) UNIX timestamp seconds when token will expire.
+    #
+    # @param info [Hash]
+    #   (default: {}) This claim is optional - this is additional information about
+    #   client connection that can be provided for Centrifugo.
+    #
+    # @example Get user JWT with expiration and extra info
+    #   notary.issue_connection_token(sub: '1', exp: 3600, info: { 'role' => 'admin' })
+    #     #=> "eyJhbGciOiJIUzI1NiJ9.eyJzdWIi..."
+    #
+    # @see (https://centrifugal.github.io/centrifugo/server/authentication/)
+    #
+    # @return [String]
+    #
+    def issue_connection_token(sub:, info: nil, exp: nil)
+      payload = {
+        'sub' => sub,
+        'info' => info,
+        'exp' => exp
+      }.compact
+
+      JWT.encode(payload, secret, algorithm)
+    end
+
+    # Generate JWT for private channels
+    #
+    # @param client [String]
+    #   Client ID which wants to subscribe on channel
+    #
+    # @option channel [String]
+    #   Channel that client tries to subscribe to (string).
+    #
+    # @param exp [Integer]
+    #   (default: nil) UNIX timestamp seconds when token will expire.
+    #
+    # @param info [Hash]
+    #   (default: {}) This claim is optional - this is additional information about
+    #   client connection that can be provided for Centrifugo.
+    #
+    # @example Get private channel JWT with expiration and extra info
+    #   notary.issue_channel_token(client: 'client', channel: 'channel', exp: 3600, info: { 'message' => 'wat' })
+    #     #=> eyJhbGciOiJIUzI1NiJ9.eyJjbGllbnQiOiJjbG..."
+    #
+    # @see (https://centrifugal.github.io/centrifugo/server/private_channels/)
+    #
+    # @return [String]
+    #
+    def issue_channel_token(client:, channel:, info: nil, exp: nil)
+      payload = {
+        'client' => client,
+        'channel' => channel,
+        'info' => info,
+        'exp' => exp
+      }.compact
+
+      JWT.encode(payload, secret, algorithm)
+    end
+
+    private
+
+    attr_reader :secret, :algorithm
+  end
+end

data/lib/cent/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Cent
+  VERSION = '2.0.0'
+end

metadata

@@ -1,124 +1,105 @@
 --- !ruby/object:Gem::Specification
 name: cent
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 2.0.0
 platform: ruby
 authors:
-- Alexander Emelin
+- Sergey Prikhodko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-16 00:00:00.000000000 Z
+date: 2021-08-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: httpclient
+  name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: multi_json
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
+        version: 1.7.0
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: 1.7.0
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: 2.0.0
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: faraday_middleware
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
+        version: '1.0'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
+        version: 2.0.0
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: webmock
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
+        version: '1.0'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.0.0
 - !ruby/object:Gem::Dependency
-  name: vcr
+  name: jwt
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
+        version: 2.2.1
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-description: Ruby gem for Centrifugo real-time messaging server
+        version: 2.2.1
+description: |
+  Provides helper classes Cent::Client and Cent::Notary.
+
+  `Cent::Client` is made to communicate to the server API
+  `Client::Notary` is a simple JWT wrapper to generate authorization tokens for the frontend
 email:
-- frvzmb@gmail.com
+- prikha@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
-files: []
+files:
+- ".github/workflows/main.yml"
+- ".github/workflows/release.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- cent.gemspec
+- lib/cent.rb
+- lib/cent/client.rb
+- lib/cent/error.rb
+- lib/cent/http.rb
+- lib/cent/notary.rb
+- lib/cent/version.rb
 homepage: https://github.com/centrifugal/rubycent
 licenses:
 - MIT
-metadata: {}
+metadata:
+  homepage_uri: https://github.com/centrifugal/rubycent
+  source_code_uri: https://github.com/centrifugal/rubycent
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -127,15 +108,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.3.1
 signing_key: 
 specification_version: 4
-summary: Ruby gem for Centrifugo real-time messaging server
+summary: Centrifugo API V2 Ruby Client
 test_files: []