ngrok-api 0.15.0 → 0.18.0

data/lib/ngrokapi/services/{endpoint_webhook_validation_module_client.rb → edge_route_webhook_verification_module_client.rb}

@@ -3,10 +3,10 @@
 module NgrokAPI
   module Services
     ##
-    # https://ngrok.com/docs/api#api-endpoint-webhook-validation-module
-    class EndpointWebhookValidationModuleClient
+    # https://ngrok.com/docs/api#api-edge-route-webhook-verification-module
+    class EdgeRouteWebhookVerificationModuleClient
       # The API path for the requests
-      PATH = '/endpoint_configurations/%{id}/webhook_validation'
+      PATH = '/edges/https/%{edge_id}/routes/%{id}/webhook_verification'
 
       attr_reader :client
 
@@ -15,17 +15,16 @@ module NgrokAPI
       end
 
       ##
+      # @param [string] edge_id
       # @param [string] id
       # @param [EndpointWebhookValidation] a_module
       # @return [NgrokAPI::Models::EndpointWebhookValidation] result from the API request
       #
-      # https://ngrok.com/docs/api#api-endpoint-webhook-validation-module-replace
-      def replace(
-        id: "",
-        a_module: nil
-      )
-        path = '/endpoint_configurations/%{id}/webhook_validation'
+      # https://ngrok.com/docs/api#api-edge-route-webhook-verification-module-replace
+      def replace(edge_id: "", id: "", a_module: nil)
+        path = '/edges/https/%{edge_id}/routes/%{id}/webhook_verification'
         replacements = {
+          edge_id: edge_id,
           id: id,
         }
         data = {}
@@ -35,17 +34,16 @@ module NgrokAPI
       end
 
       ##
+      # @param [string] edge_id
       # @param [string] id
       # @param [EndpointWebhookValidation] a_module
       # @return [NgrokAPI::Models::EndpointWebhookValidation] result from the API request
       #
-      # https://ngrok.com/docs/api#api-endpoint-webhook-validation-module-replace
-      def replace!(
-        id: "",
-        a_module: nil
-      )
-        path = '/endpoint_configurations/%{id}/webhook_validation'
+      # https://ngrok.com/docs/api#api-edge-route-webhook-verification-module-replace
+      def replace!(edge_id: "", id: "", a_module: nil)
+        path = '/edges/https/%{edge_id}/routes/%{id}/webhook_verification'
         replacements = {
+          edge_id: edge_id,
           id: id,
         }
         data = {}
@@ -55,15 +53,15 @@ module NgrokAPI
       end
 
       ##
-      # @param [string] id a resource identifier
+      # @param [string] edge_id unique identifier of this edge
+      # @param [string] id unique identifier of this edge route
       # @return [NgrokAPI::Models::EndpointWebhookValidation] result from the API request
       #
-      # https://ngrok.com/docs/api#api-endpoint-webhook-validation-module-get
-      def get(
-        id: ""
-      )
-        path = '/endpoint_configurations/%{id}/webhook_validation'
+      # https://ngrok.com/docs/api#api-edge-route-webhook-verification-module-get
+      def get(edge_id: "", id: "")
+        path = '/edges/https/%{edge_id}/routes/%{id}/webhook_verification'
         replacements = {
+          edge_id: edge_id,
           id: id,
         }
         data = {}
@@ -72,15 +70,15 @@ module NgrokAPI
       end
 
       ##
-      # @param [string] id a resource identifier
+      # @param [string] edge_id unique identifier of this edge
+      # @param [string] id unique identifier of this edge route
       # @return [NgrokAPI::Models::EndpointWebhookValidation] result from the API request
       #
-      # https://ngrok.com/docs/api#api-endpoint-webhook-validation-module-get
-      def get!(
-        id: ""
-      )
-        path = '/endpoint_configurations/%{id}/webhook_validation'
+      # https://ngrok.com/docs/api#api-edge-route-webhook-verification-module-get
+      def get!(edge_id: "", id: "")
+        path = '/edges/https/%{edge_id}/routes/%{id}/webhook_verification'
         replacements = {
+          edge_id: edge_id,
           id: id,
         }
         data = {}
@@ -89,30 +87,30 @@ module NgrokAPI
       end
 
       ##
-      # @param [string] id a resource identifier
+      # @param [string] edge_id unique identifier of this edge
+      # @param [string] id unique identifier of this edge route
       # @return [NgrokAPI::Models::Empty] result from the API request
       #
-      # https://ngrok.com/docs/api#api-endpoint-webhook-validation-module-delete
-      def delete(
-        id: ""
-      )
-        path = '/endpoint_configurations/%{id}/webhook_validation'
+      # https://ngrok.com/docs/api#api-edge-route-webhook-verification-module-delete
+      def delete(edge_id: "", id: "")
+        path = '/edges/https/%{edge_id}/routes/%{id}/webhook_verification'
         replacements = {
+          edge_id: edge_id,
           id: id,
         }
         @client.delete(path % replacements)
       end
 
       ##
-      # @param [string] id a resource identifier
+      # @param [string] edge_id unique identifier of this edge
+      # @param [string] id unique identifier of this edge route
       # @return [NgrokAPI::Models::Empty] result from the API request
       #
-      # https://ngrok.com/docs/api#api-endpoint-webhook-validation-module-delete
-      def delete!(
-        id: ""
-      )
-        path = '/endpoint_configurations/%{id}/webhook_validation'
+      # https://ngrok.com/docs/api#api-edge-route-webhook-verification-module-delete
+      def delete!(edge_id: "", id: "")
+        path = '/edges/https/%{edge_id}/routes/%{id}/webhook_verification'
         replacements = {
+          edge_id: edge_id,
           id: id,
         }
         @client.delete(path % replacements, danger: true)

data/lib/ngrokapi/services/edge_route_websocket_tcp_converter_module_client.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+module NgrokAPI
+  module Services
+    ##
+    # https://ngrok.com/docs/api#api-edge-route-websocket-tcp-converter-module
+    class EdgeRouteWebsocketTCPConverterModuleClient
+      # The API path for the requests
+      PATH = '/edges/https/%{edge_id}/routes/%{id}/websocket_tcp_converter'
+
+      attr_reader :client
+
+      def initialize(client:)
+        @client = client
+      end
+
+      ##
+      # @param [string] edge_id
+      # @param [string] id
+      # @param [EndpointWebsocketTCPConverter] a_module
+      # @return [NgrokAPI::Models::EndpointWebsocketTCPConverter] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edge-route-websocket-tcp-converter-module-replace
+      def replace(edge_id: "", id: "", a_module: nil)
+        path = '/edges/https/%{edge_id}/routes/%{id}/websocket_tcp_converter'
+        replacements = {
+          edge_id: edge_id,
+          id: id,
+        }
+        data = {}
+        data[:module] = a_module if a_module
+        result = @client.put(path % replacements, data: data)
+        NgrokAPI::Models::EndpointWebsocketTCPConverter.new(client: self, result: result)
+      end
+
+      ##
+      # @param [string] edge_id
+      # @param [string] id
+      # @param [EndpointWebsocketTCPConverter] a_module
+      # @return [NgrokAPI::Models::EndpointWebsocketTCPConverter] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edge-route-websocket-tcp-converter-module-replace
+      def replace!(edge_id: "", id: "", a_module: nil)
+        path = '/edges/https/%{edge_id}/routes/%{id}/websocket_tcp_converter'
+        replacements = {
+          edge_id: edge_id,
+          id: id,
+        }
+        data = {}
+        data[:module] = a_module if a_module
+        result = @client.put(path % replacements, data: data, danger: true)
+        NgrokAPI::Models::EndpointWebsocketTCPConverter.new(client: self, result: result)
+      end
+
+      ##
+      # @param [string] edge_id unique identifier of this edge
+      # @param [string] id unique identifier of this edge route
+      # @return [NgrokAPI::Models::EndpointWebsocketTCPConverter] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edge-route-websocket-tcp-converter-module-get
+      def get(edge_id: "", id: "")
+        path = '/edges/https/%{edge_id}/routes/%{id}/websocket_tcp_converter'
+        replacements = {
+          edge_id: edge_id,
+          id: id,
+        }
+        data = {}
+        result = @client.get(path % replacements, data: data)
+        NgrokAPI::Models::EndpointWebsocketTCPConverter.new(client: self, result: result)
+      end
+
+      ##
+      # @param [string] edge_id unique identifier of this edge
+      # @param [string] id unique identifier of this edge route
+      # @return [NgrokAPI::Models::EndpointWebsocketTCPConverter] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edge-route-websocket-tcp-converter-module-get
+      def get!(edge_id: "", id: "")
+        path = '/edges/https/%{edge_id}/routes/%{id}/websocket_tcp_converter'
+        replacements = {
+          edge_id: edge_id,
+          id: id,
+        }
+        data = {}
+        result = @client.get(path % replacements, data: data, danger: true)
+        NgrokAPI::Models::EndpointWebsocketTCPConverter.new(client: self, result: result)
+      end
+
+      ##
+      # @param [string] edge_id unique identifier of this edge
+      # @param [string] id unique identifier of this edge route
+      # @return [NgrokAPI::Models::Empty] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edge-route-websocket-tcp-converter-module-delete
+      def delete(edge_id: "", id: "")
+        path = '/edges/https/%{edge_id}/routes/%{id}/websocket_tcp_converter'
+        replacements = {
+          edge_id: edge_id,
+          id: id,
+        }
+        @client.delete(path % replacements)
+      end
+
+      ##
+      # @param [string] edge_id unique identifier of this edge
+      # @param [string] id unique identifier of this edge route
+      # @return [NgrokAPI::Models::Empty] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edge-route-websocket-tcp-converter-module-delete
+      def delete!(edge_id: "", id: "")
+        path = '/edges/https/%{edge_id}/routes/%{id}/websocket_tcp_converter'
+        replacements = {
+          edge_id: edge_id,
+          id: id,
+        }
+        @client.delete(path % replacements, danger: true)
+      end
+    end
+  end
+end

data/lib/ngrokapi/services/edges_https_client.rb

@@ -0,0 +1,227 @@
+# frozen_string_literal: true
+
+module NgrokAPI
+  module Services
+    ##
+    # https://ngrok.com/docs/api#api-edges-https
+    class EdgesHTTPSClient
+      # The API path for the requests
+      PATH = '/edges/https'
+      # The List Property from the resulting API for list calls
+      LIST_PROPERTY = 'https_edges'
+
+      attr_reader :client
+
+      def initialize(client:)
+        @client = client
+      end
+
+      ##
+      # Create an HTTPS Edge
+      #
+      # @param [string] description human-readable description of what this edge will be used for; optional, max 255 bytes.
+      # @param [string] metadata arbitrary user-defined machine-readable data of this edge; optional, max 4096 bytes.
+      # @param [List<string>] hostports hostports served by this edge
+      # @param [EndpointMutualTLSMutate] mutual_tls edge modules
+      # @param [EndpointTLSTerminationAtEdge] tls_termination
+      # @return [NgrokAPI::Models::HTTPSEdge] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-https-create
+      def create(description: "", metadata: "", hostports: nil, mutual_tls: nil, tls_termination: nil)
+        path = '/edges/https'
+        replacements = {
+        }
+        data = {}
+        data[:description] = description if description
+        data[:metadata] = metadata if metadata
+        data[:hostports] = hostports if hostports
+        data[:mutual_tls] = mutual_tls if mutual_tls
+        data[:tls_termination] = tls_termination if tls_termination
+        result = @client.post(path % replacements, data: data)
+        NgrokAPI::Models::HTTPSEdge.new(client: self, result: result)
+      end
+
+      ##
+      # Get an HTTPS Edge by ID
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::HTTPSEdge] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-https-get
+      def get(id: "")
+        path = '/edges/https/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        result = @client.get(path % replacements, data: data)
+        NgrokAPI::Models::HTTPSEdge.new(client: self, result: result)
+      end
+
+      ##
+      # Get an HTTPS Edge by ID
+      # Throws an exception if API error.
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::HTTPSEdge] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-https-get
+      def get!(id: "")
+        path = '/edges/https/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        result = @client.get(path % replacements, data: data, danger: true)
+        NgrokAPI::Models::HTTPSEdge.new(client: self, result: result)
+      end
+
+      ##
+      # Returns a list of all HTTPS Edges on this account
+      #
+      # @param [string] before_id
+      # @param [string] limit
+      # @param [string] url optional and mutually exclusive from before_id and limit
+      # @return [NgrokAPI::Models::Listable] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-https-list
+      def list(before_id: nil, limit: nil,
+               url: nil)
+        result = @client.list(
+          before_id: before_id,
+          limit: limit,
+          url: url,
+          path: PATH
+        )
+
+        NgrokAPI::Models::Listable.new(
+          client: self,
+          result: result,
+          list_property: LIST_PROPERTY,
+          klass: NgrokAPI::Models::HTTPSEdge
+        )
+      end
+
+      ##
+      # Returns a list of all HTTPS Edges on this account
+      # Throws an exception if API error.
+      #
+      # @param [string] before_id
+      # @param [string] limit
+      # @param [string] url optional and mutually exclusive from before_id and limit
+      # @return [NgrokAPI::Models::Listable] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-https-list
+      def list!(before_id: nil, limit: nil,
+                url: nil)
+        result = @client.list(
+          before_id: before_id,
+          limit: limit,
+          danger: true,
+          url: url,
+          path: PATH
+        )
+
+        NgrokAPI::Models::Listable.new(
+          client: self,
+          result: result,
+          list_property: LIST_PROPERTY,
+          klass: NgrokAPI::Models::HTTPSEdge,
+          danger: true
+        )
+      end
+
+      ##
+      # Updates an HTTPS Edge by ID. If a module is not specified in the update, it will
+      # not be modified. However, each module configuration that is specified will
+      # completely replace the existing value. There is no way to delete an existing
+      # module via this API, instead use the delete module API.
+      #
+      # @param [string] id unique identifier of this edge
+      # @param [string] description human-readable description of what this edge will be used for; optional, max 255 bytes.
+      # @param [string] metadata arbitrary user-defined machine-readable data of this edge; optional, max 4096 bytes.
+      # @param [List<string>] hostports hostports served by this edge
+      # @param [EndpointMutualTLSMutate] mutual_tls edge modules
+      # @param [EndpointTLSTerminationAtEdge] tls_termination
+      # @return [NgrokAPI::Models::HTTPSEdge] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-https-update
+      def update(id: "", description: nil, metadata: nil, hostports: nil, mutual_tls: nil, tls_termination: nil)
+        path = '/edges/https/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        data[:description] = description if description
+        data[:metadata] = metadata if metadata
+        data[:hostports] = hostports if hostports
+        data[:mutual_tls] = mutual_tls if mutual_tls
+        data[:tls_termination] = tls_termination if tls_termination
+        result = @client.patch(path % replacements, data: data)
+        NgrokAPI::Models::HTTPSEdge.new(client: self, result: result)
+      end
+
+      ##
+      # Updates an HTTPS Edge by ID. If a module is not specified in the update, it will
+      # not be modified. However, each module configuration that is specified will
+      # completely replace the existing value. There is no way to delete an existing
+      # module via this API, instead use the delete module API.
+      # Throws an exception if API error.
+      #
+      # @param [string] id unique identifier of this edge
+      # @param [string] description human-readable description of what this edge will be used for; optional, max 255 bytes.
+      # @param [string] metadata arbitrary user-defined machine-readable data of this edge; optional, max 4096 bytes.
+      # @param [List<string>] hostports hostports served by this edge
+      # @param [EndpointMutualTLSMutate] mutual_tls edge modules
+      # @param [EndpointTLSTerminationAtEdge] tls_termination
+      # @return [NgrokAPI::Models::HTTPSEdge] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-https-update
+      def update!(id: "", description: nil, metadata: nil, hostports: nil, mutual_tls: nil, tls_termination: nil)
+        path = '/edges/https/%{id}'
+        replacements = {
+          id: id,
+        }
+        data = {}
+        data[:description] = description if description
+        data[:metadata] = metadata if metadata
+        data[:hostports] = hostports if hostports
+        data[:mutual_tls] = mutual_tls if mutual_tls
+        data[:tls_termination] = tls_termination if tls_termination
+        result = @client.patch(path % replacements, data: data, danger: true)
+        NgrokAPI::Models::HTTPSEdge.new(client: self, result: result)
+      end
+
+      ##
+      # Delete an HTTPS Edge by ID
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::Empty] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-https-delete
+      def delete(id: "")
+        path = '/edges/https/%{id}'
+        replacements = {
+          id: id,
+        }
+        @client.delete(path % replacements)
+      end
+
+      ##
+      # Delete an HTTPS Edge by ID
+      # Throws an exception if API error.
+      #
+      # @param [string] id a resource identifier
+      # @return [NgrokAPI::Models::Empty] result from the API request
+      #
+      # https://ngrok.com/docs/api#api-edges-https-delete
+      def delete!(id: "")
+        path = '/edges/https/%{id}'
+        replacements = {
+          id: id,
+        }
+        @client.delete(path % replacements, danger: true)
+      end
+    end
+  end
+end