pangea-core 0.1.0

data/flake.nix

@@ -0,0 +1,60 @@
+{
+  description = "Pangea Core — shared types and utilities for Pangea infrastructure DSL";
+
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+    ruby-nix.url = "github:inscapist/ruby-nix";
+    flake-utils.url = "github:numtide/flake-utils";
+    substrate = {
+      url = "github:pleme-io/substrate";
+      inputs.nixpkgs.follows = "nixpkgs";
+    };
+    forge = {
+      url = "github:pleme-io/forge";
+      inputs.nixpkgs.follows = "nixpkgs";
+      inputs.substrate.follows = "substrate";
+    };
+  };
+
+  outputs = {
+    self,
+    nixpkgs,
+    ruby-nix,
+    flake-utils,
+    substrate,
+    forge,
+    ...
+  }:
+    flake-utils.lib.eachSystem ["x86_64-linux" "aarch64-linux" "aarch64-darwin"] (system: let
+      pkgs = import nixpkgs {
+        inherit system;
+        overlays = [ruby-nix.overlays.ruby];
+      };
+      rnix = ruby-nix.lib pkgs;
+      rnix-env = rnix {
+        name = "pangea-core";
+        gemset = ./gemset.nix;
+      };
+      env = rnix-env.env;
+      ruby = rnix-env.ruby;
+
+      rubyBuild = import "${substrate}/lib/ruby-build.nix" {
+        inherit pkgs;
+        forgeCmd = "${forge.packages.${system}.default}/bin/forge";
+        defaultGhcrToken = "";
+      };
+    in {
+      devShells.default = pkgs.mkShell {
+        buildInputs = [env ruby];
+        shellHook = ''
+          export RUBYLIB=$PWD/lib:$RUBYLIB
+          export DRY_TYPES_WARNINGS=false
+        '';
+      };
+
+      apps = rubyBuild.mkRubyGemApps {
+        srcDir = self;
+        name = "pangea-core";
+      };
+    });
+}

data/gemset.nix

@@ -0,0 +1,262 @@
+{
+  abstract-synthesizer = {
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1724yzbklcmiiahb7s3y1ir1i0n03b9c3arlib35g85d8hf0h75d";
+      type = "gem";
+    };
+    version = "0.0.15";
+  };
+  base64 = {
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0yx9yn47a8lkfcjmigk79fykxvr80r4m1i35q82sxzynpbm7lcr7";
+      type = "gem";
+    };
+    version = "0.3.0";
+  };
+  bigdecimal = {
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "19y406nx17arzsbc515mjmr6k5p59afprspa1k423yd9cp8d61wb";
+      type = "gem";
+    };
+    version = "4.0.1";
+  };
+  concurrent-ruby = {
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1aymcakhzl83k77g2f2krz07bg1cbafbcd2ghvwr4lky3rz86mkb";
+      type = "gem";
+    };
+    version = "1.3.6";
+  };
+  diff-lcs = {
+    groups = ["default" "development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0qlrj2qyysc9avzlr4zs1py3x684hqm61n4czrsk1pyllz5x5q4s";
+      type = "gem";
+    };
+    version = "1.6.2";
+  };
+  docile = {
+    groups = ["default" "development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "07pj4z3h8wk4fgdn6s62vw1lwvhj0ac0x10vfbdkr9xzk7krn5cn";
+      type = "gem";
+    };
+    version = "1.4.1";
+  };
+  dry-core = {
+    dependencies = ["concurrent-ruby" "logger" "zeitwerk"];
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "18cn9s2p7cbgacy0z41h3sf9jvl75vjfmvj774apyffzi3dagi8c";
+      type = "gem";
+    };
+    version = "1.2.0";
+  };
+  dry-inflector = {
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1k1dd35sqqqg2abd2g2w78m94pa3mcwvmrsjbkr3hxpn0jxw5c3z";
+      type = "gem";
+    };
+    version = "1.3.1";
+  };
+  dry-logic = {
+    dependencies = ["bigdecimal" "concurrent-ruby" "dry-core" "zeitwerk"];
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "18nf8mbnhgvkw34drj7nmvpx2afmyl2nyzncn3wl3z4h1yyfsvys";
+      type = "gem";
+    };
+    version = "1.6.0";
+  };
+  dry-struct = {
+    dependencies = ["dry-core" "dry-types" "ice_nine" "zeitwerk"];
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0ri9iqxknxvvhpbshf6jn7bq581k8l67iv23mii69yr4k5aqphvl";
+      type = "gem";
+    };
+    version = "1.8.0";
+  };
+  dry-types = {
+    dependencies = ["bigdecimal" "concurrent-ruby" "dry-core" "dry-inflector" "dry-logic" "zeitwerk"];
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0y7icwaa26ycikz6h97gwd1hji3r280n4yr2kmn5sfgqp76yxsxs";
+      type = "gem";
+    };
+    version = "1.9.1";
+  };
+  ice_nine = {
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1nv35qg1rps9fsis28hz2cq2fx1i96795f91q4nmkm934xynll2x";
+      type = "gem";
+    };
+    version = "0.11.2";
+  };
+  logger = {
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "00q2zznygpbls8asz5knjvvj2brr3ghmqxgr83xnrdj4rk3xwvhr";
+      type = "gem";
+    };
+    version = "1.7.0";
+  };
+  pangea-core = {
+    dependencies = ["base64" "dry-struct" "dry-types" "terraform-synthesizer"];
+    groups = ["default"];
+    platforms = [];
+    source = {
+      path = ./.;
+      type = "path";
+    };
+    version = "0.1.0";
+  };
+  rake = {
+    groups = ["development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "175iisqb211n0qbfyqd8jz2g01q6xj038zjf4q0nm8k6kz88k7lc";
+      type = "gem";
+    };
+    version = "13.3.1";
+  };
+  rspec = {
+    dependencies = ["rspec-core" "rspec-expectations" "rspec-mocks"];
+    groups = ["development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "11q5hagj6vr694innqj4r45jrm8qcwvkxjnphqgyd66piah88qi0";
+      type = "gem";
+    };
+    version = "3.13.2";
+  };
+  rspec-core = {
+    dependencies = ["rspec-support"];
+    groups = ["default" "development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0bcbh9yv6cs6pv299zs4bvalr8yxa51kcdd1pjl60yv625j3r0m8";
+      type = "gem";
+    };
+    version = "3.13.6";
+  };
+  rspec-expectations = {
+    dependencies = ["diff-lcs" "rspec-support"];
+    groups = ["default" "development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0dl8npj0jfpy31bxi6syc7jymyd861q277sfr6jawq2hv6hx791k";
+      type = "gem";
+    };
+    version = "3.13.5";
+  };
+  rspec-mocks = {
+    dependencies = ["diff-lcs" "rspec-support"];
+    groups = ["default" "development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "071bqrk2rblk3zq3jk1xxx0dr92y0szi5pxdm8waimxici706y89";
+      type = "gem";
+    };
+    version = "3.13.7";
+  };
+  rspec-support = {
+    groups = ["default" "development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0z64h5rznm2zv21vjdjshz4v0h7bxvg02yc6g7yzxakj11byah06";
+      type = "gem";
+    };
+    version = "3.13.7";
+  };
+  simplecov = {
+    dependencies = ["docile" "simplecov-html" "simplecov_json_formatter"];
+    groups = ["development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "198kcbrjxhhzca19yrdcd6jjj9sb51aaic3b0sc3pwjghg3j49py";
+      type = "gem";
+    };
+    version = "0.22.0";
+  };
+  simplecov-html = {
+    groups = ["default" "development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0ikjfwydgs08nm3xzc4cn4b6z6rmcrj2imp84xcnimy2wxa8w2xx";
+      type = "gem";
+    };
+    version = "0.13.2";
+  };
+  simplecov_json_formatter = {
+    groups = ["default" "development"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "0a5l0733hj7sk51j81ykfmlk2vd5vaijlq9d5fn165yyx3xii52j";
+      type = "gem";
+    };
+    version = "0.1.4";
+  };
+  terraform-synthesizer = {
+    dependencies = ["abstract-synthesizer"];
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "01yl1s6xnxn3qh42ybqanxdgcfpppg2cvjk8pka7xcf5hxz9qxda";
+      type = "gem";
+    };
+    version = "0.0.28";
+  };
+  zeitwerk = {
+    groups = ["default"];
+    platforms = [];
+    source = {
+      remotes = ["https://rubygems.org"];
+      sha256 = "1pbkiwwla5gldgb3saamn91058nl1sq1344l5k36xsh9ih995nnq";
+      type = "gem";
+    };
+    version = "2.7.5";
+  };
+}

data/lib/pangea/resource_registry.rb

@@ -0,0 +1,68 @@
+# 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 'set'
+
+module Pangea
+  # Global registry for resource modules that auto-register when loaded
+  module ResourceRegistry
+    @registered_modules = Set.new
+    @provider_modules = Hash.new { |h, k| h[k] = Set.new }
+
+    class << self
+      # Register a module to be available in template contexts
+      def register_module(mod)
+        @registered_modules.add(mod)
+      end
+
+      # Get all registered modules
+      def registered_modules
+        @registered_modules.to_a
+      end
+
+      # Clear registry (useful for testing)
+      def clear!
+        @registered_modules.clear
+      end
+
+      # Check if a module is registered
+      def registered?(mod)
+        @registered_modules.include?(mod)
+      end
+
+      # Support provider-based registration used by individual resources
+      def register(provider, mod)
+        @provider_modules[provider].add(mod)
+        # Also add to global registry for backward compatibility
+        @registered_modules.add(mod)
+      end
+      
+      # Get modules for a specific provider
+      def modules_for(provider)
+        @provider_modules[provider].to_a
+      end
+
+      # Get registry statistics
+      def stats
+        {
+          total_modules: @registered_modules.size,
+          modules: @registered_modules.map(&:name),
+          by_provider: @provider_modules.transform_values(&:size)
+        }
+      end
+    end
+  end
+end

data/lib/pangea/resources/base.rb

@@ -0,0 +1,81 @@
+# 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
+    # Base functionality for all resource abstractions
+    module Base
+      # Resource definition that gets passed to terraform-synthesizer
+      class ResourceDefinition
+        attr_reader :type, :name, :attributes
+        
+        def initialize(type, name, attributes)
+          @type = type
+          @name = name
+          @attributes = attributes
+        end
+        
+        # Convert to terraform-synthesizer resource block
+        def to_terraform_resource(&block)
+          resource(type, name, &block)
+        end
+      end
+      
+      protected
+      
+      # Helper method to create resource definitions
+      def create_resource(type, name, attributes_class, attributes = {})
+        # Validate attributes with dry-struct
+        validated_attrs = attributes_class.new(attributes)
+        
+        # Create resource definition
+        ResourceDefinition.new(type, name, validated_attrs)
+      end
+      
+      # Helper to convert hash keys to terraform-synthesizer method calls
+      def apply_attributes_to_resource(resource_block, attributes)
+        attributes.each do |key, value|
+          case value
+          when Hash
+            resource_block.public_send(key) do
+              apply_attributes_to_resource(self, value)
+            end
+          when Array
+            value.each do |item|
+              if item.is_a?(Hash)
+                resource_block.public_send(key) do
+                  apply_attributes_to_resource(self, item)
+                end
+              else
+                resource_block.public_send(key, item)
+              end
+            end
+          else
+            resource_block.public_send(key, value)
+          end
+        end
+      end
+      
+      # Helper for reference generation
+      def resource_ref(type, name, attribute)
+        # This would integrate with terraform-synthesizer's ref functionality
+        "${#{type}.#{name}.#{attribute}}"
+      end
+    end
+  end
+end

data/lib/pangea/resources/base_attributes.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require 'dry-struct'
+
+module Pangea
+  module Resources
+    # Base class for all provider resource attribute structs.
+    #
+    # Provides:
+    # - transform_keys(&:to_sym) so hash keys are normalized
+    # - T constant aliasing Resources::Types for short, unambiguous type references
+    #
+    # All provider attribute classes should inherit from this:
+    #   class VpcAttributes < Pangea::Resources::BaseAttributes
+    #     attribute :cidr_block, T::CidrBlock
+    #     attribute :tags, T::AwsTags.default({}.freeze)
+    #   end
+    #
+    class BaseAttributes < Dry::Struct
+      # Short alias for Pangea::Resources::Types — works inside class bodies
+      # because it's a real constant (not const_missing-based)
+      T = Pangea::Resources::Types
+
+      transform_keys(&:to_sym)
+
+      # Terraform reference pattern — matches ${...} interpolation syntax.
+      # Use in self.new validators to skip format checks on values that are
+      # terraform references (they will be resolved at plan/apply time).
+      TERRAFORM_REF_PATTERN = /\$\{.*\}/.freeze
+
+      # Returns true if the value contains a terraform/HCL interpolation reference.
+      # Works for both class-level (self.terraform_reference?) and instance-level usage.
+      def self.terraform_reference?(value)
+        return false unless value.is_a?(String)
+
+        value.match?(TERRAFORM_REF_PATTERN)
+      end
+
+      def terraform_reference?(value)
+        self.class.terraform_reference?(value)
+      end
+
+      # Create a copy with merged attributes.
+      # Uses Dry::Struct's load method to bypass custom self.new overrides,
+      # preventing infinite recursion when copy_with is called inside validators.
+      def copy_with(changes = {})
+        merged = to_h.merge(changes.transform_keys(&:to_sym))
+        self.class.load(merged)
+      end
+    end
+  end
+end

data/lib/pangea/resources/helpers.rb

@@ -0,0 +1,54 @@
+# 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
+    # Helper functions available in template context
+    module Helpers
+      # Create a terraform reference to another resource
+      # @param resource_type [Symbol] The resource type (e.g., :aws_vpc)
+      # @param resource_name [Symbol] The resource name
+      # @param attribute [Symbol] The attribute to reference (e.g., :id)
+      # @return [String] Terraform reference string
+      def ref(resource_type, resource_name, attribute)
+        "${#{resource_type}.#{resource_name}.#{attribute}}"
+      end
+      
+      # Create a data source reference
+      # @param data_type [Symbol] The data source type
+      # @param data_name [Symbol] The data source name  
+      # @param attribute [Symbol] The attribute to reference
+      # @return [String] Terraform data reference string
+      def data_ref(data_type, data_name, attribute)
+        "${data.#{data_type}.#{data_name}.#{attribute}}"
+      end
+      
+      # Create a variable reference
+      # @param var_name [Symbol] The variable name
+      # @return [String] Terraform variable reference string
+      def var(var_name)
+        "${var.#{var_name}}"
+      end
+      
+      # Create a local value reference
+      # @param local_name [Symbol] The local value name
+      # @return [String] Terraform local reference string
+      def local(local_name)
+        "${local.#{local_name}}"
+      end
+    end
+  end
+end

data/lib/pangea/resources/network_helpers.rb

@@ -0,0 +1,75 @@
+# 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/utilities/ip_discovery'
+require 'pangea/resource_registry'
+
+module Pangea
+  module Resources
+    # Network helpers for templates
+    module NetworkHelpers
+      # Discover public IP address - available in template context
+      def discover_public_ip(timeout: 5)
+        # Cache the IP discovery result to avoid multiple calls
+        @_discovered_ip ||= begin
+          discovery = Utilities::IpDiscovery.new(timeout: timeout)
+          ip = discovery.discover
+          puts "[Pangea] Discovered public IP: #{ip}"
+          ip
+        end
+      end
+      
+      # Create CIDR block from IP and mask
+      def cidr_block(ip, mask)
+        "#{ip}/#{mask}"
+      end
+      
+      # Calculate subnet CIDR from base and offset
+      def subnet_cidr(base_cidr, subnet_bits, index)
+        base_ip, base_mask = base_cidr.split('/')
+        octets = base_ip.split('.').map(&:to_i)
+        
+        # Calculate new IP based on subnet bits and index
+        subnet_size = 2 ** subnet_bits
+        offset = index * subnet_size
+        
+        # Apply offset to appropriate octet
+        octet_index = (32 - base_mask.to_i - subnet_bits) / 8
+        octets[octet_index] += offset
+        
+        new_ip = octets.join('.')
+        new_mask = base_mask.to_i + subnet_bits
+        
+        "#{new_ip}/#{new_mask}"
+      end
+      
+      # Generate availability zones for a region
+      def availability_zones(region, count = 3)
+        zones = ('a'..'f').to_a
+        zones.take(count).map { |zone| "#{region}#{zone}" }
+      end
+      
+      # Validate IP address format
+      def valid_ip?(ip)
+        return false unless ip =~ /\A(?:\d{1,3}\.){3}\d{1,3}\z/
+        
+        ip.split('.').all? { |octet| octet.to_i <= 255 }
+      end
+    end
+  end
+end
+
+# Auto-register the module when loaded
+Pangea::ResourceRegistry.register_module(Pangea::Resources::NetworkHelpers)