outpunch-rails 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a26df1916a7b588561507c63bf92ff1a37f5514177cc5f20b5b452dfce87dff1
+  data.tar.gz: c5938d675495f16c91141723d47307dc5f15929c467bd2a1ca3aa29cf12a76aa
+SHA512:
+  metadata.gz: f92c995d5c61514dfba82aea81282e54af8fbbe92a4e218247b43673413b6dc85387317019ff2bc8e0d2271f041ba1b0f3c0eb9864b25c210755530e54342b2e
+  data.tar.gz: e81584f3cf84df13e5f5bf4b3bc166ca30e6a21251631f1aaf9920bff8c80cc910bdb87212abf5a50d8721fed37b9b586f0a230b1af2d6bc2c83afedda3f74fb

data/app/controllers/outpunch/tunnel_controller.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+class Outpunch::TunnelController < OutpunchRails.configuration.base_controller.constantize
+  skip_before_action :verify_authenticity_token, raise: false
+
+  def proxy
+    service_name = params[:service_name]
+    service_path = params[:service_path] || ""
+
+    return render_error(400, "Service name required") if service_name.blank?
+
+    if (auth = OutpunchRails.configuration.authorize_service)
+      unless auth.call(service_name, request)
+        return render_error(403, "Service '#{service_name}' not allowed for this product")
+      end
+    end
+
+    unless OutpunchRails.connected?(service_name)
+      return render_error(502, "Service '#{service_name}' offline")
+    end
+
+    request_id = SecureRandom.uuid
+    payload = {
+      request_id: request_id,
+      method: request.method,
+      path: service_path,
+      query: request.query_parameters,
+      headers: OutpunchRails.extract_proxy_headers(request.headers),
+      body: request.body&.read || ""
+    }
+
+    run_hook(:before_proxy, service_name, service_path, payload)
+
+    response_data = OutpunchRails.handle_request(
+      service: service_name,
+      method: payload[:method],
+      path: payload[:path],
+      query: payload[:query],
+      headers: payload[:headers],
+      body: payload[:body]
+    )
+    result = OutpunchRails.success_response(response_data)
+
+    run_hook(:after_proxy, service_name, service_path, payload, result: result)
+
+    render_tunnel_result(result)
+  rescue Timeout::Error
+    render_error(504, "Tunnel timeout for service '#{params[:service_name]}'")
+  rescue => e
+    render_error(502, e.message)
+  end
+
+  private
+
+  def run_hook(type, service_name, path, payload, extra = {})
+    hooks = OutpunchRails.configuration.hooks
+    return unless hooks
+
+    case type
+    when :before_proxy
+      hooks.before_proxy(service_name: service_name, path: path, payload: payload, request: request)
+    when :after_proxy
+      hooks.after_proxy(service_name: service_name, path: path, payload: payload, request: request, **extra)
+    end
+  end
+
+  def render_tunnel_result(result)
+    if result[:body_encoding] == "base64"
+      content_disposition = result[:headers]["content-disposition"] || "attachment"
+      disposition = content_disposition.start_with?("attachment") ? "attachment" : "inline"
+      filename = content_disposition[/filename="?([^";]+)"?/, 1]
+
+      send_data result[:body],
+                type: result[:headers]["content-type"] || "application/octet-stream",
+                disposition: disposition,
+                filename: filename,
+                status: result[:status]
+    else
+      result[:headers]&.each { |key, value| response.set_header(key, value) }
+      render body: result[:body], status: result[:status]
+    end
+  end
+
+  def render_error(status, message)
+    result = OutpunchRails.error_response(status, message)
+    render json: JSON.parse(result[:body]), status: result[:status]
+  end
+end

data/lib/outpunch/rails/engine.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Outpunch
+  module Rails
+    class Engine < ::Rails::Engine
+      initializer "outpunch_rails.insert_middleware" do |app|
+        app.middleware.insert_before 0, Outpunch::Rack::Middleware
+      end
+
+      initializer "outpunch_rails.routes" do
+        prefix = OutpunchRails.configuration.route_prefix
+        ::Rails.application.routes.prepend do
+          match "#{prefix}/:service_name/*service_path", to: "outpunch/tunnel#proxy", via: :all
+          match "#{prefix}/:service_name",               to: "outpunch/tunnel#proxy", via: :all
+        end
+      end
+    end
+  end
+end

data/lib/outpunch/rails/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Outpunch
+  module Rails
+    VERSION = "0.1.2"
+  end
+end

data/lib/outpunch/rails.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require "outpunch/rack"
+require "outpunch/rails/version"
+require "outpunch/rails/engine"
+
+# OutpunchRails — thin Rails wrapper around OutpunchRack.
+#
+# Usage in config/initializers/outpunch.rb:
+#
+#   OutpunchRails.configure do |config|
+#     config.secret  = ENV['MORDOR_TUNNEL_SECRET']
+#     config.timeout = 60
+#   end
+#
+module OutpunchRails
+  class << self
+    def configure(&block)
+      Outpunch::Rack.configure(&block)
+    end
+
+    def configuration
+      Outpunch::Rack.configuration
+    end
+
+    def hooks
+      Outpunch::Rack.configuration.hooks
+    end
+
+    def server
+      Outpunch::Rack.server
+    end
+
+    # Convenience delegates so application code only needs to reference OutpunchRails.
+
+    def connected?(service_name)
+      Outpunch::Rack.connected?(service_name)
+    end
+
+    def handle_request(**kwargs)
+      Outpunch::Rack.handle_request(**kwargs)
+    end
+
+    def success_response(data)
+      Outpunch::Rack.success_response(data)
+    end
+
+    def error_response(status, message)
+      Outpunch::Rack.error_response(status, message)
+    end
+
+    def extract_proxy_headers(headers)
+      Outpunch::Rack.extract_proxy_headers(headers)
+    end
+  end
+end

data/lib/outpunch.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require "outpunch/rails"

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: outpunch-rails
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: ruby
+authors:
+- TechyCorp
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-04-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: outpunch-rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7.0'
+description:
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- app/controllers/outpunch/tunnel_controller.rb
+- lib/outpunch.rb
+- lib/outpunch/rails.rb
+- lib/outpunch/rails/engine.rb
+- lib/outpunch/rails/version.rb
+homepage:
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Rails Engine adapter for the outpunch reverse WebSocket tunnel
+test_files: []