pangea-aws 0.1.0

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

@@ -0,0 +1,70 @@
+# 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/core_attributes'
+require_relative 'types/storage_attributes'
+require_relative 'types/network_attributes'
+require_relative 'types/backup_attributes'
+require_relative 'types/monitoring_attributes'
+require_relative 'types/options_attributes'
+require_relative 'types/validations'
+require_relative 'types/helpers'
+require_relative 'types/engine_configs'
+
+module Pangea
+  module Resources
+    module AWS
+      module Types
+        # Type-safe attributes for AWS RDS Database Instance resources
+        # Composed from modular attribute structs for maintainability
+        class DbInstanceAttributes < Pangea::Resources::BaseAttributes
+          transform_keys(&:to_sym)
+
+          # Compose attributes from modular structs
+          attributes_from CoreAttributes
+          attributes_from StorageAttributes
+          attributes_from NetworkAttributes
+          attributes_from BackupAttributes
+          attributes_from MonitoringAttributes
+          attributes_from OptionsAttributes
+
+          # Include helper methods
+          include DbInstanceHelpers
+
+          # Custom validation
+          def self.new(attributes = {})
+            attrs = super(attributes)
+
+            # Run all validations
+            DbInstanceValidations.validate!(attrs)
+            validate_non_aurora!(attrs)
+
+            attrs
+          end
+
+          # Non-Aurora engines require allocated_storage (kept here for self.new context)
+          def self.validate_non_aurora!(attrs)
+            return if attrs.engine.start_with?("aurora")
+
+            if attrs.allocated_storage.nil?
+              raise Dry::Struct::Error, "Non-Aurora engines require 'allocated_storage' to be specified"
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,91 @@
+# 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_db_parameter_group/types'
+require 'pangea/resource_registry'
+
+module Pangea
+  module Resources
+    module AWS
+      # Create an AWS RDS DB Parameter Group with type-safe attributes
+      #
+      # @param name [Symbol] The resource name
+      # @param attributes [Hash] DB parameter group attributes
+      # @return [ResourceReference] Reference object with outputs and computed properties
+      def aws_db_parameter_group(name, attributes = {})
+        # Validate attributes using dry-struct
+        param_group_attrs = Types::DbParameterGroupAttributes.new(attributes)
+        
+        # Validate parameters for the specific engine family
+        param_group_attrs.validate_parameters_for_family
+        
+        # Generate terraform resource block via terraform-synthesizer
+        resource(:aws_db_parameter_group, name) do
+          name param_group_attrs.name
+          family param_group_attrs.family
+          description param_group_attrs.effective_description
+          
+          # Add parameters if present
+          if param_group_attrs.parameters&.any?
+            param_group_attrs.parameters.each do |param|
+              parameter do
+                name param.name
+                value param.value
+                apply_method param.apply_method if param.apply_method
+              end
+            end
+          end
+          
+          # Apply tags if present
+          if param_group_attrs.tags&.any?
+            tags do
+              param_group_attrs.tags.each do |key, value|
+                public_send(key, value)
+              end
+            end
+          end
+        end
+        
+        # Return resource reference with available outputs
+        ResourceReference.new(
+          type: 'aws_db_parameter_group',
+          name: name,
+          resource_attributes: param_group_attrs.to_h,
+          outputs: {
+            id: "${aws_db_parameter_group.#{name}.id}",
+            arn: "${aws_db_parameter_group.#{name}.arn}",
+            name: "${aws_db_parameter_group.#{name}.name}",
+            description: "${aws_db_parameter_group.#{name}.description}",
+            family: "${aws_db_parameter_group.#{name}.family}"
+          },
+          computed_properties: {
+            engine: param_group_attrs.engine,
+            engine_version: param_group_attrs.engine_version,
+            is_aurora: param_group_attrs.is_aurora?,
+            parameter_count: param_group_attrs.parameter_count,
+            requires_reboot: param_group_attrs.requires_reboot?,
+            reboot_required_parameters: param_group_attrs.reboot_required_parameters.map(&:name),
+            immediate_parameters: param_group_attrs.immediate_parameters.map(&:name),
+            effective_description: param_group_attrs.effective_description,
+            estimated_monthly_cost: param_group_attrs.estimated_monthly_cost
+          }
+        )
+      end
+    end
+  end
+end

data/lib/pangea/resources/aws_db_parameter_group/types/db_parameter.rb

@@ -0,0 +1,59 @@
+# 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
+        # Individual parameter definition for DB parameter groups
+        unless const_defined?(:DbParameter)
+        class DbParameter < Pangea::Resources::BaseAttributes
+          # Parameter name
+          attribute? :name, Resources::Types::String.optional
+
+          # Parameter value
+          attribute? :value, Resources::Types::String.optional
+
+          # Apply method for parameter application
+          attribute? :apply_method, Resources::Types::String.constrained(included_in: ["immediate", "pending-reboot"]).optional
+
+          def self.new(attributes = {})
+            attrs = super(attributes)
+
+            # Validate parameter name format
+            unless attrs.name.match?(/^[a-zA-Z][a-zA-Z0-9_.-]*$/)
+              raise Dry::Struct::Error, "Invalid parameter name format: #{attrs.name}"
+            end
+
+            attrs
+          end
+
+          # Check if parameter requires reboot
+          def requires_reboot?
+            apply_method == "pending-reboot"
+          end
+
+          # Check if parameter applies immediately
+          def applies_immediately?
+            apply_method == "immediate" || apply_method.nil?
+          end
+        end
+        end
+      end
+    end
+  end
+end

data/lib/pangea/resources/aws_db_parameter_group/types/db_parameter_configs.rb

@@ -0,0 +1,82 @@
+# 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.
+
+module Pangea
+  module Resources
+    module AWS
+      module Types
+        # Common parameter configurations for different engines
+        module DbParameterConfigs
+          # MySQL performance tuning parameters
+          def self.mysql_performance(instance_class: "db.t3.micro")
+            buffer_pool_size = case instance_class
+                             when /t3.micro/ then "134217728"  # 128MB
+                             when /t3.small/ then "268435456"  # 256MB
+                             when /t3.medium/ then "536870912" # 512MB
+                             when /m5.large/ then "1073741824" # 1GB
+                             else "268435456" # Default 256MB
+                             end
+
+            [
+              { name: "innodb_buffer_pool_size", value: buffer_pool_size, apply_method: "pending-reboot" },
+              { name: "slow_query_log", value: "1", apply_method: "immediate" },
+              { name: "long_query_time", value: "2", apply_method: "immediate" },
+              { name: "max_connections", value: "100", apply_method: "immediate" }
+            ]
+          end
+
+          # PostgreSQL performance tuning parameters
+          def self.postgresql_performance(instance_class: "db.t3.micro")
+            shared_buffers = case instance_class
+                           when /t3.micro/ then "32MB"
+                           when /t3.small/ then "64MB"
+                           when /t3.medium/ then "128MB"
+                           when /m5.large/ then "256MB"
+                           else "64MB"
+                           end
+
+            [
+              { name: "shared_buffers", value: shared_buffers, apply_method: "pending-reboot" },
+              { name: "work_mem", value: "4MB", apply_method: "immediate" },
+              { name: "maintenance_work_mem", value: "64MB", apply_method: "immediate" },
+              { name: "checkpoint_completion_target", value: "0.9", apply_method: "immediate" },
+              { name: "log_statement", value: "all", apply_method: "immediate" }
+            ]
+          end
+
+          # Aurora MySQL parameters
+          def self.aurora_mysql_performance
+            [
+              { name: "slow_query_log", value: "1", apply_method: "immediate" },
+              { name: "long_query_time", value: "2", apply_method: "immediate" },
+              { name: "binlog_format", value: "ROW", apply_method: "pending-reboot" },
+              { name: "innodb_print_all_deadlocks", value: "1", apply_method: "immediate" }
+            ]
+          end
+
+          # Aurora PostgreSQL parameters
+          def self.aurora_postgresql_performance
+            [
+              { name: "shared_preload_libraries", value: "pg_stat_statements", apply_method: "pending-reboot" },
+              { name: "log_statement", value: "all", apply_method: "immediate" },
+              { name: "log_min_duration_statement", value: "1000", apply_method: "immediate" },
+              { name: "checkpoint_completion_target", value: "0.9", apply_method: "immediate" }
+            ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pangea/resources/aws_db_parameter_group/types/parameter_validators.rb

@@ -0,0 +1,73 @@
+# 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.
+
+module Pangea
+  module Resources
+    module AWS
+      module Types
+        # Engine-specific parameter validation methods
+        module ParameterValidators
+          private
+
+          def validate_mysql_parameters
+            # MySQL-specific parameter validation
+            mysql_params = %w[
+              innodb_buffer_pool_size max_connections slow_query_log
+              log_bin_trust_function_creators innodb_log_file_size
+            ]
+
+            invalid_params = parameters.map(&:name) - mysql_params
+            if invalid_params.any?
+              # Note: This is a simplified validation - in practice, MySQL has hundreds of parameters
+              # For production use, we'd want a comprehensive parameter registry
+            end
+          end
+
+          def validate_postgresql_parameters
+            # PostgreSQL-specific parameter validation
+            pg_params = %w[
+              shared_preload_libraries max_connections work_mem
+              maintenance_work_mem checkpoint_completion_target
+              wal_buffers log_statement
+            ]
+
+            # Similar simplified validation for PostgreSQL
+          end
+
+          def validate_mariadb_parameters
+            # MariaDB shares many parameters with MySQL
+            validate_mysql_parameters
+          end
+
+          def validate_oracle_parameters
+            # Oracle-specific parameter validation
+            oracle_params = %w[
+              open_cursors processes sessions
+              shared_pool_size pga_aggregate_target
+            ]
+          end
+
+          def validate_sqlserver_parameters
+            # SQL Server parameter validation
+            sqlserver_params = %w[
+              max_degree_of_parallelism cost_threshold_for_parallelism
+              max_server_memory backup_compression_default
+            ]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,162 @@
+# 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/db_parameter'
+require_relative 'types/db_parameter_configs'
+require_relative 'types/parameter_validators'
+
+module Pangea
+  module Resources
+    module AWS
+      module Types
+        # Type-safe attributes for AWS RDS DB Parameter Group resources
+        class DbParameterGroupAttributes < Pangea::Resources::BaseAttributes
+          include ParameterValidators
+
+          # Parameter group name (required)
+          attribute? :name, Resources::Types::String.optional
+
+          # Parameter group family (engine-specific)
+          attribute? :family, Resources::Types::String.enum(
+            # MySQL families
+            "mysql5.7", "mysql8.0",
+            # PostgreSQL families
+            "postgres11", "postgres12", "postgres13", "postgres14", "postgres15", "postgres16",
+            # MariaDB families
+            "mariadb10.4", "mariadb10.5", "mariadb10.6", "mariadb10.11",
+            # Oracle families
+            "oracle-ee-11.2", "oracle-ee-12.1", "oracle-ee-12.2", "oracle-ee-19", "oracle-ee-21",
+            "oracle-se2-11.2", "oracle-se2-12.1", "oracle-se2-12.2", "oracle-se2-19", "oracle-se2-21",
+            # SQL Server families
+            "sqlserver-ee-11.0", "sqlserver-ee-12.0", "sqlserver-ee-13.0", "sqlserver-ee-14.0", "sqlserver-ee-15.0", "sqlserver-ee-16.0",
+            "sqlserver-ex-11.0", "sqlserver-ex-12.0", "sqlserver-ex-13.0", "sqlserver-ex-14.0", "sqlserver-ex-15.0", "sqlserver-ex-16.0",
+            "sqlserver-se-11.0", "sqlserver-se-12.0", "sqlserver-se-13.0", "sqlserver-se-14.0", "sqlserver-se-15.0", "sqlserver-se-16.0",
+            "sqlserver-web-11.0", "sqlserver-web-12.0", "sqlserver-web-13.0", "sqlserver-web-14.0", "sqlserver-web-15.0", "sqlserver-web-16.0",
+            # Aurora families
+            "aurora-mysql5.7", "aurora-mysql8.0",
+            "aurora-postgresql11", "aurora-postgresql12", "aurora-postgresql13", "aurora-postgresql14", "aurora-postgresql15", "aurora-postgresql16"
+          )
+
+          # Description for the parameter group
+          attribute? :description, Resources::Types::String.optional
+
+          # Parameters to set
+          attribute :parameters, Resources::Types::Array.of(DbParameter).default([].freeze)
+
+          # Tags to apply to the parameter group
+          attribute :tags, Resources::Types::AwsTags.default({}.freeze)
+
+          # Custom validation
+          def self.new(attributes = {})
+            attrs = super(attributes)
+
+            # Validate parameter group name format
+            unless attrs.name.match?(/^[a-zA-Z][a-zA-Z0-9-]{0,254}$/)
+              raise Dry::Struct::Error, "Parameter group name must start with a letter and contain only alphanumeric characters and hyphens (max 255 chars)"
+            end
+
+            # Validate unique parameter names
+            param_names = attrs.parameters.map(&:name)
+            if param_names.uniq.length != param_names.length
+              duplicates = param_names.group_by(&:itself).select { |_, v| v.size > 1 }.keys
+              raise Dry::Struct::Error, "Duplicate parameter names found: #{duplicates.join(', ')}"
+            end
+
+            attrs
+          end
+
+          # Get the database engine from family
+          def engine
+            case family
+            when /aurora-mysql/
+              "aurora-mysql"
+            when /aurora-postgresql/
+              "aurora-postgresql"
+            when /mysql/
+              "mysql"
+            when /postgres/
+              "postgresql"
+            when /mariadb/
+              "mariadb"
+            when /oracle/
+              "oracle"
+            when /sqlserver/
+              "sqlserver"
+            else
+              "unknown"
+            end
+          end
+
+          # Check if this is an Aurora parameter group
+          def is_aurora?
+            family.start_with?("aurora")
+          end
+
+          # Get engine version from family
+          def engine_version
+            family.split(/[.-]/).last || "unknown"
+          end
+
+          # Generate a description if none provided
+          def effective_description
+            description || "Custom #{engine} parameter group for #{name}"
+          end
+
+          # Get parameters that require reboot
+          def reboot_required_parameters
+            parameters.select(&:requires_reboot?)
+          end
+
+          # Get parameters that apply immediately
+          def immediate_parameters
+            parameters.select(&:applies_immediately?)
+          end
+
+          # Check if any parameters require instance reboot
+          def requires_reboot?
+            reboot_required_parameters.any?
+          end
+
+          # Get parameter count
+          def parameter_count
+            parameters.length
+          end
+
+          # Validate parameters for the specific engine family
+          def validate_parameters_for_family
+            case engine
+            when "mysql", "aurora-mysql"
+              validate_mysql_parameters
+            when "postgresql", "aurora-postgresql"
+              validate_postgresql_parameters
+            when "mariadb"
+              validate_mariadb_parameters
+            when "oracle"
+              validate_oracle_parameters
+            when "sqlserver"
+              validate_sqlserver_parameters
+            end
+          end
+
+          # Estimate monthly cost (parameter groups have no direct cost)
+          def estimated_monthly_cost
+            "$0.00/month (no direct cost for parameter groups)"
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,89 @@
+# 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_db_snapshot/types'
+require 'pangea/resource_registry'
+
+module Pangea
+  module Resources
+    module AWS
+      # Create an AWS DB Snapshot with type-safe attributes
+      #
+      # @param name [Symbol] The resource name
+      # @param attributes [Hash] DB snapshot attributes
+      # @return [ResourceReference] Reference object with outputs and computed properties
+      def aws_db_snapshot(name, attributes = {})
+        # Validate attributes using dry-struct
+        snapshot_attrs = Types::DbSnapshotAttributes.new(attributes)
+        
+        # Generate terraform resource block via terraform-synthesizer
+        resource(:aws_db_snapshot, name) do
+          db_instance_identifier snapshot_attrs.db_instance_identifier
+          db_snapshot_identifier snapshot_attrs.db_snapshot_identifier
+          
+          # Apply tags if present
+          if snapshot_attrs.tags&.any?
+            tags do
+              snapshot_attrs.tags.each do |key, value|
+                public_send(key, value)
+              end
+            end
+          end
+        end
+        
+        # Return resource reference with available outputs
+        ResourceReference.new(
+          type: 'aws_db_snapshot',
+          name: name,
+          resource_attributes: snapshot_attrs.to_h,
+          outputs: {
+            id: "${aws_db_snapshot.#{name}.id}",
+            arn: "${aws_db_snapshot.#{name}.db_snapshot_arn}",
+            db_instance_identifier: "${aws_db_snapshot.#{name}.db_instance_identifier}",
+            db_snapshot_identifier: "${aws_db_snapshot.#{name}.db_snapshot_identifier}",
+            allocated_storage: "${aws_db_snapshot.#{name}.allocated_storage}",
+            availability_zone: "${aws_db_snapshot.#{name}.availability_zone}",
+            db_instance_class: "${aws_db_snapshot.#{name}.instance_class}",
+            engine: "${aws_db_snapshot.#{name}.engine}",
+            engine_version: "${aws_db_snapshot.#{name}.engine_version}",
+            license_model: "${aws_db_snapshot.#{name}.license_model}",
+            master_username: "${aws_db_snapshot.#{name}.master_username}",
+            option_group_name: "${aws_db_snapshot.#{name}.option_group_name}",
+            port: "${aws_db_snapshot.#{name}.port}",
+            snapshot_create_time: "${aws_db_snapshot.#{name}.snapshot_create_time}",
+            snapshot_type: "${aws_db_snapshot.#{name}.snapshot_type}",
+            source_region: "${aws_db_snapshot.#{name}.source_region}",
+            status: "${aws_db_snapshot.#{name}.status}",
+            storage_type: "${aws_db_snapshot.#{name}.storage_type}",
+            vpc_id: "${aws_db_snapshot.#{name}.vpc_id}",
+            tags: "${aws_db_snapshot.#{name}.tags}",
+            tags_all: "${aws_db_snapshot.#{name}.tags_all}"
+          },
+          computed_properties: {
+            follows_naming_convention: snapshot_attrs.follows_naming_convention?,
+            base_name: snapshot_attrs.base_name,
+            timestamp: snapshot_attrs.timestamp,
+            age_in_days: snapshot_attrs.age_in_days,
+            snapshot_summary: snapshot_attrs.snapshot_summary,
+            estimated_monthly_storage_cost: snapshot_attrs.estimated_monthly_storage_cost
+          }
+        )
+      end
+    end
+  end
+end