subflag-rails 0.2.0 → 0.4.0

data/lib/subflag/rails.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "open_feature/sdk"
-require "subflag"
 
 require_relative "rails/version"
 require_relative "rails/configuration"
@@ -27,14 +26,25 @@ module Subflag
 
       # Configure Subflag for Rails
       #
-      # @example
+      # @example Using Subflag Cloud (SaaS)
       #   Subflag::Rails.configure do |config|
+      #     config.backend = :subflag
       #     config.api_key = Rails.application.credentials.subflag_api_key
       #     config.user_context do |user|
       #       { targeting_key: user.id.to_s, email: user.email, plan: user.plan }
       #     end
       #   end
       #
+      # @example Using ActiveRecord (self-hosted)
+      #   Subflag::Rails.configure do |config|
+      #     config.backend = :active_record
+      #   end
+      #
+      # @example Using Memory (testing)
+      #   Subflag::Rails.configure do |config|
+      #     config.backend = :memory
+      #   end
+      #
       # @yield [Configuration]
       def configure
         yield(configuration)
@@ -48,25 +58,86 @@ module Subflag
         @client ||= Client.new
       end
 
+      # Access the current provider instance
+      #
+      # Useful for the Memory backend where you can set flags directly:
+      #   Subflag::Rails.provider.set(:my_flag, true)
+      #
+      # @return [Object] The current OpenFeature provider
+      def provider
+        @provider
+      end
+
+      # Prefetch all flags for a user/context in a single API call
+      #
+      # Call this early in a request to fetch all flags at once.
+      # Subsequent flag lookups will use the cached values.
+      #
+      # @param user [Object, nil] The user object for targeting
+      # @param context [Hash, nil] Additional context attributes
+      # @return [Array<Hash>] Array of prefetched flag results (for inspection)
+      #
+      # @example Prefetch in a controller
+      #   before_action :prefetch_flags
+      #
+      #   def prefetch_flags
+      #     Subflag::Rails.prefetch_flags(user: current_user)
+      #   end
+      #
+      def prefetch_flags(user: nil, context: nil)
+        client.prefetch_all(user: user, context: context)
+      end
+
       # Reset configuration (primarily for testing)
       def reset!
         @configuration = Configuration.new
         @client = nil
+        @provider = nil
       end
 
       private
 
       def setup_provider
-        return unless configuration.api_key
+        @provider = build_provider
+        return unless @provider
+
+        OpenFeature::SDK.configure do |config|
+          config.set_provider(@provider)
+        end
+      end
+
+      def build_provider
+        case configuration.backend
+        when :subflag
+          build_subflag_provider
+        when :active_record
+          build_active_record_provider
+        when :memory
+          build_memory_provider
+        else
+          raise ArgumentError, "Unknown backend: #{configuration.backend}. Use :subflag, :active_record, or :memory"
+        end
+      end
+
+      def build_subflag_provider
+        return nil unless configuration.api_key
 
-        provider = ::Subflag::Provider.new(
+        require_relative "rails/backends/subflag_provider"
+        Backends::SubflagProvider.new(
           api_key: configuration.api_key,
           api_url: configuration.api_url
         )
+      end
 
-        OpenFeature::SDK.configure do |config|
-          config.set_provider(provider)
-        end
+      def build_active_record_provider
+        require_relative "rails/backends/active_record_provider"
+        require_relative "rails/models/flag"
+        Backends::ActiveRecordProvider.new
+      end
+
+      def build_memory_provider
+        require_relative "rails/backends/memory_provider"
+        Backends::MemoryProvider.new
       end
     end
   end
@@ -92,5 +163,20 @@ module Subflag
     def flags(user: nil, context: nil)
       Rails::FlagAccessor.new(user: user, context: context)
     end
+
+    # Prefetch all flags for a user/context in a single API call
+    #
+    # @param user [Object, nil] The user object for targeting
+    # @param context [Hash, nil] Additional context attributes
+    # @return [Array<Hash>] Array of prefetched flag results
+    #
+    # @example
+    #   Subflag.prefetch_flags(user: current_user)
+    #   # Subsequent lookups use cache
+    #   Subflag.flags(user: current_user).new_feature?(default: false)
+    #
+    def prefetch_flags(user: nil, context: nil)
+      Rails.prefetch_flags(user: user, context: context)
+    end
   end
 end

metadata

@@ -1,22 +1,22 @@
 --- !ruby/object:Gem::Specification
 name: subflag-rails
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Subflag
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-01 00:00:00.000000000 Z
+date: 2025-12-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: subflag-openfeature-provider
+  name: openfeature-sdk
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.3'
     - - "<"
       - !ruby/object:Gem::Version
         version: '1.0'
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.3'
     - - "<"
       - !ruby/object:Gem::Version
         version: '1.0'
@@ -170,9 +170,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.1'
-description: Rails integration for Subflag feature flags. Get typed values (boolean,
-  string, integer, double, object) with user targeting. Includes generators, view
-  helpers, and ActiveRecord context integration.
+description: Feature flags for Rails with pluggable backends. Use Subflag Cloud (SaaS),
+  ActiveRecord (self-hosted), or Memory (testing). Get typed values (boolean, string,
+  integer, double, object) with the same API regardless of backend.
 email:
 - support@subflag.com
 executables: []
@@ -183,15 +183,20 @@ files:
 - LICENSE.txt
 - README.md
 - lib/generators/subflag/install_generator.rb
-- lib/generators/subflag/templates/initializer.rb
+- lib/generators/subflag/templates/create_subflag_flags.rb.tt
+- lib/generators/subflag/templates/initializer.rb.tt
 - lib/subflag-rails.rb
 - lib/subflag/rails.rb
+- lib/subflag/rails/backends/active_record_provider.rb
+- lib/subflag/rails/backends/memory_provider.rb
+- lib/subflag/rails/backends/subflag_provider.rb
 - lib/subflag/rails/client.rb
 - lib/subflag/rails/configuration.rb
 - lib/subflag/rails/context_builder.rb
 - lib/subflag/rails/evaluation_result.rb
 - lib/subflag/rails/flag_accessor.rb
 - lib/subflag/rails/helpers.rb
+- lib/subflag/rails/models/flag.rb
 - lib/subflag/rails/railtie.rb
 - lib/subflag/rails/request_cache.rb
 - lib/subflag/rails/test_helpers.rb