yrb-lite 0.1.0.beta3-x86_64-linux-musl → 0.1.0.beta4-x86_64-linux-musl

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8c75abbfba8fd4f5b06a613066e804ac630a6078509142f8d96bdb9f98ddbf7
-  data.tar.gz: 8406c4ccbebfd116f53b04b48c4f328dfcf93cfff9fd1a384efb903aa096abee
+  metadata.gz: d30b134e25ded582a7cefad2c3aacaa9fb25fac53c686b4a68fdf1c54c858f05
+  data.tar.gz: f8c392669953c1658de1b2174ec5beb5f814902f2110d49e115e125770be6eb3
 SHA512:
-  metadata.gz: a8f63fa73e324759d2c550b01369412c50cdfac92afab4a5249fd7ac9bee6cda6e8d42d06b78e13ea84bea0b20d2933446e6c3bf9e7bddd90e8ca68a2845ee42
-  data.tar.gz: e00e0b3d388f9ef6c496cc508797f3d928e301fd80b4d363df157a79c1ab54feeb8e078f501331604803faa68b683abc9477eafaf26670eee890c2a5c1001a09
+  metadata.gz: 0bb4e1724eff734814185ef7d5fe600741d8fd4e8ac6f6fcf3f258279e9a29d5f407a8a290a7778c41d071db43165a3a8bfb38e83c9127f631d25a9cd69f1539
+  data.tar.gz: 4652e8fc269d4ddb5f9a2e13579c4f76c34fffed24879505a20e1df3628be549282cd8f834ed7c3d7bbff0011e1783359678c0c9a7770040b1409d3112a698be

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: x86_64-linux-musl
 authors:
 - JP Camara