pangea-aws 0.1.0

data/lib/pangea/resources/aws_rds_cluster_endpoint/types/members.rb

@@ -0,0 +1,36 @@
+# 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/types'
+
+module Pangea
+  module Resources
+    module AWS
+      module Types
+        # Excluded cluster member configuration for Aurora endpoints
+        class ExcludedMember < Pangea::Resources::BaseAttributes
+          # The DB instance identifier for the cluster member to exclude
+          attribute? :db_instance_identifier, Resources::Types::String.optional
+        end
+
+        # Static cluster member configuration for Aurora endpoints
+        class StaticMember < Pangea::Resources::BaseAttributes
+          # The DB instance identifier for the static cluster member
+          attribute? :db_instance_identifier, Resources::Types::String.optional
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,165 @@
+# 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/types'
+require_relative 'types/members'
+require_relative 'types/configs'
+
+module Pangea
+  module Resources
+    module AWS
+      module Types
+        # Type-safe attributes for AWS RDS Cluster Endpoint resources
+        class RdsClusterEndpointAttributes < Pangea::Resources::BaseAttributes
+          # Cluster identifier that the endpoint will belong to
+          attribute? :cluster_identifier, Resources::Types::String.optional
+
+          # Cluster endpoint identifier (unique within the cluster)
+          attribute? :cluster_endpoint_identifier, Resources::Types::String.optional
+
+          # Custom endpoint type (READER, WRITER, ANY)
+          attribute? :custom_endpoint_type, Resources::Types::String.constrained(included_in: ["READER", "WRITER", "ANY"]).optional
+
+          # List of static cluster members to include in the endpoint
+          # These members will always be included regardless of their role
+          attribute :static_members, Resources::Types::Array.of(StaticMember).default([].freeze)
+
+          # List of cluster members to exclude from the endpoint
+          # These members will never be included in load balancing
+          attribute :excluded_members, Resources::Types::Array.of(ExcludedMember).default([].freeze)
+
+          # Tags to apply to the cluster endpoint
+          attribute :tags, Resources::Types::AwsTags.default({}.freeze)
+
+          # Custom validation
+          def self.new(attributes = {})
+            attrs = super(attributes)
+
+            # Cannot have the same DB instance in both static_members and excluded_members
+            static_db_ids = attrs.static_members.map(&:db_instance_identifier).to_set
+            excluded_db_ids = attrs.excluded_members.map(&:db_instance_identifier).to_set
+
+            overlap = static_db_ids & excluded_db_ids
+            if overlap.any?
+              raise Dry::Struct::Error, "DB instances cannot be in both static_members and excluded_members: #{overlap.to_a.join(', ')}"
+            end
+
+            validate_endpoint_identifier(attrs.cluster_endpoint_identifier)
+            validate_writer_restrictions(attrs)
+
+            attrs
+          end
+
+          # Validate endpoint identifier format and length
+          def self.validate_endpoint_identifier(identifier)
+            unless identifier =~ /^[a-zA-Z][a-zA-Z0-9-]*$/
+              raise Dry::Struct::Error, "cluster_endpoint_identifier must start with a letter and contain only letters, numbers, and hyphens"
+            end
+
+            if identifier.length > 63
+              raise Dry::Struct::Error, "cluster_endpoint_identifier cannot exceed 63 characters"
+            end
+          end
+
+          # Validate WRITER endpoint restrictions
+          def self.validate_writer_restrictions(attrs)
+            return unless attrs.custom_endpoint_type == "WRITER"
+
+            if attrs.static_members.any?
+              raise Dry::Struct::Error, "WRITER endpoints cannot have static members"
+            end
+
+            if attrs.excluded_members.any?
+              raise Dry::Struct::Error, "WRITER endpoints cannot have excluded members"
+            end
+          end
+
+          # Check if this is a reader endpoint
+          def is_reader?
+            custom_endpoint_type == "READER"
+          end
+
+          # Check if this is a writer endpoint
+          def is_writer?
+            custom_endpoint_type == "WRITER"
+          end
+
+          # Check if this is an any endpoint
+          def is_any?
+            custom_endpoint_type == "ANY"
+          end
+
+          # Check if endpoint has static member configuration
+          def has_static_members?
+            static_members.any?
+          end
+
+          # Check if endpoint has excluded member configuration
+          def has_excluded_members?
+            excluded_members.any?
+          end
+
+          # Get list of static member DB instance identifiers
+          def static_member_db_ids
+            static_members.map(&:db_instance_identifier)
+          end
+
+          # Get list of excluded member DB instance identifiers
+          def excluded_member_db_ids
+            excluded_members.map(&:db_instance_identifier)
+          end
+
+          # Check if endpoint uses custom member configuration
+          def uses_custom_member_config?
+            has_static_members? || has_excluded_members?
+          end
+
+          # Get endpoint configuration summary
+          def configuration_summary
+            config = ["Type: #{custom_endpoint_type}"]
+
+            config << "Static members: #{static_member_db_ids.join(', ')}" if has_static_members?
+            config << "Excluded members: #{excluded_member_db_ids.join(', ')}" if has_excluded_members?
+            config << "Uses cluster default member selection" unless uses_custom_member_config?
+
+            config.join("; ")
+          end
+
+          # Validate that referenced DB instance exists in the cluster
+          def validate_db_instances(cluster_instances)
+            all_referenced_ids = static_member_db_ids + excluded_member_db_ids
+            cluster_db_ids = cluster_instances.map { |instance| instance.fetch(:db_instance_identifier) }
+
+            invalid_ids = all_referenced_ids - cluster_db_ids
+            if invalid_ids.any?
+              raise Dry::Struct::Error, "Referenced DB instances not found in cluster: #{invalid_ids.join(', ')}"
+            end
+          end
+
+          # Generate unique endpoint name for use in DNS and connection strings
+          def endpoint_dns_name(cluster_arn_or_id)
+            cluster_id = cluster_arn_or_id.include?(':') ? cluster_arn_or_id.split(':').last : cluster_arn_or_id
+            "#{cluster_id}.cluster-custom-#{cluster_endpoint_identifier}"
+          end
+
+          # Estimate additional monthly cost (Aurora endpoints are generally free)
+          def estimated_monthly_cost
+            "$0.00 (Custom endpoints are included with Aurora clusters)"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pangea/resources/aws_rds_cluster_endpoint/types.rbs

@@ -0,0 +1,59 @@
+module Pangea
+  module Resources
+    module AWS
+      class ExcludedMember < Dry::Struct
+        attribute :db_instance_identifier, Types::String
+        
+        def db_instance_identifier: () -> String
+      end
+
+      class StaticMember < Dry::Struct
+        attribute :db_instance_identifier, Types::String
+        
+        def db_instance_identifier: () -> String
+      end
+
+      class RdsClusterEndpointAttributes < Dry::Struct
+        attribute :cluster_identifier, Types::String
+        attribute :cluster_endpoint_identifier, Types::String
+        attribute :custom_endpoint_type, Types::String
+        attribute :static_members, Types::Array[StaticMember]
+        attribute :excluded_members, Types::Array[ExcludedMember]
+        attribute :tags, Types::AwsTags
+
+        def self.new: (Hash[Symbol, untyped] attributes) -> RdsClusterEndpointAttributes
+
+        def cluster_identifier: () -> String
+        def cluster_endpoint_identifier: () -> String
+        def custom_endpoint_type: () -> String
+        def static_members: () -> Array[StaticMember]
+        def excluded_members: () -> Array[ExcludedMember]
+        def tags: () -> Hash[Symbol, String]
+
+        def is_reader?: () -> bool
+        def is_writer?: () -> bool
+        def is_any?: () -> bool
+        def has_static_members?: () -> bool
+        def has_excluded_members?: () -> bool
+        def static_member_db_ids: () -> Array[String]
+        def excluded_member_db_ids: () -> Array[String]
+        def uses_custom_member_config?: () -> bool
+        def configuration_summary: () -> String
+        def validate_db_instances: (Array[Hash[Symbol, String]]) -> void
+        def endpoint_dns_name: (String) -> String
+        def estimated_monthly_cost: () -> String
+      end
+
+      module RdsClusterEndpointConfigs
+        def self.read_replica_endpoint: (cluster_id: String, ?endpoint_id: String) -> Hash[Symbol, untyped]
+        def self.analytics_endpoint: (cluster_id: String, ?excluded_db_instances: Array[String], ?endpoint_id: String) -> Hash[Symbol, untyped]
+        def self.dedicated_reader_endpoint: (cluster_id: String, static_db_instances: Array[String], ?endpoint_id: String) -> Hash[Symbol, untyped]
+        def self.pooled_endpoint: (cluster_id: String, ?endpoint_id: String) -> Hash[Symbol, untyped]
+        def self.development_endpoint: (cluster_id: String, ?endpoint_id: String) -> Hash[Symbol, untyped]
+        def self.failover_endpoint: (cluster_id: String, ?excluded_primary: String?, ?endpoint_id: String) -> Hash[Symbol, untyped]
+      end
+
+      def aws_rds_cluster_endpoint: (Symbol name, Hash[Symbol, untyped] attributes) -> ResourceReference
+    end
+  end
+end

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

@@ -0,0 +1,140 @@
+# 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/aws_rds_cluster_instance/types'
+require 'pangea/resource_registry'
+
+module Pangea
+  module Resources
+    module AWS
+      # Create an AWS RDS Cluster Instance (Aurora) with type-safe attributes
+      #
+      # @param name [Symbol] The resource name
+      # @param attributes [Hash] RDS cluster instance attributes
+      # @return [ResourceReference] Reference object with outputs and computed properties
+      def aws_rds_cluster_instance(name, attributes = {})
+        # Validate attributes using dry-struct
+        instance_attrs = Types::RdsClusterInstanceAttributes.new(attributes)
+        
+        # Generate terraform resource block via terraform-synthesizer
+        resource(:aws_rds_cluster_instance, name) do
+          identifier instance_attrs.identifier if instance_attrs.identifier
+          identifier_prefix instance_attrs.identifier_prefix if instance_attrs.identifier_prefix
+          
+          # Cluster association (required)
+          cluster_identifier instance_attrs.cluster_identifier
+          
+          # Instance configuration
+          instance_class instance_attrs.instance_class
+          engine instance_attrs.engine if instance_attrs.engine
+          engine_version instance_attrs.engine_version if instance_attrs.engine_version
+          
+          # Availability and networking
+          availability_zone instance_attrs.availability_zone if instance_attrs.availability_zone
+          publicly_accessible instance_attrs.publicly_accessible
+          
+          # Parameter group
+          db_parameter_group_name instance_attrs.db_parameter_group_name if instance_attrs.db_parameter_group_name
+          
+          # Monitoring configuration
+          monitoring_interval instance_attrs.monitoring_interval if instance_attrs.monitoring_interval > 0
+          monitoring_role_arn instance_attrs.monitoring_role_arn if instance_attrs.monitoring_role_arn
+          
+          # Performance Insights
+          performance_insights_enabled instance_attrs.performance_insights_enabled if instance_attrs.performance_insights_enabled
+          performance_insights_kms_key_id instance_attrs.performance_insights_kms_key_id if instance_attrs.performance_insights_kms_key_id
+          performance_insights_retention_period instance_attrs.performance_insights_retention_period if instance_attrs.performance_insights_enabled
+          
+          # Backup and maintenance windows
+          preferred_backup_window instance_attrs.preferred_backup_window if instance_attrs.preferred_backup_window
+          preferred_maintenance_window instance_attrs.preferred_maintenance_window if instance_attrs.preferred_maintenance_window
+          
+          # Additional configurations
+          auto_minor_version_upgrade instance_attrs.auto_minor_version_upgrade
+          apply_immediately instance_attrs.apply_immediately if instance_attrs.apply_immediately
+          copy_tags_to_snapshot instance_attrs.copy_tags_to_snapshot
+          
+          # CA certificate
+          ca_cert_identifier instance_attrs.ca_cert_identifier if instance_attrs.ca_cert_identifier
+          
+          # Promotion tier for failover priority
+          promotion_tier instance_attrs.promotion_tier
+          
+          # Apply tags if present
+          if instance_attrs.tags&.any?
+            tags do
+              instance_attrs.tags.each do |key, value|
+                public_send(key, value)
+              end
+            end
+          end
+        end
+        
+        # Return resource reference with available outputs
+        ResourceReference.new(
+          type: 'aws_rds_cluster_instance',
+          name: name,
+          resource_attributes: instance_attrs.to_h,
+          outputs: {
+            id: "${aws_rds_cluster_instance.#{name}.id}",
+            arn: "${aws_rds_cluster_instance.#{name}.arn}",
+            identifier: "${aws_rds_cluster_instance.#{name}.identifier}",
+            cluster_identifier: "${aws_rds_cluster_instance.#{name}.cluster_identifier}",
+            endpoint: "${aws_rds_cluster_instance.#{name}.endpoint}",
+            engine: "${aws_rds_cluster_instance.#{name}.engine}",
+            engine_version_actual: "${aws_rds_cluster_instance.#{name}.engine_version_actual}",
+            instance_class: "${aws_rds_cluster_instance.#{name}.instance_class}",
+            port: "${aws_rds_cluster_instance.#{name}.port}",
+            availability_zone: "${aws_rds_cluster_instance.#{name}.availability_zone}",
+            publicly_accessible: "${aws_rds_cluster_instance.#{name}.publicly_accessible}",
+            writer: "${aws_rds_cluster_instance.#{name}.writer}",
+            db_parameter_group_name: "${aws_rds_cluster_instance.#{name}.db_parameter_group_name}",
+            promotion_tier: "${aws_rds_cluster_instance.#{name}.promotion_tier}",
+            performance_insights_enabled: "${aws_rds_cluster_instance.#{name}.performance_insights_enabled}",
+            performance_insights_kms_key_id: "${aws_rds_cluster_instance.#{name}.performance_insights_kms_key_id}",
+            monitoring_interval: "${aws_rds_cluster_instance.#{name}.monitoring_interval}",
+            monitoring_role_arn: "${aws_rds_cluster_instance.#{name}.monitoring_role_arn}",
+            preferred_backup_window: "${aws_rds_cluster_instance.#{name}.preferred_backup_window}",
+            preferred_maintenance_window: "${aws_rds_cluster_instance.#{name}.preferred_maintenance_window}",
+            ca_cert_identifier: "${aws_rds_cluster_instance.#{name}.ca_cert_identifier}",
+            dbi_resource_id: "${aws_rds_cluster_instance.#{name}.dbi_resource_id}"
+          },
+          computed_properties: {
+            is_serverless: instance_attrs.is_serverless?,
+            is_burstable: instance_attrs.is_burstable?,
+            is_memory_optimized: instance_attrs.is_memory_optimized?,
+            is_graviton: instance_attrs.is_graviton?,
+            instance_family: instance_attrs.instance_family,
+            instance_size: instance_attrs.instance_size,
+            can_be_writer: instance_attrs.can_be_writer?,
+            is_likely_reader: instance_attrs.is_likely_reader?,
+            role_description: instance_attrs.role_description,
+            has_enhanced_monitoring: instance_attrs.has_enhanced_monitoring?,
+            has_performance_insights: instance_attrs.has_performance_insights?,
+            estimated_vcpus: instance_attrs.estimated_vcpus,
+            estimated_memory_gb: instance_attrs.estimated_memory_gb,
+            supports_performance_insights: instance_attrs.supports_performance_insights?,
+            supports_enhanced_monitoring: instance_attrs.supports_enhanced_monitoring?,
+            performance_characteristics: instance_attrs.performance_characteristics,
+            estimated_monthly_cost: instance_attrs.estimated_monthly_cost
+          }
+        )
+      end
+    end
+  end
+end

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

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+# Copyright 2025 The Pangea Authors. Licensed under Apache 2.0.
+
+require_relative 'instance_methods'
+
+module Pangea
+  module Resources
+    module AWS
+      module Types
+        class RdsClusterInstanceAttributes < Pangea::Resources::BaseAttributes
+          include RdsClusterInstanceMethods
+
+          INSTANCE_CLASSES = %w[
+            db.t3.small db.t3.medium db.t3.large db.t3.xlarge db.t3.2xlarge
+            db.t4g.micro db.t4g.small db.t4g.medium db.t4g.large db.t4g.xlarge db.t4g.2xlarge
+            db.r5.large db.r5.xlarge db.r5.2xlarge db.r5.4xlarge db.r5.8xlarge db.r5.12xlarge db.r5.16xlarge db.r5.24xlarge
+            db.r6g.large db.r6g.xlarge db.r6g.2xlarge db.r6g.4xlarge db.r6g.8xlarge db.r6g.12xlarge db.r6g.16xlarge
+            db.r6i.large db.r6i.xlarge db.r6i.2xlarge db.r6i.4xlarge db.r6i.8xlarge db.r6i.12xlarge db.r6i.16xlarge db.r6i.24xlarge db.r6i.32xlarge
+            db.x2g.medium db.x2g.large db.x2g.xlarge db.x2g.2xlarge db.x2g.4xlarge db.x2g.8xlarge db.x2g.12xlarge db.x2g.16xlarge
+            serverless
+          ].freeze
+
+          attribute? :identifier, Resources::Types::String.optional
+          attribute? :identifier_prefix, Resources::Types::String.optional
+          attribute? :cluster_identifier, Resources::Types::String.optional
+          attribute? :instance_class, Resources::Types::String.enum(*INSTANCE_CLASSES).optional
+          attribute? :engine, Resources::Types::String.optional
+          attribute? :engine_version, Resources::Types::String.optional
+          attribute? :availability_zone, Resources::Types::String.optional
+          attribute? :db_parameter_group_name, Resources::Types::String.optional
+          attribute :publicly_accessible, Resources::Types::Bool.default(false)
+          attribute :monitoring_interval, Resources::Types::Integer.default(0).constrained(gteq: 0, lteq: 60)
+          attribute? :monitoring_role_arn, Resources::Types::String.optional
+          attribute :performance_insights_enabled, Resources::Types::Bool.default(false)
+          attribute? :performance_insights_kms_key_id, Resources::Types::String.optional
+          attribute :performance_insights_retention_period, Resources::Types::Integer.default(7).constrained(gteq: 7, lteq: 731)
+          attribute? :preferred_backup_window, Resources::Types::String.optional
+          attribute? :preferred_maintenance_window, Resources::Types::String.optional
+          attribute :auto_minor_version_upgrade, Resources::Types::Bool.default(true)
+          attribute :apply_immediately, Resources::Types::Bool.default(false)
+          attribute :copy_tags_to_snapshot, Resources::Types::Bool.default(true)
+          attribute? :ca_cert_identifier, Resources::Types::String.optional
+          attribute :promotion_tier, Resources::Types::Integer.default(1).constrained(gteq: 0, lteq: 15)
+          attribute :tags, Resources::Types::AwsTags.default({}.freeze)
+
+          def self.new(attributes = {})
+            attrs = super(attributes)
+            raise Dry::Struct::Error, "Cannot specify both 'identifier' and 'identifier_prefix'" if attrs.identifier && attrs.identifier_prefix
+            raise Dry::Struct::Error, 'monitoring_role_arn is required when monitoring_interval > 0' if attrs.monitoring_interval.positive? && !attrs.monitoring_role_arn
+            raise Dry::Struct::Error, 'performance_insights_retention_period must be at least 7 days when Performance Insights is enabled' if attrs.performance_insights_enabled && attrs.performance_insights_retention_period < 7
+            raise Dry::Struct::Error, 'Enhanced monitoring is not supported for serverless instances' if attrs.instance_class == 'serverless' && attrs.monitoring_interval.positive?
+            attrs
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pangea/resources/aws_rds_cluster_instance/types/configs.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+# Copyright 2025 The Pangea Authors. Licensed under Apache 2.0.
+
+module Pangea
+  module Resources
+    module AWS
+      module Types
+        module AuroraInstanceConfigs
+          def self.writer_instance(instance_class: 'db.r5.large')
+            { instance_class: instance_class, promotion_tier: 0, performance_insights_enabled: true,
+              monitoring_interval: 60, tags: { Role: 'writer', Tier: 'primary' } }
+          end
+
+          def self.reader_instance(instance_class: 'db.r5.large', tier: 1)
+            { instance_class: instance_class, promotion_tier: tier, performance_insights_enabled: true,
+              monitoring_interval: 30, tags: { Role: 'reader', Tier: "tier-#{tier}" } }
+          end
+
+          def self.development_instance
+            { instance_class: 'db.t3.medium', promotion_tier: 0, performance_insights_enabled: false,
+              monitoring_interval: 0, auto_minor_version_upgrade: true, tags: { Environment: 'development', CostOptimized: 'true' } }
+          end
+
+          def self.production_writer
+            { instance_class: 'db.r5.2xlarge', promotion_tier: 0, performance_insights_enabled: true,
+              performance_insights_retention_period: 93, monitoring_interval: 15,
+              tags: { Environment: 'production', Role: 'writer', CriticalSystem: 'true' } }
+          end
+
+          def self.production_reader(tier: 1)
+            { instance_class: 'db.r5.xlarge', promotion_tier: tier, performance_insights_enabled: true,
+              performance_insights_retention_period: 31, monitoring_interval: 60,
+              tags: { Environment: 'production', Role: 'reader', Tier: "tier-#{tier}" } }
+          end
+
+          def self.graviton_writer
+            { instance_class: 'db.r6g.large', promotion_tier: 0, performance_insights_enabled: true,
+              monitoring_interval: 60, tags: { Role: 'writer', Architecture: 'graviton2', CostOptimized: 'true' } }
+          end
+
+          def self.graviton_reader(tier: 1)
+            { instance_class: 'db.r6g.large', promotion_tier: tier, performance_insights_enabled: true,
+              monitoring_interval: 30, tags: { Role: 'reader', Architecture: 'graviton2', Tier: "tier-#{tier}", CostOptimized: 'true' } }
+          end
+
+          def self.multi_az_deployment
+            {
+              writer: writer_instance(instance_class: 'db.r5.large'),
+              reader_az_b: reader_instance(instance_class: 'db.r5.large', tier: 1),
+              reader_az_c: reader_instance(instance_class: 'db.r5.large', tier: 2)
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pangea/resources/aws_rds_cluster_instance/types/instance_methods.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+# Copyright 2025 The Pangea Authors. Licensed under Apache 2.0.
+
+module Pangea
+  module Resources
+    module AWS
+      module Types
+        module RdsClusterInstanceMethods
+          def is_serverless? = instance_class == 'serverless'
+          def is_burstable? = instance_class.include?('t3') || instance_class.include?('t4g')
+          def is_memory_optimized? = instance_class.include?('r5') || instance_class.include?('r6') || instance_class.include?('x2g')
+          def is_graviton? = instance_class.include?('t4g') || instance_class.include?('r6g') || instance_class.include?('x2g')
+          def has_enhanced_monitoring? = monitoring_interval.positive?
+          def has_performance_insights? = performance_insights_enabled
+          def can_be_writer? = promotion_tier.zero?
+          def is_likely_reader? = promotion_tier.positive?
+          def supports_performance_insights? = !is_serverless?
+          def supports_enhanced_monitoring? = !is_serverless?
+
+          def instance_family
+            return 'serverless' if is_serverless?
+            case instance_class
+            when /^db\.t3/ then 't3'
+            when /^db\.t4g/ then 't4g'
+            when /^db\.r5/ then 'r5'
+            when /^db\.r6g/ then 'r6g'
+            when /^db\.r6i/ then 'r6i'
+            when /^db\.x2g/ then 'x2g'
+            else 'unknown'
+            end
+          end
+
+          def instance_size
+            return 'serverless' if is_serverless?
+            parts = instance_class.split('.')
+            parts.last if parts.length >= 3
+          end
+
+          def role_description
+            case promotion_tier
+            when 0 then 'Primary writer instance'
+            when 1 then 'Primary failover target'
+            else "Reader instance (tier #{promotion_tier})"
+            end
+          end
+
+          def estimated_vcpus
+            return 'variable' if is_serverless?
+            case instance_class
+            when /micro|small/ then 1
+            when /medium/ then 2
+            when /large$/ then 2
+            when /xlarge$/ then 4
+            when /2xlarge/ then 8
+            when /4xlarge/ then 16
+            when /8xlarge/ then 32
+            when /12xlarge/ then 48
+            when /16xlarge/ then 64
+            when /24xlarge/ then 96
+            when /32xlarge/ then 128
+            else 2
+            end
+          end
+
+          def estimated_memory_gb
+            return 'variable' if is_serverless?
+            INSTANCE_MEMORY_MAP[instance_class] || 8
+          end
+
+          def estimated_monthly_cost
+            return 'Variable based on Aurora Capacity Units' if is_serverless?
+            hourly_rate = HOURLY_RATES[instance_class] || 0.200
+            "~$#{(hourly_rate * 730).round(2)}/month"
+          end
+
+          def performance_characteristics
+            {
+              vcpus: estimated_vcpus, memory_gb: estimated_memory_gb, instance_family: instance_family,
+              instance_size: instance_size, is_burstable: is_burstable?, is_memory_optimized: is_memory_optimized?,
+              is_graviton: is_graviton?, supports_performance_insights: supports_performance_insights?,
+              supports_enhanced_monitoring: supports_enhanced_monitoring?
+            }
+          end
+
+          INSTANCE_MEMORY_MAP = {
+            'db.t3.micro' => 1, 'db.t3.small' => 2, 'db.t3.medium' => 4, 'db.t3.large' => 8,
+            'db.t3.xlarge' => 16, 'db.t3.2xlarge' => 32, 'db.t4g.micro' => 1, 'db.t4g.small' => 2,
+            'db.t4g.medium' => 4, 'db.t4g.large' => 8, 'db.t4g.xlarge' => 16, 'db.t4g.2xlarge' => 32,
+            'db.r5.large' => 16, 'db.r5.xlarge' => 32, 'db.r5.2xlarge' => 64, 'db.r5.4xlarge' => 128,
+            'db.r5.8xlarge' => 256, 'db.r5.12xlarge' => 384, 'db.r5.16xlarge' => 512, 'db.r5.24xlarge' => 768,
+            'db.r6g.large' => 16, 'db.r6g.xlarge' => 32, 'db.r6g.2xlarge' => 64, 'db.r6g.4xlarge' => 128,
+            'db.r6g.8xlarge' => 256, 'db.r6g.12xlarge' => 384, 'db.r6g.16xlarge' => 512
+          }.freeze
+
+          HOURLY_RATES = {
+            'db.t3.small' => 0.041, 'db.t3.medium' => 0.082, 'db.t3.large' => 0.164, 'db.t3.xlarge' => 0.328,
+            'db.t3.2xlarge' => 0.656, 'db.t4g.medium' => 0.073, 'db.t4g.large' => 0.146,
+            'db.r5.large' => 0.240, 'db.r5.xlarge' => 0.480, 'db.r5.2xlarge' => 0.960, 'db.r5.4xlarge' => 1.920,
+            'db.r6g.large' => 0.216, 'db.r6g.xlarge' => 0.432, 'db.r6g.2xlarge' => 0.864
+          }.freeze
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# Copyright 2025 The Pangea Authors. Licensed under Apache 2.0.
+
+require 'pangea/resources/types'
+require_relative 'types/attributes'
+require_relative 'types/configs'
+
+module Pangea
+  module Resources
+    module AWS
+      module Types
+        # RdsClusterInstanceAttributes is defined in types/attributes.rb
+        # AuroraInstanceConfigs is defined in types/configs.rb
+      end
+    end
+  end
+end