fastlane 2.126.0.beta.20190606200048 → 2.126.0.beta.20190607200028

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 61b4101d42b906b61eca04fa40634b785bc3422b
-  data.tar.gz: dc2d90be2d1fd77826e2f9ae2b4d024191743cf0
+  metadata.gz: d91d9d80b7f521a1830910eb7fd026640a56a698
+  data.tar.gz: 7dccfc7b62dabaa8a56885ca65f0b074817f0157
 SHA512:
-  metadata.gz: b6e4dcc9647440b2a8aab7ae69f2db28fb20ed0b3f27af3e416505261fc1bbd03da1576f51960a8909da5be60eb01ff0d8f4a96d57c99b2fb7c9a0014a53be51
-  data.tar.gz: dd1d9d09003164e0e7c97d7d733f7c9e8bdd803c7c793f627db1ac08e2b5a2a24ed9c15a7199b7c74b6ad27a1b965c9c7e6986ecc6e7400125f6bf5518ee3868
+  metadata.gz: 040c1029f885f87674fd9d817bfc2bea1ec7dd3580c7470b4b6850d537802016ef96af40e3f8ecddff63662699e946758229dbda4c4856cfcd8630d49e5b4ffc
+  data.tar.gz: f33329bc76c620f62268bf5c02b638913904d85659e88bba29cf3341291d3d079be08261dabf48b162e3d8a4e177b9cded99f6d0fe0f51cc9ee23ff37de0c443

data/fastlane/lib/fastlane/actions/app_store_build_number.rb

@@ -49,7 +49,7 @@ module Fastlane
           UI.message("Fetching the latest build number for #{version_number_message}")
 
           # Get latest build for optional version number and return build number if found
-          client = Spaceship::ConnectAPI::Base.client
+          client = Spaceship::ConnectAPI::TestFlight.client
           build = client.get_builds(filter: filter, sort: "-version", includes: "preReleaseVersion", limit: 1).first
           if build
             build_nr = build.version

data/fastlane/lib/fastlane/version.rb

@@ -1,5 +1,5 @@
 module Fastlane
-  VERSION = '2.126.0.beta.20190606200048'.freeze
+  VERSION = '2.126.0.beta.20190607200028'.freeze
   DESCRIPTION = "The easiest way to automate beta deployments and releases for your iOS and Android apps".freeze
   MINIMUM_XCODE_RELEASE = "7.0".freeze
   RUBOCOP_REQUIREMENT = '0.49.1'.freeze

data/fastlane_core/lib/fastlane_core/build_watcher.rb

@@ -1,5 +1,4 @@
-require 'spaceship/connect_api/models/build'
-require 'spaceship/connect_api/models/build_delivery'
+require 'spaceship/connect_api'
 
 require_relative 'ui/ui'
 
@@ -48,12 +47,12 @@ module FastlaneCore
         watched_app_version = remove_version_leading_zeros(version: watched_app_version)
         watched_build_version = remove_version_leading_zeros(version: watched_build_version)
 
-        build_deliveries = Spaceship::ConnectAPI::BuildDelivery.all(app_id: app_id, version: watched_app_version, build_number: watched_build_version)
+        build_deliveries = Spaceship::ConnectAPI::TestFlight::BuildDelivery.all(app_id: app_id, version: watched_app_version, build_number: watched_build_version)
         build_delivery = build_deliveries.first
 
         # Get processed builds when no longer in build deliveries
         if build_delivery.nil?
-          matched_builds = Spaceship::ConnectAPI::Build.all(
+          matched_builds = Spaceship::ConnectAPI::TestFlight::Build.all(
             app_id: app_id,
             version: watched_app_version,
             build_number: watched_build_version,

data/pilot/lib/pilot/build_manager.rb

@@ -100,14 +100,14 @@ module Pilot
       end
 
       # Get latest uploaded build if no build specified
-      build ||= Spaceship::ConnectAPI::Build.all(app_id: app.id, sort: "-uploadedDate", limit: 1).first
+      build ||= Spaceship::ConnectAPI::TestFlight::Build.all(app_id: app.id, sort: "-uploadedDate", limit: 1).first
 
       # Verify the build has all the includes that we need
       # and fetch a new build if not
       if build && (!build.app || !build.build_beta_detail || !build.pre_release_version)
         UI.important("Build did include information for app, build beta detail and pre release version")
         UI.important("Fetching a new build with all the information needed")
-        build = Spaceship::ConnectAPI::Build.get(build_id: build.id)
+        build = Spaceship::ConnectAPI::TestFlight::Build.get(build_id: build.id)
       end
 
       # Error out if no build
@@ -328,7 +328,7 @@ module Pilot
         uses_non_exempt_encryption = options[:uses_non_exempt_encryption]
         attributes = { usesNonExemptEncryption: uses_non_exempt_encryption }
 
-        client = Spaceship::ConnectAPI::Base.client
+        client = Spaceship::ConnectAPI::TestFlight.client
         client.patch_builds(build_id: uploaded_build.id, attributes: attributes)
 
         UI.important("Export compliance has been set to '#{uses_non_exempt_encryption}'. Need to wait for build to finishing processing again...")
@@ -350,7 +350,7 @@ module Pilot
       attributes[:demoAccountRequired] = info[:demo_account_required] if info.key?(:demo_account_required)
       attributes[:notes] = info[:notes] if info.key?(:notes)
 
-      client = Spaceship::ConnectAPI::Base.client
+      client = Spaceship::ConnectAPI::TestFlight.client
       client.patch_beta_app_review_detail(app_id: build.app.id, attributes: attributes)
     end
 
@@ -392,7 +392,7 @@ module Pilot
       attributes[:tvOsPrivacyPolicy] = info[:tv_os_privacy_policy_url] if info.key?(:tv_os_privacy_policy_url)
       attributes[:description] = info[:description] if info.key?(:description)
 
-      client = Spaceship::ConnectAPI::Base.client
+      client = Spaceship::ConnectAPI::TestFlight.client
       if localization
         client.patch_beta_app_localizations(localization_id: localization.id, attributes: attributes)
       else
@@ -435,7 +435,7 @@ module Pilot
       attributes = {}
       attributes[:whatsNew] = self.class.sanitize_changelog(info[:whats_new]) if info.key?(:whats_new)
 
-      client = Spaceship::ConnectAPI::Base.client
+      client = Spaceship::ConnectAPI::TestFlight.client
       if localization
         client.patch_beta_build_localizations(localization_id: localization.id, attributes: attributes)
       else
@@ -450,7 +450,7 @@ module Pilot
       attributes = {}
       attributes[:autoNotifyEnabled] = info[:auto_notify_enabled] if info.key?(:auto_notify_enabled)
 
-      client = Spaceship::ConnectAPI::Base.client
+      client = Spaceship::ConnectAPI::TestFlight.client
       client.patch_build_beta_details(build_beta_details_id: build_beta_detail.id, attributes: attributes)
     end
   end

data/pilot/lib/pilot/manager.rb

@@ -29,7 +29,7 @@ module Pilot
     def app
       @app_id ||= fetch_app_id
 
-      @app ||= Spaceship::ConnectAPI::App.get(app_id: @app_id)
+      @app ||= Spaceship::ConnectAPI::TestFlight::App.get(app_id: @app_id)
       unless @app
         UI.user_error!("Could not find app with #{(config[:apple_id] || config[:app_identifier])}")
       end
@@ -48,7 +48,7 @@ module Pilot
       config[:app_identifier] = fetch_app_identifier
 
       if config[:app_identifier]
-        @app ||= Spaceship::ConnectAPI::App.find(config[:app_identifier])
+        @app ||= Spaceship::ConnectAPI::TestFlight::App.find(config[:app_identifier])
         UI.user_error!("Couldn't find app '#{config[:app_identifier]}' on the account of '#{config[:username]}' on App Store Connect") unless @app
         @app_id ||= @app.id
       end

data/pilot/lib/pilot/tester_exporter.rb

@@ -15,7 +15,7 @@ module Pilot
       if app
         testers = app.get_beta_testers(includes: "apps,betaTesterMetrics,betaGroups")
       else
-        testers = Spaceship::ConnectAPI::BetaTester.all(includes: "apps,betaTesterMetrics,betaGroups")
+        testers = Spaceship::ConnectAPI::TestFlight::BetaTester.all(includes: "apps,betaTesterMetrics,betaGroups")
       end
 
       file = config[:testers_file_path]
@@ -41,13 +41,13 @@ module Pilot
 
     def find_app(apple_id: nil, app_identifier: nil)
       if app_identifier
-        app = Spaceship::ConnectAPI::App.find(app_identifier)
+        app = Spaceship::ConnectAPI::TestFlight::App.find(app_identifier)
         UI.user_error!("Could not find an app by #{app_identifier}") unless app
         return app
       end
 
       if apple_id
-        app = Spaceship::ConnectAPI::App.get(app_id: apple_id)
+        app = Spaceship::ConnectAPI::TestFlight::App.get(app_id: apple_id)
         UI.user_error!("Could not find an app by #{apple_id}") unless app
         return app
       end

data/pilot/lib/pilot/tester_manager.rb

@@ -83,13 +83,13 @@ module Pilot
 
     def find_app(apple_id: nil, app_identifier: nil)
       if app_identifier
-        app = Spaceship::ConnectAPI::App.find(app_identifier)
+        app = Spaceship::ConnectAPI::TestFlight::App.find(app_identifier)
         UI.user_error!("Could not find an app by #{app_identifier}") unless app
         return app
       end
 
       if apple_id
-        app = Spaceship::ConnectAPI::App.get(app_id: apple_id)
+        app = Spaceship::ConnectAPI::TestFlight::App.get(app_id: apple_id)
         UI.user_error!("Could not find an app by #{apple_id}") unless app
         return app
       end

data/spaceship/lib/spaceship/connect_api.rb

@@ -1,20 +1,5 @@
-require 'spaceship/connect_api/client'
-require 'spaceship/connect_api/base'
+require 'spaceship/connect_api/model'
 require 'spaceship/connect_api/response'
 require 'spaceship/connect_api/token'
 
-require 'spaceship/connect_api/models/model'
-require 'spaceship/connect_api/models/app'
-require 'spaceship/connect_api/models/beta_app_localization'
-require 'spaceship/connect_api/models/beta_build_localization'
-require 'spaceship/connect_api/models/beta_build_metric'
-require 'spaceship/connect_api/models/beta_app_review_detail'
-require 'spaceship/connect_api/models/beta_app_review_submission'
-require 'spaceship/connect_api/models/beta_group'
-require 'spaceship/connect_api/models/beta_tester'
-require 'spaceship/connect_api/models/beta_tester_metric'
-require 'spaceship/connect_api/models/build'
-require 'spaceship/connect_api/models/build_delivery'
-require 'spaceship/connect_api/models/build_beta_detail'
-require 'spaceship/connect_api/models/pre_release_version'
-require 'spaceship/connect_api/models/user'
+require 'spaceship/connect_api/testflight/testflight'

data/spaceship/lib/spaceship/connect_api/{models/model.rb → model.rb}

@@ -1,4 +1,5 @@
 require_relative '../base'
+require_relative './testflight/base'
 
 module Spaceship
   module ConnectAPI
@@ -11,8 +12,8 @@ module Spaceship
       end
 
       module ClassMethods
-        def client
-          return Spaceship::ConnectAPI::Base.client
+        def testflight_client
+          return Spaceship::ConnectAPI::TestFlight::Base.client
         end
       end
 
@@ -30,8 +31,8 @@ module Spaceship
         end
       end
 
-      def client
-        return Spaceship::ConnectAPI::Base.client
+      def testflight_client
+        return Spaceship::ConnectAPI::TestFlight::Base.client
       end
 
       #

data/spaceship/lib/spaceship/connect_api/response.rb

@@ -1,5 +1,4 @@
-require_relative './base'
-require_relative './models/model'
+require_relative './model'
 
 module Spaceship
   module ConnectAPI
@@ -7,14 +6,12 @@ module Spaceship
       include Enumerable
       attr_reader :body
       attr_reader :status
+      attr_reader :client
 
-      def initialize(body: nil, status: nil)
+      def initialize(body: nil, status: nil, client: nil)
         @body = body
         @status = status
-      end
-
-      def client
-        return Spaceship::ConnectAPI::Base.client
+        @client = client
       end
 
       def next_url

data/spaceship/lib/spaceship/connect_api/testflight/base.rb

@@ -0,0 +1,41 @@
+require_relative '../../base'
+require_relative '../../tunes/tunes_client'
+
+module Spaceship
+  module ConnectAPI
+    module TestFlight
+      class Base < Spaceship::Base
+        def self.client
+          # Verify there is a client that can be used
+          if Spaceship::Tunes.client
+            # Initialize new client if new or if team changed
+            if @client.nil? || @client.team_id != Spaceship::Tunes.client.team_id
+              @client = Client.client_with_authorization_from(Spaceship::Tunes.client)
+            end
+          end
+
+          # Need to handle not having a client but this shouldn't ever happen
+          raise "Please login using `Spaceship::Tunes.login('user', 'password')`" unless @client
+
+          @client
+        end
+
+        ##
+        # Have subclasses inherit the client from their superclass
+        #
+        # Essentially, we are making a class-inheritable-accessor as described here:
+        # https://apidock.com/rails/v4.2.7/Class/class_attribute
+        def self.inherited(subclass)
+          this_class = self
+          subclass.define_singleton_method(:client) do
+            this_class.client
+          end
+        end
+
+        def to_json
+          raw_data.to_json
+        end
+      end
+    end
+  end
+end

data/spaceship/lib/spaceship/connect_api/testflight/client.rb

@@ -0,0 +1,553 @@
+require_relative '../../client'
+require_relative '../response'
+
+module Spaceship
+  # rubocop:disable Metrics/ClassLength
+  module ConnectAPI
+    module TestFlight
+      class Client < Spaceship::Client
+        ##
+        # Spaceship HTTP client for the App Store Connect API.
+        #
+        # This client is solely responsible for the making HTTP requests and
+        # parsing their responses. Parameters should be either named parameters, or
+        # for large request data bodies, pass in anything that can resond to
+        # `to_json`.
+        #
+        # Each request method should validate the required parameters. A required parameter is one that would result in 400-range response if it is not supplied.
+        # Each request method should make only one request. For more high-level logic, put code in the data models.
+
+        def self.hostname
+          'https://appstoreconnect.apple.com/iris/v1/'
+        end
+
+        #
+        # Helpers
+        #
+
+        def build_params(filter: nil, includes: nil, limit: nil, sort: nil, cursor: nil)
+          params = {}
+
+          filter = filter.delete_if { |k, v| v.nil? } if filter
+
+          params[:filter] = filter if filter && !filter.empty?
+          params[:include] = includes if includes
+          params[:limit] = limit if limit
+          params[:sort] = sort if sort
+          params[:cursor] = cursor if cursor
+
+          return params
+        end
+
+        def get(url_or_path, params = nil)
+          response = request(:get) do |req|
+            req.url(url_or_path)
+            req.options.params_encoder = Faraday::NestedParamsEncoder
+            req.params = params if params
+          end
+          handle_response(response)
+        end
+
+        def post(url_or_path, body)
+          response = request(:post) do |req|
+            req.url(url_or_path)
+            req.body = body.to_json
+            req.headers['Content-Type'] = 'application/json'
+          end
+          handle_response(response)
+        end
+
+        def patch(url_or_path, body)
+          response = request(:patch) do |req|
+            req.url(url_or_path)
+            req.body = body.to_json
+            req.headers['Content-Type'] = 'application/json'
+          end
+          handle_response(response)
+        end
+
+        def delete(url_or_path, params = nil, body = nil)
+          response = request(:delete) do |req|
+            req.url(url_or_path)
+            req.options.params_encoder = Faraday::NestedParamsEncoder if params
+            req.params = params if params
+            req.body = body.to_json if body
+            req.headers['Content-Type'] = 'application/json' if body
+          end
+          handle_response(response)
+        end
+
+        #
+        # apps
+        #
+
+        def get_apps(filter: {}, includes: nil, limit: nil, sort: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/apps
+          params = build_params(filter: filter, includes: includes, limit: limit, sort: sort)
+          get("apps", params)
+        end
+
+        def get_app(app_id: nil, includes: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/apps/<app_id>
+          params = build_params(filter: nil, includes: includes, limit: nil, sort: nil)
+          get("apps/#{app_id}", params)
+        end
+
+        #
+        # betaAppLocalizations
+        #
+
+        def get_beta_app_localizations(filter: {}, includes: nil, limit: nil, sort: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/betaAppLocalizations?filter[app]=<app_id>
+          params = build_params(filter: filter, includes: includes, limit: limit, sort: sort)
+          get("betaAppLocalizations", params)
+        end
+
+        def post_beta_app_localizations(app_id: nil, attributes: {})
+          # POST
+          # https://appstoreconnect.apple.com/iris/v1/betaAppLocalizations
+          path = "betaAppLocalizations"
+
+          body = {
+            data: {
+              attributes: attributes,
+              type: "betaAppLocalizations",
+              relationships: {
+                app: {
+                  data: {
+                    type: "apps",
+                    id: app_id
+                  }
+                }
+              }
+            }
+          }
+
+          post(path, body)
+        end
+
+        def patch_beta_app_localizations(localization_id: nil, attributes: {})
+          # PATCH
+          # https://appstoreconnect.apple.com/iris/v1/apps/<app_id>/betaAppLocalizations/<localization_id>
+          path = "betaAppLocalizations/#{localization_id}"
+
+          body = {
+            data: {
+              attributes: attributes,
+              id: localization_id,
+              type: "betaAppLocalizations"
+            }
+          }
+
+          patch(path, body)
+        end
+
+        #
+        # betaAppReviewDetails
+        #
+
+        def get_beta_app_review_detail(filter: {}, includes: nil, limit: nil, sort: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/betaAppReviewDetails?filter[app]=<app_id>
+          params = build_params(filter: filter, includes: includes, limit: limit, sort: sort)
+          get("betaAppReviewDetails", params)
+        end
+
+        def patch_beta_app_review_detail(app_id: nil, attributes: {})
+          # PATCH
+          # https://appstoreconnect.apple.com/iris/v1/apps/<app_id>/betaAppReviewDetails
+          path = "betaAppReviewDetails/#{app_id}"
+
+          body = {
+            data: {
+              attributes: attributes,
+              id: app_id,
+              type: "betaAppReviewDetails"
+            }
+          }
+
+          patch(path, body)
+        end
+
+        #
+        # betaAppReviewSubmissions
+        #
+
+        def get_beta_app_review_submissions(filter: {}, includes: nil, limit: nil, sort: nil, cursor: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/betaAppReviewSubmissions
+          params = build_params(filter: filter, includes: includes, limit: limit, sort: sort, cursor: cursor)
+          get("betaAppReviewSubmissions", params)
+        end
+
+        def post_beta_app_review_submissions(build_id: nil)
+          # POST
+          # https://appstoreconnect.apple.com/iris/v1/betaAppReviewSubmissions
+          path = "betaAppReviewSubmissions"
+          body = {
+            data: {
+              type: "betaAppReviewSubmissions",
+              relationships: {
+                build: {
+                  data: {
+                    type: "builds",
+                    id: build_id
+                  }
+                }
+              }
+            }
+          }
+
+          post(path, body)
+        end
+
+        def delete_beta_app_review_submission(beta_app_review_submission_id: nil)
+          # DELETE
+          # https://appstoreconnect.apple.com/iris/v1/betaAppReviewSubmissions/<beta_app_review_submission_id>
+          params = build_params(filter: nil, includes: nil, limit: nil, sort: nil, cursor: nil)
+          delete("betaAppReviewSubmissions/#{beta_app_review_submission_id}", params)
+        end
+
+        #
+        # betaBuildLocalizations
+        #
+
+        def get_beta_build_localizations(filter: {}, includes: nil, limit: nil, sort: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/betaBuildLocalizations
+          path = "betaBuildLocalizations"
+          params = build_params(filter: filter, includes: includes, limit: limit, sort: sort)
+          get(path, params)
+        end
+
+        def post_beta_build_localizations(build_id: nil, attributes: {})
+          # POST
+          # https://appstoreconnect.apple.com/iris/v1/betaBuildLocalizations
+          path = "betaBuildLocalizations"
+
+          body = {
+            data: {
+              attributes: attributes,
+              type: "betaBuildLocalizations",
+              relationships: {
+                build: {
+                  data: {
+                    type: "builds",
+                    id: build_id
+                  }
+                }
+              }
+            }
+          }
+
+          post(path, body)
+        end
+
+        def patch_beta_build_localizations(localization_id: nil, feedbackEmail: nil, attributes: {})
+          # PATCH
+          # https://appstoreconnect.apple.com/iris/v1/apps/<app_id>/betaBuildLocalizations
+          path = "betaBuildLocalizations/#{localization_id}"
+
+          body = {
+            data: {
+              attributes: attributes,
+              id: localization_id,
+              type: "betaBuildLocalizations"
+            }
+          }
+
+          patch(path, body)
+        end
+
+        #
+        # betaBuildMetrics
+        #
+
+        def get_beta_build_metrics(filter: {}, includes: nil, limit: nil, sort: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/betaBuildMetrics
+          params = build_params(filter: filter, includes: includes, limit: limit, sort: sort)
+          get("betaBuildMetrics", params)
+        end
+
+        #
+        # betaGroups
+        #
+
+        def get_beta_groups(filter: {}, includes: nil, limit: nil, sort: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/betaGroups
+          params = build_params(filter: filter, includes: includes, limit: limit, sort: sort)
+          get("betaGroups", params)
+        end
+
+        def add_beta_groups_to_build(build_id: nil, beta_group_ids: [])
+          # POST
+          # https://appstoreconnect.apple.com/iris/v1/builds/<build_id>/relationships/betaGroups
+          path = "builds/#{build_id}/relationships/betaGroups"
+          body = {
+            data: beta_group_ids.map do |id|
+              {
+                type: "betaGroups",
+                id: id
+              }
+            end
+          }
+
+          post(path, body)
+        end
+
+        #
+        # betaTesters
+        #
+
+        def get_beta_testers(filter: {}, includes: nil, limit: nil, sort: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/betaTesters
+          params = build_params(filter: filter, includes: includes, limit: limit, sort: sort)
+          get("betaTesters", params)
+        end
+
+        # beta_testers - [{email: "", firstName: "", lastName: ""}]
+        def post_bulk_beta_tester_assignments(beta_group_id: nil, beta_testers: nil)
+          # POST
+          # https://appstoreconnect.apple.com/iris/v1/bulkBetaTesterAssignments
+          beta_testers || []
+
+          beta_testers.map do |tester|
+            tester[:errors] = []
+          end
+
+          body = {
+            data: {
+              attributes: {
+                betaTesters: beta_testers
+              },
+              relationships: {
+                betaGroup: {
+                  data: {
+                    type: "betaGroups",
+                    id: beta_group_id
+                  }
+                }
+              },
+              type: "bulkBetaTesterAssignments"
+            }
+          }
+
+          post("bulkBetaTesterAssignments", body)
+        end
+
+        def delete_beta_tester_from_apps(beta_tester_id: nil, app_ids: [])
+          # DELETE
+          # https://appstoreconnect.apple.com/iris/v1/betaTesters/<beta_tester_id>/relationships/apps
+          path = "betaTesters/#{beta_tester_id}/relationships/apps"
+          body = {
+            data: app_ids.map do |id|
+              {
+                type: "apps",
+                id: id
+              }
+            end
+          }
+
+          delete(path, nil, body)
+        end
+
+        def delete_beta_tester_from_beta_groups(beta_tester_id: nil, beta_group_ids: [])
+          # DELETE
+          # https://appstoreconnect.apple.com/iris/v1/betaTesters/<beta_tester_id>/relationships/betaGroups
+          path = "betaTesters/#{beta_tester_id}/relationships/betaGroups"
+          body = {
+            data: beta_group_ids.map do |id|
+              {
+                type: "betaGroups",
+                id: id
+              }
+            end
+          }
+
+          delete(path, nil, body)
+        end
+
+        #
+        # betaTesterMetrics
+        #
+
+        def get_beta_tester_metrics(filter: {}, includes: nil, limit: nil, sort: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/betaTesterMetrics
+          params = build_params(filter: filter, includes: includes, limit: limit, sort: sort)
+          get("betaTesterMetrics", params)
+        end
+
+        #
+        # builds
+        #
+
+        def get_builds(filter: {}, includes: "buildBetaDetail,betaBuildMetrics", limit: 10, sort: "uploadedDate", cursor: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/builds
+          params = build_params(filter: filter, includes: includes, limit: limit, sort: sort, cursor: cursor)
+          get("builds", params)
+        end
+
+        def get_build(build_id: nil, includes: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/builds/<build_id>?
+          params = build_params(filter: nil, includes: includes, limit: nil, sort: nil, cursor: nil)
+          get("builds/#{build_id}", params)
+        end
+
+        def patch_builds(build_id: nil, attributes: {})
+          # PATCH
+          # https://appstoreconnect.apple.com/iris/v1/builds/<build_id>
+          path = "builds/#{build_id}"
+
+          body = {
+            data: {
+              attributes: attributes,
+              id: build_id,
+              type: "builds"
+            }
+          }
+
+          patch(path, body)
+        end
+
+        #
+        # buildBetaDetails
+        #
+
+        def get_build_beta_details(filter: {}, includes: nil, limit: nil, sort: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/buildBetaDetails
+          params = build_params(filter: filter, includes: includes, limit: limit, sort: sort)
+          get("buildBetaDetails", params)
+        end
+
+        def patch_build_beta_details(build_beta_details_id: nil, attributes: {})
+          # PATCH
+          # https://appstoreconnect.apple.com/iris/v1/buildBetaDetails/<build_beta_details_id>
+          path = "buildBetaDetails/#{build_beta_details_id}"
+
+          body = {
+            data: {
+              attributes: attributes,
+              id: build_beta_details_id,
+              type: "buildBetaDetails"
+            }
+          }
+
+          patch(path, body)
+        end
+
+        #
+        # buildDeliveries
+        #
+
+        def get_build_deliveries(filter: {}, includes: nil, limit: nil, sort: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/buildDeliveries
+          params = build_params(filter: filter, includes: includes, limit: limit, sort: sort)
+          get("buildDeliveries", params)
+        end
+
+        #
+        # preReleaseVersions
+        #
+
+        def get_pre_release_versions(filter: {}, includes: nil, limit: nil, sort: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/preReleaseVersions
+          params = build_params(filter: filter, includes: includes, limit: limit, sort: sort)
+          get("preReleaseVersions", params)
+        end
+
+        #
+        # users
+        #
+
+        def get_users(filter: {}, includes: nil, limit: nil, sort: nil)
+          # GET
+          # https://appstoreconnect.apple.com/iris/v1/users
+          params = build_params(filter: filter, includes: includes, limit: limit, sort: sort)
+          get("users", params)
+        end
+
+        protected
+
+        def handle_response(response)
+          if (200...300).cover?(response.status) && (response.body.nil? || response.body.empty?)
+            return
+          end
+
+          raise InternalServerError, "Server error got #{response.status}" if (500...600).cover?(response.status)
+
+          unless response.body.kind_of?(Hash)
+            raise UnexpectedResponse, response.body
+          end
+
+          raise UnexpectedResponse, response.body['error'] if response.body['error']
+
+          raise UnexpectedResponse, handle_errors(response) if response.body['errors']
+
+          raise UnexpectedResponse, "Temporary App Store Connect error: #{response.body}" if response.body['statusCode'] == 'ERROR'
+
+          return Spaceship::ConnectAPI::Response.new(body: response.body, status: response.status, client: self)
+        end
+
+        def handle_errors(response)
+          # Example error format
+          # {
+          #   "errors" : [ {
+          #     "id" : "ce8c391e-f858-411b-a14b-5aa26e0915f2",
+          #     "status" : "400",
+          #     "code" : "PARAMETER_ERROR.INVALID",
+          #     "title" : "A parameter has an invalid value",
+          #     "detail" : "'uploadedDate3' is not a valid field name",
+          #     "source" : {
+          #       "parameter" : "sort"
+          #     }
+          #   } ]
+          # }
+
+          return response.body['errors'].map do |error|
+            "#{error['title']} - #{error['detail']}"
+          end.join(" ")
+        end
+
+        private
+
+        # used to assert all of the named parameters are supplied values
+        #
+        # @raises NameError if the values are nil
+        def assert_required_params(method_name, binding)
+          parameter_names = method(method_name).parameters.map { |_, v| v }
+          parameter_names.each do |name|
+            if local_variable_get(binding, name).nil?
+              raise NameError, "`#{name}' is a required parameter"
+            end
+          end
+        end
+
+        def local_variable_get(binding, name)
+          if binding.respond_to?(:local_variable_get)
+            binding.local_variable_get(name)
+          else
+            binding.eval(name.to_s)
+          end
+        end
+
+        def provider_id
+          return team_id if self.provider.nil?
+          self.provider.provider_id
+        end
+      end
+    end
+  end
+  # rubocop:enable Metrics/ClassLength
+end