warb 1.0.0

data/lib/warb/dispatcher_concern.rb

@@ -0,0 +1,69 @@
+module Warb
+  module DispatcherConcern
+    def message
+      @message ||= Dispatcher.new Resources::Text, dispatcher
+    end
+
+    def image
+      @image ||= MediaDispatcher.new Resources::Image, dispatcher
+    end
+
+    def video
+      @video ||= MediaDispatcher.new Resources::Video, dispatcher
+    end
+
+    def audio
+      @audio ||= MediaDispatcher.new Resources::Audio, dispatcher
+    end
+
+    def document
+      @document ||= MediaDispatcher.new Resources::Document, dispatcher
+    end
+
+    def location
+      @location ||= Dispatcher.new Resources::Location, dispatcher
+    end
+
+    def location_request
+      @location_request ||= Dispatcher.new Resources::LocationRequest, dispatcher
+    end
+
+    def interactive_reply_button
+      @interactive_reply_button ||= Dispatcher.new Resources::InteractiveReplyButton, dispatcher
+    end
+
+    def interactive_list
+      @interactive_list ||= Dispatcher.new Resources::InteractiveList, dispatcher
+    end
+
+    def interactive_call_to_action_url
+      @interactive_call_to_action_url ||= Dispatcher.new Resources::InteractiveCallToActionUrl, dispatcher
+    end
+
+    def sticker
+      @sticker ||= MediaDispatcher.new Resources::Sticker, dispatcher
+    end
+
+    def reaction
+      @reaction ||= Dispatcher.new Resources::Reaction, dispatcher
+    end
+
+    def indicator
+      @indicator ||= IndicatorDispatcher.new dispatcher
+    end
+
+    def contact
+      @contact ||= Dispatcher.new Resources::Contact, dispatcher
+    end
+
+    def flow
+      @flow ||= Dispatcher.new Resources::Flow, dispatcher
+    end
+
+    private
+
+    def dispatcher
+      is_a?(Client) ? self : Warb.client
+    end
+  end
+end

data/lib/warb/indicator_dispatcher.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Warb
+  class IndicatorDispatcher
+    def initialize(client)
+      @client = client
+    end
+
+    def send_typing_indicator(message_id)
+      data = common_indicator_params(message_id).merge(typing_indicator: { type: "text" })
+
+      @client.post("messages", data)
+    end
+
+    def mark_as_read(message_id)
+      data = common_indicator_params(message_id)
+
+      @client.post("messages", data)
+    end
+
+    private
+
+    def common_indicator_params(message_id)
+      {
+        messaging_product: Warb::MESSAGING_PRODUCT,
+        message_id: message_id,
+        status: "read"
+      }
+    end
+  end
+end

data/lib/warb/media_dispatcher.rb

@@ -0,0 +1,46 @@
+module Warb
+  class MediaDispatcher < Dispatcher
+    def upload(file_path:, file_type: "text/plain")
+      file = Faraday::UploadIO.new(file_path, file_type)
+
+      data = { file:, messaging_product: Warb::MESSAGING_PRODUCT }
+
+      @client.post("media", data, multipart: true).body["id"]
+    end
+
+    def download(file_path:, media_url: nil, media_id: nil)
+      media_url ||= retrieve(media_id)["url"]
+
+      resp = downloaded_media_response(media_url)
+
+      File.open(file_path, "wb") do |file|
+        file.write(resp.body)
+      end
+    end
+
+    def retrieve(media_id)
+      @client.get(media_id, endpoint_prefix: nil).body
+    end
+
+    def delete(media_id)
+      response_body = @client.delete(media_id, endpoint_prefix: nil).body
+
+      return response_body["success"] if response_body["success"]
+
+      response_body["error"]["message"]
+    end
+
+    private
+
+    def downloaded_media_response(url)
+      uri = URI(url)
+
+      request = Net::HTTP::Get.new(uri)
+      request["Authorization"] = "Bearer #{@client.access_token}"
+
+      Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
+        http.request(request)
+      end
+    end
+  end
+end

data/lib/warb/resources/audio.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class Audio < Resource
+      attr_accessor :media_id, :link
+
+      def build_payload
+        {
+          type: "audio",
+          audio: {
+            id: media_id || @params[:media_id],
+            link: link || @params[:link]
+          }
+        }
+      end
+    end
+  end
+end

data/lib/warb/resources/contact.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require_relative "../components/address"
+require_relative "../components/name"
+require_relative "../components/email"
+require_relative "../components/org"
+require_relative "../components/phone"
+require_relative "../components/url"
+
+module Warb
+  module Resources
+    class Contact < Resource
+      attr_accessor :addresses, :emails, :phones, :urls, :name, :org, :birthday
+
+      def initialize(**params)
+        super(**params)
+
+        @org = @params[:org]
+        @name = @params[:name]
+        @birthday = @params[:birthday]
+        @addresses = @params.fetch(:addresses, [])
+        @emails = @params.fetch(:emails, [])
+        @phones = @params.fetch(:phones, [])
+        @urls = @params.fetch(:urls, [])
+      end
+
+      def build_payload
+        {
+          type: "contacts",
+          contacts: [
+            {
+              birthday: birthday,
+              org: org.to_h,
+              name: name.to_h,
+              urls: urls.map(&:to_h),
+              emails: emails.map(&:to_h),
+              phones: phones.map(&:to_h),
+              addresses: addresses.map(&:to_h)
+            }
+          ]
+        }
+      end
+
+      def add_address(**params, &block)
+        address = Components::Address.new(**params)
+
+        @addresses << address
+
+        block_given? ? address.tap(&block) : address
+      end
+
+      def add_email(**params, &block)
+        email = Components::Email.new(**params)
+
+        @emails << email
+
+        block_given? ? email.tap(&block) : email
+      end
+
+      def add_phone(**params, &block)
+        phone = Components::Phone.new(**params)
+
+        @phones << phone
+
+        block_given? ? phone.tap(&block) : phone
+      end
+
+      def add_url(**params, &block)
+        url = Components::URL.new(**params)
+
+        @urls << url
+
+        block_given? ? url.tap(&block) : url
+      end
+
+      def build_name(**params, &block)
+        @name = Warb::Components::Name.new(**params)
+
+        block_given? ? @name.tap(&block) : @name
+      end
+
+      def build_org(**params, &block)
+        @org = Warb::Components::Org.new(**params)
+
+        block_given? ? @org.tap(&block) : @org
+      end
+    end
+  end
+end

data/lib/warb/resources/document.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class Document < Resource
+      attr_accessor :media_id, :link, :filename, :caption
+
+      def build_header
+        common_document_params
+      end
+
+      def build_payload
+        params = common_document_params
+        params[:document][:caption] = caption || @params[:caption]
+        params
+      end
+
+      private
+
+      def common_document_params
+        {
+          type: "document",
+          document: {
+            id: media_id || @params[:media_id],
+            filename: filename || @params[:filename],
+            link: link || @params[:link]
+          }
+        }
+      end
+    end
+  end
+end

data/lib/warb/resources/flow.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class Flow < Resource
+      attr_accessor :flow_id, :screen
+
+      def build_payload
+        {
+          type: "interactive",
+          interactive: {
+            type: "flow",
+            body: {
+              text: "Not shown in draft mode"
+            },
+            action: {
+              name: "flow",
+              parameters: {
+                flow_message_version: "3",
+                flow_action: "navigate",
+                flow_id: flow_id || @params[:flow_id],
+                flow_cta: "Not shown in draft mode",
+                mode: "draft",
+                flow_action_payload: {
+                  screen: screen || @params[:screen]
+                }
+              }
+            }
+          }
+        }
+      end
+    end
+  end
+end

data/lib/warb/resources/image.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class Image < Resource
+      attr_accessor :media_id, :link, :caption
+
+      def build_header
+        common_image_params
+      end
+
+      def build_payload
+        params = common_image_params
+        params[:image][:caption] = caption || @params[:caption]
+        params
+      end
+
+      private
+
+      def common_image_params
+        {
+          type: "image",
+          image: {
+            id: media_id || @params[:media_id],
+            link: link || @params[:link]
+          }
+        }
+      end
+    end
+  end
+end

data/lib/warb/resources/interactive_call_to_action_url.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class InteractiveCallToActionUrl < Resource
+      attr_accessor :header, :body, :footer, :action
+
+      def build_payload
+        {
+          type: "interactive",
+          interactive: {
+            type: "cta_url",
+            header: header || @params[:header]&.to_h,
+            body: {
+              text: body || @params[:body]
+            },
+            footer: {
+              text: footer || @params[:footer]
+            },
+            action: (action || @params[:action])&.to_h
+          }
+        }
+      end
+
+      def set_text_header(text)
+        @header = Warb::Resources::Text.new(text:).build_header
+      end
+
+      def set_image_header(link: nil)
+        @header = Warb::Resources::Image.new(link:).build_header
+      end
+
+      def set_video_header(link: nil)
+        @header = Warb::Resources::Video.new(link:).build_header
+      end
+
+      def set_document_header(link: nil, filename: nil)
+        @header = Warb::Resources::Document.new(link:, filename:).build_header
+      end
+
+      def build_action(**params, &block)
+        @action = Warb::Components::CTAAction.new(**params)
+
+        block_given? ? @action.tap(&block) : @action
+      end
+    end
+  end
+end

data/lib/warb/resources/interactive_list.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class InteractiveList < Resource
+      attr_accessor :header, :body, :footer, :action
+
+      def build_payload
+        {
+          type: "interactive",
+          interactive: {
+            type: "list",
+            header: header || @params[:header]&.to_h,
+            body: {
+              text: body || @params[:body]
+            },
+            footer: {
+              text: footer || @params[:footer]
+            },
+            action: (action || @params[:action])&.to_h
+          }
+        }
+      end
+
+      def set_text_header(text)
+        @header = Warb::Resources::Text.new(text:).build_header
+      end
+
+      def build_action(**params, &block)
+        @action = Warb::Components::ListAction.new(**params)
+
+        block_given? ? @action.tap(&block) : @action
+      end
+    end
+  end
+end

data/lib/warb/resources/interactive_reply_button.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class InteractiveReplyButton < Resource
+      attr_accessor :header, :body, :footer, :action
+
+      def build_payload
+        {
+          type: "interactive",
+          interactive: {
+            type: "button",
+            header: header || @params[:header]&.to_h,
+            body: {
+              text: body || @params[:body]
+            },
+            footer: {
+              text: footer || @params[:footer]
+            },
+            action: (action || @params[:action])&.to_h
+          }
+        }
+      end
+
+      def set_text_header(text)
+        @header = Warb::Resources::Text.new(text:).build_header
+      end
+
+      def set_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)
+        @header = Warb::Resources::Video.new(media_id:, link:).build_header
+      end
+
+      def set_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)
+        @action = Warb::Components::ReplyButtonAction.new(**params)
+
+        block_given? ? @action.tap(&block) : @action
+      end
+    end
+  end
+end

data/lib/warb/resources/location.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class Location < Resource
+      attr_accessor :latitude, :longitude, :name, :address
+
+      def build_payload
+        {
+          type: "location",
+          location: {
+            latitude: latitude || @params[:latitude],
+            longitude: longitude || @params[:longitude],
+            name: name || @params[:name],
+            address: address || @params[:address]
+          }
+        }
+      end
+    end
+  end
+end

data/lib/warb/resources/location_request.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class LocationRequest < Resource
+      attr_accessor :body_text
+
+      def build_payload
+        {
+          type: "interactive",
+          interactive: {
+            type: "location_request_message",
+            body: {
+              text: body_text || @params[:body_text]
+            },
+            action: {
+              name: "send_location"
+            }
+          }
+        }
+      end
+    end
+  end
+end

data/lib/warb/resources/reaction.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class Reaction < Resource
+      attr_accessor :message_id, :emoji
+
+      def build_payload
+        {
+          type: "reaction",
+          reaction: {
+            message_id: message_id || @params[:message_id],
+            emoji: emoji || @params[:emoji]
+          }
+        }
+      end
+    end
+  end
+end

data/lib/warb/resources/resource.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class Resource
+      def initialize(**params)
+        @params = params
+      end
+
+      def call(recipient_number, reply_to: nil)
+        common_resources_params(recipient_number, reply_to).merge build_payload
+      end
+
+      def build_header
+        raise NotImplementedError
+      end
+
+      def build_payload
+        raise NotImplementedError
+      end
+
+      def set_text_header
+        raise NotImplementedError
+      end
+
+      def set_image_header
+        raise NotImplementedError
+      end
+
+      def set_video_header
+        raise NotImplementedError
+      end
+
+      def set_document_header
+        raise NotImplementedError
+      end
+
+      protected
+
+      def common_resources_params(recipient_number, reply_to)
+        {
+          messaging_product: Warb::MESSAGING_PRODUCT,
+          recipient_type: Warb::RECIPIENT_TYPE,
+          to: recipient_number
+        }.tap do |params|
+          params[:context] = { message_id: reply_to } if reply_to
+        end
+      end
+    end
+  end
+end

data/lib/warb/resources/sticker.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class Sticker < Resource
+      attr_accessor :media_id, :link
+
+      def build_payload
+        {
+          type: "sticker",
+          sticker: {
+            id: media_id || @params[:media_id],
+            link: link || @params[:link]
+          }
+        }
+      end
+    end
+  end
+end

data/lib/warb/resources/text.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class Text < Resource
+      attr_accessor :content, :text, :message, :preview_url
+
+      def build_header
+        { type: "text", text: message_per_priority }
+      end
+
+      def build_payload
+        {
+          type: "text",
+          text: {
+            preview_url: preview_url || @params[:preview_url],
+            body: message_per_priority
+          }
+        }
+      end
+
+      private
+
+      def message_per_priority
+        content || text || message || @params[:content] || @params[:text] || @params[:message]
+      end
+    end
+  end
+end

data/lib/warb/resources/video.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    class Video < Resource
+      attr_accessor :media_id, :link, :caption
+
+      def build_header
+        common_video_params
+      end
+
+      def build_payload
+        params = common_video_params
+        params[:video][:caption] = caption || @params[:caption]
+        params
+      end
+
+      private
+
+      def common_video_params
+        {
+          type: "video",
+          video: {
+            id: media_id || @params[:media_id],
+            link: link || @params[:link]
+          }
+        }
+      end
+    end
+  end
+end

data/lib/warb/utils.rb

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