warb 1.0.0 → 1.0.1

data/lib/warb/resources/interactive_reply_button.rb

@@ -5,11 +5,12 @@ module Warb
     class InteractiveReplyButton < Resource
       attr_accessor :header, :body, :footer, :action
 
+      # rubocop:disable Metrics/MethodLength
       def build_payload
         {
-          type: "interactive",
+          type: 'interactive',
           interactive: {
-            type: "button",
+            type: 'button',
             header: header || @params[:header]&.to_h,
             body: {
               text: body || @params[:body]
@@ -21,27 +22,28 @@ module Warb
           }
         }
       end
+      # rubocop:enable Metrics/MethodLength
 
-      def set_text_header(text)
+      def add_text_header(text)
         @header = Warb::Resources::Text.new(text:).build_header
       end
 
-      def set_image_header(media_id: nil, link: nil)
+      def add_image_header(media_id: nil, link: nil)
         @header = Warb::Resources::Image.new(media_id:, link:).build_header
       end
 
-      def set_video_header(media_id: nil, link: nil)
+      def add_video_header(media_id: nil, link: nil)
         @header = Warb::Resources::Video.new(media_id:, link:).build_header
       end
 
-      def set_document_header(media_id: nil, link: nil, filename: nil)
+      def add_document_header(media_id: nil, link: nil, filename: nil)
         @header = Warb::Resources::Document.new(media_id:, link:, filename:).build_header
       end
 
-      def build_action(**params, &block)
+      def build_action(**params, &)
         @action = Warb::Components::ReplyButtonAction.new(**params)
 
-        block_given? ? @action.tap(&block) : @action
+        block_given? ? @action.tap(&) : @action
       end
     end
   end

data/lib/warb/resources/location.rb

@@ -5,9 +5,19 @@ module Warb
     class Location < Resource
       attr_accessor :latitude, :longitude, :name, :address
 
+      def build_header
+        common_location_params
+      end
+
       def build_payload
+        common_location_params
+      end
+
+      private
+
+      def common_location_params
         {
-          type: "location",
+          type: 'location',
           location: {
             latitude: latitude || @params[:latitude],
             longitude: longitude || @params[:longitude],

data/lib/warb/resources/location_request.rb

@@ -5,20 +5,22 @@ module Warb
     class LocationRequest < Resource
       attr_accessor :body_text
 
+      # rubocop:disable Metrics/MethodLength
       def build_payload
         {
-          type: "interactive",
+          type: 'interactive',
           interactive: {
-            type: "location_request_message",
+            type: 'location_request_message',
             body: {
               text: body_text || @params[:body_text]
             },
             action: {
-              name: "send_location"
+              name: 'send_location'
             }
           }
         }
       end
+      # rubocop:enable Metrics/MethodLength
     end
   end
 end

data/lib/warb/resources/reaction.rb

@@ -7,7 +7,7 @@ module Warb
 
       def build_payload
         {
-          type: "reaction",
+          type: 'reaction',
           reaction: {
             message_id: message_id || @params[:message_id],
             emoji: emoji || @params[:emoji]

data/lib/warb/resources/resource.rb

@@ -3,6 +3,8 @@
 module Warb
   module Resources
     class Resource
+      include Validation
+
       def initialize(**params)
         @params = params
       end
@@ -19,19 +21,27 @@ module Warb
         raise NotImplementedError
       end
 
-      def set_text_header
+      def build_template_positional_parameter
+        raise NotImplementedError
+      end
+
+      def build_template_named_parameter(paramater_name)
+        raise NotImplementedError
+      end
+
+      def add_text_header
         raise NotImplementedError
       end
 
-      def set_image_header
+      def add_image_header
         raise NotImplementedError
       end
 
-      def set_video_header
+      def add_video_header
         raise NotImplementedError
       end
 
-      def set_document_header
+      def add_document_header
         raise NotImplementedError
       end
 

data/lib/warb/resources/sticker.rb

@@ -7,7 +7,7 @@ module Warb
 
       def build_payload
         {
-          type: "sticker",
+          type: 'sticker',
           sticker: {
             id: media_id || @params[:media_id],
             link: link || @params[:link]

data/lib/warb/resources/template.rb

@@ -0,0 +1,163 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class Template < Resource
+      include Helpers::Header
+
+      attr_accessor :name, :language, :resources, :header, :category, :body, :buttons
+
+      def initialize(**params)
+        super
+
+        @name = params[:name]
+        @language = params[:language]
+        @resources = params[:resources]
+        @category = params[:category]
+        @body = params[:body]
+        @buttons = []
+      end
+
+      # rubocop:disable Metrics/MethodLength
+      def build_payload
+        {
+          type: 'template',
+          template: {
+            name: name,
+            language: {
+              code: language
+            },
+            components: [
+              component_header,
+              component_body,
+              *buttons
+            ].compact
+          }
+        }
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      def creation_payload
+        {
+          name: name,
+          language: language,
+          category: category,
+          components: [
+            body&.build_template_example_parameter
+          ].compact
+        }
+      end
+
+      def add_currency_parameter(parameter_name = nil, **params, &)
+        add_parameter(parameter_name, Currency.new(**params), &)
+      end
+
+      def add_date_time_parameter(parameter_name = nil, **params, &)
+        add_parameter(parameter_name, DateTime.new(**params), &)
+      end
+
+      def add_text_parameter(parameter_name = nil, **params, &)
+        add_parameter(parameter_name, Text.new(**params), &)
+      end
+
+      def add_quick_reply_button(index: position, &block)
+        add_button(Warb::Components::QuickReplyButton.new(index:), &block)
+      end
+
+      def add_dynamic_url_button(index: position, text: nil, &block)
+        add_button(Warb::Components::UrlButton.new(index:, text:), &block)
+      end
+
+      alias add_auth_code_button add_dynamic_url_button
+
+      def add_copy_code_button(index: position, coupon_code: nil, &block)
+        add_button(Warb::Components::CopyCodeButton.new(index:, coupon_code:), &block)
+      end
+
+      def add_voice_call_button(index: position, &block)
+        add_button(Warb::Components::VoiceCallButton.new(index:), &block)
+      end
+
+      def add_flow_button(index: position, flow_token: nil, flow_action_data: nil, &block)
+        add_button(
+          Warb::Components::FlowButton.new(index: index, flow_token: flow_token,
+                                           flow_action_data: flow_action_data), &block
+        )
+      end
+
+      def add_button(instance, &)
+        return @buttons << instance.to_h unless block_given?
+
+        @buttons << instance.tap(&).to_h
+      end
+
+      private
+
+      def component_header
+        return unless header.is_a? Resource
+
+        {
+          type: 'header',
+          parameters: [
+            header.build_header
+          ]
+        }
+      end
+
+      def component_body
+        return if resources.nil? || resources.empty?
+
+        {
+          type: 'body',
+          parameters: build_parameters
+        }
+      end
+
+      def build_parameters
+        case resources
+        when Hash
+          named_parameters
+        when Array
+          positional_parameters
+        end
+      end
+
+      def named_parameters
+        resources.map do |parameter_name, resource|
+          resource.build_template_named_parameter(parameter_name.to_s)
+        end
+      end
+
+      def positional_parameters
+        resources.map(&:build_template_positional_parameter)
+      end
+
+      def add_parameter(parameter_name, instance, &)
+        case resources
+        when Hash
+          resources[parameter_name.to_s] = instance
+        when Array
+          resources << instance
+        else
+          initialize_resources(parameter_name, instance, &)
+        end
+
+        block_given? ? instance.tap(&) : instance
+      end
+
+      def initialize_resources(parameter_name, instance)
+        if parameter_name.nil?
+          @resources = []
+          @resources << instance
+        else
+          @resources = {}
+          @resources[parameter_name] = instance
+        end
+      end
+
+      def position
+        buttons.count
+      end
+    end
+  end
+end

data/lib/warb/resources/text.rb

@@ -3,15 +3,18 @@
 module Warb
   module Resources
     class Text < Resource
-      attr_accessor :content, :text, :message, :preview_url
+      attr_accessor :content, :text, :message, :preview_url, :parameter_name, :examples
 
       def build_header
-        { type: "text", text: message_per_priority }
+        { type: 'text', text: message_per_priority }.tap do |header|
+          parameter_name ||= @params[:parameter_name]
+          header[:parameter_name] = parameter_name unless parameter_name.nil?
+        end
       end
 
       def build_payload
         {
-          type: "text",
+          type: 'text',
           text: {
             preview_url: preview_url || @params[:preview_url],
             body: message_per_priority
@@ -19,6 +22,31 @@ module Warb
         }
       end
 
+      def build_template_named_parameter(parameter_name)
+        {
+          type: 'text',
+          text: message_per_priority,
+          parameter_name: parameter_name
+        }
+      end
+
+      def build_template_positional_parameter
+        {
+          type: 'text',
+          text: message_per_priority
+        }
+      end
+
+      def build_template_example_parameter
+        { type: 'body', text: message_per_priority }.tap do |param|
+          examples ||= @params[:examples]
+
+          next unless examples.is_a?(Array)
+
+          param[:example] = { body_text: [examples] }
+        end
+      end
+
       private
 
       def message_per_priority

data/lib/warb/resources/validation.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    module Validation
+      def blank?(val)
+        val.respond_to?(:empty?) ? val.empty? : !val
+      end
+
+      def raw_value(field)
+        respond_to?(field) ? public_send(field) : nil
+      end
+
+      def resolve(field, default = nil)
+        val = raw_value(field)
+        val = @params[field] if blank?(val) && defined?(@params) && @params&.key?(field)
+        val = default if blank?(val) && !default.nil?
+        val
+      end
+
+      def validates(field, required: false, message: nil)
+        needed = required.respond_to?(:call) ? required.call : required
+        return unless needed
+        return unless blank?(resolve(field))
+
+        raise ArgumentError, (message || "#{field} is required")
+      end
+    end
+  end
+end

data/lib/warb/resources/video.rb

@@ -19,7 +19,7 @@ module Warb
 
       def common_video_params
         {
-          type: "video",
+          type: 'video',
           video: {
             id: media_id || @params[:media_id],
             link: link || @params[:link]

data/lib/warb/response.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Warb
+  class Response
+    attr_reader :input, :wa_id, :message_id, :body
+
+    def initialize(body)
+      @body = body || {}
+      extract_contact_data
+      extract_message_data
+    end
+
+    private
+
+    def extract_contact_data
+      first_contact = contacts&.first
+      @input = first_contact&.dig('input')
+      @wa_id = first_contact&.dig('wa_id')
+    end
+
+    def extract_message_data
+      @message_id = messages&.first&.dig('id')
+    end
+
+    def contacts
+      @body['contacts']
+    end
+
+    def messages
+      @body['messages']
+    end
+  end
+end

data/lib/warb/response_error_handler.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Warb
+  class ResponseErrorHandler
+    def initialize(body, status)
+      @body   = body
+      @status = status
+    end
+
+    def handle
+      raise Warb::RequestError, 'invalid body' if @body.nil?
+
+      http_class   = Warb::HTTP_ERRORS[@status]
+      error_class  = custom_class || http_class || Warb::RequestError
+      Warb.configuration.logger.error(message.to_s)
+
+      raise error_class, message_from_error
+    end
+
+    private
+
+    def custom_class
+      Warb.configuration.custom_errors[@status]&.dig(code)
+    end
+
+    def message_from_error
+      details ? "(##{code}) #{details}" : message
+    end
+
+    def code
+      @code ||= @body.dig('error', 'code')
+    end
+
+    def message
+      @message ||= @body.dig('error', 'message')
+    end
+
+    def details
+      @details ||= @body.dig('error', 'error_data', 'details')
+    end
+  end
+end

data/lib/warb/template_dispatcher.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Warb
+  class TemplateDispatcher < Dispatcher
+    def create(**args)
+      template = Resources::Template.new(**args)
+      @client.post('message_templates', template.creation_payload, endpoint_prefix: :business_id)
+    end
+
+    def delete(template_name)
+      @client.delete('message_templates', { name: template_name }, endpoint_prefix: :business_id).body
+    end
+
+    def list(**args)
+      filter = args.slice(:limit, :fields, :after, :before)
+      filter[:fields] = filter[:fields].join(',') if filter[:fields].is_a?(Array)
+
+      @client.get('message_templates', endpoint_prefix: :business_id, data: filter).body
+    end
+  end
+end

data/lib/warb/utils.rb

@@ -1,5 +1,7 @@
+# frozen_string_literal: true
+
 class String
   def normalize
-    unicode_normalize(:nfd).gsub(/\p{Mn}/, "")
+    unicode_normalize(:nfd).gsub(/\p{Mn}/, '')
   end
 end

data/lib/warb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Warb
-  VERSION = "1.0.0"
+  VERSION = '1.0.1'
 end

data/lib/warb.rb

@@ -1,38 +1,70 @@
 # frozen_string_literal: true
 
-require "faraday"
-require "faraday/multipart"
-require_relative "warb/version"
-require_relative "warb/configuration"
-require_relative "warb/dispatcher_concern"
-require_relative "warb/client"
-require_relative "warb/resources/resource"
-require_relative "warb/resources/text"
-require_relative "warb/resources/image"
-require_relative "warb/resources/video"
-require_relative "warb/resources/sticker"
-require_relative "warb/resources/audio"
-require_relative "warb/resources/document"
-require_relative "warb/resources/location"
-require_relative "warb/resources/reaction"
-require_relative "warb/resources/location_request"
-require_relative "warb/resources/interactive_reply_button"
-require_relative "warb/resources/interactive_list"
-require_relative "warb/resources/interactive_call_to_action_url"
-require_relative "warb/resources/contact"
-require_relative "warb/resources/flow"
-require_relative "warb/dispatcher"
-require_relative "warb/media_dispatcher"
-require_relative "warb/indicator_dispatcher"
-require_relative "warb/utils"
-require_relative "warb/components/action"
+require 'faraday'
+require 'faraday/multipart'
 
-module Warb
-  MESSAGING_PRODUCT = "whatsapp"
-  RECIPIENT_TYPE = "individual"
+require_relative 'warb/version'
+require_relative 'warb/language'
+require_relative 'warb/category'
+require_relative 'warb/configuration'
+require_relative 'warb/dispatcher_concern'
+require_relative 'warb/client'
+
+# Error/response stack
+require_relative 'warb/errors'
+require_relative 'warb/response_error_handler'
+require_relative 'warb/response'
+
+# Resources
+require_relative 'warb/resources/validation'
+require_relative 'warb/resources/helpers/header'
+require_relative 'warb/resources/resource'
+require_relative 'warb/resources/text'
+require_relative 'warb/resources/image'
+require_relative 'warb/resources/video'
+require_relative 'warb/resources/sticker'
+require_relative 'warb/resources/audio'
+require_relative 'warb/resources/document'
+require_relative 'warb/resources/location'
+require_relative 'warb/resources/reaction'
+require_relative 'warb/resources/location_request'
+require_relative 'warb/resources/interactive_reply_button'
+require_relative 'warb/resources/interactive_list'
+require_relative 'warb/resources/interactive_call_to_action_url'
+require_relative 'warb/resources/contact'
+require_relative 'warb/resources/template'
+require_relative 'warb/resources/currency'
+require_relative 'warb/resources/date_time'
+require_relative 'warb/resources/flow'
+
+# Dispatchers
+require_relative 'warb/dispatcher'
+require_relative 'warb/media_dispatcher'
+require_relative 'warb/template_dispatcher'
+require_relative 'warb/indicator_dispatcher'
 
-  class Error < StandardError; end
-  # Your code goes here...
+# Utils and components
+require_relative 'warb/utils'
+require_relative 'warb/components/component'
+require_relative 'warb/components/button'
+require_relative 'warb/components/flow_button'
+require_relative 'warb/components/quick_reply_button'
+require_relative 'warb/components/url_button'
+require_relative 'warb/components/copy_code_button'
+require_relative 'warb/components/voice_call_button'
+require_relative 'warb/components/action'
+
+module Warb
+  MESSAGING_PRODUCT = 'whatsapp'
+  RECIPIENT_TYPE = 'individual'
+  HTTP_ERRORS = {
+    400 => BadRequest,
+    401 => Unauthorized,
+    403 => Forbidden,
+    404 => NotFound,
+    500 => InternalServerError,
+    503 => ServiceUnavailable
+  }.freeze
 
   class << self
     include DispatcherConcern
@@ -54,5 +86,9 @@ module Warb
 
       client
     end
+
+    def list_phone_numbers
+      client.get('phone_numbers', endpoint_prefix: :business_id).body['data']
+    end
   end
 end