warb 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae3d5993ad731dab7a7aeb08130e76aff0872f4f4420680c8724613241043966
-  data.tar.gz: c1fa725f65ad1f69dd37abee564a9864b8cb96b224bc2e098d6ffee183fa33a6
+  metadata.gz: 58ff4cfa4904a9a820c4b5906b947b6f5dcbd3e5a3afa76a9e88ed3f83488bb8
+  data.tar.gz: 1edcbcef65fd5f128cb0cf475f4b5c6ae8e4e285a4b57335b80818e0487f874a
 SHA512:
-  metadata.gz: 30e29c7d31ea2d88bb844c1d50c727cbecf7a32d08d4eb5b6b0114a7d756eb16a103c8e4ca3e32c9532d0a834d0524e8d4d90ba536de8560bb2523dc3dd0c34a
-  data.tar.gz: 765c7adf8cefc2a3eb53dfacfa847f1e29ffddbfd512273a6af8ae09a8f247259b4d6f4465a3c9ea46f83621781c94fa24176c1158589b9e0bda7e9e37c6e355
+  metadata.gz: 43cabbb2bcd395dbbc32eacf0f170e00c5fa913f9edbe4543b9b19f81278648ccae955ac64601182fc468ab02ae81cdb81ae1c07d4601f793dd1645cad28a698
+  data.tar.gz: f7ef031988f7c39be607047ebab9e56d627b848527fce0baa5043f1108a93e378e4e7b6d7df853240bcdba9ccb46b0c0c8ba135833fc31fbccaf01175dab9ba6

data/README.md

@@ -9,16 +9,18 @@ A Ruby Gem focused on wrap all the functionalities and use cases of the WhatsApp
 
 ## Installation
 
-Add `warb` to your bundle
+TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
 
-```ruby
-bundle add warb
+Install the gem and add to the application's Gemfile by executing:
+
+```bash
+bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
 ```
 
-or add it manually to your Gemfile if you prefer.
+If bundler is not being used to manage dependencies, install the gem by executing:
 
-```ruby
-gem 'warb'
+```bash
+gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
 ```
 
 ## Configuration
@@ -88,26 +90,9 @@ Warb.message.dispatch(recipient_number) do |builder|
 end
 ```
 
-### What types of messages can I send?
-
-Warb implements the main types of WhatsApp messages, you can follow the message types [`here`](docs/messages/README.md#messages-types)
-
-examples:
-
-```ruby
-
-warb = Warb.new(...)
-
-warb.message.dispatch(...)
-warb.audio.dispatch(...)
-warb.video.dispatch(...)
-warb.image.dispatch(...)
-...
-```
-
 ### Find all usage examples
 
-We suggest heading to the [`examples`](examples) directory, where you'll find documentation files with plenty of usage examples, organized by **Resources** (**Resources** are the types of messages you can send via WhatsApp using Warb).
+We suggest heading to the `examples/` directory, where you'll find documentation files with plenty of usage examples, organized by **Resources** (**Resources** are the types of messages you can send via WhatsApp using Warb).
 
 You can also check the [`docs`](docs/README.md) for a more structured overview of the available resources and their usage.
 

data/docs/README.md

@@ -10,7 +10,4 @@ Refer to [webhook](webhook.md) for more details on how to setup a webhook to get
 Refer to [messages](./messages/README.md) for more details on how to send messages using Warb.
 
 ## Components
-Refer to [components](./components/README.md) for more details on how Warb components work.
-
-## Resources
-Refer to [resources](./resources/README.md) for more details on resources.
+Refer to [components](./components/README.md) for more details on how Warb components work.

data/docs/components/README.md

@@ -18,7 +18,4 @@ Here is a table of available components, and where they can be used:
 | `Warb::Components::ReplyButtonAction` | [Interactive Reply Button](../messages/interactive_reply_button.md)             | [Reply Button Action](./reply_button_action) |
 | `Warb::Components::Row`               | [Interactive List](../messages/interactive_list.md)                             | [Row](./row.md)                              |
 | `Warb::Components::ListAction`        | [Interactive List](../messages/interactive_list.md)                             | [List Action](./list_action.md)              |
-| `Warb::Components::Section`           | [Interactive List](../messages/interactive_list.md)                             | [Section](./section.md)                      |
-| `Warb::Components::Button`            | [Template](../messages/template.md)                                             | [Button](./button.md)                        |
-| `Warb::Components::UrlButton`         | [Template](../messages/template.md)                                             | [UrlButton](./url_button.md)                 |
-| `Warb::Components::CopyCodeButton`    | [Template](../messages/template.md)                                             | [CopyCodeButton](./copy_code_button.md)      |
+| `Warb::Components::Section`           | [Interactive List](../messages/interactive_list.md)                             | [Section](./section.md)                      |

data/docs/messages/README.md

@@ -71,10 +71,9 @@ Messages are sent using a helper dispatcher and its resource class. Here is a li
 | Video                          | `Warb::Resources::Video`                      | `video`                             | [Video Message](./video.md)                                                   |
 | Special Dispatchers                                                                                                                                                                                  |
 | Indicator                      | `Warb::Resources::Indicator`                  | `indicator`                         | [Indicator Message](./indicator.md)                                           |
-| Template                       | `Warb::Resources::Template`                   | `template`                          | [Template Message](./template.md)                                             |
 
 > Simple Dispatcher doesn't offer any additional functionality, they just send messages.
 
 > Media Dispatchers, aside from sending messages, also provide methods to upload and download media files.
 
-> Special Dispatchers are used for specific purposes, such as sending indicators, reactions or templates.
+> Special Dispatchers are used for specific purposes, such as sending indicators or reactions.

data/lib/warb/dispatcher.rb

@@ -6,7 +6,7 @@ module Warb
     end
 
     def dispatch(recipient_number, reply_to: nil, **args, &block)
-      resource = block_given? ? @klass.new(**args).tap(&block) : @klass.new(**args)
+      resource = block_given? ? @klass.new.tap(&block) : @klass.new(**args)
 
       data = resource.call(recipient_number, reply_to:)
 

data/lib/warb/dispatcher_concern.rb

@@ -56,10 +56,6 @@ module Warb
       @contact ||= Dispatcher.new Resources::Contact, dispatcher
     end
 
-    def template
-      @template ||= TemplateDispatcher.new Resources::Template, dispatcher
-    end
-
     def flow
       @flow ||= Dispatcher.new Resources::Flow, dispatcher
     end

data/lib/warb/resources/location.rb

@@ -5,17 +5,7 @@ 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",
           location: {

data/lib/warb/resources/resource.rb

@@ -19,14 +19,6 @@ module Warb
         raise NotImplementedError
       end
 
-      def build_template_positional_parameter
-        raise NotImplementedError
-      end
-
-      def build_template_named_parameter(paramater_name)
-        raise NotImplementedError
-      end
-
       def set_text_header
         raise NotImplementedError
       end

data/lib/warb/resources/text.rb

@@ -3,13 +3,10 @@
 module Warb
   module Resources
     class Text < Resource
-      attr_accessor :content, :text, :message, :preview_url, :parameter_name
+      attr_accessor :content, :text, :message, :preview_url
 
       def build_header
-        { type: "text", text: message_per_priority }.tap do |header|
-          parameter_name ||= @params[:parameter_name]
-          header[:parameter_name] = parameter_name unless parameter_name.nil?
-        end
+        { type: "text", text: message_per_priority }
       end
 
       def build_payload
@@ -22,21 +19,6 @@ 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
-
       private
 
       def message_per_priority

data/lib/warb/version.rb

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

data/lib/warb.rb

@@ -3,7 +3,6 @@
 require "faraday"
 require "faraday/multipart"
 require_relative "warb/version"
-require_relative "warb/language"
 require_relative "warb/configuration"
 require_relative "warb/dispatcher_concern"
 require_relative "warb/client"
@@ -21,21 +20,11 @@ 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"
 require_relative "warb/dispatcher"
 require_relative "warb/media_dispatcher"
-require_relative "warb/template_dispatcher"
 require_relative "warb/indicator_dispatcher"
 require_relative "warb/utils"
-require_relative "warb/components/component"
-require_relative "warb/components/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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: warb
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Rebase
@@ -52,8 +52,6 @@ files:
 - docs/README.md
 - docs/components/README.md
 - docs/components/address.md
-- docs/components/button.md
-- docs/components/copy_code_button.md
 - docs/components/cta_action.md
 - docs/components/email.md
 - docs/components/list_action.md
@@ -64,7 +62,6 @@ files:
 - docs/components/row.md
 - docs/components/section.md
 - docs/components/url.md
-- docs/components/url_button.md
 - docs/images/contact-with-wa_id.png
 - docs/images/contact-without-wa_id.png
 - docs/messages/README.md
@@ -81,13 +78,8 @@ files:
 - docs/messages/location_request.md
 - docs/messages/reaction.md
 - docs/messages/sticker.md
-- docs/messages/template.md
 - docs/messages/text.md
 - docs/messages/video.md
-- docs/resources/currency.md
-- docs/resources/date_time.md
-- docs/resources/index.md
-- docs/resources/text.md
 - docs/setup.md
 - docs/webhook.md
 - examples/audio.rb
@@ -106,28 +98,19 @@ files:
 - lib/warb/client.rb
 - lib/warb/components/action.rb
 - lib/warb/components/address.rb
-- lib/warb/components/button.rb
-- lib/warb/components/component.rb
-- lib/warb/components/copy_code_button.rb
 - lib/warb/components/email.rb
 - lib/warb/components/name.rb
 - lib/warb/components/org.rb
 - lib/warb/components/phone.rb
-- lib/warb/components/quick_reply_button.rb
 - lib/warb/components/url.rb
-- lib/warb/components/url_button.rb
-- lib/warb/components/voice_call_button.rb
 - lib/warb/configuration.rb
 - lib/warb/connection.rb
 - lib/warb/dispatcher.rb
 - lib/warb/dispatcher_concern.rb
 - lib/warb/indicator_dispatcher.rb
-- lib/warb/language.rb
 - lib/warb/media_dispatcher.rb
 - lib/warb/resources/audio.rb
 - lib/warb/resources/contact.rb
-- lib/warb/resources/currency.rb
-- lib/warb/resources/date_time.rb
 - lib/warb/resources/document.rb
 - lib/warb/resources/flow.rb
 - lib/warb/resources/image.rb
@@ -139,10 +122,8 @@ files:
 - lib/warb/resources/reaction.rb
 - lib/warb/resources/resource.rb
 - lib/warb/resources/sticker.rb
-- lib/warb/resources/template.rb
 - lib/warb/resources/text.rb
 - lib/warb/resources/video.rb
-- lib/warb/template_dispatcher.rb
 - lib/warb/utils.rb
 - lib/warb/version.rb
 - sig/warb.rbs

data/docs/components/button.md

@@ -1,61 +0,0 @@
-# Button
-
-`Warb::Components::Button` is a component that represents a generic button used in template messages. It's part of the Components module, which contains reusable parts of complex structures.
-
-It represents a generic button, which can be set with the following attributes:
-
-## Attributes
-|   Attribute  |    Type   | Required |                   Description                 |
-|--------------|-----------|----------|-----------------------------------------------|
-| `index`      | `Integer` |   Yes    | An identifier or position for the button.     |
-| `sub_type`   | `String`  |   Yes    | A more specific classification for the button |
-
-## Common Button Types
-| Button Type   | Template Instance Method     | Params                  |
-|---------------|------------------------------|-------------------------|
-| `quick_reply` | `add_quick_reply_button`     | `index`                 |
-| `voice_call`  | `add_voice_call_button`      | `index`                 |
-| `url`         | `add_dynamic_url_button`     | `index`, `text`         |
-| `copy_code`   | `add_copy_code_button`       | `index`, `coupon_code`  |
-
-Please, refer to our [templates messaging documentation](../messages/template.md) for more info. You can check the methods to insert a button in the "Adding Buttons" section.
-
-## Examples
-
-### Quick Reply button
-```ruby
-quick_reply = Warb::Components::Button.new(index: 0, sub_type: "quick_reply")
-quick_reply.to_h
-=> {
-     type: "button",
-     sub_type: "quick_reply",
-     index: 0
-   }
-```
-
-### Voice Call button
-```ruby
-voice_call = Warb::Components::Button.new(index: 1, sub_type: "voice_call")
-voice_call.to_h
-=> {
-     type: "button",
-     sub_type: "voice_call",
-     index: 1
-   }
-```
-
-## Usage in Templates
-
-Buttons are typically used within template messages. Here's how to add them:
-
-```ruby
-template = Warb::Resources::Template.new(name: "my_template", language: "en_US")
-
-# Add a quick reply button
-template.add_quick_reply_button(index: 0)
-
-# Add a voice call button
-template.add_voice_call_button(index: 1)
-
-# The buttons will be included in the template's build_payload (as components)
-```

data/docs/components/copy_code_button.md

@@ -1,57 +0,0 @@
-# CopyCodeButton
-
-`Warb::Components::CopyCodeButton` is a component used in template messages for copy code buttons.
-
-## Attributes
-|   Attribute    |    Type   | Required |                   Description                 |
-|----------------|-----------|----------|-----------------------------------------------|
-| `index`        | `Integer` |   Yes    | An identifier or position for the button.     |
-| `sub_type`     | `String`  |   Yes    | Always "copy_code" for this button type       |
-| `coupon_code`  | `String`  |   No     | The coupon code to be copied when button is pressed |
-
-## Examples
-
-### Basic copy code button
-```ruby
-copy_button = Warb::Components::CopyCodeButton.new(index: 0, sub_type: "copy_code", coupon_code: "SAVE20")
-copy_button.to_h
-=> {
-     type: "button",
-     sub_type: "copy_code",
-     index: 0,
-     parameters: [
-       {
-         type: "coupon_code",
-         coupon_code: "SAVE20"
-       }
-     ]
-   }
-```
-
-### Copy code button without coupon code
-```ruby
-copy_button = Warb::Components::CopyCodeButton.new(index: 1, sub_type: "copy_code")
-copy_button.to_h
-=> {
-     type: "button",
-     sub_type: "copy_code",
-     index: 1
-   }
-```
-
-## Usage in Templates
-
-Copy code buttons are typically added to templates using the `add_copy_code_button` method:
-
-```ruby
-template = Warb::Resources::Template.new(name: "my_template", language: "en_US")
-
-# Add a copy code button
-template.add_copy_code_button(index: 0, coupon_code: "SAVE20")
-
-# Or using a block for more complex configuration
-template.add_copy_code_button do |button|
-  button.index = 0
-  button.coupon_code = "SAVE20"
-end
-```

data/docs/components/url_button.md

@@ -1,57 +0,0 @@
-# UrlButton
-
-`Warb::Components::UrlButton` is a component used in template messages, for dynamic url or auth code buttons.
-
-## Attributes
-|   Attribute  |    Type   | Required |                   Description                 |
-|--------------|-----------|----------|-----------------------------------------------|
-| `index`      | `Integer` |   Yes    | An identifier or position for the button.     |
-| `sub_type`   | `String`  |   Yes    | Always "url" for this button type             |
-| `text`       | `String`  |   No     | The URL suffix or text parameter for the button |
-
-## Examples
-
-### Basic URL button
-```ruby
-url_button = Warb::Components::UrlButton.new(index: 0, sub_type: "url", text: "example.com")
-url_button.to_h
-=> {
-     type: "button",
-     sub_type: "url",
-     index: 0,
-     parameters: [
-       {
-         type: "text",
-         text: "example.com"
-       }
-     ]
-   }
-```
-
-### URL button without text parameter
-```ruby
-url_button = Warb::Components::UrlButton.new(index: 1, sub_type: "url")
-url_button.to_h
-=> {
-     type: "button",
-     sub_type: "url",
-     index: 1
-   }
-```
-
-## Usage in Templates
-
-URL buttons are typically added to templates using the `add_dynamic_url_button` method:
-
-```ruby
-template = Warb::Resources::Template.new(name: "my_template", language: "en_US")
-
-# Add a dynamic URL button
-template.add_dynamic_url_button(index: 0, text: "example.com")
-
-# Or using a block for more complex configuration
-template.add_dynamic_url_button do |button|
-  button.index = 0
-  button.text = "example.com"
-end
-```

data/docs/messages/template.md

@@ -1,327 +0,0 @@
-# Template
-
-Template messages are used to send a message with a specific template.
-
-This is useful for sending messages that have a predefined structure, such as notifications or alerts.
-
-#### Quick Examples
-
-**Note**: For the examples below, take into account `Warb.setup` was called to configure the global client instance.
-
-List available templates:
-```ruby
-Warb.template.list
-```
-
-Sending template messages:
-```ruby
-Warb.template.dispatch(recipient_number, **params)
-```
-
-#### Listing Templates
-
-**Prerequisites**: In order to view templates, you need to have them available in your business account. For more details, refer to the [Meta documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates/template-library). Template creation via API will be covered later in this documentation (coming soon).
-
-You can retrieve all available message templates:
-
-```ruby
-Warb.template.list
-```
-
-##### Optional Parameters
-
-You can optionally filter templates using various parameters:
-
-Limit the number of results:
-```ruby
-Warb.template.list(limit: 10)
-```
-
-Specify which template fields to return:
-```ruby
-Warb.template.list(fields: ["name", "status", "category"])
-```
-
-For a complete list of available fields, refer to the [Meta documentation](https://developers.facebook.com/docs/graph-api/reference/whats-app-business-hsm/#fields).
-
-##### Example Response
-
-```ruby
-{
-  "data" => [
-    {
-      "name" => "hello_world",
-      "status" => "APPROVED",
-      "category" => "UTILITY",
-      "language" => "en_US",
-      "components" => [ ... ],
-      "id" => "1282952826730729"
-    },
-    {
-      "name" => "other_template_001",
-      "status" => "APPROVED",
-      "category" => "MARKETING",
-      "language" => "pt_BR",
-      "components" => [ ... ],
-      "id" => "1948352829250167"
-    }
-  ],
-  "paging" => {
-    "cursors" => {
-      "before" => "...",
-      "after" => "..."
-    }
-  }
-}
-```
-
-#### Sending Template Messages
-
-To send  a template message, you need to provide the template name and the parameters for the template, if any.
-
-```ruby
-Warb.template.dispatch(recipient_number, **params)
-```
-
-Here, `**params` is a named hash parameters that will be passed to the template, as follow:
-| Attribute   | Type              | Required | Description                           |
-|-------------|-------------------|----------|---------------------------------------|
-| `name`      | `String`          | Yes      | The name of the template to use       |
-| `language`  | `String`          | Yes      | The language to use for the template  |
-| `resources` | `Array` or `Hash` | No       | The resources to use for the template |
-
-`name` must be the name of a template that has been created in the WhatsApp Business Platform.
-
-`language` must be a valid language code, such as `en_US` for English (United States) or `fr_FR` for French (France). Also, the specified template must support the specified language.
-
-> You can check `Warb::Language` for a list of supported languages.
-> If yours isn't there, you can refer to this [list with all supported languages](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/supported-languages) by WhatsApp.
-> Just use the value in the `code` column, and it will work.
-
-`resouces` can be an array or a hash of resources that will be used as parameters for the template. At this point, only `text`, `date_time` and `currency` are supported.
-
-If the template uses named parameters, then `resources` must be a hash, as follow:
-```ruby
-customer_name = Warb::Resources::Text.new(content: "Name")
-purchase_date = Warb::Resources::Text.new("January 1, 2023")
-
-Warb.template.dispatch(recipient_number, resources: {
-  customer_name: customer_name,
-  purchase_date: purchase_date
-}, name: "testing", language: "pt_BR")
-```
-
-If the template uses positional parameters, then `resources` must be an array, as follow:
-```ruby
-customer_name = Warb::Resources::Text.new(content: "Name")
-purchase_date = Warb::Resources::DateTime.new("January 1, 2023")
-
-Warb.template.dispatch(recipient_number, resources: [
-  customer_name,
-  purchase_date
-], name: "testing", language: "en_US")
-```
-
-In any case, under the hood, the resources instances' method `build_template_named_parameter` or `build_template_positional_parameter` will be called to build the template parameters accordingly.
-
-Instead of instatiating the resources manually, you can use helper methods as follow:
-```ruby
-Warb.template.dispatch(recipient_number) do |template|
-  template.name = "testing"
-  template.language = Warb::Language::PORTUGUESE_BR
-  template.add_text_parameter(content: "Name")
-  template.add_currency_parameter(code: "USD", amount: 11.42)
-end
-```
-
-Here, `add_text_parameter` and `add_currency_parameter` will build the resources for you with the given named parameters and add them to the template.
-
-Here's a table with all the helper methods you can use to add resources/paramters to the template message:
-| Method Name                     | Resource Type               | Description                                      |
-|---------------------------------|-----------------------------|--------------------------------------------------|
-| `add_text_parameter`            | `Warb::Resources::Text`     | Adds a text parameter to the template            |
-| `add_date_time_parameter`       | `Warb::Resources::DateTime` | Adds a date time parameter to the template       |
-| `add_currency_parameter`        | `Warb::Resources::Currency` | Adds a currency parameter to the template        |
-
-In the example above, notice we only used named parameters (no positional parameters) as arguments to the add parameter methods.
-
-So, the parameters will be built as positional parameters, and the `resources` will be an array.
-
-Also, the resources will be used to substitute the corresponding parameters in your template, in the same order they were added to the parameters/resources list.
-
-If you don't want to worry about the order of the parameters, you may use named parameters.
-
-For that, you have to pass the parameter name (as defined in your template) as the first argument to the helper method, as follow:
-```ruby
-Warb.template.dispatch(recipient_number, name: "testing", language: "pt_BR") do |template|
-  template.add_text_parameter("customer_name", content: "Name")
-  template.add_date_time_parameter("purchase_date", date_time: "January 1, 2023")
-end
-```
-
-This way, the order of the parameters names in the template and the order they were added with the `add_parameter` methods may be entirely different.
-
-One **IMPORTANT** thing to note is that, once defined, the type of the parameters won't be changed.
-
-So, in the following code:
-```ruby
-Warb.template.dispatch(recipient_number, name: "testing", language: "pt_BR") do |template|
-  template.add_date_time_parameter(date_time: "January 1, 2023")
-  template.add_text_parameter("customer_name", content: "Name")
-end
-```
-Your `customer_name` parameter won't behave the way you may expect.
-
-Since the first call to an `add_parameter` method was using the positional parameters syntax, then the internal resources attribute was set to an array, so that means any posterior calls to any `add_parameter` method will simply ignore the named parameter syntax and append the built resource to the list of positional parameters
-
-If the order of the calls was different:
-```ruby
-Warb.template.dispatch(recipient_number, name: "testing", language: "pt_BR") do |template|
-  template.add_text_parameter("customer_name", content: "Name")
-  template.add_date_time_parameter(date_time: "January 1, 2023")
-  template.add_currency_parameter(code: "USD", amount: 10)
-end
-```
-
-1. The first call to `add_parameter` method would set the internal resources/parameter to a hash, with a initial key named `customer_name`, pointing to a text resource
-
-2. Then the `DateTime` resource (built in the second call to `add_parameter` method) would be set as value to the key `""` (empty string) in the named parameter hash.
-
-3. Eventually, the `Currency` resource (in the third call do `add_parameter` method) would be set as value to the same key `""` (empty string) as the previous call, which would overwrite the previous resource.
-
-In this case, the call to the api would result in an error, either due to the mismatch of the count of parameters, or due to not having all named parameters defined.
-
-So, make sure to always use the same parameter syntax accordingly to your template.
-
-The add parameter methods also support block building as well:
-```ruby
-Warb.template.dispatch(recipient_number) do |template|
-  template.name = "testing"
-  template.language = Warb::Language::ENGLISH_US
-
-  template.add_text_parameter(content: "Name")
-
-  template.add_currency_parameter do |currency|
-    currency.code = "USD"
-    currency.amount = 11.42
-    currency.fallback = "$ 11.42"
-  end
-
-  template.add_date_time_parameter do |purchase_date|
-    purchase_date.date_time = "Jan 1st, 2024"
-  end
-end
-```
-
-If your template has any media header, you can set it as follow:
-| Header Type    | Template Instance Method    | Params                                         |
-|----------------|-----------------------------|------------------------------------------------|
-| `image`        | `set_image_header`          | `media_id` or `link`                           |
-| `video`        | `set_video_header`          | `media_id` or `link`                           |
-| `document`     | `set_document_header`       | `media_id` or `link`, `filename`               |
-| `location`     | `set_location_header`       | `latitude`, `longitude`, `name`, and `address` |
-| `text`         | `set_text_header`           | `content`, `parameter_name`                    |
-
-Every time a call is made to any `set_header` method, a new header will be set, overwriting the previous one.
-
-If you just want to change one attribute or another, `set_header` methods return the related resource, so it is possible to set the values if you keep a hold of such instance
-```ruby
-Warb.template.dispatch(recipient_number) do |template|
-  header = template.set_image_header(media_id: "wrong_media_id")
-
-  header.media_id = "correct_media_id"
-end
-```
-
-Also, either only one of `media_id` or `link` must be provided.
-
-The `media_id` must be the id of media uploaded previously to WhatsApp Business Platform, while the `link` must be a public acessible URL.
-
-Check the `upload` section for each media related message, like [`image`](./image.md) or [`document`](./document.md), for more info on how to upload and the supported formats.
-
-For the `document` header, `filename` is important because its extension will determine the preview capability on the recipient's device.
-
-For the `location` header, at least `latitude` and `longitude` must be provided.
-
-`set_header` methods will simply instatiate the corresponding resource class with the given parameters, and then, set it as the header attribute.
-
-For `text` header, note that, due to how the WhatsApp Business Platform works, you can't set the entire content for it (the same that happens with the body of the message).
-
-In this case, `set_text_header`, will simply use whatever was given to it as parameter to build the final header in the WhatsApp Business Platform.
-
-So, for example, if your tamplate header was created with `Hello, {{1}}!`, then the text passed to `set_text_header` will simply be substituted in that `{{1}}`.
-
-If your template was defined using named parameters instead (something like `Hello, {{customer_name}}!`), then you must pass the name of the paramter to `set_text_header` as follow:
-```ruby
-Warb.template.dispatch(recipient_number) do |template|
-  template.set_text_header(content: "John", parameter_name: "customer_name")
-end
-```
-
-When the template instance's `build_payload` method is called (which happens when the message is about to be dispatched), the header param will be created using the `header`'s `build_header` method.
-
-#### Adding Buttons
-
-If your template supports buttons, you can add them using the following methods:
-
-| Button Type        | Template Instance Method      | Params                                    |
-|--------------------|-------------------------------|-------------------------------------------|
-| `quick_reply`      | `add_quick_reply_button`      | `index`                                   |
-| `url`              | `add_dynamic_url_button`      | `index`, `text`                           |
-| `url`              | `add_auth_code_button`        | `index`, `text`                           |
-| `copy_code`        | `add_copy_code_button`        | `index`, `coupon_code`                    |
-| `voice_call`       | `add_voice_call_button`       | `index`                                   |
-| `doesn't apply`    | `add_button`                  | `instance`, `&block`                      |
-
-You can either use the keyword parameters or set the attributes using a block:
-
-```ruby
-Warb.template.dispatch(recipient_number) do |template|
-  template.name = "order_confirmation"
-  template.language = Warb::Language::ENGLISH_US
-
-  # Add a quick reply button
-  template.add_quick_reply_button
-
-  # Add a dynamic URL button
-  template.add_dynamic_url_button do |button|
-    button.text = "dynamic-url-suffix"
-  end
-
-  # Add a copy auth code button
-  template.add_auth_code_button do |button|
-    button.text = "4UTHC0D3"
-  end
-
-  # Add a copy code button
-  template.add_copy_code_button(index: 2) do |button|
-    button.coupon_code = "SAVE20"
-  end
-
-  # Add a voice call button
-  template.add_voice_call_button
-end
-```
-
-or if you'd rather to, you can add buttons using it's component and the `add_button` method:
-
-```ruby
-quick_reply_btn = Warb::Components::QuickReplyButton.new
-
-Warb.template.dispatch(recipient_number) do |template|
-  template.name = "order_confirmation"
-  template.language = Warb::Language::ENGLISH_US
-
-  # Add a quick reply button
-  template.add_button(quick_reply_btn)
-
- # Add a quick reply button, passing a block.
-  template.add_button(quick_reply_btn) { |button| button.index = 1 }
-end
-```
-
-**Note**: The `index` parameter determines the order of the buttons in the template. Make sure the
-indices match the button positions defined in your template. The `index` is automaticaly set if you
-don't do it manually, but it is done based on the number of buttons added with the methods above,
-so if your template has a button that doesn't need configuration like the static url button you'll
-have provide the position of the other buttons.

data/docs/resources/currency.md

@@ -1,22 +0,0 @@
-# Currency
-
-`Warb::Resources::Currency` is a resource, but different from most other resources, it can't be sent. Instead, it's used in a template message as one of its parameters.
-
-Please, refer to  our [templates messaging documentation](../messages/template.md) for more info.
-
-It represents an amount in a specific currency, which can be set with the following attributes:
-| Attribute  | Type               | Required | Description                                                 |
-|------------|--------------------|----------|-------------------------------------------------------------|
-| `amount`   | `Integer`, `Float` | Yes      | The amount to be represented in the given currency          |
-| `code`     | `String`           | Yes      | The code of the currency to be used                         |
-| `fallback` | `String`           | No       | A fallback value to be used in case the code can't be found |
-
-Since it is used in template messages, it implements both `build_template_named_parameter` and `build_template_positional_parameter`, which prepares the resource for using as parameter.
-
-If no `fallback` value is given, then a default one, based on the given `amount` and `currency` is used.
-
-In the WhatsApp Business Platform, the `code` will be used to represent the given `amount` according to the specific currency.
-
-But if the given code doesn't exist, or is not supported, then the given `fallback` value will be used instead.
-
-For the `code`, you must use one currency code like `USD` or `BRL`. `Warb::Resources::Currency` offers some of the most used currencies. You can also [check here](https://www.iso.org/iso-4217-currency-codes.html) for more detailed info and other available options.

data/docs/resources/date_time.md

@@ -1,11 +0,0 @@
-# Date Time
-
-`Warb::Resources::DateTime` is a resource, but different from most other resources, it can't be sent. Instead, it's used in a template message as one of its parameters.
-
-Please, refer to  our [templates messaging documentation](../messages/template.md) for more info.
-
-It simply represents a date time object, with the unique param/attribute being `date_time`.
-
-Although its name is `date_time`, its content can be any string, like `"January 1st"`, `"2020-01-01"` or `"Wednesday, Jan, 1st, 2020"`.
-
-Since it is used in template messages, it implements both `build_template_named_parameter` and `build_template_positional_parameter`, which prepares the resource for using as parameter.

data/docs/resources/index.md

@@ -1,14 +0,0 @@
-# Resources
-
-Most of the resources can be sent as message. Check the [messages](../messages/index.md) for detailed info.
-
-But there are some resources which act more like a component, not being used alone by themself.
-
-There are also, resources which can be used alone, and as components for other messages types, like the `Text` resource.
-
-Such resources, and where they are used, are listed bellow:
-| Resource                    | Documentation                | Used at                                                                              |
-|-----------------------------|------------------------------|--------------------------------------------------------------------------------------|
-| `Warb::Resources::Currency` | [Currency](./currency.md)    | [Template Messaging](../messages/template.md)                                        |
-| `Warb::Resources::DateTime` | [Date Time](./date_time.md)  | [Template Messaging](../messages/template.md)                                        |
-| `Warb::Resources::Text`     | [Text](./text.md)            | [Text Messaging](../messages/text.md), [Template Messaging](../messages/template.md) |

data/docs/resources/text.md

@@ -1,9 +0,0 @@
-# Text
-
-`Warb::Resources::Text` is a resource, which represents a text.
-
-It can be used as a [simple message](../messages/text.md), as a text header for some interactive messages, like the [reply button message](../messages/interactive_reply_button.md) and as [parameters for templates](../messages/template.md) variables.
-
-In the [text messaging documentation](../messages/text.md) there is a table with the corresponding attributes.
-
-Aside from such attributes, `Text` resource also provides the `build_template_named_parameter` and `build_template_positional_parameter` methods, which are using under the hood for the template messaging feature.

data/lib/warb/components/button.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-module Warb
-  module Components
-    class Button < Component
-      attr_accessor :index, :sub_type
-
-      def initialize(**params)
-        params[:sub_type] = button_type unless params[:sub_type]
-
-        super(**params)
-      end
-
-      def to_h
-        {
-          type: "button",
-          sub_type: sub_type || @params[:sub_type],
-          index: index || @params[:index]
-        }
-      end
-
-      private
-
-      def button_type
-        raise NotImplementedError
-      end
-    end
-  end
-end

data/lib/warb/components/component.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-module Warb
-  module Components
-    class Component
-      def initialize(**params)
-        @params = params
-      end
-
-      def to_h
-        raise NotImplementedError
-      end
-
-      protected
-
-      attr_reader :params
-    end
-  end
-end 

data/lib/warb/components/copy_code_button.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-module Warb
-  module Components
-    class CopyCodeButton < Button
-      BUTTON_TYPE = "copy_code"
-
-      attr_accessor :coupon_code
-
-      def to_h
-        button_payload = super
-
-        if coupon_code || @params[:coupon_code]
-          button_payload[:parameters] = Array.new(1, {
-            type: "coupon_code",
-            coupon_code: coupon_code || @params[:coupon_code]
-          })
-        end
-
-        button_payload
-      end
-
-      private
-
-      def button_type
-        BUTTON_TYPE
-      end
-    end
-  end
-end

data/lib/warb/components/quick_reply_button.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Warb
-  module Components
-    class QuickReplyButton < Button
-      BUTTON_TYPE = "quick_reply"
-
-      private
-
-      def button_type
-        BUTTON_TYPE
-      end
-    end
-  end
-end

data/lib/warb/components/url_button.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-module Warb
-  module Components
-    class UrlButton < Button
-      BUTTON_TYPE = "url"
-
-      attr_accessor :text
-
-      def to_h
-        button_payload = super
-
-        if text || @params[:text]
-          button_payload[:parameters] = Array.new(1, {
-            type: "text",
-            text: text || @params[:text]
-          })
-        end
-
-        button_payload
-      end
-
-      private
-
-      def button_type
-        BUTTON_TYPE
-      end
-    end
-  end
-end

data/lib/warb/components/voice_call_button.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Warb
-  module Components
-    class VoiceCallButton < Button
-      BUTTON_TYPE = "voice_call"
-
-      private
-
-      def button_type
-        BUTTON_TYPE
-      end
-    end
-  end
-end

data/lib/warb/language.rb

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-module Warb
-  module Language
-    ENGLISH_US = "en_US"
-    PORTUGUESE_BR = "pt_BR"
-  end
-end

data/lib/warb/resources/currency.rb

@@ -1,45 +0,0 @@
-# frozen_string_literal: true
-
-module Warb
-  module Resources
-    class Currency < Resource
-      BRL = "BRL"
-      USD = "USD"
-
-      attr_accessor :amount, :code, :fallback
-
-      def initialize(**params)
-        super(**params)
-
-        @code = params[:code]
-        @amount = params[:amount]
-        @fallback = params[:fallback]
-      end
-
-      def build_template_named_parameter(parameter_name)
-        common_currency_params.merge(parameter_name: parameter_name)
-      end
-
-      def build_template_positional_parameter
-        common_currency_params
-      end
-
-      private
-
-      def common_currency_params
-        {
-          type: "currency",
-          currency: {
-            amount_1000: amount * 1000,
-            code: code,
-            fallback_value: fallback || default_fallback_value
-          }
-        }
-      end
-
-      def default_fallback_value
-        "#{amount} (#{code})"
-      end
-    end
-  end
-end

data/lib/warb/resources/date_time.rb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-module Warb
-  module Resources
-    class DateTime < Resource
-      attr_accessor :date_time
-
-      def initialize(date_time = nil, **params)
-        super(**params)
-
-        @date_time = date_time || params[:date_time]
-      end
-
-      def build_template_named_parameter(parameter_name)
-        common_date_time_params.merge(parameter_name: parameter_name)
-      end
-
-      def build_template_positional_parameter
-        common_date_time_params
-      end
-
-      private
-
-      def common_date_time_params
-        {
-          type: "date_time",
-          date_time: {
-            fallback_value: date_time
-          }
-        }
-      end
-    end
-  end
-end

data/lib/warb/resources/template.rb

@@ -1,166 +0,0 @@
-# frozen_string_literal: true
-
-module Warb
-  module Resources
-    class Template < Resource
-      attr_accessor :name, :language, :resources, :header, :buttons
-
-      def initialize(**params)
-        super(**params)
-
-        @name = params[:name]
-        @language = params[:language]
-        @resources = params[:resources]
-        @buttons = []
-      end
-
-      def build_payload
-        {
-          type: "template",
-          template: {
-            name: name,
-            language: {
-              code: language
-            },
-            components: [
-              component_header,
-              component_body,
-              *buttons
-            ].compact
-          }
-        }
-      end
-
-      def add_currency_parameter(parameter_name = nil, **params, &block)
-        add_parameter(parameter_name, Currency.new(**params), &block)
-      end
-
-      def add_date_time_parameter(parameter_name = nil, **params, &block)
-        add_parameter(parameter_name, DateTime.new(**params), &block)
-      end
-
-      def add_text_parameter(parameter_name = nil, **params, &block)
-        add_parameter(parameter_name, Text.new(**params), &block)
-      end
-
-      def set_text_header(content: nil, message: nil, text: nil, parameter_name: nil, &block)
-        set_header(Text.new(content:, message:, text:, parameter_name:), &block)
-      end
-
-      def set_image_header(media_id: nil, link: nil, &block)
-        set_header(Image.new(media_id:, link:), &block)
-      end
-
-      def set_document_header(media_id: nil, link: nil, filename: nil, &block)
-        set_header(Document.new(media_id:, link:, filename:), &block)
-      end
-
-      def set_video_header(media_id: nil, link: nil, &block)
-        set_header(Video.new(media_id:, link:), &block)
-      end
-
-      def set_location_header(latitude: nil, longitude: nil, address: nil, name: nil, &block)
-        set_header(Location.new(latitude:, longitude:, address:, name:), &block)
-      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_method :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_button(instance, &block)
-        return @buttons << instance.to_h unless block_given?
-
-        @buttons << instance.tap(&block).to_h
-      end
-
-      private
-
-      def set_header(instance, &block)
-        @header = instance
-
-        block_given? ? @header.tap(&block) : @header
-      end
-
-
-      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, &block)
-        case resources
-        when Hash
-          resources[parameter_name.to_s] = instance
-        when Array
-          resources << instance
-        else
-          initialize_resources(parameter_name, instance, &block)
-        end
-
-        block_given? ? instance.tap(&block) : 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/template_dispatcher.rb

@@ -1,10 +0,0 @@
-module Warb
-  class TemplateDispatcher < Dispatcher
-    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