fino-solid 1.10.0 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d001f6bb38d131992464c9cdeab1e5927fd5a16623759459c7020b1c35d6664a
-  data.tar.gz: 339ab6d35c8dc40ecd553f835f536eb74a6978375ed29943cf5c8905c9c812e2
+  metadata.gz: 316e2cce3c27678cdf847e621410ec7d91b02c4da86dde2450bca861b8d50159
+  data.tar.gz: 359289766581dc9f4a3e02500379f659985a16d06ed07b3c1e69a61a03f1b3d3
 SHA512:
-  metadata.gz: 6f81641ee84473e0fb6262bfa41d6beefd0e2051eb8caf6fc15364198385324f162f395a959d6658791dd70b9dbc28de46259a561a7c08b7df90f7d04f7c0f54
-  data.tar.gz: 53eef4644ef38aaa358cf40d9f2cbf5ed587800a5acb0e47b94cf09b8f51371d5cb5a34678385f691a524d2beda08ed5814e029ebbf0180cf63a6055299585c8
+  metadata.gz: 4cd553efffc63fc306a528419ccad8c186677eb7febce0c344ed03c1f23a3d91a262ec8825ab13958c50e48a5253cc1b63d81c874a2c3a485f0df61bf683451a
+  data.tar.gz: cf00571edcb858d874a3ed4f8b83c894c42cf7782f64341a899b3ac9b6dcb0ac9f74d794af677bdd4cfce007ccc6c64190eeabef4d3db1b36438a2caa268445d

data/README.md

@@ -238,7 +238,7 @@ Fino.value(:model, at: :openai, for: "user_2") #=> "gpt-5"
 
 #### Experiment analysis
 
-Some Fino adapters support A/B testing analysis, e.g built-in Redis adapter
+Fino adapters might support A/B testing analysis, both built-in `solid` and `redis` adapters do
 
 When you run an A/B test for a setting, fino automatically calculates variant based on a stable identifier you pass as
 a `for` option
@@ -416,6 +416,14 @@ end
    end
    ```
 
+## Development
+
+To create and mugrate dummy app db to test solid adapter, do
+
+```bash
+cd spec/dummy && bin/rails db:create db:migrate
+```
+
 ## Releasing
 
 `rake release`

data/lib/fino/solid/adapter.rb

@@ -62,6 +62,36 @@ module Fino
         end
       end
 
+      def record_ab_testing_conversion(setting_definition, variant, scope, time)
+        Fino::Solid::Conversion.insert(
+          {
+            setting_key: setting_definition.key,
+            variant_id: variant.id,
+            scope: scope.to_s,
+            converted_at: time
+          },
+          unique_by: :idx_fino_conversions_unique
+        )
+      end
+
+      def read_ab_testing_conversions(setting_definition, variants)
+        rows =
+          Fino::Solid::Conversion
+          .where(setting_key: setting_definition.key, variant_id: variants.map(&:id))
+          .pluck(:variant_id, :scope, :converted_at)
+
+        grouped = rows.group_by(&:first)
+
+        variants.each_with_object({}) do |variant, memo|
+          entries = grouped.fetch(variant.id, [])
+          memo[variant] = entries.map { |_vid, scope, converted_at| [scope, (converted_at.to_f * 1000).to_i] }
+        end
+      end
+
+      def clear_ab_testing_conversions(setting_key)
+        Fino::Solid::Conversion.where(setting_key: setting_key).delete_all
+      end
+
       def fetch_raw_variants_from(raw_adapter_data)
         raw_adapter_data.each_with_object([]) do |(key, value), memo|
           next unless key.start_with?("#{VARIANT_PREFIX}/")

data/lib/fino/solid/conversion.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Fino
+  module Solid
+    class Conversion < Record
+      self.table_name = "fino_ab_testing_conversions"
+    end
+  end
+end

data/lib/fino/solid/generators/install/USAGE

@@ -1,8 +1,9 @@
 Description:
-    Installs Fino::Solid adapter by creating necessary database migration.
+    Installs Fino::Solid adapter by creating necessary database migrations.
 
 Example:
     bin/rails generate fino:solid:install
 
     This will create:
         db/migrate/[timestamp]_create_fino_settings.rb
+        db/migrate/[timestamp]_create_fino_ab_testing_conversions.rb

data/lib/fino/solid/generators/install/install_generator.rb

@@ -11,8 +11,10 @@ module Fino
 
         source_root File.expand_path("templates", __dir__)
 
-        def copy_migration
+        def copy_migrations
           migration_template "create_fino_settings.rb.tt", File.join(db_migrate_path, "create_fino_settings.rb")
+          migration_template "create_fino_ab_testing_conversions.rb.tt",
+                             File.join(db_migrate_path, "create_fino_ab_testing_conversions.rb")
         end
 
         private

data/lib/fino/solid/generators/install/templates/create_fino_ab_testing_conversions.rb.tt

@@ -0,0 +1,17 @@
+class CreateFinoAbTestingConversions < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    create_table :fino_ab_testing_conversions do |t|
+      t.string :setting_key, null: false
+      t.string :variant_id, null: false
+      t.string :scope, null: false
+      t.datetime :converted_at, null: false
+
+      t.timestamps
+    end
+
+    add_index :fino_ab_testing_conversions, %i[setting_key variant_id scope],
+              unique: true, name: :idx_fino_conversions_unique
+    add_index :fino_ab_testing_conversions, %i[setting_key variant_id],
+              name: :idx_fino_conversions_lookup
+  end
+end

data/lib/fino/solid.rb

@@ -16,6 +16,7 @@ end
 
 require "fino/solid/record"
 require "fino/solid/setting"
+require "fino/solid/conversion"
 require "fino/solid/adapter"
 require "fino/solid/railtie" if defined?(Rails::Railtie)
 

data/lib/fino/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Fino
-  VERSION = "1.10.0"
+  VERSION = "1.11.0"
   REQUIRED_RUBY_VERSION = ">= 3.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fino-solid
 version: !ruby/object:Gem::Version
-  version: 1.10.0
+  version: 1.11.0
 platform: ruby
 authors:
 - Egor Iskrenkov
@@ -29,14 +29,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.10.0
+        version: 1.11.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.10.0
+        version: 1.11.0
 - !ruby/object:Gem::Dependency
   name: mysql2
   requirement: !ruby/object:Gem::Requirement
@@ -91,8 +91,10 @@ files:
 - lib/fino/solid.rb
 - lib/fino/solid/README.md
 - lib/fino/solid/adapter.rb
+- lib/fino/solid/conversion.rb
 - lib/fino/solid/generators/install/USAGE
 - lib/fino/solid/generators/install/install_generator.rb
+- lib/fino/solid/generators/install/templates/create_fino_ab_testing_conversions.rb.tt
 - lib/fino/solid/generators/install/templates/create_fino_settings.rb.tt
 - lib/fino/solid/railtie.rb
 - lib/fino/solid/record.rb
@@ -119,7 +121,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
 summary: ActiveRecord adapter for Fino settings engine
 test_files: []