levelup 0.9.2

data/lib/levelup/endpoints/app_users.rb

@@ -0,0 +1,30 @@
+module Levelup
+  module Endpoints
+    # The endpoint holding all functions related to managing users under the
+    # current app.
+    class AppUsers < Base
+      def initialize(app_access_token)
+        @app_access_token = app_access_token
+      end
+
+      def create(create_user_request)
+        request = build_request(create_user_request, Requests::CreateUser)
+        request.app_access_token ||= app_access_token
+        request.send_to_api(:post, endpoint_path)
+      end
+
+      def get(user_access_token)
+        request = Requests::GetUser.new(user_access_token: user_access_token)
+        request.send_to_api(:get, endpoint_path)
+      end
+
+      private
+
+      attr_reader :app_access_token
+
+      def path
+        'apps/users'
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/apps.rb

@@ -0,0 +1,30 @@
+module Levelup
+  module Endpoints
+    # The endpoint serving as a bucket for all app-related functions.
+    class Apps < Base
+      def initialize(app_access_token)
+        @app_access_token = app_access_token
+      end
+
+      def permissions_requests(request_id = nil)
+        if request_id
+          SpecificPermissionsRequest.new(request_id, app_access_token)
+        else
+          PermissionsRequests.new(app_access_token)
+        end
+      end
+
+      def users
+        AppUsers.new(app_access_token)
+      end
+
+      private
+
+      attr_reader :app_access_token
+
+      def path
+        'apps'
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/base.rb

@@ -0,0 +1,25 @@
+module Levelup
+  module Endpoints
+    # The class describing the behavior required of all endpoints.
+    class Base
+      private
+
+      # Constructs the specified class out of the supplied hash. If the first
+      # parameter is not a hash, simply returns it.
+      def build_request(request, building_class)
+        request.is_a?(Hash) ? building_class.new(request) : request
+      end
+
+      # Builds a path to this endpoint dynamically.
+      def endpoint_path(version = Configuration::DEFAULT_API_VERSION)
+        Configuration.api_url(version) + "/#{path}"
+      end
+
+      # Determines the name of this endpoint for purposes of building a URL.
+      def path
+        raise NotImplementedError,
+          'Attempted to access endpoint with undefined path.'
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/credit_cards.rb

@@ -0,0 +1,26 @@
+module Levelup
+  module Endpoints
+    # The endpoint holding all functions related to managing users' credit
+    # cards.
+    class CreditCards < Base
+      def initialize(api_key: nil, secret: nil)
+        @api_key = api_key
+        @secret = secret
+      end
+
+      # Adds a credit card to a user's account. Requires a user access token
+      # with create_first_credit_card permission.
+      # This request will fail unless the user account has no credit card on it.
+      def create(credit_card_request)
+        request = build_request(credit_card_request, Requests::CreateCard)
+        request.send_to_api(:get, endpoint_path)
+      end
+
+      private
+
+      def path
+        'credit_cards'
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/location_orders.rb

@@ -0,0 +1,32 @@
+module Levelup
+  module Endpoints
+    # The endpoint holding all functions relating to orders for a specific
+    # location.
+    # This is a v14 endpoint and should not be expected to remain functional
+    # indefinitely.
+    class LocationOrders < Base
+      def initialize(location_id)
+        @id = location_id
+      end
+
+      # Gets a list of orders made at this location. This list is paginated.
+      #
+      # [merchant_auth_token]
+      #   An access token for the merchant that owns this
+      #   location.
+      def list(merchant_auth_token)
+        request = Requests::ListOrders.new(
+          merchant_access_token: merchant_auth_token)
+        request.send_to_api(:get, endpoint_path(:v14))
+      end
+
+      private
+
+      attr_reader :id
+
+      def path
+        "locations/#{id}/orders"
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/merchant_funded_credits.rb

@@ -0,0 +1,19 @@
+module Levelup
+  module Endpoints
+    # The endpoint holding all functions relating to managing merchant-funded
+    # credit.
+    class MerchantFundedCredits < Base
+      def give(give_credit_request)
+        request = build_request(give_credit_request,
+          Requests::GiveMerchantCredit)
+        request.send_to_api(:post, endpoint_path)
+      end
+
+      private
+
+      def path
+        "merchant_funded_credits"
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/merchant_locations.rb

@@ -0,0 +1,32 @@
+module Levelup
+  module Endpoints
+    # The endpoint holding all functions relating to a single merchant's
+    # locations. This is a v14 endpoint and should not be expected to remain
+    # functional indefinitely.
+    class MerchantLocations < Base
+      def initialize(merchant_id)
+        @id = merchant_id
+      end
+
+      # Provides a list of locations controlled by this merchant. This list is
+      # not paginated.
+      #
+      # [merchant_auth_token]
+      #   An authorization token with permission to view
+      #   this merchant.
+      def list(merchant_auth_token)
+        request = Requests::ListLocations.new(
+          merchant_access_token: merchant_auth_token)
+        request.send_to_api(:get, endpoint_path(:v14))
+      end
+
+      private
+
+      attr_reader :id
+
+      def path
+        "merchants/#{id}/locations"
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/merchant_orders.rb

@@ -0,0 +1,28 @@
+module Levelup
+  module Endpoints
+    # The endpoint holding all functions relating to a single merchant's orders.
+    # This is a v14 endpoint and should not be expected to remain functional
+    # indefinitely.
+    class MerchantOrders < Base
+      def initialize(merchant_id)
+        @id = merchant_id
+      end
+
+      # Provides merchant-facing details about a specific order. For more
+      # information about the parameters, see OrderDetailsRequest.
+      def details(uuid, merchant_access_token)
+        request = Requests::CreateOrderDetails.new(
+          merchant_access_token: merchant_access_token)
+        request.send_to_api(:get, endpoint_path(:v14) + "/#{uuid}")
+      end
+
+      private
+
+      attr_reader :id
+
+      def path
+        "merchants/#{id}/orders"
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/orders.rb

@@ -0,0 +1,19 @@
+module Levelup
+  module Endpoints
+    # The class holding all functions related to orders that do not specify a
+    # specific order. For single-order functions, see SpecificOrder.
+    class Orders < Base
+      # Creates an order. See OrderRequest for more info about the parameters.
+      def create(order_request)
+        request = build_request(order_request, Requests::CreateOrder)
+        request.send_to_api(:post, endpoint_path)
+      end
+
+      private
+
+      def path
+        'orders'
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/permissions_requests.rb

@@ -0,0 +1,28 @@
+module Levelup
+  module Endpoints
+    # The endpoint holding all functions related to managing permissions
+    # requests.
+    class PermissionsRequests < Base
+      def initialize(app_access_token)
+        @app_access_token = app_access_token
+      end
+
+      # Requests a set of permissions from the specified user.
+      # See RequestPermissionsRequest for more detail about parameters.
+      def create(user_permissions_request)
+        request = build_request(user_permissions_request,
+          Requests::RequestPermissions)
+        request.app_access_token ||= app_access_token
+        request.send_to_api(:post, endpoint_path)
+      end
+
+      private
+
+      attr_reader :app_access_token
+
+      def path
+        'apps/permissions_requests'
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/qr_codes.rb

@@ -0,0 +1,28 @@
+module Levelup
+  module Endpoints
+    # The endpoint holding all functions related to managing users' QR codes.
+    class QrCodes < Base
+      def initialize(color: 0, tip_amount: 0, tip_percent: 0)
+        self.color = color
+        self.tip_amount = tip_amount
+        self.tip_percent = tip_percent
+      end
+
+      # Retrieves the specified user's QR code using parameters specified
+      # in the endpoint.
+      def get(user_access_token)
+        request = Requests::GetQrCode.new(user_access_token: user_access_token)
+        request.send_to_api(:get, endpoint_path)
+      end
+
+      private
+
+      attr_accessor :color, :tip_amount, :tip_percent
+
+      def path
+        "qr_codes?preferences[color]=#{color}&preferences[tip_amount]="\
+        "#{tip_amount}&preferences[tip_percent]=#{tip_percent}"
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/specific_location.rb

@@ -0,0 +1,24 @@
+module Levelup
+  module Endpoints
+    # The endpoint holding all functions relating to a specific location.
+    # This is a v14 endpoint and should not be expected to remain functional
+    # indefinitely.
+    class SpecificLocation < Base
+      attr_reader :id
+
+      def initialize(location_id)
+        @id = location_id
+      end
+
+      def orders
+        LocationOrders.new(id)
+      end
+
+      private
+
+      def path
+        "locations/#{id}"
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/specific_merchant.rb

@@ -0,0 +1,28 @@
+module Levelup
+  module Endpoints
+    # The endpoint holding all functions relating to a single merchant. This is
+    # a v14 endpoint and should not be expected to remain functional
+    # indefinitely.
+    class SpecificMerchant < Base
+      attr_reader :id
+
+      def initialize(merchant_id)
+        @id = merchant_id
+      end
+
+      def locations
+        MerchantLocations.new(id)
+      end
+
+      def orders
+        MerchantOrders.new(id)
+      end
+
+      private
+
+      def path
+        "merchants/#{id}"
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/specific_order.rb

@@ -0,0 +1,28 @@
+module Levelup
+  module Endpoints
+    # Endpoint holding all functions relating to a specified order.
+    class SpecificOrder < Base
+      attr_reader :uuid
+      def initialize(order_uuid)
+        @uuid = order_uuid
+      end
+
+      # Refunds the order specified by this endpoint.
+      #
+      # [merchant_auth_token]
+      #   A merchant access token with permissions to
+      #   refund orders made at the location where this order was placed.
+      def refund(merchant_auth_token)
+        request = Requests::RefundOrder.new(
+          merchant_access_token: merchant_auth_token)
+        request.send_to_api(:post, endpoint_path + '/refund')
+      end
+
+      private
+
+      def path
+        "orders/#{uuid}"
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/specific_permissions_request.rb

@@ -0,0 +1,26 @@
+module Levelup
+  module Endpoints
+    # The endpoint holding all functions related to accessing a specified
+    # permissions request.
+    class SpecificPermissionsRequest < Base
+      def initialize(request_id, app_access_token)
+        self.app_access_token = app_access_token
+        self.request_id = request_id
+      end
+
+      def show
+        request = Requests::ShowPermissionsRequest.
+          new(app_access_token: app_access_token)
+        request.send_to_api(:get, endpoint_path)
+      end
+
+      private
+
+      attr_accessor :request_id, :app_access_token
+
+      def path
+        "apps/permissions_requests/#{request_id}"
+      end
+    end
+  end
+end

data/lib/levelup/endpoints/user_addresses.rb

@@ -0,0 +1,25 @@
+module Levelup
+  module Endpoints
+    # Endpoint holding all functions relating to user addresses.
+    class UserAddresses < Base
+      # Creates a specified user address. For more information on parameters,
+      # see UserAddressRequest.
+      def create(user_address_request)
+        request = build_request(user_address_request,
+          Requests::CreateAddress)
+        request.send_to_api(:post, endpoint_path)
+      end
+
+      def list(user_access_token)
+        request = Requests::ListAddresses(user_access_token: user_access_token)
+        request.send_to_api(:get, endpoint_path)
+      end
+
+      private
+
+      def path
+        'user_addresses'
+      end
+    end
+  end
+end