feat-sdk 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96fb093819af9d5ad6b3caf1e2d7dbe8bb54615c72c96d44c54a50e90a5b2ec4
-  data.tar.gz: 62b5a48dfc8bd4917567aff1c43ca75907b9f474f3ae60500b73d53b58dd57c2
+  metadata.gz: 4dfb1cd9905d46890db88dea9411a6dc3755208286fbbec6565d8742459d5008
+  data.tar.gz: 63c030396f376ff362b3d0d5b7c07a7cc926b4dd5141c9516988dbcb87a3419f
 SHA512:
-  metadata.gz: 8cc1f3d77862b0fa9adde4d8c5a766bc2ab17e040cd791054c8fbde8199e9764067412e48d451283c8a3d47c6484cb317b83aefb63efda48a1249e65eca2859a
-  data.tar.gz: c6f7fac4513cbcdcdcd605d8a326ce858638a2a8da6f9bed01f834f696c5d792323471fe6d77ec631ec671307da82bd54b6fa3587374f66cded36c75919d794f
+  metadata.gz: 347f444e5f8354f9b4b4d8957c812bde443a502b7c6cc54623df05983abe332cafd77f37ffebbb01d8cd8e8940d280a8004068e16403398721b2bb6bcc2ec4c6
+  data.tar.gz: e192084e64f93ff51ab4e14aa4384ec0954be13f6e4996c00371185deee30a9fe67b718d3065a07b64d2bd15dd98a4bfcf0677bb54e67a0959015ad542504fee

data/lib/feat/client.rb

@@ -135,9 +135,36 @@ module Feat
         api_key: @api_key,
         transport: transport,
         on_put: ->(parsed) { store_datafile(parsed, parsed["etag"]) },
+        on_patch: ->(parsed) { apply_patch(parsed) },
       )
     end
 
+    # Apply a streamed `patch` delta. Version-gated: the delta is merged only
+    # when the in-memory datafile's version equals the patch's +from+, so the
+    # result is exactly the +to+ snapshot. On any gap or mismatch the patch is
+    # ignored - a reconnect reseeds a full `put` and the safety poll backstops.
+    # Runs under the same mutex as store_datafile, so a subsequent evaluation
+    # sees the merged delta atomically. Returns true when applied.
+    def apply_patch(patch)
+      from = patch["from"]
+      to   = patch["to"]
+      # Reject malformed or out-of-order deltas before touching the datafile:
+      # both bounds must be integers and the patch must move strictly forward.
+      # Without the `to > from` guard a backward `to` would roll the in-memory
+      # version backward and break version ordering.
+      return false unless from.is_a?(Integer) && to.is_a?(Integer) && to > from
+
+      @mutex.synchronize do
+        current = @datafile
+        return false if current.nil?
+        return false unless current.version == from
+
+        @datafile = Datafile.merge_patch(current, patch)
+        @etag = patch["etag"] if patch["etag"]
+      end
+      true
+    end
+
     def poll_loop
       until @stop
         interruptible_sleep(@poll_interval) { @stop }

data/lib/feat/datafile.rb

@@ -49,6 +49,36 @@ module Feat
       )
     end
 
+    # Merge a patch delta onto an existing File and return a new File. Pure:
+    # +current+ is not mutated. Added or changed flags/segments are built
+    # from their wire objects and override by key; removed keys are dropped.
+    # version, etag, and generatedAt advance to the patch's values (etag and
+    # generatedAt fall back to the current ones when the patch omits them).
+    # Raises if a flag or segment object is malformed; the caller treats that
+    # as a no-op and ignores the patch.
+    def self.merge_patch(current, patch)
+      flags = current.flags.dup
+      (patch["flags"] || {}).each { |k, v| flags[k] = build_flag(v) }
+      (patch["removedFlags"] || []).each { |k| flags.delete(k) }
+
+      segments = current.segments.dup
+      (patch["segments"] || {}).each { |k, v| segments[k] = build_segment(v) }
+      (patch["removedSegments"] || []).each { |k| segments.delete(k) }
+
+      File.new(
+        schemaVersion: current.schemaVersion,
+        envId:         current.envId,
+        envKey:        current.envKey,
+        projectId:     current.projectId,
+        version:       patch["to"],
+        etag:          patch["etag"] || current.etag,
+        generatedAt:   patch["generatedAt"] || current.generatedAt,
+        flags:         flags,
+        segments:      segments,
+        contextKinds:  current.contextKinds
+      )
+    end
+
     def self.build_flag(d)
       FlagSpec.new(
         id:                             d["id"],

data/lib/feat/streaming.rb

@@ -87,8 +87,9 @@ module Feat
   end
 
   # Holds a long-lived SSE connection to the datafile stream endpoint and
-  # invokes +on_put+ with the parsed datafile for every `put` frame. Runs on
-  # its own thread, reconnects with exponential backoff, and stops cleanly.
+  # invokes +on_put+ with the parsed datafile for every `put` frame and
+  # +on_patch+ with the parsed delta for every `patch` frame. Runs on its
+  # own thread, reconnects with exponential backoff, and stops cleanly.
   class StreamingClient
     include InterruptibleSleep
 
@@ -106,7 +107,7 @@ module Feat
     TERMINAL_STREAM_CODES = [401, 403].freeze
     JOIN_TIMEOUT_SECONDS = 5
 
-    def initialize(url:, api_key:, transport:, on_put:, on_error: nil,
+    def initialize(url:, api_key:, transport:, on_put:, on_patch: nil, on_error: nil,
                    initial_backoff: DEFAULT_INITIAL_BACKOFF,
                    max_backoff: DEFAULT_MAX_BACKOFF,
                    min_uptime: DEFAULT_MIN_UPTIME,
@@ -115,6 +116,7 @@ module Feat
       @api_key         = api_key
       @transport       = transport
       @on_put          = on_put
+      @on_patch        = on_patch
       @on_error        = on_error
       @initial_backoff = initial_backoff
       @max_backoff     = max_backoff
@@ -213,8 +215,19 @@ module Feat
     end
 
     def handle_event(event)
-      return unless event[:event] == "put"
+      case event[:event]
+      when "put"   then with_parsed_payload(event) { |parsed| @on_put.call(parsed) }
+      when "patch" then with_parsed_payload(event) { |parsed| @on_patch&.call(parsed) }
+      end
+    rescue StandardError => e
+      notify_error(e)
+    end
 
+    # Decode the event's JSON data field and hand it to the block. A missing,
+    # empty, or unparseable payload is dropped silently (the next frame or a
+    # reconnect recovers); any error the block raises bubbles to the caller's
+    # rescue and is surfaced via on_error.
+    def with_parsed_payload(event)
       raw = event[:data]
       return if raw.nil? || raw.empty?
 
@@ -225,9 +238,7 @@ module Feat
           return
         end
 
-      @on_put.call(parsed)
-    rescue StandardError => e
-      notify_error(e)
+      yield parsed
     end
 
     # We deliberately do not send a Last-Event-ID header to resume. The

data/lib/feat/version.rb

@@ -1,3 +1,3 @@
 module Feat
-  VERSION = "0.2.0".freeze
+  VERSION = "0.3.0".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: feat-sdk
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - feat HQ