sequel-privacy 0.5.5 → 0.5.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7dd8660d0cc93e21c96080ba66f777e9b39f00ec7a5ca4f8fa211739a97dbe62
-  data.tar.gz: 85952e038e33a535adf8adaed566c08310e003f2540a406457029d678e889009
+  metadata.gz: 2b47c85175a70082489fe5307e91094ea6a60dfde2d7f28ee814206a3029a892
+  data.tar.gz: a14f83b40de9d66df9390b5d2e797356bebd98f7f4c03947123b910fa0290f11
 SHA512:
-  metadata.gz: 9276223bd19d31daaabbaa34076e15c6dce4ce2439daadc30bee5e021fc7a88571323ce213ab2840afbe533b53d73129625817177a44b7a178f1fc93b6f21c37
-  data.tar.gz: d6c2e72d8eea11c83b42be27a64dd5076e0e320a7d15efe7a6092ca543714203cf643ad14eee190b986eda570a331fca2b8d519126494ff35d5caef421f2fb9a
+  metadata.gz: 941314443e93f294bb0de8017ca4abf7181b9298de65ab4b020f2811c48b6f486dc65514c442b764a03f2c6138e51b5ac52a3bb1cf66b0fa976be7bb081ad075
+  data.tar.gz: 372ca5512a9a8a215ab354ab4fa878334aef8edfec000524b40b36d8a9cac690af2e44ed0a9e0e7e9a0d539a843f9b34a9ad422b283c49a0a45aa2e0e202dc3b

data/README.md

@@ -180,6 +180,33 @@ policy :MyPolicy, ->() { ... },
 
 **`allow_anonymous: true`**: Skip the auto-deny for nil actor. Use for state-gate policies that examine only the subject (e.g. "post is published").
 
+### Policy Factories
+
+Use `policy_factory` when a policy needs definition-time arguments, while still receiving the normal runtime policy arguments (`actor`, `subject`, `direct_object`) during enforcement.
+
+```ruby
+module P
+  extend Sequel::Privacy::PolicyDSL
+
+  policy_factory :AllowIfActorMeetsFieldVisibility, ->(visibility_field) {
+    ->(actor, subject) {
+      allow if actor.meets_visibility?(subject.public_send(visibility_field))
+    }
+  }
+end
+
+class Member < Sequel::Model
+  plugin :privacy
+
+  privacy do
+    can :view, P::AllowMembers
+    field :phone, P::AllowIfActorMeetsFieldVisibility(:phone_visibility)
+  end
+end
+```
+
+Policy factories accept the same options as `policy`. The factory must return a Proc, and each call returns a concrete `Policy` instance with its own cache identity.
+
 ### Policy Combinators
 
 Use `all()` to require multiple conditions:

data/lib/sequel/plugins/privacy.rb

@@ -126,6 +126,8 @@ module Sequel
             case p
             when Sequel::Privacy::Policy, Proc
               p
+            when Sequel::Privacy::PolicyFactory
+              Kernel.raise ArgumentError, "Policy factory #{p.factory_name} must be called with arguments"
             else
               Kernel.raise ArgumentError, "Invalid policy: #{p.inspect}"
             end

data/lib/sequel/privacy/policy_dsl.rb

@@ -50,6 +50,35 @@ module Sequel
         )
         const_set(name, p)
       end
+
+      sig do
+        params(
+          name: Symbol,
+          factory: Proc,
+          comment: T.nilable(String),
+          cacheable: T::Boolean,
+          single_match: T::Boolean,
+          cache_by: T.nilable(T.any(Symbol, T::Array[Symbol])),
+          allow_anonymous: T::Boolean
+        ).void
+      end
+      def policy_factory(name, factory, comment = nil, cacheable: true, single_match: false, cache_by: nil,
+                         allow_anonymous: false)
+        policy_factory = PolicyFactory.new(
+          name,
+          factory,
+          comment: comment,
+          cacheable: cacheable,
+          single_match: single_match,
+          cache_by: cache_by,
+          allow_anonymous: allow_anonymous
+        )
+
+        const_set(name, policy_factory)
+        define_singleton_method(name) do |*args|
+          policy_factory.call(*args)
+        end
+      end
     end
   end
 end

data/lib/sequel/privacy/policy_factory.rb

@@ -0,0 +1,68 @@
+# typed: true
+# frozen_string_literal: true
+
+module Sequel
+  module Privacy
+    # A PolicyFactory captures definition-time arguments and returns concrete
+    # Policy instances that can be registered in a privacy policy chain.
+    class PolicyFactory
+      extend T::Sig
+
+      sig { returns(String) }
+      attr_reader :factory_name
+
+      sig do
+        params(
+          factory_name: Symbol,
+          factory: Proc,
+          comment: T.nilable(String),
+          cacheable: T::Boolean,
+          single_match: T::Boolean,
+          cache_by: T.nilable(T.any(Symbol, T::Array[Symbol])),
+          allow_anonymous: T::Boolean
+        ).void
+      end
+      def initialize(factory_name, factory, comment: nil, cacheable: true, single_match: false, cache_by: nil,
+                     allow_anonymous: false)
+        @factory_name = T.let(factory_name.to_s, String)
+        @factory = T.let(factory, Proc)
+        @comment = T.let(comment, T.nilable(String))
+        @cacheable = T.let(cacheable, T::Boolean)
+        @single_match = T.let(single_match, T::Boolean)
+        @cache_by = T.let(cache_by, T.nilable(T.any(Symbol, T::Array[Symbol])))
+        @allow_anonymous = T.let(allow_anonymous, T::Boolean)
+      end
+
+      sig { params(args: T.untyped).returns(Policy) }
+      def call(*args)
+        lam = T.unsafe(@factory).call(*args)
+        unless lam.is_a?(Proc)
+          Kernel.raise ArgumentError,
+                       "Policy factory #{@factory_name} must return a Proc, got #{lam.inspect}"
+        end
+
+        T.cast(
+          Policy.create(
+            policy_name_for(args),
+            lam,
+            @comment,
+            cacheable: @cacheable,
+            single_match: @single_match,
+            cache_by: @cache_by,
+            allow_anonymous: @allow_anonymous
+          ),
+          Policy
+        )
+      end
+
+      private
+
+      sig { params(args: T::Array[T.untyped]).returns(Symbol) }
+      def policy_name_for(args)
+        return @factory_name.to_sym if args.empty?
+
+        :"#{@factory_name}(#{args.map(&:inspect).join(', ')})"
+      end
+    end
+  end
+end

data/lib/sequel/privacy/version.rb

@@ -3,6 +3,6 @@
 
 module Sequel
   module Privacy
-    VERSION = '0.5.5'
+    VERSION = '0.5.6'
   end
 end

data/lib/sequel-privacy.rb

@@ -20,6 +20,7 @@ require_relative 'sequel/privacy/version'
 require_relative 'sequel/privacy/errors'
 require_relative 'sequel/privacy/i_actor'
 require_relative 'sequel/privacy/policy'
+require_relative 'sequel/privacy/policy_factory'
 require_relative 'sequel/privacy/cache'
 require_relative 'sequel/privacy/actions'
 require_relative 'sequel/privacy/viewer_context'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sequel-privacy
 version: !ruby/object:Gem::Version
-  version: 0.5.5
+  version: 0.5.6
 platform: ruby
 authors:
 - Austin Bales
@@ -114,6 +114,7 @@ files:
 - lib/sequel/privacy/i_actor.rb
 - lib/sequel/privacy/policy.rb
 - lib/sequel/privacy/policy_dsl.rb
+- lib/sequel/privacy/policy_factory.rb
 - lib/sequel/privacy/version.rb
 - lib/sequel/privacy/viewer_context.rb
 homepage: https://github.com/arbales/sequel-privacy