leal 0.0.9

data/lib/leal/locations/client.rb

@@ -0,0 +1,225 @@
+# frozen_string_literal: true
+
+module Leal
+  module Locations
+    class Client
+      # @param client [Leal::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # Returns every physical location belonging to the specified store.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [Integer] :account_id
+      #
+      # @example
+      #   client.locations.list(account_id: 1)
+      #
+      # @return [Array[Leal::Locations::Types::ListLocationsResponseItem]]
+      def list(request_options: {}, **params)
+        params = Leal::Internal::Types::Utils.normalize_keys(params)
+        request = Leal::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "api/v1/accounts/#{URI.encode_uri_component(params[:account_id].to_s)}/locations",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Leal::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        return if code.between?(200, 299)
+
+        error_class = Leal::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+
+      # Creates a new physical location for the store. The provided address is
+      # automatically geocoded to latitude and longitude coordinates in the background.
+      #
+      # @param request_options [Hash]
+      # @param params [Leal::Locations::Types::CreateLocationsRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [Integer] :account_id
+      #
+      # @example
+      #   client.locations.create(
+      #     account_id: 1,
+      #     location: {
+      #       address: "address",
+      #       name: "name"
+      #     }
+      #   )
+      #
+      # @return [Leal::Locations::Types::CreateLocationsResponse]
+      def create(request_options: {}, **params)
+        params = Leal::Internal::Types::Utils.normalize_keys(params)
+        request_data = Leal::Locations::Types::CreateLocationsRequest.new(params).to_h
+        non_body_param_names = %w[account_id]
+        body = request_data.except(*non_body_param_names)
+
+        request = Leal::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "api/v1/accounts/#{URI.encode_uri_component(params[:account_id].to_s)}/locations",
+          body: body,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Leal::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Leal::Locations::Types::CreateLocationsResponse.load(response.body)
+        else
+          error_class = Leal::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Returns a single location by ID.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [Integer] :account_id
+      # @option params [Integer] :id
+      #
+      # @example
+      #   client.locations.get(
+      #     account_id: 1,
+      #     id: 1
+      #   )
+      #
+      # @return [Leal::Locations::Types::GetLocationsResponse]
+      def get(request_options: {}, **params)
+        params = Leal::Internal::Types::Utils.normalize_keys(params)
+        request = Leal::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "api/v1/accounts/#{URI.encode_uri_component(params[:account_id].to_s)}/locations/#{URI.encode_uri_component(params[:id].to_s)}",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Leal::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Leal::Locations::Types::GetLocationsResponse.load(response.body)
+        else
+          error_class = Leal::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Permanently deletes a location. This action cannot be undone.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [Integer] :account_id
+      # @option params [Integer] :id
+      #
+      # @example
+      #   client.locations.delete(
+      #     account_id: 1,
+      #     id: 1
+      #   )
+      #
+      # @return [untyped]
+      def delete(request_options: {}, **params)
+        params = Leal::Internal::Types::Utils.normalize_keys(params)
+        request = Leal::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "DELETE",
+          path: "api/v1/accounts/#{URI.encode_uri_component(params[:account_id].to_s)}/locations/#{URI.encode_uri_component(params[:id].to_s)}",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Leal::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        return if code.between?(200, 299)
+
+        error_class = Leal::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+
+      # Updates an existing location. If the address is changed, it will be re-geocoded automatically.
+      #
+      # @param request_options [Hash]
+      # @param params [Leal::Locations::Types::UpdateLocationsRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [Integer] :account_id
+      # @option params [Integer] :id
+      #
+      # @example
+      #   client.locations.update(
+      #     account_id: 1,
+      #     id: 1,
+      #     location: {}
+      #   )
+      #
+      # @return [Leal::Locations::Types::UpdateLocationsResponse]
+      def update(request_options: {}, **params)
+        params = Leal::Internal::Types::Utils.normalize_keys(params)
+        request_data = Leal::Locations::Types::UpdateLocationsRequest.new(params).to_h
+        non_body_param_names = %w[account_id id]
+        body = request_data.except(*non_body_param_names)
+
+        request = Leal::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "PATCH",
+          path: "api/v1/accounts/#{URI.encode_uri_component(params[:account_id].to_s)}/locations/#{URI.encode_uri_component(params[:id].to_s)}",
+          body: body,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Leal::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Leal::Locations::Types::UpdateLocationsResponse.load(response.body)
+        else
+          error_class = Leal::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+    end
+  end
+end

data/lib/leal/locations/types/create_locations_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Leal
+  module Locations
+    module Types
+      class CreateLocationsRequest < Internal::Types::Model
+        field :account_id, -> { Integer }, optional: false, nullable: false
+
+        field :location, -> { Leal::Locations::Types::CreateLocationsRequestLocation }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/leal/locations/types/create_locations_request_location.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Leal
+  module Locations
+    module Types
+      class CreateLocationsRequestLocation < Internal::Types::Model
+        field :address, -> { String }, optional: false, nullable: false
+
+        field :name, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/leal/locations/types/create_locations_response.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Leal
+  module Locations
+    module Types
+      class CreateLocationsResponse < Internal::Types::Model
+        field :account_id, -> { Integer }, optional: false, nullable: false
+
+        field :address, -> { String }, optional: false, nullable: false
+
+        field :created_at, -> { String }, optional: false, nullable: false
+
+        field :id, -> { Integer }, optional: false, nullable: false
+
+        field :latitude, -> { Integer }, optional: false, nullable: false
+
+        field :longitude, -> { Integer }, optional: false, nullable: false
+
+        field :name, -> { String }, optional: false, nullable: false
+
+        field :updated_at, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/leal/locations/types/delete_locations_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Leal
+  module Locations
+    module Types
+      class DeleteLocationsRequest < Internal::Types::Model
+        field :account_id, -> { Integer }, optional: false, nullable: false
+
+        field :id, -> { Integer }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/leal/locations/types/get_locations_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Leal
+  module Locations
+    module Types
+      class GetLocationsRequest < Internal::Types::Model
+        field :account_id, -> { Integer }, optional: false, nullable: false
+
+        field :id, -> { Integer }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/leal/locations/types/get_locations_response.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Leal
+  module Locations
+    module Types
+      class GetLocationsResponse < Internal::Types::Model
+        field :account_id, -> { Integer }, optional: false, nullable: false
+
+        field :address, -> { String }, optional: false, nullable: false
+
+        field :created_at, -> { String }, optional: false, nullable: false
+
+        field :id, -> { Integer }, optional: false, nullable: false
+
+        field :latitude, -> { Integer }, optional: false, nullable: false
+
+        field :longitude, -> { Integer }, optional: false, nullable: false
+
+        field :name, -> { String }, optional: false, nullable: false
+
+        field :updated_at, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/leal/locations/types/list_locations_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Leal
+  module Locations
+    module Types
+      class ListLocationsRequest < Internal::Types::Model
+        field :account_id, -> { Integer }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/leal/locations/types/list_locations_response_item.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Leal
+  module Locations
+    module Types
+      class ListLocationsResponseItem < Internal::Types::Model
+        field :account_id, -> { Integer }, optional: false, nullable: false
+
+        field :address, -> { String }, optional: false, nullable: false
+
+        field :created_at, -> { String }, optional: false, nullable: false
+
+        field :id, -> { Integer }, optional: false, nullable: false
+
+        field :latitude, -> { Integer }, optional: false, nullable: false
+
+        field :longitude, -> { Integer }, optional: false, nullable: false
+
+        field :name, -> { String }, optional: false, nullable: false
+
+        field :updated_at, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/leal/locations/types/update_locations_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Leal
+  module Locations
+    module Types
+      class UpdateLocationsRequest < Internal::Types::Model
+        field :account_id, -> { Integer }, optional: false, nullable: false
+
+        field :id, -> { Integer }, optional: false, nullable: false
+
+        field :location, -> { Leal::Locations::Types::UpdateLocationsRequestLocation }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/leal/locations/types/update_locations_request_location.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Leal
+  module Locations
+    module Types
+      class UpdateLocationsRequestLocation < Internal::Types::Model
+        field :address, -> { String }, optional: true, nullable: false
+
+        field :name, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/leal/locations/types/update_locations_response.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Leal
+  module Locations
+    module Types
+      class UpdateLocationsResponse < Internal::Types::Model
+        field :account_id, -> { Integer }, optional: false, nullable: false
+
+        field :address, -> { String }, optional: false, nullable: false
+
+        field :created_at, -> { String }, optional: false, nullable: false
+
+        field :id, -> { Integer }, optional: false, nullable: false
+
+        field :latitude, -> { Integer }, optional: false, nullable: false
+
+        field :longitude, -> { Integer }, optional: false, nullable: false
+
+        field :name, -> { String }, optional: false, nullable: false
+
+        field :updated_at, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/leal/posters/client.rb

@@ -0,0 +1,232 @@
+# frozen_string_literal: true
+
+module Leal
+  module Posters
+    class Client
+      # @param client [Leal::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # Returns all posters for the store. Optionally filter by card or active status.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [Integer] :account_id
+      # @option params [Integer, nil] :card_id
+      # @option params [String, nil] :active
+      #
+      # @example
+      #   client.posters.list(account_id: 1)
+      #
+      # @return [Array[Leal::Posters::Types::ListPostersResponseItem]]
+      def list(request_options: {}, **params)
+        params = Leal::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["card_id"] = params[:card_id] if params.key?(:card_id)
+        query_params["active"] = params[:active] if params.key?(:active)
+
+        request = Leal::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "api/v1/accounts/#{URI.encode_uri_component(params[:account_id].to_s)}/posters",
+          query: query_params,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Leal::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        return if code.between?(200, 299)
+
+        error_class = Leal::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+
+      # Creates a new printable QR code poster for customer signup. The poster will automatically
+      # generate a unique public signup URL and QR code. The `card_id` is required on create to
+      # associate the poster with a loyalty card.
+      #
+      # @param request_options [Hash]
+      # @param params [Leal::Posters::Types::CreatePostersRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [Integer] :account_id
+      #
+      # @example
+      #   client.posters.create(
+      #     account_id: 1,
+      #     poster: {
+      #       card_id: 1
+      #     }
+      #   )
+      #
+      # @return [Leal::Posters::Types::CreatePostersResponse]
+      def create(request_options: {}, **params)
+        params = Leal::Internal::Types::Utils.normalize_keys(params)
+        request_data = Leal::Posters::Types::CreatePostersRequest.new(params).to_h
+        non_body_param_names = %w[account_id]
+        body = request_data.except(*non_body_param_names)
+
+        request = Leal::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "api/v1/accounts/#{URI.encode_uri_component(params[:account_id].to_s)}/posters",
+          body: body,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Leal::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Leal::Posters::Types::CreatePostersResponse.load(response.body)
+        else
+          error_class = Leal::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Returns a single poster by ID, including generated signup and display URLs.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [Integer] :account_id
+      # @option params [Integer] :id
+      #
+      # @example
+      #   client.posters.get(
+      #     account_id: 1,
+      #     id: 1
+      #   )
+      #
+      # @return [Leal::Posters::Types::GetPostersResponse]
+      def get(request_options: {}, **params)
+        params = Leal::Internal::Types::Utils.normalize_keys(params)
+        request = Leal::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "api/v1/accounts/#{URI.encode_uri_component(params[:account_id].to_s)}/posters/#{URI.encode_uri_component(params[:id].to_s)}",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Leal::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Leal::Posters::Types::GetPostersResponse.load(response.body)
+        else
+          error_class = Leal::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Permanently deletes a poster. The public signup URL will stop working.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [Integer] :account_id
+      # @option params [Integer] :id
+      #
+      # @example
+      #   client.posters.delete(
+      #     account_id: 1,
+      #     id: 1
+      #   )
+      #
+      # @return [untyped]
+      def delete(request_options: {}, **params)
+        params = Leal::Internal::Types::Utils.normalize_keys(params)
+        request = Leal::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "DELETE",
+          path: "api/v1/accounts/#{URI.encode_uri_component(params[:account_id].to_s)}/posters/#{URI.encode_uri_component(params[:id].to_s)}",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Leal::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        return if code.between?(200, 299)
+
+        error_class = Leal::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+
+      # Updates an existing poster. The `card_id` cannot be changed after creation.
+      #
+      # @param request_options [Hash]
+      # @param params [Leal::Posters::Types::UpdatePostersRequest]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [Integer] :account_id
+      # @option params [Integer] :id
+      #
+      # @example
+      #   client.posters.update(
+      #     account_id: 1,
+      #     id: 1,
+      #     poster: {}
+      #   )
+      #
+      # @return [Leal::Posters::Types::UpdatePostersResponse]
+      def update(request_options: {}, **params)
+        params = Leal::Internal::Types::Utils.normalize_keys(params)
+        request_data = Leal::Posters::Types::UpdatePostersRequest.new(params).to_h
+        non_body_param_names = %w[account_id id]
+        body = request_data.except(*non_body_param_names)
+
+        request = Leal::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "PATCH",
+          path: "api/v1/accounts/#{URI.encode_uri_component(params[:account_id].to_s)}/posters/#{URI.encode_uri_component(params[:id].to_s)}",
+          body: body,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Leal::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Leal::Posters::Types::UpdatePostersResponse.load(response.body)
+        else
+          error_class = Leal::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+    end
+  end
+end

data/lib/leal/posters/types/create_posters_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Leal
+  module Posters
+    module Types
+      class CreatePostersRequest < Internal::Types::Model
+        field :account_id, -> { Integer }, optional: false, nullable: false
+
+        field :poster, -> { Leal::Posters::Types::CreatePostersRequestPoster }, optional: false, nullable: false
+      end
+    end
+  end
+end