pangea 0.0.45 → 0.0.46

data/lib/pangea/resources/aws_gamelift_fleet/CLAUDE.md

@@ -1,191 +0,0 @@
-# AWS GameLift Fleet Resource - Technical Documentation
-
-## Architecture
-GameLift Fleet is a core component of Amazon GameLift's game server hosting solution. It manages collections of EC2 instances that run game server processes, providing automatic scaling, health monitoring, and game session placement.
-
-## Key Concepts
-
-### Fleet Types
-- **ON_DEMAND**: Stable pricing, guaranteed capacity
-- **SPOT**: Cost-effective, potential interruptions
-
-### Compute Types
-- **EC2**: Traditional EC2-based fleets
-- **ANYWHERE**: Hybrid deployments using on-premises hardware
-
-### Build vs Script
-- **Build**: Custom game server executables (C++, C#, etc.)
-- **Script**: Realtime Servers using Node.js/JavaScript
-
-## Implementation Details
-
-### Type Validation
-The types.rb file implements comprehensive validation:
-- Either build_id or script_id required (mutually exclusive)
-- IP permissions validate port ranges and protocols
-- Runtime configuration validates server process settings
-- Scaling constraints ensure min <= desired <= max
-
-### Resource Defaults
-- fleet_type: ON_DEMAND (stable hosting)
-- new_game_session_protection_policy: NoProtection
-- certificate_configuration: GENERATED (automatic TLS)
-- Scaling: min=0, max=1, desired=1
-
-### Computed Attributes
-- id: Fleet identifier
-- arn: Fleet ARN for IAM policies
-- build_arn: Associated build ARN
-- status: Fleet status (ACTIVE, BUILDING, etc.)
-- log_paths: S3 paths for game session logs
-
-## Game Server Architecture Patterns
-
-### Multi-Region Deployment
-```ruby
-["us-east-1", "eu-west-1", "ap-northeast-1"].each do |region|
-  aws_gamelift_fleet(:"game_fleet_#{region}", {
-    name: "game-fleet-#{region}",
-    build_id: ref(:aws_gamelift_build, :"game_build_#{region}", :id),
-    ec2_instance_type: "c5.large",
-    min_size: 2,
-    max_size: 20,
-    desired_ec2_instances: 4
-  })
-end
-```
-
-### Development vs Production
-```ruby
-# Development fleet - minimal resources
-aws_gamelift_fleet(:dev_fleet, {
-  name: "dev-game-fleet",
-  build_id: dev_build_id,
-  ec2_instance_type: "t3.medium",
-  fleet_type: "SPOT",
-  max_size: 2
-})
-
-# Production fleet - high availability
-aws_gamelift_fleet(:prod_fleet, {
-  name: "prod-game-fleet",
-  build_id: prod_build_id,
-  ec2_instance_type: "c5.xlarge",
-  fleet_type: "ON_DEMAND",
-  min_size: 10,
-  max_size: 100,
-  new_game_session_protection_policy: "FullProtection"
-})
-```
-
-## Security Considerations
-
-### Network Security
-- Configure minimal ec2_inbound_permission rules
-- Use specific IP ranges instead of 0.0.0.0/0
-- Separate game traffic from management ports
-
-### TLS Configuration
-- GENERATED: Automatic TLS certificates
-- DISABLED: For development/testing only
-
-### IAM Roles
-- instance_role_arn grants permissions to fleet instances
-- Required for S3 access, CloudWatch logs, etc.
-
-## Performance Optimization
-
-### Instance Selection
-- c5 family: CPU-intensive games
-- m5 family: Balanced workloads
-- t3 family: Development/testing
-
-### Process Configuration
-```ruby
-runtime_configuration: {
-  game_session_activation_timeout_seconds: 300,
-  max_concurrent_game_session_activations: 2,
-  server_process: [
-    {
-      concurrent_executions: 10,  # Sessions per instance
-      launch_path: "/game/server",
-      parameters: "-maxplayers 100"
-    }
-  ]
-}
-```
-
-## Monitoring and Metrics
-
-### CloudWatch Integration
-```ruby
-metric_groups: ["default", "custom-metrics"],
-```
-
-### Key Metrics
-- ActiveInstances
-- IdleInstances
-- PercentIdleInstances
-- ActiveGameSessions
-- GameSessionActivations
-
-## Cost Management
-
-### Spot Fleet Strategy
-```ruby
-aws_gamelift_fleet(:cost_optimized, {
-  fleet_type: "SPOT",
-  # Implement graceful shutdown in game server
-  new_game_session_protection_policy: "FullProtection",
-  # Scale down during off-peak
-  min_size: 0
-})
-```
-
-### Resource Limits
-```ruby
-resource_creation_limit_policy: {
-  new_game_sessions_per_creator: 5,
-  policy_period_in_minutes: 15
-}
-```
-
-## Integration Points
-
-### With GameLift Build
-```ruby
-build = aws_gamelift_build(:game_build, {...})
-fleet = aws_gamelift_fleet(:game_fleet, {
-  build_id: build.id,
-  ...
-})
-```
-
-### With GameLift Alias
-```ruby
-fleet = aws_gamelift_fleet(:blue_fleet, {...})
-alias = aws_gamelift_alias(:production, {
-  routing_strategy: {
-    type: "SIMPLE",
-    fleet_id: fleet.id
-  }
-})
-```
-
-### With Session Queue
-```ruby
-queue = aws_gamelift_game_session_queue(:matchmaking, {
-  destinations: [fleet.arn]
-})
-```
-
-## Troubleshooting
-
-### Common Issues
-1. Fleet stuck in ACTIVATING: Check build/script validity
-2. No available instances: Verify scaling settings
-3. Connection timeouts: Check security group rules
-4. High latency: Review instance placement and types
-
-### Health Checks
-GameLift automatically performs health checks on fleet instances and replaces unhealthy ones.

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

@@ -1,118 +0,0 @@
-# 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_relative "types"
-
-module Pangea
-  module Resources
-    module AwsGameliftFleet
-      # Resource-specific methods for AWS GameLift Fleet
-      module Resource
-        def self.validate(definition)
-          # Must have either build_id or script_id
-          unless definition[:build_id] || definition[:script_id]
-            raise ArgumentError, "Either build_id or script_id must be specified for GameLift fleet"
-          end
-
-          # Both cannot be specified
-          if definition[:build_id] && definition[:script_id]
-            raise ArgumentError, "Cannot specify both build_id and script_id for GameLift fleet"
-          end
-
-          # Validate scaling constraints
-          if definition[:min_size] && definition[:max_size]
-            if definition[:min_size] > definition[:max_size]
-              raise ArgumentError, "min_size cannot be greater than max_size"
-            end
-          end
-
-          if definition[:desired_ec2_instances]
-            min = definition[:min_size] || 0
-            max = definition[:max_size] || 1000
-            desired = definition[:desired_ec2_instances]
-            
-            if desired < min || desired > max
-              raise ArgumentError, "desired_ec2_instances must be between min_size and max_size"
-            end
-          end
-
-          Types::Attributes.from_dynamic(definition)
-        end
-
-        def self.defaults
-          {
-            fleet_type: "ON_DEMAND",
-            new_game_session_protection_policy: "NoProtection",
-            compute_type: "EC2",
-            min_size: 0,
-            max_size: 1,
-            desired_ec2_instances: 1,
-            certificate_configuration: {
-              certificate_type: "GENERATED"
-            }
-          }
-        end
-
-        def self.required_attributes
-          %i[name ec2_instance_type]
-        end
-
-        def self.compute_attributes(definition)
-          attrs = {
-            id: ref(definition[:name], :id),
-            arn: ref(definition[:name], :arn),
-            build_arn: ref(definition[:name], :build_arn),
-            creation_time: ref(definition[:name], :creation_time),
-            operating_system: ref(definition[:name], :operating_system),
-            status: ref(definition[:name], :status),
-            log_paths: ref(definition[:name], :log_paths)
-          }
-
-          Types::Reference.new(attrs)
-        end
-
-        private
-
-        def self.ref(name, attribute)
-          "${aws_gamelift_fleet.#{name}.#{attribute}}"
-        end
-      end
-
-      # Public resource function
-      def aws_gamelift_fleet(name, attributes = {})
-        # Apply defaults
-        attributes = Resource.defaults.merge(attributes)
-        
-        # Validate and create resource
-        validated = Resource.validate(attributes)
-        
-        # Create terraform resource
-        resource :aws_gamelift_fleet, name do
-          # Add attributes
-          validated.to_h.each do |key, value|
-            send(key, value) unless value.nil?
-          end
-        end
-        
-        # Return computed attributes as reference
-        Resource.compute_attributes(validated.to_h.merge(name: name))
-      end
-    end
-  end
-end
-
-# Auto-register this module when it's loaded
-Pangea::ResourceRegistry.register(:aws, Pangea::Resources::AWS)

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

@@ -1,128 +0,0 @@
-# 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/types"
-
-module Pangea
-  module Resources
-    module AwsGameliftFleet
-      module Types
-        # IP permission configuration for the fleet
-        class IpPermission < Dry::Struct
-          attribute :from_port, Pangea::Types::Integer
-          attribute :to_port, Pangea::Types::Integer
-          attribute :ip_range, Pangea::Types::String
-          attribute :protocol, Pangea::Types::String.enum("TCP", "UDP")
-        end
-
-        # Runtime configuration for fleet instances
-        class ServerProcess < Dry::Struct
-          attribute :concurrent_executions, Pangea::Types::Integer
-          attribute :launch_path, Pangea::Types::String
-          attribute :parameters?, Pangea::Types::String
-        end
-
-        class RuntimeConfiguration < Dry::Struct
-          attribute :game_session_activation_timeout_seconds?, Pangea::Types::Integer.constrained(gteq: 1, lteq: 600)
-          attribute :max_concurrent_game_session_activations?, Pangea::Types::Integer.constrained(gteq: 1, lteq: 2147483647)
-          attribute :server_process?, Pangea::Types::Array.of(ServerProcess)
-        end
-
-        # Resource creation limit policy
-        class ResourceCreationLimitPolicy < Dry::Struct
-          attribute :new_game_sessions_per_creator?, Pangea::Types::Integer
-          attribute :policy_period_in_minutes?, Pangea::Types::Integer
-        end
-
-        # Certificate configuration for TLS
-        class CertificateConfiguration < Dry::Struct
-          attribute :certificate_type, Pangea::Types::String.enum("DISABLED", "GENERATED")
-        end
-
-        # Main attributes for GameLift fleet
-        class Attributes < Dry::Struct
-          # Required attributes
-          attribute :name, Pangea::Types::String
-          attribute :build_id?, Pangea::Types::String
-          attribute :script_id?, Pangea::Types::String
-          attribute :ec2_instance_type, Pangea::Types::String
-          
-          # Optional attributes
-          attribute :description?, Pangea::Types::String
-          attribute :ec2_inbound_permission?, Pangea::Types::Array.of(IpPermission)
-          attribute :fleet_type?, Pangea::Types::String.enum("ON_DEMAND", "SPOT")
-          attribute :instance_role_arn?, Pangea::Types::String
-          attribute :certificate_configuration?, CertificateConfiguration
-          attribute :metric_groups?, Pangea::Types::Array.of(Pangea::Types::String)
-          attribute :new_game_session_protection_policy?, Pangea::Types::String.enum("NoProtection", "FullProtection")
-          attribute :resource_creation_limit_policy?, ResourceCreationLimitPolicy
-          attribute :runtime_configuration?, RuntimeConfiguration
-          attribute :peer_vpc_aws_account_id?, Pangea::Types::String
-          attribute :peer_vpc_id?, Pangea::Types::String
-          attribute :tags?, Pangea::Types::Hash.map(Pangea::Types::String, Pangea::Types::String)
-
-          # Compute configuration
-          attribute :compute_type?, Pangea::Types::String.enum("EC2", "ANYWHERE")
-          attribute :anywhere_configuration?, Pangea::Types::Hash
-
-          # Scaling configuration
-          attribute :desired_ec2_instances?, Pangea::Types::Integer
-          attribute :min_size?, Pangea::Types::Integer
-          attribute :max_size?, Pangea::Types::Integer
-
-          def self.from_dynamic(d)
-            d = Pangea::Types::Hash[d]
-            new(
-              name: d.fetch(:name),
-              build_id: d[:build_id],
-              script_id: d[:script_id],
-              ec2_instance_type: d.fetch(:ec2_instance_type),
-              description: d[:description],
-              ec2_inbound_permission: d[:ec2_inbound_permission]&.map { |p| IpPermission.from_dynamic(p) },
-              fleet_type: d[:fleet_type],
-              instance_role_arn: d[:instance_role_arn],
-              certificate_configuration: d[:certificate_configuration] ? CertificateConfiguration.from_dynamic(d[:certificate_configuration]) : nil,
-              metric_groups: d[:metric_groups],
-              new_game_session_protection_policy: d[:new_game_session_protection_policy],
-              resource_creation_limit_policy: d[:resource_creation_limit_policy] ? ResourceCreationLimitPolicy.from_dynamic(d[:resource_creation_limit_policy]) : nil,
-              runtime_configuration: d[:runtime_configuration] ? RuntimeConfiguration.from_dynamic(d[:runtime_configuration]) : nil,
-              peer_vpc_aws_account_id: d[:peer_vpc_aws_account_id],
-              peer_vpc_id: d[:peer_vpc_id],
-              tags: d[:tags],
-              compute_type: d[:compute_type],
-              anywhere_configuration: d[:anywhere_configuration],
-              desired_ec2_instances: d[:desired_ec2_instances],
-              min_size: d[:min_size],
-              max_size: d[:max_size]
-            )
-          end
-        end
-
-        # Reference for GameLift fleet resources
-        class Reference < Dry::Struct
-          attribute :id, Pangea::Types::String
-          attribute :arn, Pangea::Types::String
-          attribute :build_arn, Pangea::Types::String
-          attribute :creation_time, Pangea::Types::String
-          attribute :operating_system, Pangea::Types::String
-          attribute :status, Pangea::Types::String
-          attribute :log_paths, Pangea::Types::Array.of(Pangea::Types::String)
-        end
-      end
-    end
-  end
-end

data/lib/pangea/resources/aws_gamelift_fleet.rbs

@@ -1,84 +0,0 @@
-# TypeProf 0.21.2
-
-module Pangea
-  module Resources
-    module AwsGameliftFleet
-      module Types
-        class IpPermission
-          attr_reader from_port: Integer
-          attr_reader to_port: Integer
-          attr_reader ip_range: String
-          attr_reader protocol: "TCP" | "UDP"
-        end
-
-        class ServerProcess
-          attr_reader concurrent_executions: Integer
-          attr_reader launch_path: String
-          attr_reader parameters: String?
-        end
-
-        class RuntimeConfiguration
-          attr_reader game_session_activation_timeout_seconds: Integer?
-          attr_reader max_concurrent_game_session_activations: Integer?
-          attr_reader server_process: Array[ServerProcess]?
-        end
-
-        class ResourceCreationLimitPolicy
-          attr_reader new_game_sessions_per_creator: Integer?
-          attr_reader policy_period_in_minutes: Integer?
-        end
-
-        class CertificateConfiguration
-          attr_reader certificate_type: "DISABLED" | "GENERATED"
-        end
-
-        class Attributes
-          attr_reader name: String
-          attr_reader build_id: String?
-          attr_reader script_id: String?
-          attr_reader ec2_instance_type: String
-          attr_reader description: String?
-          attr_reader ec2_inbound_permission: Array[IpPermission]?
-          attr_reader fleet_type: ("ON_DEMAND" | "SPOT")?
-          attr_reader instance_role_arn: String?
-          attr_reader certificate_configuration: CertificateConfiguration?
-          attr_reader metric_groups: Array[String]?
-          attr_reader new_game_session_protection_policy: ("NoProtection" | "FullProtection")?
-          attr_reader resource_creation_limit_policy: ResourceCreationLimitPolicy?
-          attr_reader runtime_configuration: RuntimeConfiguration?
-          attr_reader peer_vpc_aws_account_id: String?
-          attr_reader peer_vpc_id: String?
-          attr_reader tags: Hash[String, String]?
-          attr_reader compute_type: ("EC2" | "ANYWHERE")?
-          attr_reader anywhere_configuration: Hash[untyped, untyped]?
-          attr_reader desired_ec2_instances: Integer?
-          attr_reader min_size: Integer?
-          attr_reader max_size: Integer?
-
-          def self.from_dynamic: (Hash[Symbol, untyped] d) -> Attributes
-        end
-
-        class Reference
-          attr_reader id: String
-          attr_reader arn: String
-          attr_reader build_arn: String
-          attr_reader creation_time: String
-          attr_reader operating_system: String
-          attr_reader status: String
-          attr_reader log_paths: Array[String]
-        end
-      end
-
-      module Resource
-        def self.validate: (Hash[Symbol, untyped] definition) -> Types::Attributes
-        def self.defaults: () -> Hash[Symbol, untyped]
-        def self.required_attributes: () -> Array[Symbol]
-        def self.compute_attributes: (Hash[Symbol, untyped] definition) -> Types::Reference
-        
-        private
-        
-        def self.ref: (String | Symbol name, Symbol attribute) -> String
-      end
-    end
-  end
-end

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

@@ -1,107 +0,0 @@
-# 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_relative "types"
-
-module Pangea
-  module Resources
-    module AwsGameliftGameSession
-      # Resource-specific methods for AWS GameLift Game Session
-      module Resource
-        def self.validate(definition)
-          # Must have either fleet_id or alias_id
-          unless definition[:fleet_id] || definition[:alias_id]
-            raise ArgumentError, "Either fleet_id or alias_id must be specified for GameLift game session"
-          end
-
-          # Both cannot be specified
-          if definition[:fleet_id] && definition[:alias_id]
-            raise ArgumentError, "Cannot specify both fleet_id and alias_id for GameLift game session"
-          end
-
-          # Validate maximum_player_session_count
-          if definition[:maximum_player_session_count] && definition[:maximum_player_session_count] <= 0
-            raise ArgumentError, "maximum_player_session_count must be greater than 0"
-          end
-
-          Types::Attributes.from_dynamic(definition)
-        end
-
-        def self.defaults
-          {
-            maximum_player_session_count: 10
-          }
-        end
-
-        def self.required_attributes
-          %i[maximum_player_session_count]
-        end
-
-        def self.compute_attributes(definition)
-          attrs = {
-            id: ref(definition[:name], :id),
-            game_session_id: ref(definition[:name], :game_session_id),
-            arn: ref(definition[:name], :arn),
-            name: ref(definition[:name], :name),
-            fleet_id: ref(definition[:name], :fleet_id),
-            fleet_arn: ref(definition[:name], :fleet_arn),
-            creation_time: ref(definition[:name], :creation_time),
-            termination_time: ref(definition[:name], :termination_time),
-            current_player_session_count: ref(definition[:name], :current_player_session_count),
-            maximum_player_session_count: ref(definition[:name], :maximum_player_session_count),
-            status: ref(definition[:name], :status),
-            status_reason: ref(definition[:name], :status_reason),
-            ip_address: ref(definition[:name], :ip_address),
-            dns_name: ref(definition[:name], :dns_name),
-            port: ref(definition[:name], :port),
-            player_session_creation_policy: ref(definition[:name], :player_session_creation_policy)
-          }
-
-          Types::Reference.new(attrs)
-        end
-
-        private
-
-        def self.ref(name, attribute)
-          "${aws_gamelift_game_session.#{name}.#{attribute}}"
-        end
-      end
-
-      # Public resource function
-      def aws_gamelift_game_session(name, attributes = {})
-        # Apply defaults
-        attributes = Resource.defaults.merge(attributes)
-        
-        # Validate and create resource
-        validated = Resource.validate(attributes)
-        
-        # Create terraform resource
-        resource :aws_gamelift_game_session, name do
-          # Add attributes
-          validated.to_h.each do |key, value|
-            send(key, value) unless value.nil?
-          end
-        end
-        
-        # Return computed attributes as reference
-        Resource.compute_attributes(validated.to_h.merge(name: name))
-      end
-    end
-  end
-end
-
-# Auto-register this module when it's loaded
-Pangea::ResourceRegistry.register(:aws, Pangea::Resources::AWS)

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

@@ -1,62 +0,0 @@
-# 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"
-
-module Pangea
-  module Resources
-    module AwsGameliftGameSession
-      module Types
-        include Dry::Types()
-
-        class GameProperty < Dry::Struct
-          attribute :key, String
-          attribute :value, String
-        end
-
-        class Attributes < Dry::Struct
-          attribute? :fleet_id, String
-          attribute? :alias_id, String
-          attribute :maximum_player_session_count, Integer
-          attribute? :name, String
-          attribute? :game_properties, Array.of(GameProperty)
-          attribute? :creator_id, String
-          attribute? :game_session_data, String
-          attribute? :idempotency_token, String
-        end
-
-        class Reference < Dry::Struct
-          attribute :id, String
-          attribute :game_session_id, String
-          attribute :arn, String
-          attribute :name, String
-          attribute :fleet_id, String
-          attribute :fleet_arn, String
-          attribute :creation_time, String
-          attribute :termination_time, String
-          attribute :current_player_session_count, Integer
-          attribute :maximum_player_session_count, Integer
-          attribute :status, String
-          attribute :status_reason, String
-          attribute :ip_address, String
-          attribute :dns_name, String
-          attribute :port, Integer
-          attribute :player_session_creation_policy, String
-        end
-      end
-    end
-  end
-end