zaikio-hub 0.6.1 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76ec2ffbec46a39d7132335f3855db80abbe10eaf2c8aebcedb31c1785715f6b
-  data.tar.gz: d69171f7abc873c12c766ddfdd188d7f0cd7be0df4c81ab0206cc9ef9cc255c4
+  metadata.gz: 18214a7030901b40e09a743798f3356cc2821588be5639360466d510425ecc1a
+  data.tar.gz: f1f691ed65c67d461bf4cc95ed0fdea6bf258ee7e8a7fb92778396c921df7bbe
 SHA512:
-  metadata.gz: 5290f7d1e9edfb3f08522e1098b663fe7f10cde3978a3ae9c48680b9ff90bc6b599d356c5536277311398716088039eda6046cb234ae1d14f9813c1ad27fdc0d
-  data.tar.gz: c88e8b7d077797ae90a843f42ceeb9e0c999ff69f1add278a70b5acd875ddd86934ab59f917af0547b1cf7031b8dc7847faf653a7f1476fdee7da8196f2402cb
+  metadata.gz: 7fb26a98cbf56f0cb9e4390d88af710b0452539b65d5f3b3dce474936e373bfaa77b6e98e1731560b9b44a2808ac96a958ac0b9a501961158084388cd94526e7
+  data.tar.gz: 79a2a1bcaf197e4eae88d31a8b87f0a3e127b1927f3e33f1437c9c52f5e1fd4e2fa42691974bee2c555c1eef6ec4f7a8aeb2263ec656ff2bd535267d0e3c8925

data/CHANGELOG.md

@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.0] - 2021-08-31
+
+* Added `.connections` and `.apps` for `CurrentOrganization`s that are vendors
+
+## [0.8.0] - 2021-08-25
+
+* Added `CurrentOrganization#create_subscription`
+
+## [0.7.0] - 2021-06-18
+
+* **BREAKING** `Relation#all` now fetches all following paginated resources by default
+  (endpoints which don't support pagination are unaffected).
+* **BREAKING** Removed `Relation#each_page` method. You should just use the `all` method now
+  instead:
+
+```diff
+-Model.all.each_page.flat_map(&:to_a)
++Model.all.to_a
+```
+
+## [0.6.2] - 2021-04-27
+
+* Include `id` property in `CurrentPerson#attributes` and `CurrentOrganization#attributes`
+
 ## [0.6.1] - 2020-04-12
 
 * Fixed that `each_page` works correctly with client instance
@@ -57,7 +81,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - Added subscriptions (migration required)
 
-[Unreleased]: https://github.com/zaikio/zaikio-hub-ruby/compare/v0.6.1..HEAD
+[Unreleased]: https://github.com/zaikio/zaikio-hub-ruby/compare/v0.9.0..HEAD
+[0.9.0]: https://github.com/zaikio/zaikio-hub-ruby/compare/v0.8.0..v0.9.0
+[0.8.0]: https://github.com/zaikio/zaikio-hub-ruby/compare/v0.7.0..v0.8.0
+[0.7.0]: https://github.com/zaikio/zaikio-hub-ruby/compare/v0.6.2..v0.7.0
+[0.6.2]: https://github.com/zaikio/zaikio-hub-ruby/compare/v0.6.1..v0.6.2
 [0.6.1]: https://github.com/zaikio/zaikio-hub-ruby/compare/v0.6.0..v0.6.1
 [0.6.0]: https://github.com/zaikio/zaikio-hub-ruby/compare/v0.5.0..v0.6.0
 [0.5.0]: https://github.com/zaikio/zaikio-hub-ruby/compare/v0.4.1..v0.5.0

data/README.md

@@ -46,8 +46,10 @@ token = "..." # Your valid JWT for an organization
 Zaikio::Hub.with_token(token) do
   organization = Zaikio::Hub::CurrentOrganization.new
 
-  # Fetch Data
+  # Fetch data
   organization.memberships.find('abc')
+
+  # Note that .all understands pagination headers and will fetch all pages
   organization.members.all
   organization.machines.all
   organization.software.all
@@ -122,16 +124,15 @@ client.test_accounts.create(
 
 ```rb
 Zaikio::Hub.with_basic_auth(client_id, client_secret) do
-  # Iterate through pages
-  Zaikio::Hub::Connection.per_page(10).each_page do |connections|
-    connections.size # e.g. 10
-    connections.total_count
-    connections.total_pages
-  end
-  # Load 2nd page
-  Zaikio::Hub::Connection.per_page(10).page(2)
+  # Get total number of records
+  Zaikio::Hub::Connection.per_page(10).total_count
+  #=> 20
+
+  # Fetch just the second page
+  Zaikio::Hub::Connection.per_page(10).page(2).find_some
+
   # All
-  all_connections = Zaikio::Hub::Connection.all.each_page.flat_map(&:to_a)
+  all_connections = Zaikio::Hub::Connection.all.to_a
 
   subscription = Zaikio::Hub::Subscription.find("Organization-b1475f65-236c-58b8-96e1-e1778b43beb7")
   subscription.plan # => "advanced"

data/lib/zaikio/hub/app.rb

@@ -0,0 +1,12 @@
+module Zaikio
+  module Hub
+    class App < Base
+      uri "apps(/:id)"
+
+      include_root_in_json :app
+
+      # Attributes
+      attributes :name, :category, :kind, :state, :configuration
+    end
+  end
+end

data/lib/zaikio/hub/base.rb

@@ -1,6 +1,8 @@
+require "zaikio/client/model"
+
 module Zaikio
   module Hub
-    class Base < Spyke::Base
+    class Base < Zaikio::Client::Model
       self.callback_methods = { create: :post, update: :patch }.freeze
     end
   end

data/lib/zaikio/hub/connection.rb

@@ -1,8 +1,6 @@
 module Zaikio
   module Hub
     class Connection < Base
-      include Zaikio::Hub::Pagination::Scopes
-
       uri "connections(/:id)"
 
       include_root_in_json :connection

data/lib/zaikio/hub/current_organization.rb

@@ -16,7 +16,7 @@ module Zaikio
       include_root_in_json :organization
 
       # Attributes
-      attributes :name, :slug, :logo_url, :connected, :subscription,
+      attributes :id, :name, :slug, :logo_url, :connected, :subscription,
                  :created_at, :updated_at, :country_code, :kinds,
                  :sections, :currency, :brand_color, :test_account_owner_id,
                  :granted_oauth_scopes, :requested_oauth_scopes,
@@ -35,6 +35,11 @@ module Zaikio
                                          uri: "specialists(/:id)"
       has_many :sites,                   class_name: "Zaikio::Hub::Site",
                                          uri: "sites(/:id)"
+      # For vendors
+      has_many :connections,             class_name: "Zaikio::Hub::Connection",
+                                         uri: "connections(/:id)"
+      has_many :apps,                    class_name: "Zaikio::Hub::App",
+                                         uri: "apps(/:id)"
 
       def fetch
         self.attributes = get
@@ -47,6 +52,14 @@ module Zaikio
       def members
         memberships.with_fallback.map(&:person)
       end
+
+      def create_subscription(status: "active", plan_name: nil)
+        if Zaikio::Hub.current_token_data.subject_type == "Organization"
+          result = self.class.request(:post, "organization/subscription",
+                                      subscription: { status: status, plan_name: plan_name })
+          Zaikio::Hub::Subscription.new(result.data)
+        end
+      end
     end
   end
 end

data/lib/zaikio/hub/current_person.rb

@@ -6,7 +6,7 @@ module Zaikio
       uri "person"
 
       # Attributes
-      attributes :updated_at, :created_at, :first_name, :name, :full_name, :email,
+      attributes :id, :updated_at, :created_at, :first_name, :name, :full_name, :email,
                  :pronoun, :locale, :country_code, :currency, :unit_system, :connected,
                  :test_account_owner_id, :time_zone, :email_confirmed,
                  :two_factor_authentication_enabled, :avatar_url, :subscription,

data/lib/zaikio/hub/subscription.rb

@@ -1,8 +1,6 @@
 module Zaikio
   module Hub
     class Subscription < Base
-      include Zaikio::Hub::Pagination::Scopes
-
       uri "subscriptions(/:id)"
 
       include_root_in_json :subscription
@@ -10,7 +8,7 @@ module Zaikio
       # Attributes
       attributes :updated_at, :created_at, :subscriber_type, :subscriber_id,
                  :status, :app_name, :activated_at, :last_billed_at,
-                 :last_paid_at, :trial_ended_at, :plan, :preceding_plan,
+                 :last_paid_at, :trial_ended_at, :plan, :plan_name, :preceding_plan,
                  :changed_plan_at, :usages_in_current_billing_period
 
       def initialize(attributes = {})

data/lib/zaikio/hub/version.rb

@@ -1,5 +1,5 @@
 module Zaikio
   module Hub
-    VERSION = "0.6.1".freeze
+    VERSION = "0.9.0".freeze
   end
 end

data/lib/zaikio/hub.rb

@@ -1,15 +1,12 @@
 require "faraday"
 require "spyke"
+require "zaikio-client-helpers"
+
 require "zaikio/hub/configuration"
-require "zaikio/hub/json_parser"
 require "zaikio/hub/authorization_middleware"
 require "zaikio/hub/basic_auth_middleware"
 
-# Pagination
-require "zaikio/hub/pagination"
-
 # Models
-require "zaikio/error"
 require "zaikio/hub/client"
 require "zaikio/hub/base"
 require "zaikio/hub/asset"
@@ -28,6 +25,7 @@ require "zaikio/hub/current_organization"
 require "zaikio/hub/role"
 require "zaikio/hub/revoked_access_token"
 require "zaikio/hub/connection"
+require "zaikio/hub/app"
 require "zaikio/hub/subscription"
 require "zaikio/hub/test_account"
 
@@ -73,8 +71,8 @@ module Zaikio
                                       ssl: { verify: configuration.environment != :test }) do |c|
           c.request     :json
           c.response    :logger, configuration&.logger, headers: false
-          c.use         Zaikio::Hub::Pagination::HeaderParser
-          c.use         JSONParser
+          c.use         Zaikio::Client::Helpers::Pagination::FaradayMiddleware
+          c.use         Zaikio::Client::Helpers::JSONParser
           c.use         AuthorizationMiddleware
           c.use         BasicAuthMiddleware
           c.adapter     Faraday.default_adapter

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zaikio-hub
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.9.0
 platform: ruby
 authors:
 - crispymtn
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-04-12 00:00:00.000000000 Z
+date: 2021-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -69,7 +69,7 @@ dependencies:
         version: 3.10.5
     - - "<"
       - !ruby/object:Gem::Version
-        version: 3.12.0
+        version: 3.14.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -79,7 +79,7 @@ dependencies:
         version: 3.10.5
     - - "<"
       - !ruby/object:Gem::Version
-        version: 3.12.0
+        version: 3.14.0
 - !ruby/object:Gem::Dependency
   name: spyke
   requirement: !ruby/object:Gem::Requirement
@@ -89,7 +89,7 @@ dependencies:
         version: 5.3.4
     - - "<"
       - !ruby/object:Gem::Version
-        version: 5.5.0
+        version: 6.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -99,7 +99,21 @@ dependencies:
         version: 5.3.4
     - - "<"
       - !ruby/object:Gem::Version
-        version: 5.5.0
+        version: 6.1.0
+- !ruby/object:Gem::Dependency
+  name: zaikio-client-helpers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
 description: Ruby API Client for Zaikio's Hub
 email:
 - op@crispymtn.com
@@ -113,9 +127,9 @@ files:
 - MIT-LICENSE
 - README.md
 - Rakefile
-- lib/zaikio/error.rb
 - lib/zaikio/hub.rb
 - lib/zaikio/hub/address.rb
+- lib/zaikio/hub/app.rb
 - lib/zaikio/hub/asset.rb
 - lib/zaikio/hub/authorization_middleware.rb
 - lib/zaikio/hub/base.rb
@@ -126,15 +140,10 @@ files:
 - lib/zaikio/hub/connection.rb
 - lib/zaikio/hub/current_organization.rb
 - lib/zaikio/hub/current_person.rb
-- lib/zaikio/hub/json_parser.rb
 - lib/zaikio/hub/machine.rb
 - lib/zaikio/hub/membership.rb
 - lib/zaikio/hub/organization.rb
 - lib/zaikio/hub/organization_membership.rb
-- lib/zaikio/hub/pagination.rb
-- lib/zaikio/hub/pagination/header_parser.rb
-- lib/zaikio/hub/pagination/relation.rb
-- lib/zaikio/hub/pagination/scopes.rb
 - lib/zaikio/hub/person.rb
 - lib/zaikio/hub/revoked_access_token.rb
 - lib/zaikio/hub/role.rb

data/lib/zaikio/error.rb

@@ -1,18 +0,0 @@
-module Zaikio
-  class Error < StandardError; end
-
-  class ConnectionError < Zaikio::Error; end
-
-  class ResourceNotFound < Zaikio::Error; end
-end
-
-module Spyke
-  instance_eval do
-    # avoid warning: already initialized constant
-    remove_const("ConnectionError")
-    remove_const("ResourceNotFound")
-  end
-
-  ConnectionError = Class.new Zaikio::ConnectionError
-  ResourceNotFound = Class.new Zaikio::ResourceNotFound
-end

data/lib/zaikio/hub/json_parser.rb

@@ -1,36 +0,0 @@
-require "multi_json"
-
-module Zaikio
-  module Hub
-    class JSONParser < Faraday::Response::Middleware
-      def on_complete(env)
-        connection_error(env) unless /^(2\d\d)|422|404$/.match?(env.status.to_s)
-
-        raise Spyke::ResourceNotFound if env.status.to_s == "404"
-
-        env.body = parse_body(env.body)
-      end
-
-      def connection_error(env)
-        Zaikio::Hub.configuration.logger
-                   .error("Zaikio::Hub Status Code #{env.status}, #{env.body}")
-        raise Spyke::ConnectionError, "Status Code #{env.status}, #{env.body}"
-      end
-
-      def parse_body(body)
-        json = MultiJson.load(body, symbolize_keys: true)
-        {
-          data: json,
-          metadata: {},
-          errors: json.is_a?(Hash) ? json[:errors] : {}
-        }
-      rescue MultiJson::ParseError
-        {
-          data: {},
-          metadata: {},
-          errors: {}
-        }
-      end
-    end
-  end
-end

data/lib/zaikio/hub/pagination/header_parser.rb

@@ -1,25 +0,0 @@
-module Zaikio
-  module Hub
-    module Pagination
-      class HeaderParser < Faraday::Response::Middleware
-        def on_complete(env)
-          @env = env
-
-          metadata = Zaikio::Hub::Pagination::HEADERS.transform_values do |key|
-            header(key)
-          end
-
-          @env.body[:metadata] ||= {}
-          @env.body[:metadata][Zaikio::Hub::Pagination::METADATA_KEY] = metadata
-        end
-
-        private
-
-        def header(key)
-          value = @env.response_headers[key]
-          value.try(:to_i)
-        end
-      end
-    end
-  end
-end

data/lib/zaikio/hub/pagination/relation.rb

@@ -1,41 +0,0 @@
-module Zaikio
-  module Hub
-    module Pagination
-      class Relation < Spyke::Relation
-        Zaikio::Hub::Pagination::HEADERS.each_key do |symbol|
-          define_method(symbol) do
-            find_some.metadata[Zaikio::Hub::Pagination::METADATA_KEY][symbol]
-          end
-        end
-
-        def first_page?
-          current_page == 1
-        end
-
-        def next_page
-          current_page + 1
-        end
-
-        def last_page?
-          current_page == total_pages
-        end
-
-        def out_of_range?
-          current_page > total_pages
-        end
-
-        def each_page
-          return to_enum(:each_page) unless block_given?
-
-          relation = clone
-          yield relation
-          return if relation.last_page? || relation.out_of_range?
-
-          (relation.next_page..relation.total_pages).each do |number|
-            yield clone.page(number)
-          end
-        end
-      end
-    end
-  end
-end

data/lib/zaikio/hub/pagination/scopes.rb

@@ -1,23 +0,0 @@
-module Zaikio
-  module Hub
-    module Pagination
-      module Scopes
-        extend ActiveSupport::Concern
-
-        included do
-          %i[page per_page].each do |symbol|
-            scope symbol, ->(value) { where(symbol => value) }
-          end
-        end
-
-        module ClassMethods
-          # Overrides the method included by Spyke::Scoping to return paginated
-          # relations.
-          def all
-            current_scope || Zaikio::Hub::Pagination::Relation.new(self, uri: uri)
-          end
-        end
-      end
-    end
-  end
-end

data/lib/zaikio/hub/pagination.rb

@@ -1,19 +0,0 @@
-# adapted from https://github.com/balvig/spyke-kaminari
-
-module Zaikio
-  module Hub
-    module Pagination
-      HEADERS = {
-        total_count: "Total-Count",
-        total_pages: "Total-Pages",
-        current_page: "Current-Page"
-      }.freeze
-
-      METADATA_KEY = :pagination
-    end
-  end
-end
-
-require "zaikio/hub/pagination/scopes"
-require "zaikio/hub/pagination/relation"
-require "zaikio/hub/pagination/header_parser"