pangea-core 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bfee8d62fa68852ea2bbfa33c42ab4d7f49b8deb56ecd8e4ea22c60df4a906d3
-  data.tar.gz: 36bb267536aad0fd63433d9cf98d0e21b0f449126578acaf4d5ddc499a514603
+  metadata.gz: 5531883112f0813ec3c3fb9261c15dbed5ad56fa1c1243e6060a493a64a89af8
+  data.tar.gz: 4061c17da43c2e93204e0b0ed28504ee9a7ee2acf306f5c1564e9469fe4846ce
 SHA512:
-  metadata.gz: 41bda81e7f82b676e4be6a01705f47f203ad1e720fffd27f8509fe08c3cff10827b9c4181579b7be164f869ab8b45d64f236484df6c19729686cf9fb61929757
-  data.tar.gz: 91cf43e388a2b11722b4cd83e1f1ca8214838a5bef34f852ee27cf3676a66340c2ed4dd6205e06a05cf90410a14f124639af30067f30b279e5f77f90e5b720f7
+  metadata.gz: 2a6d5530c63c03213627f0385f9beff6d09b726c60a00068d9721f0ba2e81190098b431f52ee8dd17609fdafc8e49ec8883548895dd640dbf55dbd89cdfe3e6f
+  data.tar.gz: fec9537295beb3213a1536b6a51c057fca7efcb4c0578bf28f950f0cb6934c03eb1aae627f3d517b8589e5f235970d5dc058bd5d2a18ea14d71c0c4fedc77d3e

data/flake.lock

@@ -771,11 +771,11 @@
         ]
       },
       "locked": {
-        "lastModified": 1771807706,
-        "narHash": "sha256-JMDKxc0hfy7itVnURZamiz+2K94VCPOfY3a4OgqHYNc=",
+        "lastModified": 1771861648,
+        "narHash": "sha256-XjYnA7XQUFTg/XrgQL35oojiX/oddmuqHSsLbQg+X44=",
         "owner": "pleme-io",
         "repo": "substrate",
-        "rev": "eb59960eb0dade9bd102b5d4ed774b452c313933",
+        "rev": "0f97a626e8141f4ffa2a4e143f96df2689a82b6b",
         "type": "github"
       },
       "original": {

data/flake.nix

@@ -16,45 +16,11 @@
     };
   };
 
-  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";
-      };
-    });
+  outputs = { self, nixpkgs, ruby-nix, flake-utils, substrate, forge, ... }:
+    (import "${substrate}/lib/ruby-gem-flake.nix" {
+      inherit nixpkgs ruby-nix flake-utils substrate forge;
+    }) {
+      inherit self;
+      name = "pangea-core";
+    };
 }

data/lib/pangea/component_registry.rb

@@ -0,0 +1,44 @@
+# 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 ComponentRegistry
+    @components = []
+    @mutex = Mutex.new
+
+    class << self
+      def register_component(component_module)
+        @mutex.synchronize do
+          unless @components.include?(component_module)
+            @components << component_module
+          end
+        end
+      end
+
+      def registered_components
+        @mutex.synchronize { @components.dup }
+      end
+
+      def clear!
+        @mutex.synchronize { @components.clear }
+      end
+
+      def registered?(component_module)
+        @mutex.synchronize { @components.include?(component_module) }
+      end
+    end
+  end
+end

data/lib/pangea/components/base.rb

@@ -0,0 +1,63 @@
+# 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 Components
+    module Base
+      class ComponentError < StandardError; end
+      class ValidationError < ComponentError; end
+      class CompositionError < ComponentError; end
+
+      def validate_required_attributes(attributes, required)
+        missing = required - attributes.keys
+        unless missing.empty?
+          raise ValidationError, "Missing required attributes: #{missing.join(', ')}"
+        end
+      end
+
+      def calculate_subnet_cidr(vpc_cidr, index, new_bits = 8)
+        require 'ipaddr'
+
+        vpc_network = IPAddr.new(vpc_cidr)
+        vpc_prefix = vpc_cidr.split('/').last.to_i
+        subnet_prefix = vpc_prefix + new_bits
+
+        subnet_size = 2 ** (32 - subnet_prefix)
+        subnet_network = vpc_network.to_i + (index * subnet_size)
+
+        "#{IPAddr.new(subnet_network, Socket::AF_INET)}/#{subnet_prefix}"
+      end
+
+      def component_resource_name(component_name, resource_type, suffix = nil)
+        parts = [component_name, resource_type]
+        parts << suffix if suffix
+        parts.join('_').to_sym
+      end
+
+      def merge_tags(default_tags, user_tags = {})
+        default_tags.merge(user_tags)
+      end
+
+      def component_outputs(resources, computed = {})
+        {
+          resources: resources,
+          computed: computed,
+          created_at: Time.now.utc.iso8601
+        }
+      end
+    end
+  end
+end

data/lib/pangea/entities/module_definition.rb

@@ -0,0 +1,120 @@
+# 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 Entities
+    class ModuleDefinition < Dry::Struct
+      module Type
+        RESOURCE = :resource
+        FUNCTION = :function
+        COMPOSITE = :composite
+      end
+
+      attribute :name, Pangea::Types::ModuleName
+      attribute :version, Pangea::Types::Version.optional.default("0.0.1")
+      attribute :description, Pangea::Types::OptionalString.default(nil)
+      attribute :author, Pangea::Types::OptionalString.default(nil)
+
+      attribute :type, Pangea::Types::Strict::Symbol.default(:resource).enum(:resource, :function, :composite)
+      attribute :source, Pangea::Types::FilePath.optional.default(nil)
+      attribute :path, Pangea::Types::DirectoryPath.optional.default(nil)
+
+      attribute :inputs, Pangea::Types::SymbolizedHash.default({}.freeze)
+      attribute :outputs, Pangea::Types::SymbolizedHash.default({}.freeze)
+      attribute :dependencies, Pangea::Types::ModuleArray.default([].freeze)
+
+      attribute :ruby_version, Pangea::Types::Version.optional.default(nil)
+      attribute :required_gems, Pangea::Types::SymbolizedHash.default({}.freeze)
+
+      def resource_module?
+        type == Type::RESOURCE || type == Type::COMPOSITE
+      end
+
+      def function_module?
+        type == Type::FUNCTION || type == Type::COMPOSITE
+      end
+
+      def load_path
+        return path if path
+        return File.dirname(source) if source
+
+        "modules/#{name}"
+      end
+
+      def required_inputs
+        inputs.select { |_, config| config[:required] }.keys
+      end
+
+      def optional_inputs
+        inputs.reject { |_, config| config[:required] }.keys
+      end
+
+      def validate_inputs(provided_inputs)
+        errors = []
+        provided = provided_inputs.keys.map(&:to_sym)
+
+        required_inputs.each do |input|
+          unless provided.include?(input)
+            errors << "Missing required input: #{input}"
+          end
+        end
+
+        provided.each do |input|
+          unless inputs.key?(input)
+            errors << "Unknown input: #{input}"
+          end
+        end
+
+        provided_inputs.each do |key, value|
+          if inputs[key.to_sym] && inputs[key.to_sym][:type]
+            expected_type = inputs[key.to_sym][:type]
+          end
+        end
+
+        raise ValidationError, errors.join(", ") unless errors.empty?
+        true
+      end
+
+      def to_documentation
+        doc = ["# Module: #{name}"]
+        doc << "Version: #{version}" if version
+        doc << "\n#{description}" if description
+        doc << "\nAuthor: #{author}" if author
+
+        if inputs.any?
+          doc << "\n## Inputs"
+          inputs.each do |name, config|
+            required = config[:required] ? " (required)" : ""
+            doc << "- `#{name}`#{required}: #{config[:description] || 'No description'}"
+            doc << "  - Type: #{config[:type]}" if config[:type]
+            doc << "  - Default: #{config[:default]}" if config[:default]
+          end
+        end
+
+        if outputs.any?
+          doc << "\n## Outputs"
+          outputs.each do |name, config|
+            doc << "- `#{name}`: #{config[:description] || 'No description'}"
+          end
+        end
+
+        doc.join("\n")
+      end
+    end
+  end
+end

data/lib/pangea/entities/namespace.rb

@@ -0,0 +1,144 @@
+# 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 Entities
+    class Namespace < Dry::Struct
+      class StateConfig < Dry::Struct
+        attribute? :bucket, Pangea::Types::String
+        attribute? :key, Pangea::Types::String
+        attribute? :region, Pangea::Types::String.optional
+        attribute? :dynamodb_table, Pangea::Types::String
+        attribute? :lock, Pangea::Types::String
+        attribute? :encrypt, Pangea::Types::Bool
+        attribute? :path, Pangea::Types::String
+
+        def validate_s3!
+          errors = []
+          errors << "S3 bucket name is required" if bucket.nil?
+          errors << "S3 key is required" if key.nil?
+          lock_table = dynamodb_table || lock
+          errors << "DynamoDB lock table is required" if lock_table.nil?
+          raise ::Pangea::Entities::ValidationError, errors.join(", ") unless errors.empty?
+        end
+
+        def lock_table
+          dynamodb_table || lock
+        end
+      end
+
+      class State < Dry::Struct
+        attribute :type, Pangea::Types::StateBackendType
+        attribute :config, StateConfig
+
+        def self.new(attributes)
+          attrs = attributes.is_a?(Hash) ? attributes : {}
+          state_type = attrs[:type]
+          config_attrs = attrs[:config] || {}
+
+          if state_type == :s3
+            required_fields = [:bucket, :key]
+            missing_fields = required_fields.select { |field| config_attrs[field].nil? || config_attrs[field].empty? }
+            unless missing_fields.empty?
+              raise ::Pangea::Entities::ValidationError, "S3 backend requires: #{missing_fields.join(', ')}"
+            end
+          elsif state_type == :local
+            config_attrs[:path] ||= "./terraform.tfstate"
+          end
+
+          super(attrs)
+        end
+
+        def s3?
+          type == :s3
+        end
+
+        def local?
+          type == :local
+        end
+      end
+
+      attribute :name, Pangea::Types::NamespaceString
+      attribute :state, State
+      attribute :description, Pangea::Types::OptionalString.default(nil)
+      attribute :tags, Pangea::Types::SymbolizedHash.default({}.freeze)
+
+      def s3_backend?
+        state.s3?
+      end
+
+      def local_backend?
+        state.local?
+      end
+
+      def state_config
+        config = {
+          type: state.type,
+          region: state.config.region
+        }
+
+        if s3_backend?
+          config[:bucket] = state.config.bucket
+          config[:lock] = state.config.lock
+        end
+
+        config.compact
+      end
+
+      def s3_config
+        raise "Namespace #{name} does not use S3 backend" unless s3_backend?
+        state.config.validate_s3!
+        {
+          bucket: state.config.bucket,
+          key: state.config.key,
+          region: state.config.region,
+          dynamodb_table: state.config.lock_table
+        }
+      end
+
+      def to_terraform_backend
+        if local_backend?
+          return {
+            local: {
+              path: state.config.path || "terraform.tfstate"
+            }
+          }
+        end
+
+        if state.config.bucket.nil? || state.config.bucket.empty?
+          raise ValidationError, "S3 bucket is required but was nil or empty for namespace '#{name}'"
+        end
+        if state.config.key.nil? || state.config.key.empty?
+          raise ValidationError, "S3 key is required but was nil or empty for namespace '#{name}'"
+        end
+
+        {
+          s3: {
+            bucket: state.config.bucket,
+            key: state.config.key,
+            region: state.config.region,
+            dynamodb_table: state.config.lock_table,
+            encrypt: state.config.encrypt
+          }.compact
+        }
+      end
+    end
+
+    class ValidationError < StandardError; end
+  end
+end

data/lib/pangea/entities/project.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'
+
+module Pangea
+  module Entities
+    class Project < Dry::Struct
+      attribute :name, Pangea::Types::ProjectString
+      attribute :namespace, Pangea::Types::NamespaceString
+      attribute :site, Pangea::Types::SiteString.optional.default(nil)
+      attribute :description, Pangea::Types::OptionalString.default(nil)
+
+      attribute :modules, Pangea::Types::ModuleArray.default([].freeze)
+      attribute :variables, Pangea::Types::SymbolizedHash.default({}.freeze)
+      attribute :outputs, Pangea::Types::StringArray.default([].freeze)
+      attribute :depends_on, Pangea::Types::IdentifierArray.default([].freeze)
+
+      attribute :terraform_version, Pangea::Types::TerraformVersion.optional.default(nil)
+      attribute :tags, Pangea::Types::SymbolizedHash.default({}.freeze)
+
+      def full_name
+        [namespace, site, name].compact.join('.')
+      end
+
+      def state_key
+        parts = [namespace]
+        parts << site if site
+        parts << name
+        parts.join('/')
+      end
+
+      def has_modules?
+        !modules.empty?
+      end
+
+      def has_dependencies?
+        !depends_on.empty?
+      end
+
+      def module_config(module_name)
+        modules.find { |m| m == module_name }
+      end
+
+      def to_backend_config(prefix: nil)
+        key_parts = [prefix, state_key].compact
+        {
+          key: key_parts.join('/'),
+          workspace_key_prefix: "workspaces"
+        }
+      end
+
+      def validate!
+        errors = []
+
+        if depends_on.include?(name)
+          errors << "Project cannot depend on itself"
+        end
+
+        modules.each do |mod|
+          unless mod.match?(/\A[a-z][a-z0-9_-]*\z/)
+            errors << "Invalid module name: #{mod}"
+          end
+        end
+
+        raise ValidationError, errors.join(", ") unless errors.empty?
+        true
+      end
+    end
+  end
+end

data/lib/pangea/entities/template.rb

@@ -0,0 +1,103 @@
+# 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 Entities
+    class Template < Dry::Struct
+      attribute :name, Pangea::Types::Identifier
+      attribute :content, Pangea::Types::Strict::String
+      attribute :file_path, Pangea::Types::FilePath.optional.default(nil)
+
+      attribute :namespace, Pangea::Types::NamespaceString.optional.default(nil)
+      attribute :project, Pangea::Types::ProjectString.optional.default(nil)
+      attribute :variables, Pangea::Types::SymbolizedHash.default({}.freeze)
+
+      attribute :target_version, Pangea::Types::TerraformVersion.optional.default(nil)
+      attribute :strict_mode, Pangea::Types::Strict::Bool.default(false)
+
+      def source
+        file_path || "<inline:#{name}>"
+      end
+
+      def from_file?
+        !file_path.nil?
+      end
+
+      def cache_key
+        parts = [namespace, project, name].compact
+        parts.join('/')
+      end
+
+      def validate!
+        errors = []
+
+        if content.strip.empty?
+          errors << "Template content cannot be empty"
+        end
+
+        if content.include?("<%") || content.include?("{{")
+          errors << "Template appears to contain ERB or Mustache syntax (not supported)"
+        end
+
+        raise ValidationError, errors.join(", ") unless errors.empty?
+        true
+      end
+
+      def metadata
+        return {} unless content.start_with?("# @")
+
+        metadata = {}
+        content.lines.each do |line|
+          break unless line.start_with?("# @")
+
+          if line =~ /# @(\w+):\s*(.+)$/
+            key = $1.to_sym
+            value = $2.strip
+            metadata[key] = value
+          end
+        end
+
+        metadata
+      end
+
+      def content_without_metadata
+        return content unless content.start_with?("# @")
+
+        lines = content.lines
+        lines.drop_while { |line| line.start_with?("# @") }.join
+      end
+    end
+
+    class CompilationResult < Dry::Struct
+      attribute :success, Pangea::Types::Strict::Bool
+      attribute :terraform_json, Pangea::Types::Strict::String.optional.default(nil)
+      attribute :errors, Pangea::Types::StringArray.default([].freeze)
+      attribute :warnings, Pangea::Types::StringArray.default([].freeze)
+      attribute :template_name, Pangea::Types::Strict::String.optional.default(nil)
+      attribute :template_count, Pangea::Types::Strict::Integer.optional.default(nil)
+
+      def success?
+        success && errors.empty?
+      end
+
+      def failure?
+        !success?
+      end
+    end
+  end
+end

data/lib/pangea/entities.rb

@@ -0,0 +1,26 @@
+# 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 'entities/namespace'
+require_relative 'entities/project'
+require_relative 'entities/module_definition'
+require_relative 'entities/template'
+
+module Pangea
+  module Entities
+    class ValidationError < StandardError; end
+  end
+end