super_auth 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d7dd44cc4a7bc63bd611b41e4f4555896c61095a279a32640831d4ff22b11628
-  data.tar.gz: bb64fa3b4cbd5059a56ef8d3aa27b372f96c7d8df15c2a42efc84d9b2f78bac9
+  metadata.gz: f8b9f0044162ed48bfd00d97ec8c865d426a1b23eba3843c812ddb06d9d074e6
+  data.tar.gz: 5359617185bba8cb18f7defa857f388deed32fb458fbdbc02e324a435f91daac
 SHA512:
-  metadata.gz: de44b731731d0e9d6f86d944306e67db639a7a768416ad96bbcb5956600f6f38bd12f253ca12e30592b5e29078cbdb56078a197d89d9242017043ac8fbd4679b
-  data.tar.gz: 77ef025662b6bc4ed8110d9dd6ef77347a1744a723cb4b56a4779262010b651ece3a65af605a9cf4cea9fcf850b8d2a6c784fa2a8814f7d06787453e02b3d727
+  metadata.gz: 8835d68b13a025b2fcf6a56746716d08b595f1d26b649823110938c9e55496f21f9394b27cb88dfbacce01cdb564844c7423d400881d3ea3b5995b58fa69cfc6
+  data.tar.gz: fb79208c943335fb1a6b9fc6de388f413384ab383068f29e118e1e3b4ee386fca9d5285b121356af140686643b30e7a96f348c5caa7c320314fb874f36856961

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [0.3.2] - 2026-03-10
+
+- Feature: Add `SuperAuth.missing_user_behavior` configuration option
+  - `:none` (default) — returns empty result set when `current_user` is blank (existing behavior)
+  - `:raise` — raises `SuperAuth::Error` when `current_user` is blank (fail-fast for apps that always require authentication)
+
 ## [0.3.1] - 2026-03-10
 
 - Refactor: move authorization compilation logic into Authorization model (`compile!` and `from_graph` class methods)

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    super_auth (0.3.1)
+    super_auth (0.3.2)
       sequel
 
 GEM

data/README.md

@@ -47,6 +47,21 @@ Then visit: `http://localhost:3000/super_auth/visualization`
 
 See [VISUALIZATION.md](VISUALIZATION.md) for complete documentation.
 
+## Configuration
+
+```ruby
+# config/initializers/super_auth.rb
+SuperAuth.setup do |config|
+  # Raise an error when a query runs without a current user set.
+  # Default is :none (returns empty results silently).
+  config.missing_user_behavior = :raise
+end
+```
+
+| Option | Values | Default | Description |
+|--------|--------|---------|-------------|
+| `missing_user_behavior` | `:none`, `:raise` | `:none` | Controls what happens when `SuperAuth.current_user` is blank. `:none` returns an empty result set. `:raise` raises `SuperAuth::Error`. |
+
 ## Usage
 
 SuperAuth is a rules engine engine that works on 5 different authorization concepts:

data/lib/generators/super_auth/install/templates/super_auth.rb

@@ -3,5 +3,7 @@
 # models on boot. Use this file for any additional configuration.
 #
 # SuperAuth.setup do |config|
-#   # configuration options here
+#   # Raise an error when a query runs without a current user set.
+#   # Default is :none (returns empty results silently).
+#   # config.missing_user_behavior = :raise
 # end

data/lib/super_auth/active_record/by_current_user.rb

@@ -1,7 +1,10 @@
 module SuperAuth::ActiveRecord::ByCurrentUser
   def self.included(base)
     base.send(:default_scope, **{all_queries: true}) do
-      next none if SuperAuth.current_user.blank?
+      if SuperAuth.current_user.blank?
+        raise SuperAuth::Error, "SuperAuth.current_user not set" if SuperAuth.missing_user_behavior == :raise
+        next none
+      end
 
       if SuperAuth.current_user.respond_to?(:system?) && SuperAuth.current_user.system?
         self

data/lib/super_auth/version.rb

@@ -1,3 +1,3 @@
 module SuperAuth
-  VERSION = "0.3.1"
+  VERSION = "0.3.2"
 end

data/lib/super_auth.rb

@@ -8,6 +8,20 @@ module SuperAuth
     yield self if block_given?
   end
 
+  # Controls behavior when SuperAuth.current_user is blank in ByCurrentUser scope.
+  # :none (default) — returns an empty result set silently
+  # :raise — raises SuperAuth::Error
+  def self.missing_user_behavior
+    @missing_user_behavior || :none
+  end
+
+  def self.missing_user_behavior=(behavior)
+    unless %i[none raise].include?(behavior)
+      raise ArgumentError, "missing_user_behavior must be :none or :raise, got #{behavior.inspect}"
+    end
+    @missing_user_behavior = behavior
+  end
+
   def self.load
     require "super_auth/authorization"
     require "super_auth/edge"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: super_auth
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Jonathan Frias
@@ -100,7 +100,6 @@ files:
 - lib/super_auth/user.rb
 - lib/super_auth/version.rb
 - lib/tasks/super_auth_tasks.rake
-- super_auth.gemspec
 - visualization.html
 homepage: https://github.com/JonathanFrias/super_auth
 licenses:

data/super_auth.gemspec

@@ -1,35 +0,0 @@
-require_relative "lib/super_auth/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "super_auth"
-  spec.version = SuperAuth::VERSION
-  spec.authors = ["Jonathan Frias"]
-  spec.email = ["jonathan@gofrias.com"]
-
-  spec.summary = "Make Unauthenticated State Unrepresentable"
-  spec.description = "Simple, yet super powerful authorization for you application"
-  spec.homepage = "https://github.com/JonathanFrias/super_auth"
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 2.6.0"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/JonathanFrias/super_auth"
-  spec.metadata["changelog_uri"] = "https://github.com/JonathanFrias/super_auth/blob/main/CHANGELOG.md"
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|circleci)|appveyor)})
-    end
-  end
-  spec.bindir = "bin"
-  spec.executables = spec.files.grep(%r{\Abin/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  # Uncomment to register a new dependency of your gem
-  spec.add_dependency "sequel"
-  spec.add_development_dependency "sqlite3"
-  # For more information and examples about making a new gem, check out our
-  # guide at: https://bundler.io/guides/creating_gem.html
-end