mailgun-ruby 1.4.3 → 1.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4ebcbb3e9a3ff18a06515ffca7027ffa893d0250ad4f6491cd896a78e035428
-  data.tar.gz: 27750827e497452d5ea7276601a01621164d9a4decfb3e6f43b1d32c51b7aa62
+  metadata.gz: c32fbe02cb160ca73a1f278217357f922e9dbdf70605f00314e8f8031ead4361
+  data.tar.gz: 59a3c18c5955237dc99bf821d522fa7530f0ba91d8608c7ed0e62389b776d04f
 SHA512:
-  metadata.gz: 7432da86b0a9b20ddaea5e0cb049c0fac6b7f8e37cc907d79bbcd5aa642550a8c8067bdd40e3c87f49679306d662906ede13c9bdbb4fd70ea19498f4325c9d92
-  data.tar.gz: 8691eac12d6cd590d8735a60965376ee7f751fe700c6533dc61cab987917292ef21d03e22d0c35c2c58584288602396b5201b8d5b55bdf9834693819a10185cc
+  metadata.gz: baf3cb978859c99d99c0b1ec3a470313a29bbeb57b5a38175be79abe3f8d8f5ce65302d407dbc759c892bd0c676d8d2ee9e1dfacf1bd4a91baeda3dce54f1d35
+  data.tar.gz: 450c77f5dc1de40e84a52f98dea1219ba0f4664b41de3396574ddef20baff7ef35d97c21406ca5d8f8b414a875d3bff48bcfb68a8a467ea5333c8b60eb0bc5f2

data/README.md

@@ -19,7 +19,7 @@ gem install mailgun-ruby
 Gemfile:
 
 ```ruby
-gem 'mailgun-ruby', '~>1.4.3'
+gem 'mailgun-ruby', '~>1.4.4'
 ```
 
 Usage
@@ -186,6 +186,7 @@ This SDK includes the following components:
 - [Opt-In Handler](docs/OptInHandler.md)
 - [Domains](docs/Domains.md)
 - [Webhooks](docs/Webhooks.md)
+- [Account Webhooks](docs/AccountWebhooks.md)
 - [Events](docs/Events.md)
 - [Snippets](docs/Snippets.md)
 - [Subaccounts](docs/Subaccounts.md)

data/docs/AccountWebhooks.md

@@ -0,0 +1,55 @@
+Mailgun - Account Webhooks
+====================
+
+This is the Mailgun Ruby *Account Webhook* utilities.
+
+The below assumes you've already installed the Mailgun Ruby SDK in to your
+project. If not, go back to the master README for instructions.
+
+Usage - Account Webhooks
+-----------------------
+
+```ruby
+# First, instantiate the Mailgun Client with your API key
+mg_client = Mailgun::Client.new('your-api-key')
+hook = Mailgun::AccountWebhooks.new(mg_client)
+
+```
+
+Account Webhooks methods:
+
+```ruby
+# List account-level webhooks
+hook.list
+hook.list('id1, id2')
+
+# Create an account-level webhook
+hook.create(
+  description: 'desc',
+  event_types: 'accepted',
+  url: 'https://the.webhook.url/'
+)
+
+# Delete account-level webhooks
+hook.remove(all: true)
+hook.remove('id1, id2')
+
+# Get account-level webhook by ID
+hook.get('id1')
+
+# Update an account-level webhook
+hook.update(
+  'hook',
+  description: 'desc',
+  event_types: 'accepted',
+  url: 'https://the.webhook.url/'
+)
+
+# Delete account-level webhook by ID
+hook.remove_by_id('id1')
+```
+
+More Documentation
+------------------
+See the official [Mailgun Account Webhooks Docs](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/account-webhooks)
+for more information

data/docs/DomainKeys.md

@@ -0,0 +1,49 @@
+Mailgun - DomainKeys
+====================
+
+This is the Mailgun Ruby *DomainKeys* utilities.
+
+The below assumes you've already installed the Mailgun Ruby SDK in to your
+project. If not, go back to the master README for instructions. It currently supports
+all calls except credentials.
+
+Usage - DomainKeys
+-----------------------
+First, instantiate the Mailgun Client with your API key
+```ruby
+mg_client = Mailgun::Client.new('your-api-key')
+domainer = Mailgun::DomainKeys.new(mg_client)
+```
+
+Domain Keys methods:
+
+```ruby
+# List keys for all domains
+domainer.list_domain_keys { some: 'options' }
+
+# Create a domain key
+domainer.create_domain_key { some: 'options' }
+
+# Delete a domain key
+domainer.delete_domain_key { some: 'options' }
+
+# Activate a domain key
+domainer.activate_domain_key 'my.perfect.domain', 'selector'
+
+# List domain keys
+domainer.get_domain_keys 'my.perfect.domain'
+
+# Deactivate a domain key
+domainer.deactivate_domain_key 'my.perfect.domain', 'selector'
+
+# Update DKIM authority
+domainer.update_domain_dkim_authority 'my.perfect.domain', { some: 'options' }
+
+# Update a DKIM selector
+domainer.update_domain_dkim_selector 'my.perfect.domain', { some: 'options' }
+```
+
+More Documentation
+------------------
+See the official [Mailgun Domain Docs](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-keys)
+for more information

data/docs/Domains.md

@@ -41,34 +41,6 @@ domainer.remove 'this.one.is.not.needed.'
 
 ```
 
-Domain Keys methods:
-
-```ruby
-# List keys for all domains
-domainer.list_domain_keys { some: 'options' }
-
-# Create a domain key
-domainer.create_domain_key { some: 'options' }
-
-# Delete a domain key
-domainer.delete_domain_key { some: 'options' }
-
-# Activate a domain key
-domainer.activate_domain_key 'my.perfect.domain', 'selector'
-
-# List domain keys
-domainer.get_domain_keys 'my.perfect.domain'
-
-# Deactivate a domain key
-domainer.deactivate_domain_key 'my.perfect.domain', 'selector'
-
-# Update DKIM authority
-domainer.update_domain_dkim_authority 'my.perfect.domain', { some: 'options' }
-
-# Update a DKIM selector
-domainer.update_domain_dkim_selector 'my.perfect.domain', { some: 'options' }
-```
-
 Domain Tracking methods:
 
 ```ruby

data/docs/Webhooks.md

@@ -38,5 +38,5 @@ hook.remove_all 'my.perfect.domain'
 
 More Documentation
 ------------------
-See the official [Mailgun Domain Docs](https://documentation.mailgun.com/en/latest/api-webhooks.html)
+See the official [Mailgun Webhooks Docs](https://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/domain-webhooks)
 for more information

data/lib/mailgun/client.rb

@@ -185,7 +185,7 @@ module Mailgun
               request.body = params.to_json
             end
           else
-            @http_client.delete(resource_path, params: params)
+            @http_client.delete(resource_path, params)
           end
         else
           @http_client.delete(resource_path)

data/lib/mailgun/domains/domain_keys.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+module Mailgun
+  # A Mailgun::Domains object is a simple CRUD interface to Mailgun DomainsKeys.
+  # Uses Mailgun
+  class DomainKeys
+    include ApiVersionChecker
+
+    def initialize(client = Mailgun::Client.new)
+      @client = client
+    end
+
+    # Public: List keys for all domains
+    #
+    # options - [Hash] of
+    #   page - [String] Encoded paging information, provided via 'next', 'previous' links
+    #   limit - [Integer] Limits the number of items returned in a request
+    #   signing_domain  - [String] Filter by signing domain
+    #   selector - [String] Filter by selector
+    #
+    # Returns [Hash] with message key
+    def list_domain_keys(options = {})
+      @client.get('dkim/keys', options).to_h
+    end
+
+    # Public: Create a domain key
+    #
+    # options - [Hash] of
+    #   signing_domain  - [String] Name of the domain (ex. domain.com)
+    #   selector - [String] Selector to be used for the new domain key
+    #   bits - [Integer] Key size, can be 1024 or 2048
+    #   pem - [String] Private key PEM
+    #
+    # Returns [Hash] with message key
+    def create_domain_key(options = {})
+      @client.post('dkim/keys', options).to_h
+    end
+
+    # Public: Delete a domain key.
+    #
+    # options - [Hash] of
+    #   signing_domain - [Integer] Name of the domain (ex. domain.com)
+    #   selector - [String] Name of the selector
+    #
+    # Returns [Hash] with message key
+    def delete_domain_key(options = {})
+      @client.delete('dkim/keys', options).to_h
+    end
+
+    # Public: Activate a domain key for a specified authority and selector.
+    #
+    # domain    - [String] Name of the domain (ex. domain.com)
+    # selector  - [String] The selector you want to activate for the domain key
+    #
+    # Returns [Hash] with message key and autority + selector data
+    def activate_domain_key(domain, selector)
+      @client.put("domains/#{domain}/keys/#{selector}/activate", {}).to_h
+    end
+
+    # Public: Lists the domain keys for a specified signing domain / authority
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    #
+    # Returns [Hash] with domain keys data
+    def get_domain_keys(domain)
+      @client.get("domains/#{domain}/keys").to_h
+    end
+
+    # Public: Deactivate a domain key for a specified authority and selector
+    #
+    # domain    - [String] Name of the domain (ex. domain.com)
+    # selector  - [String] The selector you want to activate for the domain key
+    #
+    # Returns [Hash] with message key and autority + selector data
+    def deactivate_domain_key(domain, selector)
+      @client.put("domains/#{domain}/keys/#{selector}/deactivate", {}).to_h
+    end
+
+    # Public: Change the DKIM authority for a domain.
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    # options - [Hash] of
+    #   self  - [Boolean] true - the domain will be the DKIM authority for itself even
+    #           if the root domain is registered on the same mailgun account
+    #
+    # Returns [Hash] Information on the DKIM authority
+    def update_domain_dkim_authority(domain, options = {})
+      @client.put("domains/#{domain}/dkim_authority", options).to_h
+    end
+
+    # Public: Update the DKIM selector for a domains
+    #
+    # domain  - [String] Name of the domain (ex. domain.com)
+    # options - [Hash] of
+    #   dkim_selector  - [String] change the DKIM selector for a domain.
+    #
+    # Returns [Hash] with message key
+    def update_domain_dkim_selector(domain, options = {})
+      @client.put("domains/#{domain}/dkim_selector", options).to_h
+    end
+
+    enforces_api_version 'v1', :list_domain_keys, :create_domain_key, :delete_domain_key
+    enforces_api_version 'v3', :update_domain_dkim_authority, :update_domain_dkim_selector
+    enforces_api_version 'v4', :activate_domain_key, :deactivate_domain_key
+    enforces_api_version 'v4', :get_domain_keys
+  end
+end

data/lib/mailgun/domains/domains.rb

@@ -88,100 +88,6 @@ module Mailgun
 
     # ==== End of Core Domains methods ====
 
-    # ==== Domain::Keys methods ====
-
-    # Public: List keys for all domains
-    #
-
-    # options - [Hash] of
-    #   page - [String] Encoded paging information, provided via 'next', 'previous' links
-    #   limit - [Integer] Limits the number of items returned in a request
-    #   signing_domain  - [String] Filter by signing domain
-    #   selector - [String] Filter by selector
-    #
-    # Returns [Hash] with message key
-    def list_domain_keys(options = {})
-      @client.get('dkim/keys', options).to_h
-    end
-
-    # Public: Create a domain key
-    #
-    # options - [Hash] of
-    #   signing_domain  - [String] Name of the domain (ex. domain.com)
-    #   selector - [String] Selector to be used for the new domain key
-    #   bits - [Integer] Key size, can be 1024 or 2048
-    #   pem - [String] Private key PEM
-    #
-    # Returns [Hash] with message key
-    def create_domain_key(options = {})
-      @client.post('dkim/keys', options).to_h
-    end
-
-    # Public: Delete a domain key.
-    #
-    # options - [Hash] of
-    #   signing_domain - [Integer] Name of the domain (ex. domain.com)
-    #   selector - [String] Name of the selector
-    #
-    # Returns [Hash] with message key
-    def delete_domain_key(options = {})
-      @client.delete('dkim/keys', options).to_h
-    end
-
-    # Public: Activate a domain key for a specified authority and selector.
-    #
-    # domain    - [String] Name of the domain (ex. domain.com)
-    # selector  - [String] The selector you want to activate for the domain key
-    #
-    # Returns [Hash] with message key and autority + selector data
-    def activate_domain_key(domain, selector)
-      @client.put("domains/#{domain}/keys/#{selector}/activate", {}).to_h
-    end
-
-    # Public: Lists the domain keys for a specified signing domain / authority
-    #
-    # domain  - [String] Name of the domain (ex. domain.com)
-    #
-    # Returns [Hash] with domain keys data
-    def get_domain_keys(domain)
-      @client.get("domains/#{domain}/keys").to_h
-    end
-
-    # Public: Deactivate a domain key for a specified authority and selector
-    #
-    # domain    - [String] Name of the domain (ex. domain.com)
-    # selector  - [String] The selector you want to activate for the domain key
-    #
-    # Returns [Hash] with message key and autority + selector data
-    def deactivate_domain_key(domain, selector)
-      @client.put("domains/#{domain}/keys/#{selector}/deactivate", {}).to_h
-    end
-
-    # Public: Change the DKIM authority for a domain.
-    #
-    # domain  - [String] Name of the domain (ex. domain.com)
-    # options - [Hash] of
-    #   self  - [Boolean] true - the domain will be the DKIM authority for itself even
-    #           if the root domain is registered on the same mailgun account
-    #
-    # Returns [Hash] Information on the DKIM authority
-    def update_domain_dkim_authority(domain, options = {})
-      @client.put("domains/#{domain}/dkim_authority", options).to_h
-    end
-
-    # Public: Update the DKIM selector for a domains
-    #
-    # domain  - [String] Name of the domain (ex. domain.com)
-    # options - [Hash] of
-    #   dkim_selector  - [String] change the DKIM selector for a domain.
-    #
-    # Returns [Hash] with message key
-    def update_domain_dkim_selector(domain, options = {})
-      @client.put("domains/#{domain}/dkim_selector", options).to_h
-    end
-
-    # ==== End of Domain::Keys methods ====
-
     # ==== Domain::Tracking methods ====
 
     # Public: Returns tracking settings for the defined domain.
@@ -346,16 +252,13 @@ module Mailgun
 
     # ==== End of Reporting::Stats methods ====
 
-    enforces_api_version 'v1', :list_domain_keys, :create_domain_key, :delete_domain_key, :dkim_rotation,
-                         :dkim_rotate
+    enforces_api_version 'v1', :dkim_rotation, :dkim_rotate
     enforces_api_version 'v2', :get_domain_tracking_certificate, :regenerate_domain_tracking_certificate,
                          :generate_domain_tracking_certificate
     enforces_api_version 'v3', :remove, :create_smtp_credentials, :update_smtp_credentials,
                          :delete_smtp_credentials, :get_domain_tracking_settings,
                          :update_domain_tracking_open_settings, :update_domain_tracking_click_settings,
-                         :update_domain_tracking_unsubscribe_settings, :update_domain_dkim_authority,
-                         :update_domain_dkim_selector, :get_domain_stats
-    enforces_api_version 'v4', :get_domain_keys, :activate_domain_key, :deactivate_domain_key,
-                         :list, :verify, :create, :update
+                         :update_domain_tracking_unsubscribe_settings, :get_domain_stats
+    enforces_api_version 'v4', :list, :verify, :create, :update
   end
 end

data/lib/mailgun/helpers/api_version_checker.rb

@@ -11,9 +11,9 @@ module Mailgun
         method_names.each do |method_name|
           original_method = instance_method(method_name)
 
-          define_method(method_name) do |*args, &block|
+          define_method(method_name) do |*args, **kwargs, &block|
             warn_unless_api_version(version)
-            original_method.bind(self).call(*args, &block)
+            original_method.bind(self).call(*args, **kwargs, &block)
           end
         end
       end
@@ -22,9 +22,9 @@ module Mailgun
         method_names.each do |method_name|
           original_method = instance_method(method_name)
 
-          define_method(method_name) do |*args, &block|
+          define_method(method_name) do |*args, **kwargs, &block|
             require_api_version(version)
-            original_method.bind(self).call(*args, &block)
+            original_method.bind(self).call(*args, **kwargs, &block)
           end
         end
       end

data/lib/mailgun/version.rb

@@ -2,5 +2,5 @@
 
 # It's the version. Yeay!
 module Mailgun
-  VERSION = '1.4.3'
+  VERSION = '1.4.4'
 end

data/lib/mailgun/webhooks/account_webhooks.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Mailgun
+  # A Mailgun::AccountWebhooks object is a simple CRUD interface to Account Mailgun Webhooks.
+  # Uses Mailgun
+  class AccountWebhooks
+    include ApiVersionChecker
+
+    # Public creates a new Mailgun::Webhooks instance.
+    #   Defaults to Mailgun::Client
+    def initialize(client = Mailgun::Client.new(Mailgun.api_key, Mailgun.api_host || 'api.mailgun.net', 'v1'))
+      @client = client
+    end
+
+    # Public: List account-level webhooks
+    #
+    # webhook_ids - [String] Comma-separated list of webhook IDs to filter results. If specified,
+    #               only webhooks with matching IDs will be returned.
+    #
+    # Retrieve all account-level webhooks or filter by specific webhook IDs.
+    # Returns webhook details including associated event types.
+    def list(webhook_ids = '')
+      res = @client.get('webhooks', webhook_ids: webhook_ids)
+      res.to_h['webhooks']
+    end
+
+    # Public: Create an account-level webhook
+    #
+    # description - [String] Description for the webhook
+    # event_types - [String] Event types to subscribe to. Use multiple times to specify multiple event types.
+    #               Maximum of 3 unique URLs per event type.
+    # url         - [String] URL for webhook to be sent to
+    #
+    # Returns the Unique identifier for the webhook
+    def create(description:, event_types:, url:)
+      res = @client.post('webhooks', { description: description, event_types: event_types, url: url })
+      res.to_h
+    end
+
+    # Public: Delete account-level webhooks
+    #
+    # webhook_ids - [String] Comma-separated list of webhook IDs to delete.
+    #               If provided, only these specific webhooks will be deleted.
+    # all         - [Boolean] The required String of the webhook action to delete
+    #
+    # Returns a Boolean of the success
+    def remove(webhook_ids = nil, all: false)
+      @client.delete('webhooks', { webhook_ids: webhook_ids, all: all }.compact).status == 204
+    end
+
+    # Public: Get account-level webhook by ID
+    #
+    # webhook_id - [String] The webhook ID to retrieve
+    #
+    # Returns webhook details including associated event types.
+    def get(webhook_id)
+      res = @client.get("webhooks/#{webhook_id}")
+      res.to_h
+    end
+
+    # Public: Update an account-level webhook
+    #
+    # description - [String] Description for the webhook
+    # event_types - [String] Event types to subscribe to. Use multiple times to specify multiple event types.
+    #               Maximum of 3 unique URLs per event type.
+    # url         - [String] URL for webhook to be sent to
+    #
+    # Returns a Boolean of the success
+    def update(webhook_id, description:, event_types:, url:)
+      @client.put("webhooks/#{webhook_id}",
+                  { description: description, event_types: event_types, url: url }).status == 204
+    end
+
+    # Public: Delete account-level webhook by ID
+    #
+    # webhook_id - [String] The webhook ID to delete
+    #
+    # Returns a Boolean of the success
+    def remove_by_id(webhook_id)
+      @client.delete("webhooks/#{webhook_id}").status == 204
+    end
+
+    enforces_api_version 'v1', :list, :create, :remove, :get, :update, :remove_by_id
+  end
+end