zubbl-sdk 1.1.9 → 1.1.12

package/dist/zubbl-sdk.cjs.js

@@ -11,6 +11,72 @@ let config = {
   workerSecret: null,
 };
 
+// ---- Telemetry State ----
+let sampleRatio = 0.1; // default 1 in 10
+let endpointBuffer = [];
+let debounceTimer = null;
+
+function shouldSample() {
+  return Math.random() < sampleRatio;
+}
+
+function setSamplingRatio(ratio) {
+  if (ratio < 0 || ratio > 1) throw new Error("Sampling ratio must be between 0 and 1");
+  sampleRatio = ratio;
+}
+
+function emitEndpoint(payload) {
+  if (!shouldSample()) return;
+  endpointBuffer.push({ ...payload, ts: Date.now(), source: "sdk" });
+  if (!debounceTimer) {
+    debounceTimer = setTimeout(flushEndpointBuffer, 200);
+  }
+}
+
+async function flushEndpointBuffer() {
+  if (endpointBuffer.length === 0) {
+    debounceTimer = null;
+    return;
+  }
+  const batch = [...endpointBuffer];
+  endpointBuffer = [];
+  debounceTimer = null;
+  try {
+    await fetch(`${config.baseUrl}/sdk/telemetry/endpoints`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(batch),
+    });
+  } catch (err) {
+    console.error("[Zubbl SDK] Failed to send endpoint telemetry", err);
+  }
+}
+
+async function zubblFetch(input, init = {}, context = {}) {
+  const start = performance.now();
+  let response;
+  try {
+    response = await fetch(input, init);
+    return response;
+  } finally {
+    const latency_ms = performance.now() - start;
+    try {
+      const url = new URL(input, window.location.origin);
+      emitEndpoint({
+        tenant_id: context.tenant_id || config.tenantId,
+        app_id: context.app_id || config.appId,
+        external_user_id: context.external_user_id,
+        method: init.method || "GET",
+        pathname: url.pathname,
+        status: response?.status ?? 0,
+        latency_ms,
+      });
+    } catch (e) {
+      console.warn("[Zubbl SDK] Failed to record endpoint telemetry", e);
+    }
+  }
+}
+
 /**
  * Initialize SDK with API credentials.
  */
@@ -112,6 +178,7 @@ async function getTiles({ external_user_id, app_id = null }) {
   );
   return response.data;
 }
+
 async function enforce({ external_user_id, app_id = null }) {
   if (!config.apiKey || !config.tenantId || !config.appId) {
     throw new Error("Zubbl SDK not initialized");
@@ -145,7 +212,10 @@ async function enforce({ external_user_id, app_id = null }) {
   }
 }
 
+exports.emitEndpoint = emitEndpoint;
 exports.enforce = enforce;
 exports.getTiles = getTiles;
 exports.identifyUser = identifyUser;
 exports.init = init;
+exports.setSamplingRatio = setSamplingRatio;
+exports.zubblFetch = zubblFetch;

package/dist/zubbl-sdk.esm.js

@@ -9,6 +9,72 @@ let config = {
   workerSecret: null,
 };
 
+// ---- Telemetry State ----
+let sampleRatio = 0.1; // default 1 in 10
+let endpointBuffer = [];
+let debounceTimer = null;
+
+function shouldSample() {
+  return Math.random() < sampleRatio;
+}
+
+function setSamplingRatio(ratio) {
+  if (ratio < 0 || ratio > 1) throw new Error("Sampling ratio must be between 0 and 1");
+  sampleRatio = ratio;
+}
+
+function emitEndpoint(payload) {
+  if (!shouldSample()) return;
+  endpointBuffer.push({ ...payload, ts: Date.now(), source: "sdk" });
+  if (!debounceTimer) {
+    debounceTimer = setTimeout(flushEndpointBuffer, 200);
+  }
+}
+
+async function flushEndpointBuffer() {
+  if (endpointBuffer.length === 0) {
+    debounceTimer = null;
+    return;
+  }
+  const batch = [...endpointBuffer];
+  endpointBuffer = [];
+  debounceTimer = null;
+  try {
+    await fetch(`${config.baseUrl}/sdk/telemetry/endpoints`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(batch),
+    });
+  } catch (err) {
+    console.error("[Zubbl SDK] Failed to send endpoint telemetry", err);
+  }
+}
+
+async function zubblFetch(input, init = {}, context = {}) {
+  const start = performance.now();
+  let response;
+  try {
+    response = await fetch(input, init);
+    return response;
+  } finally {
+    const latency_ms = performance.now() - start;
+    try {
+      const url = new URL(input, window.location.origin);
+      emitEndpoint({
+        tenant_id: context.tenant_id || config.tenantId,
+        app_id: context.app_id || config.appId,
+        external_user_id: context.external_user_id,
+        method: init.method || "GET",
+        pathname: url.pathname,
+        status: response?.status ?? 0,
+        latency_ms,
+      });
+    } catch (e) {
+      console.warn("[Zubbl SDK] Failed to record endpoint telemetry", e);
+    }
+  }
+}
+
 /**
  * Initialize SDK with API credentials.
  */
@@ -110,6 +176,7 @@ async function getTiles({ external_user_id, app_id = null }) {
   );
   return response.data;
 }
+
 async function enforce({ external_user_id, app_id = null }) {
   if (!config.apiKey || !config.tenantId || !config.appId) {
     throw new Error("Zubbl SDK not initialized");
@@ -143,4 +210,4 @@ async function enforce({ external_user_id, app_id = null }) {
   }
 }
 
-export { enforce, getTiles, identifyUser, init };
+export { emitEndpoint, enforce, getTiles, identifyUser, init, setSamplingRatio, zubblFetch };

package/dist/zubbl-sdk.umd.js

@@ -13,6 +13,72 @@
     workerSecret: null,
   };
 
+  // ---- Telemetry State ----
+  let sampleRatio = 0.1; // default 1 in 10
+  let endpointBuffer = [];
+  let debounceTimer = null;
+
+  function shouldSample() {
+    return Math.random() < sampleRatio;
+  }
+
+  function setSamplingRatio(ratio) {
+    if (ratio < 0 || ratio > 1) throw new Error("Sampling ratio must be between 0 and 1");
+    sampleRatio = ratio;
+  }
+
+  function emitEndpoint(payload) {
+    if (!shouldSample()) return;
+    endpointBuffer.push({ ...payload, ts: Date.now(), source: "sdk" });
+    if (!debounceTimer) {
+      debounceTimer = setTimeout(flushEndpointBuffer, 200);
+    }
+  }
+
+  async function flushEndpointBuffer() {
+    if (endpointBuffer.length === 0) {
+      debounceTimer = null;
+      return;
+    }
+    const batch = [...endpointBuffer];
+    endpointBuffer = [];
+    debounceTimer = null;
+    try {
+      await fetch(`${config.baseUrl}/sdk/telemetry/endpoints`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(batch),
+      });
+    } catch (err) {
+      console.error("[Zubbl SDK] Failed to send endpoint telemetry", err);
+    }
+  }
+
+  async function zubblFetch(input, init = {}, context = {}) {
+    const start = performance.now();
+    let response;
+    try {
+      response = await fetch(input, init);
+      return response;
+    } finally {
+      const latency_ms = performance.now() - start;
+      try {
+        const url = new URL(input, window.location.origin);
+        emitEndpoint({
+          tenant_id: context.tenant_id || config.tenantId,
+          app_id: context.app_id || config.appId,
+          external_user_id: context.external_user_id,
+          method: init.method || "GET",
+          pathname: url.pathname,
+          status: response?.status ?? 0,
+          latency_ms,
+        });
+      } catch (e) {
+        console.warn("[Zubbl SDK] Failed to record endpoint telemetry", e);
+      }
+    }
+  }
+
   /**
    * Initialize SDK with API credentials.
    */
@@ -114,6 +180,7 @@
     );
     return response.data;
   }
+
   async function enforce({ external_user_id, app_id = null }) {
     if (!config.apiKey || !config.tenantId || !config.appId) {
       throw new Error("Zubbl SDK not initialized");
@@ -147,9 +214,12 @@
     }
   }
 
+  exports.emitEndpoint = emitEndpoint;
   exports.enforce = enforce;
   exports.getTiles = getTiles;
   exports.identifyUser = identifyUser;
   exports.init = init;
+  exports.setSamplingRatio = setSamplingRatio;
+  exports.zubblFetch = zubblFetch;
 
 }));

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "zubbl-sdk",
-  "version": "1.1.9",
+  "version": "1.1.12",
+  "type": "module",
   "description": "Zubbl SDK for secure policy enforcement (browser, Node, universal)",
   "main": "dist/zubbl-sdk.cjs.js",
   "module": "dist/zubbl-sdk.esm.js",
@@ -21,13 +22,14 @@
   "scripts": {
     "build": "rollup -c",
     "prepublishOnly": "npm run build",
-    "test": "echo 'Add tests!'"
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest"
   },
   "repository": "https://github.com/zubbl/zubbl-sdk",
   "author": "Zubbl",
   "license": "MIT",
   "devDependencies": {
     "@rollup/plugin-node-resolve": "^16.0.1",
+    "jest": "^30.1.3",
     "rollup": "^4.2.0"
   },
   "dependencies": {