salopulse 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 508b79a0d71e8bf74c4c743df633f4c78d54607acf341587bcb6a29eeeb7f0c8
+  data.tar.gz: 9b27e52989cebcdaa7f6b48f4b9b758422c362c1e91fc3f93e35e3c26e06030f
+SHA512:
+  metadata.gz: 9c6dd7aabc843b88d157244c9479ef89786d4efcf20c4b0db7330b596b259a5c9ede75e9bf491ed0e29459d60580d516794303274b97a99f8ebdc89159214278
+  data.tar.gz: 760dc6b01a270fcf26ee5e90a8ad1c60fbb7951168baa1bb9caf654526d7ea6ab3e2d1b09c84bcf5368962707c60530a2bf5b1ec13620bf9ba070571112b73a7

data/LICENSE

@@ -0,0 +1,28 @@
+
+---
+
+# 📄 **3. `LICENSE`
+
+```text
+MIT License
+
+Copyright (c) 2025 Salo Company
+All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights  
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell  
+copies of the Software, and to permit persons to whom the Software is  
+furnished to do so, subject to the following conditions:  
+
+The above copyright notice and this permission notice shall be included in  
+all copies or substantial portions of the Software.  
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR  
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,  
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE  
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER  
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,  
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN  
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,26 @@
+# SaloPulse Ruby SDK
+
+SaloPulse Ruby SDK, Ruby ve Ruby on Rails projeleri için geliştirilmiş hafif ve modern bir **monitoring & analytics entegrasyon kütüphanesidir**.
+
+Bu SDK, uygulamanızdaki her HTTP isteğini otomatik olarak izler, performans ölçer ve verileri **SaloPulse Observability Platformu**na güvenli bir şekilde iletir.
+
+---
+
+## 🚀 Özellikler
+
+- Otomatik request yakalama (middleware)
+- Path, method, status, response time ölçümü
+- IP & User-Agent toplama
+- API key tabanlı güvenli kimliklendirme
+- SaloPulse backend’e JSON gönderimi
+- Non-blocking – uygulamanızı hiçbir zaman bozmaz
+- Production-ready – enterprise sistemler için uygundur
+
+---
+
+## 📦 Kurulum
+
+### 1. Gem ekle
+
+```ruby
+gem "salopulse"

data/lib/salopulse/client.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'uri'
+require 'json'
+
+module SaloPulse
+  class Client
+    class << self
+      def send_event(payload)
+        config = SaloPulse.config
+
+        return unless config.valid?
+
+        uri = URI.parse(config.endpoint)
+
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl      = uri.scheme == 'https'
+        http.read_timeout = config.timeout
+        http.open_timeout = config.timeout
+
+        request = Net::HTTP::Post.new(uri.request_uri)
+        request['Content-Type'] = 'application/json'
+        request['Accept']       = 'application/json'
+
+        body = payload.merge(
+          api_key: config.api_key,
+          environment: config.environment
+        )
+
+        request.body = JSON.generate(body)
+
+        http.request(request)
+      rescue StandardError => e
+        log_error(e)
+        nil
+      end
+
+      private
+
+      def log_error(error)
+        message = "[SaloPulse] Failed to send event: #{error.class}: #{error.message}"
+
+        if defined?(Rails)
+          Rails.logger.debug(message)
+        else
+          warn(message)
+        end
+      end
+    end
+  end
+end

data/lib/salopulse/configuration.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module SaloPulse
+  class Configuration
+    attr_accessor :api_key, :environment, :endpoint, :timeout, :enabled
+
+    def initialize
+      @api_key      = ENV['SALO_PULSE_API_KEY']
+      @environment  = ENV['RAILS_ENV'] || ENV['RACK_ENV'] || 'development'
+      @endpoint     = ENV['SALO_PULSE_ENDPOINT'] || 'https://api.salopulse.com/v1/ingest'
+      @timeout      = 1.0
+      @enabled      = true
+    end
+
+    def valid?
+      @enabled && @api_key && !@api_key.strip.empty?
+    end
+  end
+end

data/lib/salopulse/middleware.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require 'rack'
+require 'time'
+
+module SaloPulse
+  class Middleware
+    def initialize(app)
+      @app = app
+    end
+
+    def call(env)
+      start_monotonic = monotonic_time
+
+      status, headers, body = @app.call(env)
+
+      duration_ms = ((monotonic_time - start_monotonic) * 1000.0).round(2)
+
+      begin
+        event = build_event(env, status, duration_ms)
+        SaloPulse::Client.send_event(event) if event
+      rescue StandardError => e
+        log_middleware_error(e)
+      end
+
+      [status, headers, body]
+    end
+
+    private
+
+    def monotonic_time
+      Process.clock_gettime(Process::CLOCK_MONOTONIC)
+    end
+
+    def build_event(env, status, duration_ms)
+      req = Rack::Request.new(env)
+
+      {
+        path: req.path,
+        method: req.request_method,
+        status: status,
+        duration_ms: duration_ms,
+        ip: extract_ip(env, req),
+        user_agent: env['HTTP_USER_AGENT'],
+        occurred_at: Time.now.utc.iso8601
+      }
+    end
+
+    def extract_ip(env, req)
+      if env['action_dispatch.remote_ip']
+        env['action_dispatch.remote_ip'].to_s
+      elsif req.respond_to?(:ip)
+        req.ip
+      else
+        env['REMOTE_ADDR']
+      end
+    end
+
+    def log_middleware_error(error)
+      message = "[SaloPulse] Middleware error: #{error.class}: #{error.message}"
+
+      if defined?(Rails)
+        Rails.logger.debug(message)
+      else
+        warn(message)
+      end
+    end
+  end
+end

data/lib/salopulse.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require "salopulse/version"
+require "salopulse/configuration"
+require "salopulse/client"
+require "salopulse/middleware"
+
+module SaloPulse
+  class << self
+    def configure
+      yield config
+    end
+
+    def config
+      @config ||= Configuration.new
+    end
+  end
+end

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification
+name: salopulse
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Salih İmran Büker
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: net-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: SaloPulse Ruby SDK provides automatic request tracking, performance measurement,
+  and real-time analytics integration for Rails apps. It captures HTTP traffic and
+  sends metrics to the SaloPulse Observability Platform.
+email:
+- info@salopulse.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/salopulse.rb
+- lib/salopulse/client.rb
+- lib/salopulse/configuration.rb
+- lib/salopulse/middleware.rb
+homepage: https://github.com/mersies/salopulse-sdk-ruby
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: SaloPulse Ruby SDK – Lightweight monitoring and request analytics for Rails
+  applications.
+test_files: []