Feature: add PuppetServerV3 (#7)

Author: zaben903

README.md

@@ -19,6 +19,7 @@ Supported endpoints:
 - Activity v1 and v2
 - Metrics v1 and v2
 - Puppet Admin v1
+- Puppet Server v3
 
 ## Installation
 Install the gem and add to the application's Gemfile by executing:

lib/pe_client/client.rb

@@ -190,6 +190,12 @@ def puppet_admin_v1
       @puppet_admin_v1 ||= Resource::PuppetAdminV1.new(self)
     end
 
+    # @return [Resource::PuppetServerV3]
+    def puppet_server_v3
+      require_relative "resources/puppet_server.v3"
+      @puppet_server_v3 ||= Resource::PuppetServerV3.new(self)
+    end
+
     private
 
     # Handle HTTP response

lib/pe_client/resources/puppet_server.v3.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Perforce Software Inc.
+#
+# 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 "base_with_port"
+
+module PEClient
+  module Resource
+    # Server-specific Puppet API endpoints.
+    #
+    # @see https://help.puppet.com/core/current/Content/PuppetCore/server/http_api/puppet-api/v3/environment_classes.htm
+    # @see https://help.puppet.com/core/current/Content/PuppetCore/server/http_api/puppet-api/v3/environment_modules.htm
+    # @see https://help.puppet.com/core/current/Content/PuppetCore/server/http_api/puppet-api/v3/static_file_content.htm
+    class PuppetServerV3 < BaseWithPort
+      # The base path for Puppet Server API v3 endpoints.
+      BASE_PATH = "/puppet/v3"
+
+      # Default Puppet Server API Port
+      PORT = 8140
+
+      # The environment classes API serves as a replacement for the Puppet resource type API for classes, which was removed in Puppet.
+      #
+      # @param environment [String] The environment to query.
+      #
+      # @return [Hash]
+      def environment_classes(environment:)
+        @client.get "#{BASE_PATH}/environment_classes", params: {environment:}
+      end
+
+      # The environment modules API returns information about what modules are installed for the requested environment.
+      #
+      # @param environment [String] The environment to query.
+      #
+      # @return [Array<Hash>, Hash]
+      def environment_modules(environment: nil)
+        @client.get "#{BASE_PATH}/environment_modules", params: {environment:}.compact
+      end
+
+      # The static_file_content endpoint returns the standard output of a `code-content-command` script, which should output the contents of a specific version of a `file resource` that has a source attribute with a `puppet:///` URI value.
+      # That source must be a file from the files or tasks directory of a module in a specific environment.
+      #
+      # @param file_path [String] The path corresponds to the requested file's path on the Server relative to the given environment's root directory, and must point to a file in the */*/files/**, */*/lib/**, */*/scripts/**, or */*/tasks/** glob.
+      #
+      # @return [String]
+      def static_file_content(file_path:)
+        @client.get File.join("#{BASE_PATH}/static_file_content", file_path)
+      end
+    end
+  end
+end

sig/pe_client/client.rbs

@@ -37,6 +37,8 @@ module PEClient
     def metrics_v2: -> Resource::MetricsV2
     @puppet_admin_v1: Resource::PuppetAdminV1
     def puppet_admin_v1: -> Resource::PuppetAdminV1
+    @puppet_server_v3: Resource::PuppetServerV3
+    def puppet_server_v3: -> Resource::PuppetServerV3
 
     # Private methods
     def handle_response: (Faraday::Response) -> (Hash[String, untyped] | Array[untyped] | String)

sig/pe_client/resource/puppet_server.v3.rbs

@@ -0,0 +1,13 @@
+module PEClient
+  module Resource
+    class PuppetServerV3 < BaseWithPort
+      BASE_PATH: String
+      PORT: Integer
+
+      def environment_classes: (environment: String) -> Hash[String, untyped]
+      def environment_modules: (?environment: nil) -> Array[Hash[String, untyped]]
+                             | (environment: String) -> Hash[String, untyped]
+      def static_file_content: (file_path: String) -> String
+    end
+  end
+end

spec/pe_client/client_spec.rb

@@ -423,5 +423,18 @@
         expect(resource1).to equal(resource2)
       end
     end
+
+    describe "#puppet_server_v3" do
+      it "returns a PuppetServerV3 resource" do
+        resource = client.puppet_server_v3
+        expect(resource).to be_a(PEClient::Resource::PuppetServerV3)
+      end
+
+      it "memorizes the resource" do
+        resource1 = client.puppet_server_v3
+        resource2 = client.puppet_server_v3
+        expect(resource1).to equal(resource2)
+      end
+    end
   end
 end