launchdarkly-server-sdk 6.0.0 → 6.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd5b1ccdc654b9ca033547f366d12fe0dde0d25245459de79f9cf1e3ed0e9b79
-  data.tar.gz: ee6461f8365f0df76055b8c1e5e71b58934df15b24bba22c8b61eb99619b21dc
+  metadata.gz: 660fcdc21e7d6c74b118c02e180fc0a2a08279d4c936f4d01b45244e2df88732
+  data.tar.gz: 0fc47ce28bb8e66ef1e0c93b06499990366c749adc32250b368d7b25573c971f
 SHA512:
-  metadata.gz: d6723297fc581f47325f0147f915efa543f1daf27d01af6d63a13546a5d18e800743060478e9f40c62083ceae5bcd8acfaa8c84d83fc870b893069ae51a9f519
-  data.tar.gz: 89b4885e33f1ebf61fd88b4a65c4da060087901aaf9772100875888b0983f420099b23971c6b8ba8d71697da410daf0b43e88c946192cb8899682aff9b77a64d
+  metadata.gz: 8c93e00623d1e6f954974a3128bd19c31b669eaa440460d1b14c30f4b9581b5aee2c06cf040f2fcbdd815a38384388d3b606c65834ffc4057ade87a083d1eda3
+  data.tar.gz: ef7d3c86a418ab1bb07e3b444107fc92d0472e9fe1a2ed9ef87a57527d72a2c63ce6007ad39dd5ff22f242ea420c4524bb292d8a9e3e18d8ebadb4042d82e1d5

data/.circleci/config.yml

@@ -20,7 +20,7 @@ jobs:
       LD_RELEASE_DOCS_TITLE: ""
       LD_RELEASE_PROJECT: "ruby-server-sdk"
       LD_RELEASE_PROJECT_TEMPLATE: "ruby"
-      LD_RELEASE_VERSION: "6.0.0"
+      LD_RELEASE_VERSION: "6.1.0"
       LD_SKIP_DATABASE_TESTS: "1"
     steps:
       - checkout

data/CHANGELOG.md

@@ -10,6 +10,7 @@ All notable changes to the LaunchDarkly Ruby SDK will be documented in this file
 - Switched to the `http` gem instead of `socketry` (with a custom http client) for streaming, and instead of `Net::HTTP` for polling / events.
 - Dropped support for Ruby < version 2.5
 - Dropped support for JRuby < version 9.2
+- Switched the default polling domain from `app.launchdarkly.com` to `sdk.launchdarkly.com`.
 
 ## [5.8.2] - 2021-01-19
 ### Fixed:

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    launchdarkly-server-sdk (6.0.0)
+    launchdarkly-server-sdk (6.1.0)
       concurrent-ruby (~> 1.1)
       http (~> 4.4.1)
       json (~> 2.3.1)
@@ -113,4 +113,4 @@ DEPENDENCIES
   webrick (~> 1.7)
 
 BUNDLED WITH
-   2.2.6
+   2.2.8

data/README.md

@@ -55,4 +55,3 @@ About LaunchDarkly
     * [docs.launchdarkly.com](https://docs.launchdarkly.com/  "LaunchDarkly Documentation") for our documentation and SDK reference guides
     * [apidocs.launchdarkly.com](https://apidocs.launchdarkly.com/  "LaunchDarkly API Documentation") for our API documentation
     * [blog.launchdarkly.com](https://blog.launchdarkly.com/  "LaunchDarkly Blog Documentation") for the latest product updates
-    * [Feature Flagging Guide](https://github.com/launchdarkly/featureflags/  "Feature Flagging Guide") for best practices and strategies

data/azure-pipelines.yml

@@ -45,7 +45,7 @@ jobs:
           workingDirectory: $(System.DefaultWorkingDirectory)
           script: |
             ruby -v
-            gem install bundler
+            gem install bundler:2.2.7
             bundle install
             mkdir rspec
             bundle exec rspec --format progress --format RspecJunitFormatter -o ./rspec/rspec.xml spec

data/lib/ldclient-rb/events.rb

@@ -439,6 +439,7 @@ module LaunchDarkly
         out[:variation] = event[:variation] if event.has_key?(:variation)
         out[:version] = event[:version] if event.has_key?(:version)
         out[:prereqOf] = event[:prereqOf] if event.has_key?(:prereqOf)
+        out[:contextKind] = event[:contextKind] if event.has_key?(:contextKind)
         if @inline_users || is_debug
           out[:user] = process_user(event)
         else
@@ -466,6 +467,7 @@ module LaunchDarkly
           out[:userKey] = event[:user].nil? ? nil : event[:user][:key]
         end
         out[:metricValue] = event[:metricValue] if event.has_key?(:metricValue)
+        out[:contextKind] = event[:contextKind] if event.has_key?(:contextKind)
         out
       when "index"
         {

data/lib/ldclient-rb/impl/event_factory.rb

@@ -28,6 +28,7 @@ module LaunchDarkly
         e[:debugEventsUntilDate] = flag[:debugEventsUntilDate] if flag[:debugEventsUntilDate]
         e[:prereqOf] = prereq_of_flag[:key] if !prereq_of_flag.nil?
         e[:reason] = detail.reason if add_experiment_data || @with_reasons
+        e[:contextKind] = context_to_context_kind(user) if !user.nil? && user[:anonymous]
         e
       end
 
@@ -43,6 +44,7 @@ module LaunchDarkly
         e[:trackEvents] = true if flag[:trackEvents]
         e[:debugEventsUntilDate] = flag[:debugEventsUntilDate] if flag[:debugEventsUntilDate]
         e[:reason] = reason if @with_reasons
+        e[:contextKind] = context_to_context_kind(user) if !user.nil? && user[:anonymous]
         e
       end
 
@@ -55,6 +57,7 @@ module LaunchDarkly
           default: default_value
         }
         e[:reason] = reason if @with_reasons
+        e[:contextKind] = context_to_context_kind(user) if !user.nil? && user[:anonymous]
         e
       end
 
@@ -66,6 +69,16 @@ module LaunchDarkly
         }
       end
 
+      def new_alias_event(current_context, previous_context)
+        {
+          kind: 'alias',
+          key: current_context[:key],
+          contextKind: context_to_context_kind(current_context),
+          previousKey: previous_context[:key],
+          previousContextKind: context_to_context_kind(previous_context)
+        }
+      end
+
       def new_custom_event(event_name, user, data, metric_value)
         e = {
           kind: 'custom',
@@ -74,11 +87,20 @@ module LaunchDarkly
         }
         e[:data] = data if !data.nil?
         e[:metricValue] = metric_value if !metric_value.nil?
+        e[:contextKind] = context_to_context_kind(user) if !user.nil? && user[:anonymous]
         e
       end
 
       private
 
+      def context_to_context_kind(user)
+          if !user.nil? && user[:anonymous]
+            return "anonymousUser"
+          else
+            return "user"
+          end
+      end
+
       def is_experiment(flag, reason)
         return false if !reason
         case reason[:kind]

data/lib/ldclient-rb/ldclient.rb

@@ -282,6 +282,23 @@ module LaunchDarkly
       @event_processor.add_event(@event_factory_default.new_custom_event(event_name, user, data, metric_value))
     end
 
+    #
+    # Associates a new and old user object for analytics purposes via an alias event.
+    #
+    # @param current_context [Hash] The current version of a user.
+    # @param previous_context [Hash] The previous version of a user.
+    # @return [void]
+    #
+    def alias(current_context, previous_context)
+      if !current_context || current_context[:key].nil? || !previous_context || previous_context[:key].nil?
+        @config.logger.warn("Alias called with nil user or nil user key!")
+        return
+      end
+      sanitize_user(current_context)
+      sanitize_user(previous_context)
+      @event_processor.add_event(@event_factory_default.new_alias_event(current_context, previous_context))
+    end
+
     #
     # Returns all feature flag values for the given user.
     #

data/lib/ldclient-rb/version.rb

@@ -1,3 +1,3 @@
 module LaunchDarkly
-  VERSION = "6.0.0"
+  VERSION = "6.1.0"
 end

data/spec/events_spec.rb

@@ -408,6 +408,16 @@ describe LaunchDarkly::EventProcessor do
     end
   end
 
+  it "queues alias event" do
+    with_processor_and_sender(default_config) do |ep, sender|
+      e = { kind: "alias", key: "a", contextKind: "user", previousKey: "b", previousContextKind: "user" }
+      ep.add_event(e)
+
+      output = flush_and_get_events(ep, sender)
+      expect(output).to contain_exactly(e)
+    end
+  end
+
   it "treats nil value for custom the same as an empty hash" do
     with_processor_and_sender(default_config) do |ep, sender|
       user_with_nil_custom = { key: "userkey", custom: nil }

data/spec/ldclient_spec.rb

@@ -25,6 +25,12 @@ describe LaunchDarkly::LDClient do
       }
     }
   end
+  let(:user_anonymous) do
+    {
+      key: "anonymous@test.com",
+      anonymous: true
+    }
+  end
   let(:numeric_key_user) do
     {
       key: 33,
@@ -155,6 +161,24 @@ describe LaunchDarkly::LDClient do
       client.variation("key", nil, "default")
     end
 
+    it "queues a feature event for an existing feature when user is anonymous" do
+      config.feature_store.init({ LaunchDarkly::FEATURES => {} })
+      config.feature_store.upsert(LaunchDarkly::FEATURES, feature_with_value)
+      expect(event_processor).to receive(:add_event).with(hash_including(
+        kind: "feature",
+        key: "key",
+        version: 100,
+        contextKind: "anonymousUser",
+        user: user_anonymous,
+        variation: 0,
+        value: "value",
+        default: "default",
+        trackEvents: true,
+        debugEventsUntilDate: 1000
+      ))
+      client.variation("key", user_anonymous, "default")
+    end
+
     it "queues a feature event for an existing feature when user key is nil" do
       config.feature_store.init({ LaunchDarkly::FEATURES => {} })
       config.feature_store.upsert(LaunchDarkly::FEATURES, feature_with_value)
@@ -455,6 +479,12 @@ describe LaunchDarkly::LDClient do
       client.track("custom_event_name", user, nil, 1.5)
     end
 
+    it "includes contextKind with anonymous user" do
+      expect(event_processor).to receive(:add_event).with(hash_including(
+        kind: "custom", key: "custom_event_name", user: user_anonymous, metricValue: 2.2, contextKind: "anonymousUser"))
+      client.track("custom_event_name", user_anonymous, nil, 2.2)
+    end
+
     it "sanitizes the user in the event" do
       expect(event_processor).to receive(:add_event).with(hash_including(user: sanitized_numeric_key_user))
       client.track("custom_event_name", numeric_key_user, nil)
@@ -473,6 +503,26 @@ describe LaunchDarkly::LDClient do
     end
   end
 
+  describe '#alias' do
+    it "queues up an alias event" do
+      expect(event_processor).to receive(:add_event).with(hash_including(
+        kind: "alias", key: user[:key], contextKind: "user", previousKey: user_anonymous[:key], previousContextKind: "anonymousUser"))
+      client.alias(user, user_anonymous)
+    end
+
+    it "does not send an event, and logs a warning, if user is nil" do
+      expect(event_processor).not_to receive(:add_event)
+      expect(logger).to receive(:warn)
+      client.alias(nil, nil)
+    end
+
+    it "does not send an event, and logs a warning, if user key is nil" do
+      expect(event_processor).not_to receive(:add_event)
+      expect(logger).to receive(:warn)
+      client.alias(user_without_key, user_without_key)
+    end
+  end
+
   describe '#identify' do 
     it "queues up an identify event" do
       expect(event_processor).to receive(:add_event).with(hash_including(kind: "identify", key: user[:key], user: user))

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: launchdarkly-server-sdk
 version: !ruby/object:Gem::Version
-  version: 6.0.0
+  version: 6.1.0
 platform: ruby
 authors:
 - LaunchDarkly
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-01-26 00:00:00.000000000 Z
+date: 2021-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-dynamodb