ree_lib 1.3.11 → 1.3.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49fa98abf408507fb7c59dea94efc94717156aa50e76b3015aee6dcada1e0f17
-  data.tar.gz: 9a5927b28c56d6b8982e2565340d7816600f894becd05493bfcb9178196e85c6
+  metadata.gz: e10f8d9ba3558f200f081f325d2a7f10b81696459c8fbdd9054fd4e0b72c72ed
+  data.tar.gz: fc2f2bba979d98082ed296caeeb8823cf1cef3201cbda6244adb131e7ccc5db1
 SHA512:
-  metadata.gz: ccdc45ab27ff92239fa01fa4bdd678c29d45a102af203192991acbf12caf447b77a6a8849d6a6f23d1891453b29074e1ed1a1503f239102d0e15948d40f4b364
-  data.tar.gz: e6af57d77e1eb6c41cf5b678e216741ec505ceec40eb74abc07fbebe134d43b6e82e33e82aed2ce5fc4a1085ff730324be4678cc32d0de920b89607947902764
+  metadata.gz: 4cbd59039f6e3b238db9c88763e75f753a567c13edd080eda2e6fafbed838e3c61a71d9ee40af35b7042f58cee315f5aa3c7cdf8be8b2e7ae339f9ed7883906d
+  data.tar.gz: e0dddd85f84fec535514ebbec51e78425511b32a8ee877b65fdf4ac31f513717f9c12ab80d4772d7649ad1856ad625bf1d967e9c56d78823dc1435196b438c85

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [1.3.12] - 2026-09-02
+
+- `ree_audit`: `annotate_audit` fn — the entry point product code uses to attach
+  facts to the current audited call. Declared `freeze false` so a host
+  application can stub it in its own specs.
+
 ## [1.3.11] - 2026-09-02
 
 - New `ree_audit` package: an opt-in trail of audited action calls (event,

data/Gemfile.lock

@@ -9,7 +9,7 @@ PATH
 PATH
   remote: .
   specs:
-    ree_lib (1.3.10)
+    ree_lib (1.3.12)
       bigdecimal
       binding_of_caller
       i18n

data/lib/ree_lib/packages/ree_audit/package/ree_audit/functions/annotate_audit.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# Точка входа для продуктового кода: прикрепить к текущему аудируемому вызову
+# то, что известно только внутри — какое право проверено, к чьим данным и к
+# какому объекту обратились.
+#
+# Почему fn, а не голая константа ReeAudit.annotate: одного `depends_on
+# :ree_audit` хватило бы, чтобы пакет загрузился, но проверка объявленной
+# зависимости (check_package_dependency_added) срабатывает только для
+# `link`/`import`. Голая константа проходит мимо неё — и удаление `depends_on`
+# как «неиспользуемого» уронило бы приложение NameError'ом уже в проде.
+class ReeAudit::AnnotateAudit
+  include Ree::FnDSL
+
+  fn :annotate_audit do
+    # fn из общего пакета иначе не подменить в спеках приложения
+    freeze false
+  end
+
+  doc("Прикрепляет факты приложения к текущему событию аудита. nil — если аудит выключен или вызов пришёл не из аудируемого маршрута.")
+  contract(Ksplat[RestKeys => Any] => Nilor[Hash])
+  def call(**attrs)
+    ReeAudit.annotate(**attrs)
+  end
+end

data/lib/ree_lib/packages/ree_audit/spec/ree_audit/functions/annotate_audit_spec.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+package_require('ree_audit/functions/annotate_audit')
+package_require('ree_audit/event')
+
+RSpec.describe :annotate_audit do
+  link :annotate_audit, from: :ree_audit
+
+  before { ReeAudit::Context.clear }
+  after { ReeAudit::Context.clear }
+
+  it "returns nil outside an audited call" do
+    expect(annotate_audit(permission: :access_uploads)).to be_nil
+  end
+
+  it "merges into the current event" do
+    event = ReeAudit::Event.build(action_name: :some_query)
+    ReeAudit::Context.push(event)
+
+    annotate_audit(permission: :access_uploads)
+    annotate_audit(subject: {type: :upload, id: "abc"})
+
+    expect(event.annotations).to eq({
+      permission: :access_uploads,
+      subject: {type: :upload, id: "abc"}
+    })
+  end
+end

data/lib/ree_lib/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ReeLib
-  VERSION = "1.3.11"
+  VERSION = "1.3.12"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ree_lib
 version: !ruby/object:Gem::Version
-  version: 1.3.11
+  version: 1.3.12
 platform: ruby
 authors:
 - Ruslan Gatiyatov
@@ -282,12 +282,14 @@ files:
 - lib/ree_lib/packages/ree_audit/package/ree_audit/config.rb
 - lib/ree_lib/packages/ree_audit/package/ree_audit/context.rb
 - lib/ree_lib/packages/ree_audit/package/ree_audit/event.rb
+- lib/ree_lib/packages/ree_audit/package/ree_audit/functions/annotate_audit.rb
 - lib/ree_lib/packages/ree_audit/package/ree_audit/functions/filter_params.rb
 - lib/ree_lib/packages/ree_audit/package/ree_audit/sinks/logger_sink.rb
 - lib/ree_lib/packages/ree_audit/package/ree_audit/sinks/null_sink.rb
 - lib/ree_lib/packages/ree_audit/package/ree_audit/sinks/sink.rb
 - lib/ree_lib/packages/ree_audit/spec/ree_audit/beans/audit_spec.rb
 - lib/ree_lib/packages/ree_audit/spec/ree_audit/context_spec.rb
+- lib/ree_lib/packages/ree_audit/spec/ree_audit/functions/annotate_audit_spec.rb
 - lib/ree_lib/packages/ree_audit/spec/ree_audit/functions/filter_params_spec.rb
 - lib/ree_lib/packages/ree_audit/spec/spec_helper.rb
 - lib/ree_lib/packages/ree_dao/.gitignore