pangea-core 0.1.0

data/lib/pangea/resources/reference.rb

@@ -0,0 +1,138 @@
+# 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
+    # Base computed attributes - common to all resources
+    class BaseComputedAttributes
+      attr_reader :resource_ref
+
+      def initialize(resource_ref)
+        @resource_ref = resource_ref
+      end
+
+      # Common terraform attributes available on all resources
+      def id
+        resource_ref.ref(:id)
+      end
+
+      def terraform_resource_name
+        "#{resource_ref.type}.#{resource_ref.name}"
+      end
+
+      def tags
+        resource_ref.resource_attributes[:tags] || {}
+      end
+    end
+
+    # Resource reference object returned by resource functions
+    # Provides access to resource attributes, outputs, and computed properties
+    class ResourceReference < Dry::Struct
+      # Registry for provider-specific computed attributes classes
+      @@computed_attributes_registry = {}
+
+      # Normalize input keys: accept `attributes:` as alias for `resource_attributes:`
+      transform_keys do |key|
+        k = key.to_sym
+        k == :attributes ? :resource_attributes : k
+      end
+
+      attribute :type, Types::Coercible::String  # aws_vpc, aws_subnet, etc. (coerces Symbol → String)
+      attribute :name, Types::Symbol | Types::String  # Resource name
+      # Accept Hash or Dry::Struct (auto-coerced via constructor)
+      attribute :resource_attributes, Types::Hash.constructor { |v|
+        v.respond_to?(:to_h) && !v.is_a?(Hash) ? v.to_h : v
+      }
+      attribute :outputs, Types::Hash.default({}.freeze)  # Available outputs for this resource type
+      attribute? :computed_properties, Types::Hash.optional  # Resource-specific computed properties
+      attribute? :computed, Types::Hash.optional             # Alias for computed_properties
+
+      # Register computed attributes classes for resource types
+      # @param mapping [Hash] resource_type => computed_attributes_class
+      def self.register_computed_attributes(mapping)
+        @@computed_attributes_registry.merge!(mapping)
+      end
+
+      # Alias for `type` — some callers prefer `resource_type` to avoid conflicts
+      def resource_type
+        type.to_sym
+      end
+
+      # Generate terraform reference for any attribute
+      def ref(attribute_name)
+        "${#{type}.#{name}.#{attribute_name}}"
+      end
+
+      # Alias for ref - more natural syntax
+      def [](attribute_name)
+        ref(attribute_name)
+      end
+
+      # Access to common outputs with friendly names
+      def id
+        ref(:id)
+      end
+
+      def arn
+        ref(:arn)
+      end
+
+      # Resource-specific computed properties (extensible via register_computed_attributes)
+      def computed_attributes
+        @computed_attributes ||= begin
+          klass = @@computed_attributes_registry[type]
+          klass ? klass.new(self) : BaseComputedAttributes.new(self)
+        end
+      end
+
+      # Method delegation to outputs, computed properties, and computed attributes
+      def method_missing(method_name, *args, &block)
+        if outputs.key?(method_name)
+          outputs[method_name]
+        elsif computed_properties&.key?(method_name)
+          computed_properties[method_name]
+        elsif computed&.key?(method_name)
+          computed[method_name]
+        elsif computed_attributes.respond_to?(method_name)
+          computed_attributes.public_send(method_name, *args, &block)
+        else
+          super
+        end
+      end
+
+      def respond_to_missing?(method_name, include_private = false)
+        outputs.key?(method_name) ||
+          computed_properties&.key?(method_name) ||
+          computed&.key?(method_name) ||
+          computed_attributes.respond_to?(method_name, include_private) ||
+          super
+      end
+
+      # Convert to hash for terraform-synthesizer integration
+      def to_h
+        {
+          type: type,
+          name: name,
+          attributes: resource_attributes,  # Use 'attributes' as key for compatibility
+          outputs: outputs
+        }
+      end
+    end
+  end
+end

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

@@ -0,0 +1,84 @@
+# 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 'dry-types'
+require 'json'
+require 'base64'
+
+module Pangea
+  module Resources
+    # Common types for resource definitions
+    module Types
+      include Dry.Types()
+
+      # Provider type registries — provider gems register their Types module here
+      # so T::SomeProviderType resolves to AWS::Types::SomeProviderType etc.
+      @provider_type_modules = []
+
+      def self.register_provider_types(mod)
+        @provider_type_modules << mod unless @provider_type_modules.include?(mod)
+      end
+
+      def self.const_missing(name)
+        if name == :ResourceReference
+          require 'pangea/resources/reference' unless defined?(::Pangea::Resources::ResourceReference)
+          return ::Pangea::Resources::ResourceReference
+        end
+
+        # Search registered provider type modules
+        @provider_type_modules.each do |mod|
+          return mod.const_get(name) if mod.const_defined?(name, false)
+        end
+
+        super
+      end
+
+      # Provider-agnostic shared types
+
+      # CIDR block validation (e.g., "10.0.0.0/16")
+      CidrBlock = String.constrained(format: /\A\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\/\d{1,2}\z/)
+
+      # Domain name validation
+      DomainName = String.constrained(
+        format: /\A(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\z/i
+      )
+
+      # Wildcard domain name validation
+      WildcardDomainName = String.constrained(
+        format: /\A\*\.(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\z/i
+      )
+
+      # Email address validation
+      EmailAddress = String.constrained(format: /\A[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}\z/)
+
+      # Network port (0-65535)
+      Port = Integer.constrained(gteq: 0, lteq: 65535)
+
+      # Network protocols
+      IpProtocol = String.enum('tcp', 'udp', 'icmp', 'icmpv6', 'all', '-1')
+
+      # Port range
+      PortRange = Hash.schema(from_port: Port, to_port: Port)
+
+      # POSIX permissions (octal format)
+      PosixPermissions = String.constrained(format: /\A[0-7]{3,4}\z/)
+
+      # Unix User/Group IDs
+      UnixUserId = Integer.constrained(gteq: 0, lteq: 4294967295)
+      UnixGroupId = Integer.constrained(gteq: 0, lteq: 4294967295)
+    end
+  end
+end

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

@@ -0,0 +1,20 @@
+# 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.
+
+# Core types (must be loaded first)
+require_relative 'core'
+
+# Provider types are loaded by their respective gems:
+# pangea-aws, pangea-cloudflare, pangea-hcloud

data/lib/pangea/resources/types.rb

@@ -0,0 +1,17 @@
+# 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.
+
+# Load all modular type definitions
+require_relative 'types/index'

data/lib/pangea/utilities/ip_discovery.rb

@@ -0,0 +1,109 @@
+# 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 'net/http'
+require 'json'
+require 'timeout'
+
+module Pangea
+  module Utilities
+    # IP Discovery service for finding public IP addresses
+    class IpDiscovery
+      # Service definitions with parsers
+      SERVICES = [
+        {
+          name: 'ipify',
+          url: 'https://api.ipify.org?format=json',
+          parser: ->(body) { JSON.parse(body)['ip'] }
+        },
+        {
+          name: 'ipinfo',
+          url: 'https://ipinfo.io/ip',
+          parser: ->(body) { body.strip }
+        },
+        {
+          name: 'aws_checkip',
+          url: 'https://checkip.amazonaws.com',
+          parser: ->(body) { body.strip }
+        },
+        {
+          name: 'ifconfig_me',
+          url: 'https://ifconfig.me',
+          parser: ->(body) { body.strip }
+        }
+      ].freeze
+      
+      IP_REGEX = /\A(?:\d{1,3}\.){3}\d{1,3}\z/.freeze
+      
+      attr_reader :timeout, :logger
+      
+      def initialize(timeout: 5, logger: nil)
+        @timeout = timeout
+        @logger = logger || Logger.new(STDOUT)
+      end
+      
+      # Discover public IP address from multiple services
+      def discover
+        SERVICES.each do |service|
+          ip = try_service(service)
+          return ip if ip
+        end
+        
+        raise DiscoveryError, "Failed to discover public IP from any service"
+      end
+      
+      # Try a single service with timeout
+      def try_service(service)
+        Timeout.timeout(@timeout) do
+          uri = URI(service[:url])
+          response = Net::HTTP.get_response(uri)
+          
+          if response.is_a?(Net::HTTPSuccess)
+            ip = service[:parser].call(response.body)
+            
+            if validate_ip_format(ip)
+              @logger&.info("[IpDiscovery] Discovered public IP from #{service[:name]}: #{ip}")
+              return ip
+            else
+              @logger&.warn("[IpDiscovery] Invalid IP format from #{service[:name]}: #{ip}")
+            end
+          else
+            @logger&.warn("[IpDiscovery] HTTP error from #{service[:name]}: #{response.code}")
+          end
+        end
+        
+        nil
+      rescue Timeout::Error
+        @logger&.warn("[IpDiscovery] Timeout querying #{service[:name]}")
+        nil
+      rescue StandardError => e
+        @logger&.warn("[IpDiscovery] Error querying #{service[:name]}: #{e.message}")
+        nil
+      end
+      
+      private
+      
+      # Validate IP address format
+      def validate_ip_format(ip)
+        return false unless ip.match?(IP_REGEX)
+        
+        octets = ip.split('.')
+        octets.all? { |octet| octet.to_i <= 255 }
+      end
+    end
+    
+    class DiscoveryError < StandardError; end
+  end
+end

data/lib/pangea-core/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module PangeaCore
+  VERSION = %(0.1.0).freeze
+end

data/lib/pangea-core.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require 'dry-struct'
+require 'dry-types'
+require 'terraform-synthesizer'
+
+# dry-types 1.9+ ConstraintError requires 2 args (message, input).
+# Our resource type code uses `raise ConstraintError, "msg"` which passes
+# only 1 arg via Ruby's `exception(msg)` method. Patch to accept single arg.
+if Dry::Types::ConstraintError.instance_method(:initialize).arity.abs > 1
+  class Dry::Types::ConstraintError
+    alias_method :_orig_initialize, :initialize
+    def initialize(message, input = nil)
+      _orig_initialize(message, input)
+    end
+  end
+end
+
+# Minimal ActiveSupport-like extensions used by resource code
+unless Object.method_defined?(:present?)
+  class Object
+    def present?
+      respond_to?(:empty?) ? !empty? : !nil?
+    end
+
+    def blank?
+      respond_to?(:empty?) ? empty? : nil?
+    end
+  end
+
+  class NilClass
+    def present? = false
+    def blank? = true
+  end
+
+  class FalseClass
+    def present? = false
+    def blank? = true
+  end
+
+  class TrueClass
+    def present? = true
+    def blank? = false
+  end
+
+  class String
+    def present? = !empty?
+    def blank? = empty? || strip.empty?
+  end
+end
+
+# Core types
+require_relative 'pangea/resources/types'
+require_relative 'pangea/resource_registry'
+require_relative 'pangea/resources/helpers'
+require_relative 'pangea/resources/base'
+require_relative 'pangea/resources/base_attributes'
+require_relative 'pangea/resources/reference'
+require_relative 'pangea/resources/network_helpers'

data/pangea-core.gemspec

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+lib = File.expand_path(%(lib), __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require_relative %(lib/pangea-core/version)
+
+Gem::Specification.new do |spec|
+  spec.name                  = %(pangea-core)
+  spec.version               = PangeaCore::VERSION
+  spec.authors               = [%(Luis Zayas)]
+  spec.email                 = [%(drzthslnt@gmail.com)]
+  spec.description           = %(Core types and utilities for Pangea infrastructure DSL. Provides ResourceReference, ResourceRegistry, Base, Types, and Helpers shared across all provider gems.)
+  spec.summary               = %(Core types for Pangea infrastructure DSL)
+  spec.homepage              = %(https://github.com/pleme-io/pangea-core)
+  spec.license               = %(Apache-2.0)
+  spec.require_paths         = [%(lib)]
+  spec.required_ruby_version = %(>=3.3.0)
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+
+  spec.add_dependency "terraform-synthesizer", "~> 0.0.28"
+  spec.add_dependency "dry-types", "~> 1.7"
+  spec.add_dependency "dry-struct", "~> 1.6"
+  spec.add_dependency "base64"
+
+  spec.add_development_dependency "rspec", "~> 3.12"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "simplecov", "~> 0.22"
+
+  spec.metadata['rubygems_mfa_required'] = 'true'
+end

metadata

@@ -0,0 +1,164 @@
+--- !ruby/object:Gem::Specification
+name: pangea-core
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Luis Zayas
+autorequire:
+bindir: bin
+cert_chain: []
+date: 1980-01-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: terraform-synthesizer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.28
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.28
+- !ruby/object:Gem::Dependency
+  name: dry-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: dry-struct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+description: Core types and utilities for Pangea infrastructure DSL. Provides ResourceReference,
+  ResourceRegistry, Base, Types, and Helpers shared across all provider gems.
+email:
+- drzthslnt@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- Rakefile
+- flake.lock
+- flake.nix
+- gemset.nix
+- lib/pangea-core.rb
+- lib/pangea-core/version.rb
+- lib/pangea/resource_registry.rb
+- lib/pangea/resources/base.rb
+- lib/pangea/resources/base_attributes.rb
+- lib/pangea/resources/helpers.rb
+- lib/pangea/resources/network_helpers.rb
+- lib/pangea/resources/reference.rb
+- lib/pangea/resources/types.rb
+- lib/pangea/resources/types/core.rb
+- lib/pangea/resources/types/index.rb
+- lib/pangea/utilities/ip_discovery.rb
+- pangea-core.gemspec
+homepage: https://github.com/pleme-io/pangea-core
+licenses:
+- Apache-2.0
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.26
+signing_key:
+specification_version: 4
+summary: Core types for Pangea infrastructure DSL
+test_files: []