action_webhook 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2063e93683fe64ce519f241843f17e33da9f29d671b965af97c0f97540a98ecc
-  data.tar.gz: 1f591bf9cfb727d9ab6e750338b708e4e24df2e782ea3f1a5096277f4311474d
+  metadata.gz: 5fd47bb2e72c2bd12feab3682031b00603f271279b435eeb56b5a4e7dba6bccb
+  data.tar.gz: a4e22834b739227926772b9b8d18f4dbc74c1d7f7fc06bcbc1174707a306897d
 SHA512:
-  metadata.gz: 14ed8242d705d62f573fd884e83bc70479ed4397c4bb3fffd75fd178bdc929fe5d981c395abb99ab7d647c7f1aec3aeaf1685784b3d521e3e62ed2e073ee8c1c
-  data.tar.gz: 45c7362968926262d79f6dedb16f2391d30a2b64980e3a5d0116558360ee63fe416b54f33a17012b82e5b50d8a465a58d5f91e1b6fa1f05e185959a2ce547230
+  metadata.gz: dd8df71521ef095e6f52aad36daacb1e518ec400a0cb1aa8919568dbe240731097679f18933bd9d30406d17a02685ffd79570189067e84405c80968c834de015
+  data.tar.gz: f42e11c74f275f4206c992a9e96a6e3b37eb40ed4f53191dbbef2192c596a2f039c172bd9d888f33ae0c18b9dc504a25d40055f86fba847ba5188c4e578af672

data/lib/action_webhook/base.rb

@@ -4,6 +4,10 @@ module ActionWebhook
   # Subclass this and define webhook methods (e.g. `created`, `updated`) that
   # define instance variables and call deliver to send webhooks.
   #
+  # Headers can be provided in two formats:
+  # 1. Hash format: { 'Authorization' => 'Bearer token', 'Content-Type' => 'application/json' }
+  # 2. Array format: [{ 'key' => 'Authorization', 'value' => 'Bearer token' }, { 'key' => 'Content-Type', 'value' => 'application/json' }]
+  #
   # Example:
   #
   #   class UserWebhook < ActionWebhook::Base
@@ -41,10 +45,26 @@ module ActionWebhook
   #
   #     def created(user)
   #       @user = user
-  #       endpoints = WebhookSubscription.where(event: 'user.created').map do |sub|
-  #         { url: sub.url, headers: { 'Authorization' => "Bearer #{sub.token}" } }
+  #       # Headers can be provided as a hash
+  #       endpoints_with_hash_headers = WebhookSubscription.where(event: 'user.created').map do |sub|
+  #         {
+  #           url: sub.url,
+  #           headers: { 'Authorization' => "Bearer #{sub.token}", 'X-Custom-Header' => 'value' }
+  #         }
   #       end
-  #       deliver(endpoints)
+  #
+  #       # Or headers can be provided as an array of key/value objects (useful for database storage)
+  #       endpoints_with_array_headers = WebhookSubscription.where(event: 'user.created').map do |sub|
+  #         {
+  #           url: sub.url,
+  #           headers: [
+  #             { 'key' => 'Authorization', 'value' => "Bearer #{sub.token}" },
+  #             { 'key' => 'X-Custom-Header', 'value' => 'value' }
+  #           ]
+  #         }
+  #       end
+  #
+  #       deliver(endpoints_with_hash_headers)
   #     end
   #   end
   #
@@ -234,8 +254,51 @@ module ActionWebhook
       assigns
     end
 
+    # Builds HTTP headers for webhook requests
+    #
+    # Supports two input formats:
+    # 1. Hash format: { 'Authorization' => 'Bearer token', 'Content-Type' => 'application/json' }
+    # 2. Array format: [{ 'key' => 'Authorization', 'value' => 'Bearer token' }, { 'key' => 'Content-Type', 'value' => 'application/json' }]
+    #
+    # The array format is useful when storing headers in databases where you need
+    # structured data with separate key and value fields.
+    #
+    # @param detail_headers [Hash, Array, nil] Headers in hash or array format
+    # @return [Hash] Formatted headers hash ready for HTTP request
     def build_headers(detail_headers)
-      headers = default_headers.merge(detail_headers)
+      # Handle both hash format and array format with key/value objects
+      processed_headers = case detail_headers
+                          when Array
+                            # Transform array of header hashes [{'key': 'value'}] into a single hash
+                            detail_headers.each_with_object({}) do |header_item, acc|
+                              next unless header_item.is_a?(Hash)
+
+                              # Handle string keys
+                              if header_item.key?('key') && header_item.key?('value')
+                                key = header_item['key']
+                                value = header_item['value']
+                                acc[key.to_s] = value.to_s if key && value
+                              # Handle symbol keys
+                              elsif header_item.key?(:key) && header_item.key?(:value)
+                                key = header_item[:key]
+                                value = header_item[:value]
+                                acc[key.to_s] = value.to_s if key && value
+                              else
+                                # Log warning for malformed header items
+                                logger&.warn("Skipping malformed header item: #{header_item.inspect}")
+                              end
+                            end
+                          when Hash
+                            # Ensure all keys and values are strings for consistency
+                            detail_headers.transform_keys(&:to_s).transform_values(&:to_s)
+                          when NilClass
+                            {}
+                          else
+                            logger&.warn("Unknown header format: #{detail_headers.class}. Expected Hash or Array.")
+                            {}
+                          end
+
+      headers = default_headers.merge(processed_headers)
       headers["Content-Type"] = "application/json" unless headers.key?("Content-Type")
       headers["X-Webhook-Attempt"] = @attempts.to_s if @attempts.positive?
       headers

data/lib/action_webhook/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActionWebhook
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: action_webhook
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Vinay Uttam Vemparala
 bindir: bin
 cert_chain: []
-date: 2025-06-06 00:00:00.000000000 Z
+date: 2025-07-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty