mbuzz 0.6.6 → 0.6.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ea1fdea339cb1fef16425236d55c76bfd987a197f55d9262e43c18ccea24fcb
-  data.tar.gz: c6f65a334a2bf5235275d00a6e887e1f08773c2e5716f104c33b43fea5ba66cd
+  metadata.gz: 0f4cc2a9e5dd77624d8c645e32752658da3ba5ce9464ade31c55571c96abd060
+  data.tar.gz: c26d4c8262ba89782b429e685d082c38688dea435ecb35cfb861ec7c97173b3b
 SHA512:
-  metadata.gz: 6500201afc07182c1fadc0d229c5ff30a53034cfa0823037bfaca09b62e9e5c202213a57779524f4731b158d2c134ba87ec8637a2e289026f8f57e8b9d951709
-  data.tar.gz: e888f57e931d43399c06640a7b9f7f2a497fe0d690dc7e56bf6138278c2f9754e9a4a1a8d98282814ef3a37aa75fd4829dda5704bc19f58334d196a60326f8c7
+  metadata.gz: 28ad02efc0768a343e259f7beb5828974fc8c818073f46e2f37d36b85e813806f158d66a3d2890aa208ba501b2236c06e863201b4297d3c4266f404cf138eabd
+  data.tar.gz: c410f3fa9c054560f14578c5618af4735359a793b63ecf3435e33653eeaa7ad13624003d9e00ca874660443ed1eb32bbec63ba2c40ec6a4ca45866b6263dc6e5

data/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.8] - 2025-12-30
+
+### Added
+
+- **Server-side session resolution support** - SDK now forwards `ip` and `user_agent` to the API for server-side session identification
+- `ip` and `user_agent` parameters on `Mbuzz::Client.track()`
+- `RequestContext#ip` method with proxy header support (X-Forwarded-For, X-Real-IP)
+- `Mbuzz.event` automatically extracts and forwards ip/user_agent from request context
+
+### Technical Details
+
+- IP extraction priority: `X-Forwarded-For` (first IP) > `X-Real-IP` > direct IP
+- Enables accurate session tracking without client-side cookies
+- Backwards compatible - ip/user_agent are optional parameters
+
 ## [0.6.0] - 2025-12-05
 
 ### Added

data/lib/mbuzz/client/track_request.rb

@@ -3,12 +3,14 @@
 module Mbuzz
   class Client
     class TrackRequest
-      def initialize(user_id, visitor_id, session_id, event_type, properties)
+      def initialize(user_id, visitor_id, session_id, event_type, properties, ip = nil, user_agent = nil)
         @user_id = user_id
         @visitor_id = visitor_id
         @session_id = session_id
         @event_type = event_type
         @properties = properties
+        @ip = ip
+        @user_agent = user_agent
       end
 
       def call
@@ -39,6 +41,8 @@ module Mbuzz
           session_id: @session_id,
           event_type: @event_type,
           properties: @properties,
+          ip: @ip,
+          user_agent: @user_agent,
           timestamp: Time.now.utc.iso8601
         }.compact
       end

data/lib/mbuzz/client.rb

@@ -7,8 +7,8 @@ require_relative "client/session_request"
 
 module Mbuzz
   class Client
-    def self.track(user_id: nil, visitor_id: nil, session_id: nil, event_type:, properties: {})
-      TrackRequest.new(user_id, visitor_id, session_id, event_type, properties).call
+    def self.track(user_id: nil, visitor_id: nil, session_id: nil, event_type:, properties: {}, ip: nil, user_agent: nil)
+      TrackRequest.new(user_id, visitor_id, session_id, event_type, properties, ip, user_agent).call
     end
 
     def self.identify(user_id:, visitor_id: nil, traits: {})

data/lib/mbuzz/request_context.rb

@@ -33,6 +33,12 @@ module Mbuzz
       @request.user_agent
     end
 
+    def ip
+      @request.env["HTTP_X_FORWARDED_FOR"]&.split(",")&.first&.strip ||
+        @request.env["HTTP_X_REAL_IP"] ||
+        @request.ip
+    end
+
     def enriched_properties(custom = {})
       { url: url, referrer: referrer }.compact.merge(custom)
     end

data/lib/mbuzz/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mbuzz
-  VERSION = "0.6.6"
+  VERSION = "0.6.8"
 end

data/lib/mbuzz.rb

@@ -104,7 +104,9 @@ module Mbuzz
       session_id: session_id,
       user_id: user_id,
       event_type: event_type,
-      properties: enriched_properties(properties)
+      properties: enriched_properties(properties),
+      ip: current_ip,
+      user_agent: current_user_agent
     )
   end
 
@@ -176,4 +178,14 @@ module Mbuzz
     RequestContext.current.enriched_properties(custom_properties)
   end
   private_class_method :enriched_properties
+
+  def self.current_ip
+    RequestContext.current&.ip
+  end
+  private_class_method :current_ip
+
+  def self.current_user_agent
+    RequestContext.current&.user_agent
+  end
+  private_class_method :current_user_agent
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mbuzz
 version: !ruby/object:Gem::Version
-  version: 0.6.6
+  version: 0.6.8
 platform: ruby
 authors:
 - mbuzz team