yrb-lite 0.1.0.beta3-x64-mingw-ucrt → 0.1.0.beta4-x64-mingw-ucrt

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 686bfcb39cb90dbc8b8a8fa5c7730bc6c7ebb9f639d5b272e8ebec5554c0f542
-  data.tar.gz: d976ab5a72dc893a6918f0d18dc2bb8d7567dde85db3ba2620a1999b7fb1dda9
+  metadata.gz: 3672b18498ed0869245f9fa46f1533e566c8bea07de50e9434c12be6fc59809a
+  data.tar.gz: fc387717203ebc9cfcb0b2bc1f2f237cbaef5b94227a52dabfbf51d7aa114b17
 SHA512:
-  metadata.gz: c224789675d7324cd9888ade7b8a52222893797c161643c98553bee7f24b2353493bec31011de86ee959a19a80f0e54f76c8849de9d904b411f06ea59d3330c4
-  data.tar.gz: fb3d8eebde8933ac1de8fc0c53dc7a308d624a075dbb7e9c8b1444e2fed097227c2967d309b6f34026a5cfc655376b8a0ad4f5b345557529eb257b63c690f787
+  metadata.gz: 273faf59f30c643e90a02ad07615123d1084d80070d0c51e011b62599dfde282b4cfb052215ab3af73e62ec3c11a2285410d8093f863bc8ba3a929d820a226e1
+  data.tar.gz: 1e139b9e19c82834852bf9809dbbe318e67b4c9997263c7be1259d284ee96fc0f0237a1d1e2859727817df8e5d16025f355b98af7b7e11d9b0723e27fbc2f7e7

data/CHANGELOG.md

@@ -6,6 +6,21 @@ to follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.1.0.beta4] - 2026-06-18
+
+### Changed
+
+- `on_change` block recorders now run in the **channel instance's context**
+  (via `instance_exec`), so a recorder can call the channel's own methods --
+  `current_user`, `params`, request/connection-scoped accessors -- directly,
+  instead of plumbing them in through a thread-local. A non-Proc callable (an
+  object responding to `#call`) is still invoked with `#call` and its own
+  context. `on_load`/`on_save` are unchanged: they can run in the shared
+  document registry during a cold load or eviction, where no connection
+  instance exists, so they remain key-only. Existing block recorders that use
+  only the `(key, update)` arguments and lexically-scoped constants are
+  unaffected; the only behavioral change is `self` inside the block.
+
 ## [0.1.0.beta3] - 2026-06-18
 
 ### Changed
@@ -76,7 +91,8 @@ to follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 - Precompiled native gems for common platforms (no Rust toolchain needed to
   install) via the cross-gem workflow.
 
-[Unreleased]: https://github.com/jpcamara/yrb-lite/compare/v0.1.0.beta3...main
+[Unreleased]: https://github.com/jpcamara/yrb-lite/compare/v0.1.0.beta4...main
+[0.1.0.beta4]: https://github.com/jpcamara/yrb-lite/compare/v0.1.0.beta3...v0.1.0.beta4
 [0.1.0.beta3]: https://github.com/jpcamara/yrb-lite/compare/v0.1.0.beta2...v0.1.0.beta3
 [0.1.0.beta2]: https://github.com/jpcamara/yrb-lite/compare/v0.1.0.beta1...v0.1.0.beta2
 [0.1.0.beta1]: https://github.com/jpcamara/yrb-lite/releases/tag/v0.1.0.beta1

data/lib/yrb_lite/sync.rb

@@ -20,6 +20,10 @@ module YrbLite
   #     on_load { |key| Document.find_by(key: key)&.content }
   #     on_save { |key, update| Document.find_by(key: key)&.update!(content: update) }
   #
+  #     # on_change blocks run in the channel instance's context, so instance
+  #     # methods (current_user, params, ...) are available without plumbing:
+  #     on_change { |key, update| Document.record!(key, update, by: current_user) }
+  #
   #     def subscribed
   #       sync_for params[:id]
   #     end
@@ -73,6 +77,13 @@ module YrbLite
       # the change is rejected: neither applied to the shared document nor
       # broadcast to other subscribers.
       #
+      # A block recorder runs in the *channel instance's* context, so it can
+      # call the channel's own methods (current_user, params, a per-connection
+      # Current.* accessor) directly, with no thread-local plumbing. (A non-Proc
+      # callable is invoked with #call instead, since it carries its own
+      # context.) on_change always fires from within sync_receive, unlike
+      # on_load/on_save, which can run context-free in the shared registry.
+      #
       # Registering an on_change switches that channel onto the strict path
       # (record, apply, broadcast). Without it, the default fast path applies
       # and broadcasts, with an optional on_save snapshot.
@@ -282,9 +293,9 @@ module YrbLite
         next :noop unless update
         next :gap unless awareness.update_ready?(update)
 
-        recorder.call(@sync_key, update) # durable write; raise to reject
-        awareness.apply_update(update)   # only recorded changes reach the doc
-        sync_distribute(encoded)         # ...and only then the wire
+        sync_record_change(recorder, update) # durable write; raise to reject
+        awareness.apply_update(update) # only recorded changes reach the doc
+        sync_distribute(encoded) # ...and only then the wire
         :recorded
       end
 
@@ -422,7 +433,9 @@ module YrbLite
           return :gap
         end
 
-        self.class.on_change&.call(@sync_key, update) # record before relay
+        if (recorder = self.class.on_change)
+          sync_record_change(recorder, update) # record before relay
+        end
         sync_distribute(encoded)
         :recorded
       when MSG_KIND_AWARENESS
@@ -460,6 +473,14 @@ module YrbLite
       saver.call(@sync_key, sync_awareness.encode_state_as_update)
     end
 
+    # Invoke the on_change recorder. A block/proc runs in this channel instance's
+    # context (instance_exec) so it can reach the channel's own methods; a
+    # non-Proc callable is invoked with #call, since it carries its own context.
+    def sync_record_change(recorder, update)
+      args = [@sync_key, update]
+      recorder.is_a?(Proc) ? instance_exec(*args, &recorder) : recorder.call(*args)
+    end
+
     # -- Shared document registry ------------------------------------------
 
     @registry = {}

data/lib/yrb_lite/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module YrbLite
-  VERSION = "0.1.0.beta3"
+  VERSION = "0.1.0.beta4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yrb-lite
 version: !ruby/object:Gem::Version
-  version: 0.1.0.beta3
+  version: 0.1.0.beta4
 platform: x64-mingw-ucrt
 authors:
 - JP Camara