phlex-reactive 0.13.0 → 0.13.1

data/lib/phlex/reactive.rb

@@ -712,6 +712,41 @@ module Phlex
         defined?(::ActiveJob::Base) ? true : false
       end
 
+      # --- Async-action lifecycle / settles (issue #248) -----------------
+
+      # NOTE: there is deliberately NO settle_token_ttl. Issue #248's sketch had
+      # one for a fallback PULL token, but a settle has no pull lane at all — the
+      # client cannot poll "is the job done yet", and redeeming such a token at
+      # the defer endpoint would render the PRE-JOB component, which is the exact
+      # bug reply.pending exists to fix. A setting that cannot change behavior is
+      # worse than no setting: it tells an operator they can extend a wait window
+      # that is not governed by a token in the first place. The settle's wait is
+      # bounded by the JOB, not by a TTL.
+
+      # Window (ms) the AGGREGATE settle streams coalesce on — the count
+      # companion, the empty-state toggle, any companion refresh. They are
+      # idempotent replaces of stable targets, so a 177-row fan-out collapses to
+      # a handful of them instead of 177. The ROW streams are never coalesced.
+      # Needs pgbus with zoolutions/pgbus#465 on the peers path; without it the
+      # window is simply ignored. nil resets to the default.
+      attr_writer :settle_coalesce_window_ms
+
+      def settle_coalesce_window_ms
+        @settle_coalesce_window_ms ||= 50
+      end
+
+      # Can reply.pending mint a settle handle at all? A settle has NO pull
+      # fallback — the client cannot poll "is the job done yet" — so it needs
+      # the defer PUSH lane (durable pgbus one-shot stream + ActiveJob). A
+      # forced defer_transport of :fetch is therefore also a no.
+      #
+      # False does NOT break anything: reply.pending degrades to a plain
+      # enqueue (no pending markers, no handle, reactive_settle no-ops in the
+      # job) — today's behavior, never a permanently pending row.
+      def settle_capable?
+        defer_push_capable? && defer_transport != :fetch
+      end
+
       # DOM id of the host-app container a Response#flash appends into.
       # Default "flash"; override to match your layout's flash region.
       def flash_target

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: phlex-reactive
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.13.1
 platform: ruby
 authors:
 - Mikael Henriksson
@@ -153,6 +153,7 @@ files:
 - lib/phlex/reactive/authorization.rb
 - lib/phlex/reactive/claude/skills/phlex-reactive-debugging/SKILL.md
 - lib/phlex/reactive/client_bindings.rb
+- lib/phlex/reactive/collections.rb
 - lib/phlex/reactive/component.rb
 - lib/phlex/reactive/component/dsl.rb
 - lib/phlex/reactive/component/helpers.rb
@@ -178,8 +179,11 @@ files:
 - lib/phlex/reactive/mcp/tools/doctor_tool.rb
 - lib/phlex/reactive/mcp/tools/find_tool.rb
 - lib/phlex/reactive/param_schema.rb
+- lib/phlex/reactive/pending.rb
 - lib/phlex/reactive/reply.rb
 - lib/phlex/reactive/response.rb
+- lib/phlex/reactive/settle.rb
+- lib/phlex/reactive/settles.rb
 - lib/phlex/reactive/show_conditions.rb
 - lib/phlex/reactive/stream.rb
 - lib/phlex/reactive/streamable.rb