@feathq/web-sdk 0.3.0 → 0.4.0

package/dist/index.cjs

@@ -287,6 +287,10 @@ var DatafileStream = class {
       const datafile = parsePut(ev.data);
       if (datafile) this.options.onPut(datafile);
     });
+    source.addEventListener("patch", (ev) => {
+      const patch = parsePatch(ev.data);
+      if (patch) this.options.onPatch(patch);
+    });
     source.addEventListener("error", () => {
       if (!this.warned) {
         this.warned = true;
@@ -313,9 +317,37 @@ function parsePut(data) {
   }
   return null;
 }
+function parsePatch(data) {
+  if (typeof data !== "string") return null;
+  try {
+    const p = JSON.parse(data);
+    if (!p || typeof p !== "object") return null;
+    if (!Number.isInteger(p.from) || !Number.isInteger(p.to)) return null;
+    if (p.to <= p.from) return null;
+    if (typeof p.etag !== "string" || typeof p.generatedAt !== "string") return null;
+    return {
+      from: p.from,
+      to: p.to,
+      etag: p.etag,
+      generatedAt: p.generatedAt,
+      flags: isRecord(p.flags) ? p.flags : {},
+      removedFlags: isStringArray(p.removedFlags) ? p.removedFlags : [],
+      segments: isRecord(p.segments) ? p.segments : {},
+      removedSegments: isStringArray(p.removedSegments) ? p.removedSegments : []
+    };
+  } catch {
+  }
+  return null;
+}
+function isRecord(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function isStringArray(v) {
+  return Array.isArray(v) && v.every((x) => typeof x === "string");
+}
 
 // src/version.ts
-var SDK_VERSION = "0.3.0";
+var SDK_VERSION = "0.4.0";
 
 // src/client.ts
 var CLIENT_SIDE_PREFIX = "feat_cs_";
@@ -574,6 +606,34 @@ var FeatWebClient = class {
     if (publish) this.broadcast?.publish(datafile, etag);
     await this.recomputeCache();
   }
+  // Apply an incremental SSE `patch`. Version-gated and atomic: a patch is only
+  // adopted when its `from` exactly matches the version we currently hold, so a
+  // missed intermediate patch (a gap) or a duplicate is ignored rather than
+  // applied out of order. On a match we merge the changed flags/segments, drop
+  // the removed keys, and advance version/etag/generatedAt to the patch's `to`,
+  // then hand the rebuilt datafile to adoptDatafile - the single version-ordered
+  // adopt path - so the cache recompute, etag write, cache save, and sibling-tab
+  // broadcast all go through the same code as a full `put` (no drift, no HTTP
+  // refetch). adoptDatafile's `version <= held` guard is satisfied because the
+  // wire invariant `to > from` holds and `from` equals the held version.
+  async applyPatch(patch) {
+    if (this.closed) return;
+    const current = this.datafile;
+    if (!current || current.version !== patch.from) return;
+    const flags = { ...current.flags, ...patch.flags };
+    for (const key of patch.removedFlags) delete flags[key];
+    const segments = { ...current.segments, ...patch.segments };
+    for (const key of patch.removedSegments) delete segments[key];
+    const next = {
+      ...current,
+      flags,
+      segments,
+      version: patch.to,
+      etag: patch.etag,
+      generatedAt: patch.generatedAt
+    };
+    return this.adoptDatafile(next, patch.etag, true);
+  }
   // Reconcile the SSE connection with the current streaming policy. Called
   // whenever an input to that policy changes: ready, a `change` (un)subscribe,
   // or close.
@@ -614,6 +674,16 @@ var FeatWebClient = class {
           void this.adoptDatafile(datafile, datafile.etag, true).catch((err) => {
             console.warn("feat: streamed datafile update failed:", messageOf(err));
           });
+        },
+        // A `patch` carries an incremental delta. Apply it only when it builds
+        // on the version we currently hold; a pure version gap is ignored. The
+        // SSE connection stays healthy in that case and does NOT reconnect or
+        // re-seed, so recovery comes solely from the safety-net poll. Reconnect
+        // re-seeding (a fresh full `put`) only happens on an actual stream drop.
+        onPatch: (patch) => {
+          void this.applyPatch(patch).catch((err) => {
+            console.warn("feat: streamed datafile patch failed:", messageOf(err));
+          });
         }
       });
     }
@@ -685,7 +755,7 @@ function assertHttpsUrl(url) {
 }
 
 // src/index.ts
-var SDK_VERSION2 = "0.3.0";
+var SDK_VERSION2 = "0.4.0";
 
 exports.FeatWebClient = FeatWebClient;
 exports.SDK_VERSION = SDK_VERSION2;

package/dist/index.d.cts

@@ -92,12 +92,13 @@ declare class FeatWebClient {
     private fetchDatafile;
     private adoptFromBroadcast;
     private adoptDatafile;
+    private applyPatch;
     private maybeUpdateStream;
     private wantsStream;
     private openStream;
     private recomputeCache;
 }
 
-declare const SDK_VERSION = "0.3.0";
+declare const SDK_VERSION = "0.4.0";
 
 export { type ChangeEvent, type EventSourceConstructor, FeatWebClient, type FeatWebClientConfig, type FlagEventMap, SDK_VERSION };

package/dist/index.d.ts

@@ -92,12 +92,13 @@ declare class FeatWebClient {
     private fetchDatafile;
     private adoptFromBroadcast;
     private adoptDatafile;
+    private applyPatch;
     private maybeUpdateStream;
     private wantsStream;
     private openStream;
     private recomputeCache;
 }
 
-declare const SDK_VERSION = "0.3.0";
+declare const SDK_VERSION = "0.4.0";
 
 export { type ChangeEvent, type EventSourceConstructor, FeatWebClient, type FeatWebClientConfig, type FlagEventMap, SDK_VERSION };

package/dist/index.js

@@ -285,6 +285,10 @@ var DatafileStream = class {
       const datafile = parsePut(ev.data);
       if (datafile) this.options.onPut(datafile);
     });
+    source.addEventListener("patch", (ev) => {
+      const patch = parsePatch(ev.data);
+      if (patch) this.options.onPatch(patch);
+    });
     source.addEventListener("error", () => {
       if (!this.warned) {
         this.warned = true;
@@ -311,9 +315,37 @@ function parsePut(data) {
   }
   return null;
 }
+function parsePatch(data) {
+  if (typeof data !== "string") return null;
+  try {
+    const p = JSON.parse(data);
+    if (!p || typeof p !== "object") return null;
+    if (!Number.isInteger(p.from) || !Number.isInteger(p.to)) return null;
+    if (p.to <= p.from) return null;
+    if (typeof p.etag !== "string" || typeof p.generatedAt !== "string") return null;
+    return {
+      from: p.from,
+      to: p.to,
+      etag: p.etag,
+      generatedAt: p.generatedAt,
+      flags: isRecord(p.flags) ? p.flags : {},
+      removedFlags: isStringArray(p.removedFlags) ? p.removedFlags : [],
+      segments: isRecord(p.segments) ? p.segments : {},
+      removedSegments: isStringArray(p.removedSegments) ? p.removedSegments : []
+    };
+  } catch {
+  }
+  return null;
+}
+function isRecord(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function isStringArray(v) {
+  return Array.isArray(v) && v.every((x) => typeof x === "string");
+}
 
 // src/version.ts
-var SDK_VERSION = "0.3.0";
+var SDK_VERSION = "0.4.0";
 
 // src/client.ts
 var CLIENT_SIDE_PREFIX = "feat_cs_";
@@ -572,6 +604,34 @@ var FeatWebClient = class {
     if (publish) this.broadcast?.publish(datafile, etag);
     await this.recomputeCache();
   }
+  // Apply an incremental SSE `patch`. Version-gated and atomic: a patch is only
+  // adopted when its `from` exactly matches the version we currently hold, so a
+  // missed intermediate patch (a gap) or a duplicate is ignored rather than
+  // applied out of order. On a match we merge the changed flags/segments, drop
+  // the removed keys, and advance version/etag/generatedAt to the patch's `to`,
+  // then hand the rebuilt datafile to adoptDatafile - the single version-ordered
+  // adopt path - so the cache recompute, etag write, cache save, and sibling-tab
+  // broadcast all go through the same code as a full `put` (no drift, no HTTP
+  // refetch). adoptDatafile's `version <= held` guard is satisfied because the
+  // wire invariant `to > from` holds and `from` equals the held version.
+  async applyPatch(patch) {
+    if (this.closed) return;
+    const current = this.datafile;
+    if (!current || current.version !== patch.from) return;
+    const flags = { ...current.flags, ...patch.flags };
+    for (const key of patch.removedFlags) delete flags[key];
+    const segments = { ...current.segments, ...patch.segments };
+    for (const key of patch.removedSegments) delete segments[key];
+    const next = {
+      ...current,
+      flags,
+      segments,
+      version: patch.to,
+      etag: patch.etag,
+      generatedAt: patch.generatedAt
+    };
+    return this.adoptDatafile(next, patch.etag, true);
+  }
   // Reconcile the SSE connection with the current streaming policy. Called
   // whenever an input to that policy changes: ready, a `change` (un)subscribe,
   // or close.
@@ -612,6 +672,16 @@ var FeatWebClient = class {
           void this.adoptDatafile(datafile, datafile.etag, true).catch((err) => {
             console.warn("feat: streamed datafile update failed:", messageOf(err));
           });
+        },
+        // A `patch` carries an incremental delta. Apply it only when it builds
+        // on the version we currently hold; a pure version gap is ignored. The
+        // SSE connection stays healthy in that case and does NOT reconnect or
+        // re-seed, so recovery comes solely from the safety-net poll. Reconnect
+        // re-seeding (a fresh full `put`) only happens on an actual stream drop.
+        onPatch: (patch) => {
+          void this.applyPatch(patch).catch((err) => {
+            console.warn("feat: streamed datafile patch failed:", messageOf(err));
+          });
         }
       });
     }
@@ -683,6 +753,6 @@ function assertHttpsUrl(url) {
 }
 
 // src/index.ts
-var SDK_VERSION2 = "0.3.0";
+var SDK_VERSION2 = "0.4.0";
 
 export { FeatWebClient, SDK_VERSION2 as SDK_VERSION };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feathq/web-sdk",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "feat feature-flag SDK for browsers. Polling client + sync evaluation cache. Pair with @feathq/openfeature-web for OpenFeature.",
   "keywords": [
     "feature-flags",