wcc-contentful 1.6.1 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b816aba232400e71ec193b4a60220a111afc356d3d6aa3a10d77f96eacea21df
-  data.tar.gz: 95b27d0804915ef3effaf67e36e8e4ebcef39aa8001921d4e94a51c699c43a93
+  metadata.gz: 9c8c705f0a469c62b48b4c0635d9ef9226e4c06ae5a51b1e3798c207bd17db20
+  data.tar.gz: b162610307104a0c5b4fbeb94ceb16806592b5dfefe766a1d538af33a1aa3452
 SHA512:
-  metadata.gz: ac1bcaeb7ddfe4f1f3fa2c34a542d814665e6d1428da89a4d8ae08a59686b5048d2892dc03cd9b3501a268bcf1867787a34ddeaac0b82d5791dadceef1df69e1
-  data.tar.gz: 7b84baba5cafff0ac07e7f0e557d08389f003918f84d2da7c10a8d7e50f60d45bd6214389b2e545803ed22964c00581920fa9f614b97d6e94a2e6e75abc090bc
+  metadata.gz: 82a7b8759d7d28ced49cb72d790dae577bff3a6f876738efc2fbd6bcc1f5d6638a8d9f777b7046b36ef9b802b2b6e343e5e13c02fa81a7b8770a6b3b4596151b
+  data.tar.gz: 580df9b2f644ae00ba75b3da1e21ceacce74a0b3f0238a6fce508d9d3d0a3d7734dc5fde6b232841b4218135af49363b75c7abd974548ad769a3258ce1ce25e4

data/lib/wcc/contentful/engine.rb

@@ -32,10 +32,18 @@ module WCC::Contentful
         next unless config&.management_token.present?
         next unless config.app_url.present?
 
-        WebhookEnableJob.set(wait: 10.seconds).perform_later if Rails.env.production?
+        if defined?(WCC::Contentful::WebhookEnableJob)
+          WCC::Contentful::WebhookEnableJob.set(wait: 10.seconds).perform_later if Rails.env.production?
+        else
+          Rails.logger.error 'ActiveJob is not defined, webhook enable job will not run'
+        end
       end
     end
 
+    initializer 'wcc-contentful.deprecations' do |app|
+      app.deprecators[:wcc_contentful] = WCC::Contentful.deprecator if app.respond_to?(:deprecators)
+    end
+
     config.generators do |g|
       g.test_framework :rspec, fixture: false
     end

data/lib/wcc/contentful/event.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'singleton'
+require 'ostruct'
 
 module WCC::Contentful::Event
   extend ActiveSupport::Concern

data/lib/wcc/contentful/link.rb

@@ -5,21 +5,30 @@ class WCC::Contentful::Link
 
   LINK_TYPES = {
     Asset: 'Asset',
-    Link: 'Entry'
+    Link: 'Entry',
+    Tag: 'Tag'
   }.freeze
 
   def initialize(model, link_type = nil)
-    @id = model.try(:id) || model
-    @link_type = link_type
-    @link_type ||= model.is_a?(WCC::Contentful::Model::Asset) ? :Asset : :Link
-    @raw =
-      {
-        'sys' => {
-          'type' => 'Link',
-          'linkType' => LINK_TYPES[@link_type] || link_type,
-          'id' => @id
+    if model.is_a?(Hash)
+      raise ArgumentError, 'Not a Link' unless model.dig('sys', 'type') == 'Link'
+
+      @raw = model
+      @id = model.dig('sys', 'id')
+      @link_type = model.dig('sys', 'linkType')
+    else
+      @id = model.try(:id) || model
+      @link_type = link_type
+      @link_type ||= model.is_a?(WCC::Contentful::Model::Asset) ? :Asset : :Link
+      @raw =
+        {
+          'sys' => {
+            'type' => 'Link',
+            'linkType' => LINK_TYPES[@link_type] || link_type,
+            'id' => @id
+          }
         }
-      }
+    end
   end
 
   alias_method :to_h, :raw

data/lib/wcc/contentful/metadata.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+WCC::Contentful::Metadata =
+  Struct.new(:raw) do
+    def tags
+      @tags ||=
+        Array(raw['tags']).map do |tag|
+          WCC::Contentful::Link.new(tag) if tag.is_a?(Hash)
+        end
+    end
+  end

data/lib/wcc/contentful/model_api.rb

@@ -41,7 +41,7 @@ module WCC::Contentful::ModelAPI
     end
 
     def store(preview = nil)
-      ActiveSupport::Deprecation.warn('Use services.store instead')
+      WCC::Contentful.deprecator.warn('Use services.store instead')
 
       preview ? services.preview_store : services.store
     end

data/lib/wcc/contentful/model_builder.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
+require 'ostruct'
 require_relative './link'
 require_relative './sys'
+require_relative './metadata'
 require_relative './rich_text'
 
 module WCC::Contentful
@@ -86,6 +88,10 @@ module WCC::Contentful
               OpenStruct.new(context).freeze
             )
 
+            @metadata = WCC::Contentful::Metadata.new(
+              raw['metadata']
+            )
+
             typedef.fields.each_value do |f|
               raw_value = raw.dig('fields', f.name)
 
@@ -119,6 +125,7 @@ module WCC::Contentful
           end
 
           attr_reader :sys
+          attr_reader :metadata
           attr_reader :raw
 
           delegate :id, to: :sys

data/lib/wcc/contentful/simple_client/cdn.rb

@@ -65,6 +65,33 @@ class WCC::Contentful::SimpleClient::Cdn < WCC::Contentful::SimpleClient
     resp.assert_ok!
   end
 
+  # https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/tags/tag-collection/get-all-tags/console
+  def tags(query = {})
+    resp =
+      _instrument 'tags', query: query do
+        get('tags', query)
+      end
+    resp.assert_ok!
+  end
+
+  # Retrieves a single tag by ID
+  #
+  # @param id [String] The ID of the tag to retrieve
+  # @param query [Hash] Optional query parameters
+  # @return [Response] Response containing the tag
+  # @raise [ArgumentError] If id is nil or empty
+  # @example
+  #   client.tag('sports')
+  def tag(id, query = {})
+    raise ArgumentError, 'id cannot be nil or empty' if id.nil? || id.empty?
+
+    resp =
+      _instrument 'tags', id: id, query: query do
+        get("tags/#{id}", query)
+      end
+    resp.assert_ok!
+  end
+
   # Accesses the Sync API to get a list of items that have changed since
   # the last sync.  Accepts a block that receives each changed item, and returns
   # the next sync token.
@@ -109,7 +136,7 @@ class WCC::Contentful::SimpleClient::Cdn < WCC::Contentful::SimpleClient
   private
 
   def sync_old(sync_token: nil, **query)
-    ActiveSupport::Deprecation.warn('Sync without a block is deprecated, please use new block syntax instead')
+    WCC::Contentful.deprecator.warn('Sync without a block is deprecated, please use new block syntax instead')
 
     sync_token =
       if sync_token

data/lib/wcc/contentful/simple_client/management.rb

@@ -66,6 +66,34 @@ class WCC::Contentful::SimpleClient::Management < WCC::Contentful::SimpleClient
     resp.assert_ok!
   end
 
+  def tags(query = {})
+    resp =
+      _instrument 'tags', query: query do
+        get("/spaces/#{space}/environments/#{environment}/tags", query)
+      end
+    resp.assert_ok!
+  end
+
+  def tag(key, query = {})
+    resp =
+      _instrument 'tags', tag: key, query: query do
+        get("/spaces/#{space}/environments/#{environment}/tags/#{key}", query)
+      end
+    resp.assert_ok!
+  end
+
+  def tag_create(tag_definition)
+    unless tag_id = tag_definition.dig('sys', 'id')
+      raise ArgumentError, "Missing tag ID in #{tag_definition}"
+    end
+
+    resp =
+      _instrument 'tag_create' do
+        put("/spaces/#{space}/environments/#{environment}/tags/#{tag_id}", tag_definition)
+      end
+    resp.assert_ok!
+  end
+
   # {
   #   "name": "My webhook",
   #   "url": "https://www.example.com/test",
@@ -109,16 +137,29 @@ class WCC::Contentful::SimpleClient::Management < WCC::Contentful::SimpleClient
       resp)
   end
 
+  def put(path, body)
+    url = URI.join(@api_url, path)
+
+    resp =
+      _instrument 'put_http', url: url do
+        post_http(url, body, {}, :put)
+      end
+
+    Response.new(self,
+      { url: url, body: body },
+      resp)
+  end
+
   private
 
-  def post_http(url, body, headers = {})
+  def post_http(url, body, headers = {}, method = :post)
     headers = {
       Authorization: "Bearer #{@access_token}",
       'Content-Type' => 'application/vnd.contentful.management.v1+json'
     }.merge(headers || {})
 
     body = body.to_json unless body.is_a? String
-    resp = @post_adapter.post(url, body, headers)
+    resp = @post_adapter.public_send(method, url, body, headers)
 
     if [301, 302, 307].include?(resp.status) && !@options[:no_follow_redirects]
       resp = get_http(resp.headers['location'], nil, headers)

data/lib/wcc/contentful/simple_client/typhoeus_adapter.rb

@@ -2,6 +2,7 @@
 
 gem 'typhoeus'
 require 'typhoeus'
+require 'ostruct'
 
 class WCC::Contentful::SimpleClient::TyphoeusAdapter
   def get(url, params = {}, headers = {})
@@ -28,6 +29,18 @@ class WCC::Contentful::SimpleClient::TyphoeusAdapter
     )
   end
 
+  def put(url, body, headers = {}, proxy = {})
+    raise NotImplementedError, 'Proxying Not Yet Implemented' if proxy[:host]
+
+    Response.new(
+      Typhoeus.put(
+        url,
+        body: body.to_json,
+        headers: headers
+      )
+    )
+  end
+
   class Response < SimpleDelegator
     delegate :to_s, to: :body
 

data/lib/wcc/contentful/simple_client.rb

@@ -26,7 +26,7 @@ module WCC::Contentful
   class SimpleClient
     include WCC::Contentful::Instrumentation
 
-    attr_reader :api_url, :space
+    attr_reader :api_url, :space, :environment
 
     # Creates a new SimpleClient with the given configuration.
     #
@@ -54,9 +54,10 @@ module WCC::Contentful
       # https://www.contentful.com/developers/docs/references/content-preview-api/#/introduction/api-rate-limits
       @rate_limit_wait_timeout = @options[:rate_limit_wait_timeout] || 1.5
 
-      return unless options[:environment].present?
+      @environment = options[:environment]
+      return unless @environment.present?
 
-      @api_url = URI.join(@api_url, 'environments/', "#{options[:environment]}/")
+      @api_url = URI.join(@api_url, 'environments/', "#{@environment}/")
     end
 
     # performs an HTTP GET request to the specified path within the configured

data/lib/wcc/contentful/store/rspec_examples/basic_store.rb

@@ -224,6 +224,94 @@ RSpec.shared_examples 'basic store' do
       found2 = subject.find('1qLdW7i7g4Ycq6i4Cckg44')
       expect(found2.dig('fields', 'slug', 'en-US')).to eq('redirect-with-slug-and-url')
     end
+
+    it 'stores metadata including tags', focus: true do
+      entry_with_tags = JSON.parse <<~JSON
+        {
+          "metadata": {
+            "tags": [
+              {
+                "sys": {
+                  "type": "Link",
+                  "linkType": "Tag",
+                  "id": "ministry_careers-in-motion"
+                }
+              }
+            ],
+            "concepts": []
+          },
+          "sys": {
+            "space": {
+              "sys": {
+                "type": "Link",
+                "linkType": "Space",
+                "id": "hw5pse7y1ojx"
+              }
+            },
+            "id": "1h5ce0SYZq8cELhESiJFkA",
+            "type": "Entry",
+            "createdAt": "2020-02-06T20:25:19.188Z",
+            "updatedAt": "2024-11-21T19:02:37.381Z",
+            "environment": {
+              "sys": {
+                "id": "dev",
+                "type": "Link",
+                "linkType": "Environment"
+              }
+            },
+            "publishedVersion": 73,
+            "revision": 7,
+            "contentType": {
+              "sys": {
+                "type": "Link",
+                "linkType": "ContentType",
+                "id": "page"
+              }
+            }
+          },
+          "fields": {
+            "title": {
+              "en-US": "Finances and Career Care"
+            },
+            "slug": {
+              "en-US": "/ministries/financialcareers"
+            },
+            "sections": {
+              "en-US": [
+                {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "Entry",
+                    "id": "4agnOGg0LQZrCbF4OeMEbj"
+                  }
+                },
+                {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "Entry",
+                    "id": "614GfdpLaD5gjc0U3sITXY"
+                  }
+                },
+                {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "Entry",
+                    "id": "xM5NWKiZSRUoUxXvoiYW4"
+                  }
+                }
+              ]
+            }
+          }
+        }
+      JSON
+
+      # act
+      subject.set('1h5ce0SYZq8cELhESiJFkA', entry_with_tags)
+      found = subject.find('1h5ce0SYZq8cELhESiJFkA')
+
+      # assert
+      expect(found.dig('metadata', 'tags', 0, 'sys', 'id')).to eq('ministry_careers-in-motion')
+    end
   end
 
   describe '#delete' do

data/lib/wcc/contentful/store/rspec_examples/include_param.rb

@@ -160,6 +160,119 @@ RSpec.shared_examples 'supports include param' do |feature_set|
         expect(link.dig('sys', 'type')).to eq('Entry')
         expect(link.dig('sys', 'id')).to eq('deep0')
       end
+
+      it 'preserves tags' do
+        entry_with_tags = JSON.parse <<~JSON
+          {
+            "metadata": {
+              "tags": [
+                {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "Tag",
+                    "id": "ministry_careers-in-motion"
+                  }
+                }
+              ],
+              "concepts": []
+            },
+            "sys": {
+              "space": {
+                "sys": {
+                  "type": "Link",
+                  "linkType": "Space",
+                  "id": "hw5pse7y1ojx"
+                }
+              },
+              "id": "1h5ce0SYZq8cELhESiJFkA",
+              "type": "Entry",
+              "createdAt": "2020-02-06T20:25:19.188Z",
+              "updatedAt": "2024-11-21T19:02:37.381Z",
+              "environment": {
+                "sys": {
+                  "id": "dev",
+                  "type": "Link",
+                  "linkType": "Environment"
+                }
+              },
+              "publishedVersion": 73,
+              "revision": 7,
+              "contentType": {
+                "sys": {
+                  "type": "Link",
+                  "linkType": "ContentType",
+                  "id": "page"
+                }
+              }
+            },
+            "fields": {
+              "title": {
+                "en-US": "Finances and Career Care"
+              },
+              "slug": {
+                "en-US": "/ministries/financialcareers"
+              },
+              "sections": {
+                "en-US": [
+                  {
+                    "sys": {
+                      "type": "Link",
+                      "linkType": "Entry",
+                      "id": "4agnOGg0LQZrCbF4OeMEbj"
+                    }
+                  }
+                ]
+              }
+            }
+          }
+        JSON
+        linked_entry = JSON.parse(<<~JSON)
+          {
+            "metadata": {
+              "tags": [
+                {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "Tag",
+                    "id": "ministry_something-else"
+                  }
+                }
+              ],
+              "concepts": []
+            },
+            "sys": {
+              "id": "4agnOGg0LQZrCbF4OeMEbj",
+              "type": "Entry",
+              "contentType": {
+                "sys": {
+                  "type": "Link",
+                  "linkType": "ContentType",
+                  "id": "page"
+                }
+              }
+            },
+            "fields": {
+              "name": {
+                "en-US": "Linked Entry"
+              }
+            }
+          }
+        JSON
+
+        subject.set('1h5ce0SYZq8cELhESiJFkA', entry_with_tags)
+        subject.set('4agnOGg0LQZrCbF4OeMEbj', linked_entry)
+
+        # act
+        found = subject.find_by(content_type: 'page', filter: { slug: '/ministries/financialcareers' }, options: {
+          include: 1
+        })
+
+        # assert
+        expect(found.dig('metadata', 'tags', 0, 'sys', 'id')).to eq('ministry_careers-in-motion')
+        linked = found.dig('fields', 'sections', 'en-US', 0)
+        expect(linked.dig('fields', 'name', 'en-US')).to eq('Linked Entry')
+        expect(linked.dig('metadata', 'tags', 0, 'sys', 'id')).to eq('ministry_something-else')
+      end
     end
 
     describe '#find_all' do

data/lib/wcc/contentful/test/double.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'ostruct'
+
 require_relative './attributes'
 
 module WCC::Contentful::Test::Double

data/lib/wcc/contentful/version.rb

@@ -2,6 +2,6 @@
 
 module WCC
   module Contentful
-    VERSION = '1.6.1'
+    VERSION = '1.7.0'
   end
 end

data/lib/wcc/contentful/webhook_enable_job.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module WCC::Contentful
+  if defined?(ActiveJob)
+    class WebhookEnableJob < ActiveJob::Base
+      self.queue_adapter = :async
+      queue_as :default
+
+      def perform(args = {})
+        args = default_configuration.merge!(args)
+
+        client = WCC::Contentful::SimpleClient::Management.new(
+          **args
+        )
+        enable_webhook(client, **args.slice(:receive_url, :webhook_username, :webhook_password))
+      end
+
+      def enable_webhook(client, receive_url:, webhook_username: nil, webhook_password: nil)
+        webhook = client.webhook_definitions.items.find { |w| w['url'] == receive_url }
+        logger.debug "existing webhook: #{webhook.inspect}" if webhook
+        return if webhook
+
+        body = {
+          'name' => 'WCC::Contentful webhook',
+          'url' => receive_url,
+          'topics' => [
+            '*.publish',
+            '*.unpublish'
+          ],
+          'filters' => webhook_filters
+        }
+        body['httpBasicUsername'] = webhook_username if webhook_username.present?
+        body['httpBasicPassword'] = webhook_password if webhook_password.present?
+
+        begin
+          resp = client.post_webhook_definition(body)
+          logger.info "Created webhook: #{resp.raw.dig('sys', 'id')}"
+        rescue WCC::Contentful::SimpleClient::ApiError => e
+          logger.error "#{e.response.code}: #{e.response.raw}" if e.response
+          raise
+        end
+      end
+
+      private
+
+      def default_configuration
+        return {} unless config = WCC::Contentful&.configuration
+
+        {
+          management_token: config.management_token,
+          space: config.space,
+          environment: config.environment,
+          connection: config.connection,
+          webhook_username: config.webhook_username,
+          webhook_password: config.webhook_password,
+
+          receive_url: URI.join(config.app_url, 'webhook/receive').to_s
+        }
+      end
+
+      def webhook_filters
+        filters = []
+
+        if (environment_id = WCC::Contentful.configuration&.environment).present?
+          filters << {
+            'equals' => [
+              { 'doc' => 'sys.environment.sys.id' },
+              environment_id
+            ]
+          }
+        end
+        filters
+      end
+    end
+  end
+end

data/lib/wcc/contentful.rb

@@ -24,6 +24,7 @@ require 'wcc/contentful/rich_text'
 require 'wcc/contentful/rich_text_renderer'
 require 'wcc/contentful/rich_text_renderer_factory'
 require 'wcc/contentful/sync_engine'
+require 'wcc/contentful/webhook_enable_job'
 require 'wcc/contentful/events'
 require 'wcc/contentful/middleware'
 
@@ -39,7 +40,7 @@ module WCC::Contentful
     attr_reader :configuration
 
     def types
-      ActiveSupport::Deprecation.warn('Use WCC::Contentful::Model.schema instead')
+      WCC::Contentful.deprecator.warn('Use WCC::Contentful::Model.schema instead')
       WCC::Contentful::Model.schema
     end
 
@@ -49,9 +50,20 @@ module WCC::Contentful
     end
 
     def logger
-      ActiveSupport::Deprecation.warn('Use WCC::Contentful::Services.instance.logger instead')
+      WCC::Contentful.deprecator.warn('Use WCC::Contentful::Services.instance.logger instead')
       WCC::Contentful::Services.instance.logger
     end
+
+    def deprecator
+      @deprecator ||=
+        begin
+          next_major_version = WCC::Contentful::VERSION.split('.').first.next
+          ActiveSupport::Deprecation.new(
+            "#{next_major_version}.0",
+            'wcc-contentful'
+          )
+        end
+    end
   end
 
   # Configures the WCC::Contentful gem to talk to a Contentful space.

data/wcc-contentful.gemspec

@@ -30,7 +30,6 @@ Gem::Specification.new do |spec|
 
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'byebug', '~> 11.0.1'
   spec.add_development_dependency 'coveralls'
   spec.add_development_dependency 'dotenv', '~> 2.2'
   spec.add_development_dependency 'erb_lint', '~> 0.0.26'

metadata

@@ -1,29 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: wcc-contentful
 version: !ruby/object:Gem::Version
-  version: 1.6.1
+  version: 1.7.0
 platform: ruby
 authors:
 - Watermark Dev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-11-27 00:00:00.000000000 Z
+date: 2024-11-25 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: byebug
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 11.0.1
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 11.0.1
 - !ruby/object:Gem::Dependency
   name: coveralls
   requirement: !ruby/object:Gem::Requirement
@@ -419,7 +405,6 @@ files:
 - Rakefile
 - app/controllers/wcc/contentful/application_controller.rb
 - app/controllers/wcc/contentful/webhook_controller.rb
-- app/jobs/wcc/contentful/webhook_enable_job.rb
 - config/initializers/mime_types.rb
 - config/routes.rb
 - lib/tasks/download_schema.rake
@@ -440,6 +425,7 @@ files:
 - lib/wcc/contentful/instrumentation.rb
 - lib/wcc/contentful/link.rb
 - lib/wcc/contentful/link_visitor.rb
+- lib/wcc/contentful/metadata.rb
 - lib/wcc/contentful/middleware.rb
 - lib/wcc/contentful/middleware/store.rb
 - lib/wcc/contentful/middleware/store/caching_middleware.rb
@@ -494,12 +480,13 @@ files:
 - lib/wcc/contentful/test/double.rb
 - lib/wcc/contentful/test/factory.rb
 - lib/wcc/contentful/version.rb
+- lib/wcc/contentful/webhook_enable_job.rb
 - wcc-contentful.gemspec
 homepage: https://github.com/watermarkchurch/wcc-contentful/wcc-contentful
 licenses:
 - MIT
 metadata:
-  documentation_uri: https://watermarkchurch.github.io/wcc-contentful/1.6/wcc-contentful
+  documentation_uri: https://watermarkchurch.github.io/wcc-contentful/1.7/wcc-contentful
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
@@ -516,7 +503,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.16
 signing_key:
 specification_version: 4
 summary: '[![Gem Version](https://badge.fury.io/rb/wcc-contentful.svg)](https://rubygems.org/gems/wcc-contentful)

data/app/jobs/wcc/contentful/webhook_enable_job.rb

@@ -1,76 +0,0 @@
-# frozen_string_literal: true
-
-require 'active_job'
-
-module WCC::Contentful
-  class WebhookEnableJob < ActiveJob::Base
-    self.queue_adapter = :async
-    queue_as :default
-
-    def perform(args = {})
-      args = default_configuration.merge!(args)
-
-      client = WCC::Contentful::SimpleClient::Management.new(
-        **args
-      )
-      enable_webhook(client, **args.slice(:receive_url, :webhook_username, :webhook_password))
-    end
-
-    def enable_webhook(client, receive_url:, webhook_username: nil, webhook_password: nil)
-      webhook = client.webhook_definitions.items.find { |w| w['url'] == receive_url }
-      logger.debug "existing webhook: #{webhook.inspect}" if webhook
-      return if webhook
-
-      body = {
-        'name' => 'WCC::Contentful webhook',
-        'url' => receive_url,
-        'topics' => [
-          '*.publish',
-          '*.unpublish'
-        ],
-        'filters' => webhook_filters
-      }
-      body['httpBasicUsername'] = webhook_username if webhook_username.present?
-      body['httpBasicPassword'] = webhook_password if webhook_password.present?
-
-      begin
-        resp = client.post_webhook_definition(body)
-        logger.info "Created webhook: #{resp.raw.dig('sys', 'id')}"
-      rescue WCC::Contentful::SimpleClient::ApiError => e
-        logger.error "#{e.response.code}: #{e.response.raw}" if e.response
-        raise
-      end
-    end
-
-    private
-
-    def default_configuration
-      return {} unless config = WCC::Contentful&.configuration
-
-      {
-        management_token: config.management_token,
-        space: config.space,
-        environment: config.environment,
-        connection: config.connection,
-        webhook_username: config.webhook_username,
-        webhook_password: config.webhook_password,
-
-        receive_url: URI.join(config.app_url, 'webhook/receive').to_s
-      }
-    end
-
-    def webhook_filters
-      filters = []
-
-      if (environment_id = WCC::Contentful.configuration&.environment).present?
-        filters << {
-          'equals' => [
-            { 'doc' => 'sys.environment.sys.id' },
-            environment_id
-          ]
-        }
-      end
-      filters
-    end
-  end
-end