pgbus 0.8.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 60cc7178f84e5d28919085f5c5a9d824aca958180d433daf13cb04a369ed25c0
-  data.tar.gz: 5a7fdb569f90cf3e60ef5951e86d6ed0c3c31c7703b0f88be91c2df3054b8817
+  metadata.gz: f4ffab2bc9e16f1f6dd6c268a1e1019d768c916ea397064fc66c0f4938ce6e5a
+  data.tar.gz: ea2bfeb2bccc34b532facace227159cd0fa550d7ceb8c2ab57e48fa6a9a9020c
 SHA512:
-  metadata.gz: 8cc8aa7893bdb605379f4cea9542766062b5a759a89d6149e49a39729484f56790bc131b1063b16a855357a0ab4979aeb52f4bd9f572568e793482fcabaf9939
-  data.tar.gz: '052525538d45540220e66da0d43f007727848543d8f1184f7598f481e3abe3fe6be961eb6c634f414c158cd884b856305a35ded77e39d2f0f4d7c24bc10cf1a4'
+  metadata.gz: cbce8e9eb0243c5875f4d39ce55dd47b9eda9043959dbc833bd3a2ac7e1470bdb299d042e2394b747c59be45177ff9fdb349f1126f360e70a78b1c03dd2db90f
+  data.tar.gz: 6d46db3bd53e2f230a43fb89496f744976910a2f64540fbfde956e0d5661a808fcfc586a6a552fe114e6b716ff288e7d310651eb2f05ef381ee058e9d0180e60

data/lib/pgbus/client/notify_stream.rb

@@ -26,7 +26,7 @@ module Pgbus
 
         Instrumentation.instrument("pgbus.stream.notify", stream: stream_name, bytes: json.bytesize) do
           synchronized do
-            @pgmq.with_connection do |conn|
+            @pgmq.__send__(:with_connection) do |conn|
               conn.exec_params("SELECT pg_notify($1, $2)", [channel, json])
             end
           end

data/lib/pgbus/configuration.rb

@@ -105,7 +105,8 @@ module Pgbus
                   :streams_max_connections, :streams_idle_timeout, :streams_listen_health_check_ms,
                   :streams_write_deadline_ms, :streams_falcon_streaming_body,
                   :streams_stats_enabled, :streams_test_mode,
-                  :streams_orphan_sweep_interval, :streams_orphan_threshold
+                  :streams_orphan_sweep_interval, :streams_orphan_threshold,
+                  :streams_durable_patterns
     attr_reader :streams_default_broadcast_mode # rubocop:disable Style/AccessorGrouping
 
     # AppSignal integration (auto-loaded when ::Appsignal is defined and this is true).
@@ -221,6 +222,7 @@ module Pgbus
       @streams_default_broadcast_mode = :ephemeral
       @streams_orphan_sweep_interval = 3600    # 1 hour
       @streams_orphan_threshold = 86_400       # 24 hours
+      @streams_durable_patterns = []
 
       # AppSignal: auto-on when the appsignal gem is loaded; probe runs in
       # the same process, so the operator can disable it independently.
@@ -365,12 +367,24 @@ module Pgbus
         raise ArgumentError, "streams_orphan_sweep_interval must be a positive number or nil to disable"
       end
 
+      raise ArgumentError, "streams_durable_patterns must be an Array of strings/regex" unless streams_durable_patterns.is_a?(Array)
+
       return if streams_orphan_threshold.nil?
       return if streams_orphan_threshold.is_a?(Numeric) && streams_orphan_threshold.positive?
 
       raise ArgumentError, "streams_orphan_threshold must be a positive number or nil to disable"
     end
 
+    # Returns true if the given stream name should be durable based on
+    # `streams_durable_patterns` (exact string or Regexp match) or the
+    # `streams_default_broadcast_mode` fallback.
+    def stream_durable?(name)
+      patterns = streams_durable_patterns || []
+      return true if patterns.any? { |p| p.is_a?(Regexp) ? p.match?(name) : p == name }
+
+      streams_default_broadcast_mode == :durable
+    end
+
     # Set the worker capsule list. Accepts:
     #
     #   String — parsed via Pgbus::Configuration::CapsuleDSL into capsules

data/lib/pgbus/streams.rb

@@ -73,11 +73,15 @@ module Pgbus
       # satisfies the predicate. The label travels with the broadcast
       # through PGMQ; the predicate itself lives in-process on the
       # subscriber side and is evaluated per-connection by the Dispatcher.
-      def broadcast(payload, visible_to: nil)
+      # Per-broadcast `durable:` overrides the stream-level default for a
+      # single broadcast. `nil` (the default) defers to the stream's own
+      # `durable?` setting; `true`/`false` flip the mode for this call only.
+      def broadcast(payload, visible_to: nil, durable: nil)
         wrapped = { "html" => payload.to_s }
         wrapped["visible_to"] = visible_to.to_s if visible_to
 
-        return broadcast_ephemeral(wrapped) unless @durable
+        use_durable = durable.nil? ? @durable : durable
+        return broadcast_ephemeral(wrapped) unless use_durable
 
         ensure_queue!
         transaction = current_open_transaction

data/lib/pgbus/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pgbus
-  VERSION = "0.8.0"
+  VERSION = "0.8.1"
 end

data/lib/pgbus.rb

@@ -104,11 +104,16 @@ module Pgbus
     # clears it. The cache key is the resolved name string, not the raw
     # streamables, so `Pgbus.stream(@order)` and `Pgbus.stream(@order)`
     # in the same process return the same instance.
-    def stream(streamables, durable: true)
+    # `durable:` defaults to `nil` so the configuration resolves the mode:
+    # `streams_durable_patterns` first (exact string or regex match), then
+    # `streams_default_broadcast_mode`. Pass `durable: true`/`false`
+    # explicitly to bypass the resolver for this Stream instance.
+    def stream(streamables, durable: nil)
       name = Streams::Stream.name_from(streamables)
-      cache_key = "#{name}:#{durable ? "d" : "e"}"
+      resolved = durable.nil? ? configuration.stream_durable?(name) : durable
+      cache_key = "#{name}:#{resolved ? "d" : "e"}"
       @stream_cache ||= Concurrent::Map.new
-      @stream_cache.compute_if_absent(cache_key) { Streams::Stream.new(streamables, durable: durable) }
+      @stream_cache.compute_if_absent(cache_key) { Streams::Stream.new(streamables, durable: resolved) }
     end
 
     # Compose a short, pgbus-safe stream identifier from any mix of

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pgbus
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.8.1
 platform: ruby
 authors:
 - Mikael Henriksson