cent 3.0.0 → 5.0.0

data/lib/cent/wire.rb

@@ -0,0 +1,222 @@
+# frozen_string_literal: true
+
+module Cent
+  # Encoding requests and decoding replies, for the generated code: each field
+  # is put or got by its kind - :str, :bool, :int, :float, :json (a payload),
+  # :bool_value and :int32_value (protobuf wrappers), or a message's class - and
+  # its shape - :one, :list, :map, or :presence for a message which is a
+  # presence wrapper, sent whenever it is set, even empty.
+  #
+  # @api private
+  module Wire
+    ZERO = { str: "", bool: false, int: 0, float: 0.0 }.freeze
+
+    module_function
+
+    # Sets +w[key]+ to the encoded field +v+, unless it is unset or at its zero
+    # value: nil, "", false, 0, an empty list or map, a message with nothing set
+    # - but a presence wrapper, sent as {} when set empty. +where+ prefixes the
+    # field's name in error messages.
+    def put(w, key, v, where, kind, shape = :one)
+      return if v.nil?
+
+      out =
+        case shape
+        when :list
+          raise InvalidRequestError, "#{where}#{key} must be an Array, not #{kind_of(v)}" unless v.is_a?(Array)
+          return if v.empty?
+
+          v.each_with_index.map { |item, i| value(kind, item, "#{where}#{key}[#{i}]", true) }
+        when :map
+          raise InvalidRequestError, "#{where}#{key} must be a Hash, not #{kind_of(v)}" unless v.is_a?(Hash)
+          return if v.empty?
+
+          v.each_with_object({}) do |(k, item), h|
+            name = map_key(k, "#{where}#{key}")
+            h[name] = value(kind, item, "#{where}#{key}[#{name.inspect}]", true)
+          end
+        else value(kind, v, "#{where}#{key}", shape == :presence)
+        end
+      w[key] = out unless out.nil?
+    end
+
+    # One value of a field, encoded; nil for a zero value, unless +keep+ (an
+    # item of a list or map, a presence wrapper).
+    def value(kind, v, path, keep)
+      case kind
+      when :str, :bool, :int, :float then scalar(kind, v, path, keep)
+      when :json then Payload.check!(v, path)
+      when :bool_value
+        raise InvalidRequestError, "#{path} must be true or false, not #{kind_of(v)}" unless [true, false].include?(v)
+
+        { "value" => v }
+      when :int32_value
+        raise InvalidRequestError, "#{path} must be an Integer, not #{kind_of(v)}" unless v.is_a?(Integer)
+
+        { "value" => v }
+      else
+        w = message(kind, v, path).to_wire("#{path}.")
+        w.empty? && !keep ? nil : w
+      end
+    end
+
+    def scalar(kind, v, path, keep)
+      case kind
+      when :str
+        s = case v
+            when String then v
+            when Symbol then v.name
+            else raise InvalidRequestError, "#{path} must be a String, not #{kind_of(v)}"
+            end
+        Payload.string!(s, path)
+        s.empty? && !keep ? nil : s
+      when :bool
+        raise InvalidRequestError, "#{path} must be true or false, not #{kind_of(v)}" unless [true, false].include?(v)
+
+        v || keep ? v : nil
+      when :int
+        raise InvalidRequestError, "#{path} must be an Integer, not #{kind_of(v)}" unless v.is_a?(Integer)
+
+        v.zero? && !keep ? nil : v
+      when :float
+        unless (v.is_a?(Float) && v.finite?) || v.is_a?(Integer)
+          raise InvalidRequestError, "#{path} must be a finite number, not #{kind_of(v)}"
+        end
+
+        v.zero? && !keep ? nil : v
+      end
+    end
+
+    # A message given as its class's instance, or as a Hash of its fields.
+    def message(klass, v, path)
+      return v if v.is_a?(klass)
+      unless v.is_a?(Hash)
+        raise InvalidRequestError, "#{path} must be a #{short(klass)} or a Hash of its fields, not #{kind_of(v)}"
+      end
+
+      v.each_key do |k|
+        next if k.is_a?(Symbol) && klass.members.include?(k)
+
+        name = k.to_s
+        if k.is_a?(String) && klass.members.include?(name.to_sym)
+          raise InvalidRequestError, "#{path}: field names are Symbols - #{name}:, not #{name.inspect}"
+        end
+
+        like = DidYouMean::SpellChecker.new(dictionary: klass.members.map(&:name)).correct(name).first
+        raise InvalidRequestError,
+              "#{path}.#{name} is not a field of #{short(klass)}#{": did you mean #{like}?" if like}"
+      end
+      missing = required_members(klass).find { !v.key?(it) }
+      raise InvalidRequestError, "#{path}.#{missing} is required" if missing
+
+      klass.new(**v)
+    end
+
+    # The fields a message type's initialize requires: every one when it is
+    # Data's own, which the generator leaves when no field has a default.
+    def required_members(klass)
+      params = klass.instance_method(:initialize).parameters
+      return klass.members if params == [[:rest]]
+
+      params.filter_map { |t, name| name if t == :keyreq }
+    end
+
+    # Raises InvalidRequestError naming the first field the proto marks
+    # required which the JSON +w+ of the request or message +key+ - its method
+    # or name in REQUIRED - leaves out: unset, or at its zero value. A nested
+    # message is checked when it is set, a list's each.
+    def check_required(w, key, path = "")
+      REQUIRED.fetch(key).each do |name, required, nested, list|
+        v = w[name]
+        if v.nil?
+          raise InvalidRequestError, "#{path}#{name} is required" if required
+
+          next
+        end
+        next unless nested
+
+        if list
+          v.each_with_index { |item, i| check_required(item, nested, "#{path}#{name}[#{i}].") }
+        else
+          check_required(v, nested, "#{path}#{name}.")
+        end
+      end
+    end
+
+    def map_key(k, path)
+      case k
+      when String
+        Payload.string!(k, "#{path} key #{k.inspect}")
+        k
+      when Symbol then k.name
+      else raise InvalidRequestError, "#{path} has a #{k.class} key, #{k.inspect}: keys are strings"
+      end
+    end
+
+    # The field +key+ of the decoded object +d+, at its zero value when the reply
+    # left it out; fields the client does not know are ignored.
+    def get(d, key, where, kind, shape = :one)
+      v = d[key]
+      case shape
+      when :list
+        return [] if v.nil?
+        raise DecodeError, "#{where}.#{key}: expected an array, got #{kind_of(v)}" unless v.is_a?(Array)
+
+        v.each_with_index.map { |item, i| decode(kind, item, "#{where}.#{key}[#{i}]") }
+      when :map
+        return {} if v.nil?
+
+        obj(v, "#{where}.#{key}").to_h { |k, item| [k, decode(kind, item, "#{where}.#{key}[#{k.inspect}]")] }
+      else
+        return ZERO.fetch(kind, nil) if v.nil? && kind != :json
+
+        decode(kind, v, "#{where}.#{key}")
+      end
+    end
+
+    def decode(kind, v, path)
+      case kind
+      when :str
+        raise DecodeError, "#{path}: expected a string, got #{kind_of(v)}" unless v.is_a?(String)
+      when :bool
+        raise DecodeError, "#{path}: expected a boolean, got #{kind_of(v)}" unless [true, false].include?(v)
+      when :int
+        raise DecodeError, "#{path}: expected an integer, got #{kind_of(v)}" unless v.is_a?(Integer)
+      when :float
+        raise DecodeError, "#{path}: expected a number, got #{kind_of(v)}" unless v.is_a?(Numeric)
+
+        return v.to_f
+      when :json then nil
+      when :bool_value, :int32_value
+        inner = obj(v, path)["value"]
+        # The value's zero, which a protobuf encoder leaves out.
+        return kind == :bool_value ? false : 0 if inner.nil?
+
+        return decode(kind == :bool_value ? :bool : :int, inner, "#{path}.value")
+      else return kind.from_wire(v, path)
+      end
+      v
+    end
+
+    def obj(v, where)
+      raise DecodeError, "#{where}: expected an object, got #{kind_of(v)}" unless v.is_a?(Hash)
+
+      v
+    end
+
+    def kind_of(v)
+      case v
+      when nil then "nil"
+      when true, false then v.to_s
+      when String then "a String"
+      when Integer then "an Integer, #{v}"
+      when Float then "a Float, #{v}"
+      when Array then "an Array"
+      when Hash then "a Hash"
+      else "a #{v.class}"
+      end
+    end
+
+    def short(klass) = klass.name.delete_prefix("Cent::")
+  end
+end

data/lib/cent.rb

@@ -1,10 +1,38 @@
 # frozen_string_literal: true
 
-require 'cent/version'
-require 'cent/notary'
-require 'cent/client'
+require "json"
+require "net/http"
+require "openssl"
+require "zlib"
 
-# Centrifugo Ruby Client
+# Ruby SDK for Centrifugo's HTTP server API:
+#
+#   client = Cent::Client.new(api_endpoint: "http://localhost:8000/api", api_key: ENV.fetch("CENTRIFUGO_API_KEY"))
+#   client.publish(channel: "news", data: { text: "hello" })
+#
+# See https://github.com/centrifugal/rubycent for the documentation.
 module Cent
-  # Here will be code...
 end
+
+require_relative "cent/version"
+require_relative "cent/message"
+require_relative "cent/errors"
+require_relative "cent/payload"
+require_relative "cent/wire"
+require_relative "cent/http"
+require_relative "cent/generated/types"
+require_relative "cent/generated/methods"
+require_relative "cent/reply"
+require_relative "cent/pages"
+require_relative "cent/broadcast"
+require_relative "cent/retry"
+require_relative "cent/batch"
+require_relative "cent/command"
+require_relative "cent/auto_batch"
+require_relative "cent/client"
+require_relative "cent/handler"
+require_relative "cent/token"
+require_relative "cent/shared_poll"
+require_relative "cent/endpoints"
+require_relative "cent/generated/proxy_types"
+require_relative "cent/proxy"

metadata

@@ -1,92 +1,75 @@
 --- !ruby/object:Gem::Specification
 name: cent
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 5.0.0
 platform: ruby
 authors:
 - Sergey Prikhodko
-autorequire: 
+- Centrifugal Labs
 bindir: bin
 cert_chain: []
-date: 2024-03-25 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: faraday
+  name: json
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.0
-    - - ">"
-      - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: '2.10'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 3.0.0
-    - - ">"
-      - !ruby/object:Gem::Version
-        version: 2.0.0
-- !ruby/object:Gem::Dependency
-  name: jwt
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 3.0.0
-    - - ">"
-      - !ruby/object:Gem::Version
-        version: 2.2.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: 3.0.0
-    - - ">"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 2.2.0
+        version: '2.10'
 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
+  Every method of Centrifugo's HTTP server API, with typed results, batches,
+  automatic batching and retries; connection, subscription and API tokens,
+  JWKS; endpoints for client SDKs and Rack handlers for Centrifugo's proxy.
+  No dependencies but json.
 email:
 - prikha@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/workflows/main.yml"
-- ".github/workflows/release.yml"
-- ".gitignore"
-- ".rspec"
-- ".rubocop.yml"
 - CHANGELOG.md
-- Gemfile
 - LICENSE.txt
+- MIGRATING.md
 - README.md
-- Rakefile
-- bin/console
-- bin/setup
-- cent.gemspec
 - lib/cent.rb
+- lib/cent/auto_batch.rb
+- lib/cent/batch.rb
+- lib/cent/broadcast.rb
 - lib/cent/client.rb
-- lib/cent/error.rb
+- lib/cent/command.rb
+- lib/cent/endpoints.rb
+- lib/cent/errors.rb
+- lib/cent/generated/methods.rb
+- lib/cent/generated/proxy_types.rb
+- lib/cent/generated/types.rb
+- lib/cent/handler.rb
 - lib/cent/http.rb
-- lib/cent/notary.rb
+- lib/cent/message.rb
+- lib/cent/pages.rb
+- lib/cent/payload.rb
+- lib/cent/proxy.rb
+- lib/cent/reply.rb
+- lib/cent/retry.rb
+- lib/cent/shared_poll.rb
+- lib/cent/token.rb
 - lib/cent/version.rb
+- lib/cent/wire.rb
 homepage: https://github.com/centrifugal/rubycent
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/centrifugal/rubycent
   source_code_uri: https://github.com/centrifugal/rubycent
-post_install_message: 
+  changelog_uri: https://github.com/centrifugal/rubycent/blob/master/CHANGELOG.md
+  bug_tracker_uri: https://github.com/centrifugal/rubycent/issues
+  documentation_uri: https://rubydoc.info/gems/cent
 rdoc_options: []
 require_paths:
 - lib
@@ -94,15 +77,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
-signing_key: 
+rubygems_version: 4.0.20
 specification_version: 4
-summary: Centrifugo API V2 Ruby Client
+summary: Ruby SDK for Centrifugo's HTTP server API
 test_files: []

data/.github/workflows/main.yml

@@ -1,20 +0,0 @@
-name: Ruby
-
-on: [push,pull_request]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        ruby-version: ['2.7', '3.3']
-    steps:
-    - uses: actions/checkout@v4
-    - name: Set up Ruby
-      uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: ${{ matrix.ruby-version }}
-    - name: Run the default task
-      run: |
-        bundle install
-        bundle exec rake

data/.github/workflows/release.yml

@@ -1,37 +0,0 @@
-name: Release Ruby Gem
-
-on:
-  push:
-    tags:
-      - 'v[0-9].[0-9]+.[0-9]+'
-jobs:
-  build-and-release:
-    name: Release
-    runs-on: ubuntu-latest
-    permissions:
-      packages: write
-      contents: read
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: 3.3.0
-
-      - name: Bundle install
-        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

@@ -1,20 +0,0 @@
-/.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

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

data/.rubocop.yml

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

data/Gemfile

@@ -1,17 +0,0 @@
-# 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/Rakefile

@@ -1,12 +0,0 @@
-# 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

@@ -1,15 +0,0 @@
-#!/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

@@ -1,8 +0,0 @@
-#!/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

@@ -1,35 +0,0 @@
-# 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', '<3.0.0', '> 2.0.0'
-  spec.add_dependency 'jwt', '<3.0.0', '> 2.2.0'
-end

data/lib/cent/error.rb

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