sessionvision 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f94cb9100274b790c0eeff2de556da99bd0a0f45980e2ddf7f350c7ab119026f
-  data.tar.gz: ea6cce1a64cf136ef40cf37d397a908295ee91fc6c63368e47d211f280c5a813
+  metadata.gz: 66e755d6fdb9d9e7135e64473ea7077c4fed08ab9fd0185ac50155000e91ce35
+  data.tar.gz: 795e7caa56b074c01d118b6e6bd4d0bd0919e30499f018631e8ddbcf3df4b255
 SHA512:
-  metadata.gz: 0bbaa3ccd591fcccf34e737a6b1469090d44742d813a8261e3b002e31396dfa289f1552683bfbce69ab25e052db749a13c451bed788f7a60206293fab8b54eff
-  data.tar.gz: 1ff05e7cd2de691da8fb71b471a595c4f592be2b9bb1e556913691320cec6a4bccc7c2dbd45c42dccf50241e06f921bf44a1dd37da0adf8e1ab08ab1d86efc5d
+  metadata.gz: c85e057308dfa09dca4a33d99e4ca0694c9ba42de5335882c0404c96fe23f2a6f1591b3e65ba40c8bda0121fc8cdc128988d334e088c907e7e3fd8cf19af538e
+  data.tar.gz: a6db7d00432f903968ae4a9475559110ea992b71e7542aba3e6960c1e84f6139355dce9d625f00f1afeecdaeac99e919a068b1eaf1770ca251f7b6268d326641

data/lib/sessionvision/client.rb

@@ -5,10 +5,15 @@ require "logger"
 
 module SessionVision
   class Client
+    MAX_GROUPS = 8
+    MAX_GROUP_KEY_LENGTH = 200
+    CONTROL_CHARS = /[\x00-\x1f\x7f]/
+
     def initialize(config)
       @config = config
       @lock = Mutex.new
       @registered = {}
+      @groups = []
       @shutdown_called = false
 
       @logger = config.debug ? Logger.new($stdout, progname: "sessionvision") : nil
@@ -35,11 +40,13 @@ module SessionVision
       @logger&.debug("Client initialized (host=#{config.ingest_host})")
     end
 
-    def capture(event_name, user_id: nil, anonymous_id: nil, session_id: nil, properties: {})
+    def capture(event_name, user_id: nil, anonymous_id: nil, session_id: nil, properties: {}, groups: nil)
       raise ArgumentError, "event_name must be a non-empty string" unless event_name.is_a?(String) && !event_name.empty?
       raise ArgumentError, "Either user_id or anonymous_id is required" if user_id.nil? && anonymous_id.nil?
 
-      merged_props = @lock.synchronize { @registered.merge(properties || {}) }
+      merged_props, merged_groups = @lock.synchronize do
+        [@registered.merge(properties || {}), merge_groups(groups)]
+      end
 
       event = {
         "event" => event_name,
@@ -49,15 +56,23 @@ module SessionVision
       }
       event["userId"] = user_id if user_id
       event["anonymousId"] = anonymous_id if anonymous_id
+      event["groups"] = merged_groups unless merged_groups.empty?
 
       @logger&.debug("Event captured: #{event_name}")
       @buffer.push(event)
     end
 
-    def identify(user_id, **traits)
+    def identify(user_id, groups: nil, **traits)
       raise ArgumentError, "user_id must be a non-empty string" unless user_id.is_a?(String) && !user_id.empty?
 
-      capture("$identify", user_id: user_id, properties: traits.transform_keys(&:to_s))
+      set_groups(groups) unless groups.nil?
+      capture("$identify", user_id: user_id, properties: traits.transform_keys(&:to_s), groups: groups)
+    end
+
+    def set_groups(groups)
+      @lock.synchronize do
+        @groups = normalize_groups(groups)
+      end
     end
 
     def register(**properties)
@@ -96,6 +111,31 @@ module SessionVision
 
     private
 
+    def normalize_groups(input)
+      return [] unless input.is_a?(Array)
+
+      seen = {}
+      normalized = []
+
+      input.each do |raw_group|
+        break if normalized.length >= MAX_GROUPS
+        next unless raw_group.is_a?(String)
+
+        trimmed_group = raw_group.strip
+        next if trimmed_group.empty? || trimmed_group.length > MAX_GROUP_KEY_LENGTH
+        next if CONTROL_CHARS.match?(trimmed_group) || seen.key?(trimmed_group)
+
+        seen[trimmed_group] = true
+        normalized << trimmed_group
+      end
+
+      normalized
+    end
+
+    def merge_groups(inline_groups)
+      normalize_groups([*@groups, *(inline_groups || [])])
+    end
+
     def send_batch(events)
       @transport.send_batch(@config.project_token, events)
     end

data/lib/sessionvision/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SessionVision
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/sessionvision.rb

@@ -29,15 +29,19 @@ module SessionVision
       end
     end
 
-    def capture(event_name, user_id: nil, anonymous_id: nil, session_id: nil, properties: {})
+    def capture(event_name, user_id: nil, anonymous_id: nil, session_id: nil, properties: {}, groups: nil)
       client.capture(event_name, user_id: user_id, anonymous_id: anonymous_id,
-                                 session_id: session_id, properties: properties)
+                                 session_id: session_id, properties: properties, groups: groups)
     end
 
     def identify(user_id, **traits)
       client.identify(user_id, **traits)
     end
 
+    def set_groups(groups)
+      client.set_groups(groups)
+    end
+
     def register(**properties)
       client.register(**properties)
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sessionvision
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - sessionvision
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-13 00:00:00.000000000 Z
+date: 2026-04-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec