stactics 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 10a190f7f56568230486fd936c573f32110f9cbe7eed13c8e7263cad64b06165
+  data.tar.gz: 17910e95c4eb977cae2978d6e67ed47850455fdb0cfb1955ae1fa9f893abd0d0
+SHA512:
+  metadata.gz: 0dcb4e90d26597d7552de8b20573c3019c0e5af7c4ecd7c5cc4e11dfdefe365ed8329ade5a65da43cf5d05c078e2457fdd38ff7324103e74a54c9808840f82c5
+  data.tar.gz: 39a6570935436fd733d2377470abc9c46ede156ee52f92d1dfe6561ffd1a22ee2f22098c50f1a0b6ae8095683b4f987bc04f7fdf3e2d4e609aa3587a87ebca29

data/README.md

@@ -0,0 +1,17 @@
+# Stactics Ruby SDK
+
+Ruby client for the Stactics ingest API.
+
+```ruby
+client = Stactics::Client.new(api_key: ENV.fetch("STACTICS_SECRET_KEY"))
+
+client.track(
+  "signup",
+  user_id: "user_123",
+  email: "founder@example.com",
+  environment: "production",
+  metadata: { plan: "free" }
+)
+```
+
+Use a `sk_...` key for server-side Ruby apps.

data/lib/stactics/client.rb

@@ -0,0 +1,103 @@
+require "json"
+require "net/http"
+require "uri"
+
+module Stactics
+  class APIError < StandardError
+    attr_reader :status, :body
+
+    def initialize(status:, body:)
+      @status = status
+      @body = body
+      super(body.fetch("error", "Stactics API request failed"))
+    end
+  end
+
+  Result = Struct.new(:accepted?, :accepted_count, :body, keyword_init: true)
+
+  class Client
+    def initialize(api_key:, host: DEFAULT_HOST, timeout: 5, transport: nil)
+      raise ArgumentError, "api_key is required" if api_key.to_s.strip.empty?
+
+      @api_key = api_key
+      @host = host.to_s.delete_suffix("/")
+      @timeout = timeout
+      @transport = transport || method(:perform_request)
+    end
+
+    def track(event_type, attributes = {})
+      payload = stringify_keys(attributes).merge("event_type" => event_type.to_s)
+      request("/v1/events", payload)
+    end
+
+    def batch(events)
+      payload = { "events" => events.map { |event| stringify_keys(event) } }
+      request("/v1/events/batch", payload)
+    end
+
+    private
+
+    def request(path, payload)
+      response = @transport.call(
+        path: path,
+        payload: payload,
+        headers: headers,
+        timeout: @timeout
+      )
+      body = parse_json(response.body)
+      status = response.code.to_i
+      raise APIError.new(status: status, body: body) unless status.between?(200, 299)
+
+      Result.new(
+        accepted?: body.fetch("accepted", false),
+        accepted_count: body.fetch("accepted_count", 0),
+        body: body
+      )
+    end
+
+    def perform_request(path:, payload:, headers:, timeout:)
+      uri = URI("#{@host}#{path}")
+      request = Net::HTTP::Post.new(uri, headers)
+      request.body = JSON.generate(payload)
+
+      Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https", read_timeout: timeout, open_timeout: timeout) do |http|
+        http.request(request)
+      end
+    end
+
+    def headers
+      {
+        "Authorization" => "Bearer #{@api_key}",
+        "Content-Type" => "application/json",
+        "User-Agent" => "stactics-ruby/#{VERSION}"
+      }
+    end
+
+    def parse_json(raw_body)
+      JSON.parse(raw_body.to_s)
+    rescue JSON::ParserError
+      {}
+    end
+
+    def stringify_keys(value)
+      case value
+      when Hash
+        value.each_with_object({}) do |(key, nested_value), memo|
+          memo[camel_or_symbol_to_snake(key)] = stringify_keys(nested_value)
+        end
+      when Array
+        value.map { |item| stringify_keys(item) }
+      else
+        value
+      end
+    end
+
+    def camel_or_symbol_to_snake(key)
+      key.to_s
+         .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+         .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+         .tr("-", "_")
+         .downcase
+    end
+  end
+end

data/lib/stactics/version.rb

@@ -0,0 +1,3 @@
+module Stactics
+  VERSION = "0.1.0"
+end

data/lib/stactics.rb

@@ -0,0 +1,6 @@
+require_relative "stactics/client"
+require_relative "stactics/version"
+
+module Stactics
+  DEFAULT_HOST = "https://api.stactics.io"
+end

metadata

@@ -0,0 +1,47 @@
+--- !ruby/object:Gem::Specification
+name: stactics
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nexu Industries
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-05-17 00:00:00.000000000 Z
+dependencies: []
+description: Track analytics events from Ruby and Rails apps with Stactics.
+email:
+- support@stactics.app
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/stactics.rb
+- lib/stactics/client.rb
+- lib/stactics/version.rb
+homepage: https://github.com/nexuindustries/stactics-sdks
+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.3.26
+signing_key:
+specification_version: 4
+summary: Ruby SDK for the Stactics ingest API
+test_files: []