@feathq/js-sdk 0.2.0 → 0.3.0

package/dist/index.cjs

@@ -145,7 +145,7 @@ var SseParser = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.2.0";
+var SDK_VERSION = "0.3.0";
 
 // src/client.ts
 var MIN_POLL_INTERVAL_MS = 5e3;
@@ -292,7 +292,16 @@ var FeatClient = class {
     this.scheduleNextPoll();
   }
   handleFrame(frame) {
-    if (frame.event !== "put") return;
+    if (frame.event === "put") {
+      this.handlePutFrame(frame);
+      return;
+    }
+    if (frame.event === "patch") {
+      this.handlePatchFrame(frame);
+      return;
+    }
+  }
+  handlePutFrame(frame) {
     let next;
     try {
       next = JSON.parse(frame.data);
@@ -302,6 +311,49 @@ var FeatClient = class {
     }
     this.adoptDatafile(next);
   }
+  // Apply an incremental `patch` frame in place. The patch is gated on the
+  // base `from` version: it only applies when it lines up exactly with the
+  // datafile we currently hold. On any gap (or before we have bootstrapped a
+  // datafile at all) the patch is dropped; the reconnect reseed (a full `put`)
+  // and the safety-net poll keep the client correct.
+  handlePatchFrame(frame) {
+    let patch;
+    try {
+      patch = parseDatafilePatch(JSON.parse(frame.data));
+    } catch {
+      warn("ignoring stream frame with invalid patch JSON");
+      return;
+    }
+    if (!patch) {
+      warn("ignoring malformed datafile patch");
+      return;
+    }
+    this.applyPatch(patch);
+  }
+  // Merge a version-matched delta atomically: build the next datafile in full,
+  // then swap it in so a partially-applied patch is never observable. Returns
+  // true if applied. Updates the ETag the conditional poll sends so the
+  // safety-net poll 304s instead of re-downloading the whole datafile.
+  applyPatch(patch) {
+    const current = this.datafile;
+    if (!current || current.version !== patch.from) return false;
+    const flags = { ...current.flags };
+    for (const [key, flag] of Object.entries(patch.flags)) flags[key] = flag;
+    for (const key of patch.removedFlags) delete flags[key];
+    const segments = { ...current.segments };
+    for (const [key, segment] of Object.entries(patch.segments)) segments[key] = segment;
+    for (const key of patch.removedSegments) delete segments[key];
+    this.datafile = {
+      ...current,
+      flags,
+      segments,
+      version: patch.to,
+      etag: patch.etag,
+      generatedAt: patch.generatedAt
+    };
+    this.etag = patch.etag;
+    return true;
+  }
   // Adopt a datafile only if its version is strictly newer than what we
   // hold. Equal or older versions are ignored so out-of-order pushes or a
   // stale poll can never roll the datafile backwards. Returns true if
@@ -340,6 +392,40 @@ var FeatClient = class {
     return adopted;
   }
 };
+function parseDatafilePatch(raw) {
+  if (typeof raw !== "object" || raw === null) return null;
+  const p = raw;
+  if (typeof p.from !== "number" || typeof p.to !== "number") return null;
+  if (!Number.isInteger(p.from) || !Number.isInteger(p.to) || p.to <= p.from) return null;
+  if (typeof p.etag !== "string" || typeof p.generatedAt !== "string") return null;
+  const flags = asRecord(p.flags);
+  const segments = asRecord(p.segments);
+  const removedFlags = asStringArray(p.removedFlags);
+  const removedSegments = asStringArray(p.removedSegments);
+  if (flags === null || segments === null) return null;
+  if (removedFlags === null || removedSegments === null) return null;
+  return {
+    from: p.from,
+    to: p.to,
+    etag: p.etag,
+    generatedAt: p.generatedAt,
+    flags,
+    removedFlags,
+    segments,
+    removedSegments
+  };
+}
+function asRecord(value) {
+  if (value === void 0) return {};
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return null;
+  return value;
+}
+function asStringArray(value) {
+  if (value === void 0) return [];
+  if (!Array.isArray(value)) return null;
+  if (value.some((item) => typeof item !== "string")) return null;
+  return value;
+}
 function warn(message, err) {
   if (err === void 0) {
     console.warn(`feat: ${message}`);

package/dist/index.d.cts

@@ -54,6 +54,9 @@ declare class FeatClient {
     private runStreamLoop;
     private setStreamConnected;
     private handleFrame;
+    private handlePutFrame;
+    private handlePatchFrame;
+    private applyPatch;
     private adoptDatafile;
     private fetchDatafile;
 }

package/dist/index.d.ts

@@ -54,6 +54,9 @@ declare class FeatClient {
     private runStreamLoop;
     private setStreamConnected;
     private handleFrame;
+    private handlePutFrame;
+    private handlePatchFrame;
+    private applyPatch;
     private adoptDatafile;
     private fetchDatafile;
 }

package/dist/index.js

@@ -144,7 +144,7 @@ var SseParser = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.2.0";
+var SDK_VERSION = "0.3.0";
 
 // src/client.ts
 var MIN_POLL_INTERVAL_MS = 5e3;
@@ -291,7 +291,16 @@ var FeatClient = class {
     this.scheduleNextPoll();
   }
   handleFrame(frame) {
-    if (frame.event !== "put") return;
+    if (frame.event === "put") {
+      this.handlePutFrame(frame);
+      return;
+    }
+    if (frame.event === "patch") {
+      this.handlePatchFrame(frame);
+      return;
+    }
+  }
+  handlePutFrame(frame) {
     let next;
     try {
       next = JSON.parse(frame.data);
@@ -301,6 +310,49 @@ var FeatClient = class {
     }
     this.adoptDatafile(next);
   }
+  // Apply an incremental `patch` frame in place. The patch is gated on the
+  // base `from` version: it only applies when it lines up exactly with the
+  // datafile we currently hold. On any gap (or before we have bootstrapped a
+  // datafile at all) the patch is dropped; the reconnect reseed (a full `put`)
+  // and the safety-net poll keep the client correct.
+  handlePatchFrame(frame) {
+    let patch;
+    try {
+      patch = parseDatafilePatch(JSON.parse(frame.data));
+    } catch {
+      warn("ignoring stream frame with invalid patch JSON");
+      return;
+    }
+    if (!patch) {
+      warn("ignoring malformed datafile patch");
+      return;
+    }
+    this.applyPatch(patch);
+  }
+  // Merge a version-matched delta atomically: build the next datafile in full,
+  // then swap it in so a partially-applied patch is never observable. Returns
+  // true if applied. Updates the ETag the conditional poll sends so the
+  // safety-net poll 304s instead of re-downloading the whole datafile.
+  applyPatch(patch) {
+    const current = this.datafile;
+    if (!current || current.version !== patch.from) return false;
+    const flags = { ...current.flags };
+    for (const [key, flag] of Object.entries(patch.flags)) flags[key] = flag;
+    for (const key of patch.removedFlags) delete flags[key];
+    const segments = { ...current.segments };
+    for (const [key, segment] of Object.entries(patch.segments)) segments[key] = segment;
+    for (const key of patch.removedSegments) delete segments[key];
+    this.datafile = {
+      ...current,
+      flags,
+      segments,
+      version: patch.to,
+      etag: patch.etag,
+      generatedAt: patch.generatedAt
+    };
+    this.etag = patch.etag;
+    return true;
+  }
   // Adopt a datafile only if its version is strictly newer than what we
   // hold. Equal or older versions are ignored so out-of-order pushes or a
   // stale poll can never roll the datafile backwards. Returns true if
@@ -339,6 +391,40 @@ var FeatClient = class {
     return adopted;
   }
 };
+function parseDatafilePatch(raw) {
+  if (typeof raw !== "object" || raw === null) return null;
+  const p = raw;
+  if (typeof p.from !== "number" || typeof p.to !== "number") return null;
+  if (!Number.isInteger(p.from) || !Number.isInteger(p.to) || p.to <= p.from) return null;
+  if (typeof p.etag !== "string" || typeof p.generatedAt !== "string") return null;
+  const flags = asRecord(p.flags);
+  const segments = asRecord(p.segments);
+  const removedFlags = asStringArray(p.removedFlags);
+  const removedSegments = asStringArray(p.removedSegments);
+  if (flags === null || segments === null) return null;
+  if (removedFlags === null || removedSegments === null) return null;
+  return {
+    from: p.from,
+    to: p.to,
+    etag: p.etag,
+    generatedAt: p.generatedAt,
+    flags,
+    removedFlags,
+    segments,
+    removedSegments
+  };
+}
+function asRecord(value) {
+  if (value === void 0) return {};
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return null;
+  return value;
+}
+function asStringArray(value) {
+  if (value === void 0) return [];
+  if (!Array.isArray(value)) return null;
+  if (value.some((item) => typeof item !== "string")) return null;
+  return value;
+}
 function warn(message, err) {
   if (err === void 0) {
     console.warn(`feat: ${message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feathq/js-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "feat feature-flag SDK for JavaScript and TypeScript (server-side, OpenFeature provider)",
   "keywords": [
     "feature-flags",