pangea-cloudflare 0.1.0

data/lib/pangea/resources/cloudflare_pages_project/resource/deployment_config.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+# Copyright 2025 The Pangea Authors. Licensed under Apache 2.0.
+
+module Pangea
+  module Resources
+    module CloudflarePagesProject
+      private
+
+      def synthesize_deployment_config(context, config)
+        context.instance_eval do
+          compatibility_date config.compatibility_date if config.compatibility_date
+          compatibility_flags config.compatibility_flags if config.compatibility_flags
+          build_image_major_version config.build_image_major_version if config.build_image_major_version
+          always_use_latest_compatibility_date config.always_use_latest_compatibility_date if config.always_use_latest_compatibility_date
+          fail_open config.fail_open if config.fail_open
+          usage_model config.usage_model if config.usage_model
+
+          config.env_vars&.each do |var_name, var_config|
+            env_vars { name var_name; value var_config.value; type var_config.type }
+          end
+
+          config.kv_namespaces&.each do |binding_name, binding_config|
+            kv_namespaces { name binding_name; namespace_id binding_config[:namespace_id] || binding_config['namespace_id'] }
+          end
+
+          config.d1_databases&.each do |binding_name, binding_config|
+            d1_databases { name binding_name; id binding_config[:id] || binding_config['id'] }
+          end
+
+          config.durable_object_namespaces&.each do |binding_name, binding_config|
+            durable_object_namespaces { name binding_name; namespace_id binding_config[:namespace_id] || binding_config['namespace_id'] }
+          end
+
+          config.r2_buckets&.each do |binding_name, binding_config|
+            r2_buckets { name binding_name; bucket_name binding_config.bucket_name; jurisdiction binding_config.jurisdiction if binding_config.jurisdiction }
+          end
+
+          config.services&.each do |binding_name, binding_config|
+            services { name binding_name; service binding_config.service; environment binding_config.environment if binding_config.environment; entrypoint binding_config.entrypoint if binding_config.entrypoint }
+          end
+
+          config.analytics_engine_datasets&.each do |binding_name, binding_config|
+            analytics_engine_datasets { name binding_name; dataset binding_config[:dataset] || binding_config['dataset'] }
+          end
+
+          config.queue_producers&.each do |binding_name, binding_config|
+            queue_producers { name binding_name; binding_name binding_config[:name] || binding_config['name'] || binding_name }
+          end
+
+          config.hyperdrive_bindings&.each do |binding_name, binding_config|
+            hyperdrive_bindings { name binding_name; id binding_config[:id] || binding_config['id'] }
+          end
+
+          config.vectorize_bindings&.each do |binding_name, binding_config|
+            vectorize_bindings { name binding_name; index_name binding_config[:index_name] || binding_config['index_name'] }
+          end
+
+          config.ai_bindings&.each do |binding_name, binding_config|
+            ai_bindings { name binding_name; project_id binding_config[:project_id] || binding_config['project_id'] if binding_config[:project_id] || binding_config['project_id'] }
+          end
+
+          config.browsers&.each { |binding_name, _| browsers { name binding_name } }
+
+          config.mtls_certificates&.each do |binding_name, binding_config|
+            mtls_certificates { name binding_name; certificate_id binding_config[:certificate_id] || binding_config['certificate_id'] }
+          end
+
+          if config.limits
+            limits { cpu_ms config.limits.cpu_ms if config.limits.cpu_ms }
+          end
+
+          if config.placement
+            placement { mode config.placement.mode }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pangea/resources/cloudflare_pages_project/resource/main.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# Copyright 2025 The Pangea Authors. Licensed under Apache 2.0.
+
+require 'pangea/resources/base'
+require 'pangea/resources/reference'
+require 'pangea/resources/cloudflare_pages_project/types'
+
+module Pangea
+  module Resources
+    module CloudflarePagesProject
+      # Create a Cloudflare Pages Project
+      def cloudflare_pages_project(name, attributes = {})
+        project_attrs = Cloudflare::Types::PagesProjectAttributes.new(attributes)
+
+        resource(:cloudflare_pages_project, name) do
+          account_id project_attrs.account_id
+          name project_attrs.name
+          production_branch project_attrs.production_branch if project_attrs.production_branch
+
+          if project_attrs.build_config
+            build_config do
+              build_command project_attrs.build_config.build_command if project_attrs.build_config.build_command
+              destination_dir project_attrs.build_config.destination_dir if project_attrs.build_config.destination_dir
+              root_dir project_attrs.build_config.root_dir if project_attrs.build_config.root_dir
+              build_caching project_attrs.build_config.build_caching if project_attrs.build_config.build_caching
+              web_analytics_tag project_attrs.build_config.web_analytics_tag if project_attrs.build_config.web_analytics_tag
+              web_analytics_token project_attrs.build_config.web_analytics_token if project_attrs.build_config.web_analytics_token
+            end
+          end
+
+          if project_attrs.source
+            source do
+              type project_attrs.source.type
+              config do
+                owner project_attrs.source.config.owner
+                repo_name project_attrs.source.config.repo_name
+                production_branch project_attrs.source.config.production_branch if project_attrs.source.config.production_branch
+                production_deployments_enabled project_attrs.source.config.production_deployments_enabled if project_attrs.source.config.production_deployments_enabled
+                deployments_enabled project_attrs.source.config.deployments_enabled if project_attrs.source.config.deployments_enabled
+                pr_comments_enabled project_attrs.source.config.pr_comments_enabled if project_attrs.source.config.pr_comments_enabled
+                preview_deployment_setting project_attrs.source.config.preview_deployment_setting if project_attrs.source.config.preview_deployment_setting
+                preview_branch_includes project_attrs.source.config.preview_branch_includes if project_attrs.source.config.preview_branch_includes
+                preview_branch_excludes project_attrs.source.config.preview_branch_excludes if project_attrs.source.config.preview_branch_excludes
+              end
+            end
+          end
+
+          if project_attrs.deployment_configs
+            deployment_configs do
+              if project_attrs.deployment_configs.production
+                production { synthesize_deployment_config(self, project_attrs.deployment_configs.production) }
+              end
+              if project_attrs.deployment_configs.preview
+                preview { synthesize_deployment_config(self, project_attrs.deployment_configs.preview) }
+              end
+            end
+          end
+        end
+
+        ResourceReference.new(
+          type: 'cloudflare_pages_project',
+          name: name,
+          resource_attributes: project_attrs.to_h,
+          outputs: {
+            id: "${cloudflare_pages_project.#{name}.id}",
+            subdomain: "${cloudflare_pages_project.#{name}.subdomain}",
+            domains: "${cloudflare_pages_project.#{name}.domains}",
+            created_on: "${cloudflare_pages_project.#{name}.created_on}"
+          }
+        )
+      end
+    end
+  end
+end

data/lib/pangea/resources/cloudflare_pages_project/resource.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Copyright 2025 The Pangea Authors. Licensed under Apache 2.0.
+
+require 'pangea/resource_registry'
+require_relative 'resource/main'
+require_relative 'resource/deployment_config'
+
+module Pangea
+  module Resources
+    # Maintain backward compatibility by extending Cloudflare module
+    module Cloudflare
+      include CloudflarePagesProject
+    end
+  end
+end
+
+# Auto-register this module when it's loaded
+Pangea::ResourceRegistry.register_module(Pangea::Resources::Cloudflare)

data/lib/pangea/resources/cloudflare_pages_project/types/attributes.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+# Copyright 2025 The Pangea Authors. Licensed under Apache 2.0.
+
+require_relative 'build_config'
+require_relative 'deployment_config'
+
+module Pangea
+  module Resources
+    module Cloudflare
+      module Types
+        # Type-safe attributes for Cloudflare Pages Project
+        class PagesProjectAttributes < Dry::Struct
+          transform_keys(&:to_sym)
+
+          attribute :account_id, ::Pangea::Resources::Types::CloudflareAccountId
+          attribute :name, Dry::Types['strict.string'].constrained(min_size: 1)
+          attribute :production_branch, Dry::Types['strict.string'].optional.default(nil)
+          attribute :build_config, PagesBuildConfig.optional.default(nil)
+          attribute :source, PagesSource.optional.default(nil)
+          attribute :deployment_configs, PagesDeploymentConfigs.optional.default(nil)
+
+          # Check if project has source configured
+          def has_source?
+            !source.nil?
+          end
+
+          # Check if project has build configuration
+          def has_build_config?
+            !build_config.nil?
+          end
+
+          # Check if project has deployment configs
+          def has_deployment_configs?
+            !deployment_configs.nil?
+          end
+
+          # Check if GitHub source
+          def github_source?
+            source&.type == 'github'
+          end
+
+          # Check if GitLab source
+          def gitlab_source?
+            source&.type == 'gitlab'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pangea/resources/cloudflare_pages_project/types/bindings.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+# Copyright 2025 The Pangea Authors. Licensed under Apache 2.0.
+
+module Pangea
+  module Resources
+    module Cloudflare
+      module Types
+        # Service binding for Pages deployment
+        class PagesServiceBinding < Dry::Struct
+          transform_keys(&:to_sym)
+
+          attribute :name, Dry::Types['strict.string']
+          attribute :service, Dry::Types['strict.string']
+          attribute :environment, Dry::Types['strict.string'].optional.default(nil)
+          attribute :entrypoint, Dry::Types['strict.string'].optional.default(nil)
+        end
+
+        # R2 bucket binding
+        class PagesR2Binding < Dry::Struct
+          transform_keys(&:to_sym)
+
+          attribute :name, Dry::Types['strict.string']
+          attribute :bucket_name, Dry::Types['strict.string']
+          attribute :jurisdiction, Dry::Types['strict.string'].optional.default(nil)
+        end
+
+        # Environment variable configuration
+        class PagesEnvVar < Dry::Struct
+          transform_keys(&:to_sym)
+
+          attribute :type, Dry::Types['strict.string'].enum('plain_text', 'secret_text')
+          attribute :value, Dry::Types['strict.string']
+        end
+      end
+    end
+  end
+end

data/lib/pangea/resources/cloudflare_pages_project/types/build_config.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+# Copyright 2025 The Pangea Authors. Licensed under Apache 2.0.
+
+module Pangea
+  module Resources
+    module Cloudflare
+      module Types
+        # Build configuration for Pages project
+        class PagesBuildConfig < Dry::Struct
+          transform_keys(&:to_sym)
+
+          attribute :build_command, Dry::Types['strict.string'].optional.default(nil)
+          attribute :destination_dir, Dry::Types['strict.string'].optional.default(nil)
+          attribute :root_dir, Dry::Types['strict.string'].optional.default(nil)
+          attribute :build_caching, Dry::Types['strict.bool'].optional.default(nil)
+          attribute :web_analytics_tag, Dry::Types['strict.string'].optional.default(nil)
+          attribute :web_analytics_token, Dry::Types['strict.string'].optional.default(nil)
+        end
+
+        # Source repository configuration
+        class PagesSourceConfig < Dry::Struct
+          transform_keys(&:to_sym)
+
+          attribute :owner, Dry::Types['strict.string']
+          attribute :repo_name, Dry::Types['strict.string']
+          attribute :production_branch, Dry::Types['strict.string'].optional.default(nil)
+          attribute :production_deployments_enabled, Dry::Types['strict.bool'].optional.default(nil)
+          attribute :deployments_enabled, Dry::Types['strict.bool'].optional.default(nil)
+          attribute :pr_comments_enabled, Dry::Types['strict.bool'].optional.default(nil)
+          attribute :preview_deployment_setting, Dry::Types['strict.string']
+            .enum('none', 'all', 'custom')
+            .optional
+            .default(nil)
+          attribute :preview_branch_includes, Dry::Types['strict.array']
+            .of(Dry::Types['strict.string'])
+            .optional
+            .default(nil)
+          attribute :preview_branch_excludes, Dry::Types['strict.array']
+            .of(Dry::Types['strict.string'])
+            .optional
+            .default(nil)
+        end
+
+        # Source repository definition
+        class PagesSource < Dry::Struct
+          transform_keys(&:to_sym)
+
+          attribute :type, Dry::Types['strict.string'].enum('github', 'gitlab')
+          attribute :config, PagesSourceConfig
+        end
+      end
+    end
+  end
+end

data/lib/pangea/resources/cloudflare_pages_project/types/deployment_config.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+# Copyright 2025 The Pangea Authors. Licensed under Apache 2.0.
+
+require_relative 'bindings'
+
+module Pangea
+  module Resources
+    module Cloudflare
+      module Types
+        # Resource limits for deployment
+        class PagesDeploymentLimits < Dry::Struct
+          transform_keys(&:to_sym)
+
+          attribute :cpu_ms, Dry::Types['coercible.integer'].constrained(gteq: 1).optional.default(nil)
+        end
+
+        # Placement configuration
+        class PagesDeploymentPlacement < Dry::Struct
+          transform_keys(&:to_sym)
+
+          attribute :mode, Dry::Types['strict.string'].enum('smart')
+        end
+
+        # Deployment configuration (for preview or production)
+        class PagesDeploymentConfig < Dry::Struct
+          transform_keys(&:to_sym)
+
+          attribute :compatibility_date, Dry::Types['strict.string']
+            .constrained(format: /\A\d{4}-\d{2}-\d{2}\z/)
+            .optional
+            .default(nil)
+          attribute :compatibility_flags, Dry::Types['strict.array']
+            .of(Dry::Types['strict.string'])
+            .optional
+            .default(nil)
+          attribute :build_image_major_version, Dry::Types['coercible.integer']
+            .constrained(gteq: 1)
+            .optional
+            .default(nil)
+          attribute :always_use_latest_compatibility_date, Dry::Types['strict.bool'].optional.default(nil)
+          attribute :fail_open, Dry::Types['strict.bool'].optional.default(nil)
+          attribute :usage_model, Dry::Types['strict.string']
+            .enum('standard', 'bundled', 'unbound')
+            .optional
+            .default(nil)
+          attribute :env_vars, Dry::Types['strict.hash']
+            .map(Dry::Types['strict.string'], PagesEnvVar)
+            .optional
+            .default(nil)
+          attribute :kv_namespaces, Dry::Types['strict.hash'].optional.default(nil)
+          attribute :d1_databases, Dry::Types['strict.hash'].optional.default(nil)
+          attribute :durable_object_namespaces, Dry::Types['strict.hash'].optional.default(nil)
+          attribute :r2_buckets, Dry::Types['strict.hash']
+            .map(Dry::Types['strict.string'], PagesR2Binding)
+            .optional
+            .default(nil)
+          attribute :services, Dry::Types['strict.hash']
+            .map(Dry::Types['strict.string'], PagesServiceBinding)
+            .optional
+            .default(nil)
+          attribute :analytics_engine_datasets, Dry::Types['strict.hash'].optional.default(nil)
+          attribute :queue_producers, Dry::Types['strict.hash'].optional.default(nil)
+          attribute :hyperdrive_bindings, Dry::Types['strict.hash'].optional.default(nil)
+          attribute :vectorize_bindings, Dry::Types['strict.hash'].optional.default(nil)
+          attribute :ai_bindings, Dry::Types['strict.hash'].optional.default(nil)
+          attribute :browsers, Dry::Types['strict.hash'].optional.default(nil)
+          attribute :mtls_certificates, Dry::Types['strict.hash'].optional.default(nil)
+          attribute :limits, PagesDeploymentLimits.optional.default(nil)
+          attribute :placement, PagesDeploymentPlacement.optional.default(nil)
+        end
+
+        # Deployment configurations container
+        class PagesDeploymentConfigs < Dry::Struct
+          transform_keys(&:to_sym)
+
+          attribute :production, PagesDeploymentConfig.optional.default(nil)
+          attribute :preview, PagesDeploymentConfig.optional.default(nil)
+        end
+      end
+    end
+  end
+end

data/lib/pangea/resources/cloudflare_pages_project/types.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# Copyright 2025 The Pangea Authors. Licensed under Apache 2.0.
+
+require 'dry-struct'
+require 'pangea/resources/types'
+require_relative 'types/attributes'
+
+module Pangea
+  module Resources
+    module Cloudflare
+      module Types
+        # PagesBuildConfig is defined in types/build_config.rb
+        # PagesSourceConfig is defined in types/build_config.rb
+        # PagesSource is defined in types/build_config.rb
+        # PagesServiceBinding is defined in types/bindings.rb
+        # PagesR2Binding is defined in types/bindings.rb
+        # PagesEnvVar is defined in types/bindings.rb
+        # PagesDeploymentLimits is defined in types/deployment_config.rb
+        # PagesDeploymentPlacement is defined in types/deployment_config.rb
+        # PagesDeploymentConfig is defined in types/deployment_config.rb
+        # PagesDeploymentConfigs is defined in types/deployment_config.rb
+        # PagesProjectAttributes is defined in types/attributes.rb
+      end
+    end
+  end
+end

data/lib/pangea/resources/cloudflare_queue/resource.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+# Copyright 2025 The Pangea Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+require 'pangea/resources/base'
+require 'pangea/resources/reference'
+require 'pangea/resources/cloudflare_queue/types'
+require 'pangea/resource_registry'
+
+module Pangea
+  module Resources
+    # Cloudflare Queue resource module that self-registers
+    module CloudflareQueue
+      # Create a Cloudflare Queue
+      #
+      # Queues provide message queuing for asynchronous task processing.
+      # Messages are delivered to Workers with configurable retry and
+      # concurrency settings.
+      #
+      # @param name [Symbol] The resource name
+      # @param attributes [Hash] Queue attributes
+      # @option attributes [String] :account_id Cloudflare account ID (required)
+      # @option attributes [String] :queue_name Queue name (required)
+      # @option attributes [Integer] :max_concurrency Maximum concurrent consumers (1-100)
+      # @option attributes [Integer] :max_retries Maximum retry attempts (0-100)
+      # @option attributes [Integer] :max_wait_time_ms Maximum wait time before retry in ms
+      # @option attributes [Integer] :retry_delay Delay between retries in seconds
+      # @option attributes [Integer] :visibility_timeout_ms Message visibility timeout in ms
+      # @option attributes [Integer] :message_retention_period Retention period in seconds (60-1209600)
+      #
+      # @return [ResourceReference] Reference object with outputs
+      #
+      # @example Create a basic task queue
+      #   cloudflare_queue(:tasks, {
+      #     account_id: "a" * 32,
+      #     queue_name: "background-tasks"
+      #   })
+      #
+      # @example Create queue with concurrency and retry settings
+      #   cloudflare_queue(:email_queue, {
+      #     account_id: "a" * 32,
+      #     queue_name: "email-delivery",
+      #     max_concurrency: 20,
+      #     max_retries: 5,
+      #     retry_delay: 60,
+      #     message_retention_period: 86400  # 1 day
+      #   })
+      #
+      # @example Create high-throughput queue
+      #   cloudflare_queue(:analytics, {
+      #     account_id: "a" * 32,
+      #     queue_name: "analytics-events",
+      #     max_concurrency: 100,
+      #     max_retries: 3,
+      #     visibility_timeout_ms: 30000,
+      #     message_retention_period: 604800  # 7 days
+      #   })
+      def cloudflare_queue(name, attributes = {})
+        # Validate attributes using dry-struct
+        queue_attrs = Cloudflare::Types::QueueAttributes.new(attributes)
+
+        # Generate terraform resource block via terraform-synthesizer
+        resource(:cloudflare_queue, name) do
+          account_id queue_attrs.account_id
+          name queue_attrs.queue_name
+          max_concurrency queue_attrs.max_concurrency if queue_attrs.max_concurrency
+          max_retries queue_attrs.max_retries if queue_attrs.max_retries
+          max_wait_time_ms queue_attrs.max_wait_time_ms if queue_attrs.max_wait_time_ms
+          retry_delay queue_attrs.retry_delay if queue_attrs.retry_delay
+          visibility_timeout_ms queue_attrs.visibility_timeout_ms if queue_attrs.visibility_timeout_ms
+          message_retention_period queue_attrs.message_retention_period if queue_attrs.message_retention_period
+        end
+
+        # Return resource reference with available outputs
+        ResourceReference.new(
+          type: 'cloudflare_queue',
+          name: name,
+          resource_attributes: queue_attrs.to_h,
+          outputs: {
+            id: "${cloudflare_queue.#{name}.id}",
+            queue_id: "${cloudflare_queue.#{name}.id}",
+            queue_name: "${cloudflare_queue.#{name}.name}"
+          }
+        )
+      end
+    end
+
+    # Maintain backward compatibility by extending Cloudflare module
+    module Cloudflare
+      include CloudflareQueue
+    end
+  end
+end
+
+# Auto-register this module when it's loaded
+Pangea::ResourceRegistry.register_module(Pangea::Resources::Cloudflare)

data/lib/pangea/resources/cloudflare_queue/types.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+# Copyright 2025 The Pangea Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+require 'dry-struct'
+require 'pangea/resources/types'
+
+module Pangea
+  module Resources
+    module Cloudflare
+      module Types
+        # Type-safe attributes for Cloudflare Queue
+        #
+        # Queues provide message queuing for asynchronous processing.
+        # Messages are delivered to Workers with configurable retry and
+        # concurrency settings.
+        #
+        # @example Create a task queue
+        #   QueueAttributes.new(
+        #     account_id: "a" * 32,
+        #     queue_name: "email-tasks",
+        #     max_concurrency: 10,
+        #     max_retries: 3
+        #   )
+        class QueueAttributes < Dry::Struct
+          transform_keys(&:to_sym)
+
+          # @!attribute account_id
+          #   @return [String] The Cloudflare account ID
+          attribute :account_id, ::Pangea::Resources::Types::CloudflareAccountId
+
+          # @!attribute queue_name
+          #   @return [String] Queue name (unique identifier)
+          attribute :queue_name, Dry::Types['strict.string'].constrained(
+            min_size: 1,
+            max_size: 256
+          )
+
+          # @!attribute max_concurrency
+          #   @return [Integer, nil] Maximum concurrent consumers (1-100)
+          attribute :max_concurrency, Dry::Types['coercible.integer']
+            .constrained(gteq: 1, lteq: 100)
+            .optional
+            .default(nil)
+
+          # @!attribute max_retries
+          #   @return [Integer, nil] Maximum retry attempts (0-100)
+          attribute :max_retries, Dry::Types['coercible.integer']
+            .constrained(gteq: 0, lteq: 100)
+            .optional
+            .default(nil)
+
+          # @!attribute max_wait_time_ms
+          #   @return [Integer, nil] Maximum wait time before retry in milliseconds
+          attribute :max_wait_time_ms, Dry::Types['coercible.integer']
+            .constrained(gteq: 0)
+            .optional
+            .default(nil)
+
+          # @!attribute retry_delay
+          #   @return [Integer, nil] Delay between retries in seconds
+          attribute :retry_delay, Dry::Types['coercible.integer']
+            .constrained(gteq: 0)
+            .optional
+            .default(nil)
+
+          # @!attribute visibility_timeout_ms
+          #   @return [Integer, nil] Message visibility timeout in milliseconds
+          attribute :visibility_timeout_ms, Dry::Types['coercible.integer']
+            .constrained(gteq: 0)
+            .optional
+            .default(nil)
+
+          # @!attribute message_retention_period
+          #   @return [Integer, nil] Message retention period in seconds (60-1209600)
+          attribute :message_retention_period, Dry::Types['coercible.integer']
+            .constrained(gteq: 60, lteq: 1209600)  # 1 min to 14 days
+            .optional
+            .default(nil)
+
+          # Check if queue has high concurrency configured
+          # @return [Boolean] true if max_concurrency >= 10
+          def high_concurrency?
+            max_concurrency && max_concurrency >= 10
+          end
+
+          # Check if queue has retry configured
+          # @return [Boolean] true if max_retries > 0
+          def retries_enabled?
+            max_retries && max_retries > 0
+          end
+
+          # Get retention period in days
+          # @return [Float, nil] Retention period in days
+          def retention_days
+            return nil unless message_retention_period
+            message_retention_period / 86400.0
+          end
+
+          # Extract environment from queue name if present
+          # @return [String, nil] Environment name if detected
+          def environment
+            case queue_name.downcase
+            when /production|prod/
+              'production'
+            when /staging|stage/
+              'staging'
+            when /development|dev/
+              'development'
+            when /test/
+              'test'
+            else
+              nil
+            end
+          end
+        end
+      end
+    end
+  end
+end