zubbl-sdk 1.1.8 → 1.1.11

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("/api/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.
  */
@@ -113,6 +179,43 @@ 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");
+  }
+  if (!external_user_id) throw new Error("external_user_id is required");
+
+  const headers = {
+    Authorization: `Bearer ${config.apiKey}`,
+    "X-Tenant-Id": config.tenantId,
+    "X-App-Id": app_id || config.appId,
+    "X-External-User-Id": external_user_id,
+    "Content-Type": "application/json",
+  };
+  if (config.injectWorkerHeaders && config.workerSecret) {
+    headers["X-Zubbl-Worker-Secret"] = config.workerSecret;
+    headers["X-Zubbl-Internal-Call"] = "true";
+  }
+
+  try {
+    const resp = await axios.post(
+      `${config.baseUrl.replace(/\/$/, "")}/sdk/test-enforcement`,
+      {},
+      { headers }
+    );
+    return { decision: "allow", status: resp.status, data: resp.data };
+  } catch (e) {
+    if (e.response && e.response.status === 429) {
+      return { decision: "block", status: 429, data: e.response.data };
+    }
+    throw e;
+  }
+}
+
+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("/api/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.
  */
@@ -111,4 +177,37 @@ async function getTiles({ external_user_id, app_id = null }) {
   return response.data;
 }
 
-export { getTiles, identifyUser, init };
+async function enforce({ external_user_id, app_id = null }) {
+  if (!config.apiKey || !config.tenantId || !config.appId) {
+    throw new Error("Zubbl SDK not initialized");
+  }
+  if (!external_user_id) throw new Error("external_user_id is required");
+
+  const headers = {
+    Authorization: `Bearer ${config.apiKey}`,
+    "X-Tenant-Id": config.tenantId,
+    "X-App-Id": app_id || config.appId,
+    "X-External-User-Id": external_user_id,
+    "Content-Type": "application/json",
+  };
+  if (config.injectWorkerHeaders && config.workerSecret) {
+    headers["X-Zubbl-Worker-Secret"] = config.workerSecret;
+    headers["X-Zubbl-Internal-Call"] = "true";
+  }
+
+  try {
+    const resp = await axios.post(
+      `${config.baseUrl.replace(/\/$/, "")}/sdk/test-enforcement`,
+      {},
+      { headers }
+    );
+    return { decision: "allow", status: resp.status, data: resp.data };
+  } catch (e) {
+    if (e.response && e.response.status === 429) {
+      return { decision: "block", status: 429, data: e.response.data };
+    }
+    throw e;
+  }
+}
+
+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("/api/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.
    */
@@ -115,8 +181,45 @@
     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");
+    }
+    if (!external_user_id) throw new Error("external_user_id is required");
+
+    const headers = {
+      Authorization: `Bearer ${config.apiKey}`,
+      "X-Tenant-Id": config.tenantId,
+      "X-App-Id": app_id || config.appId,
+      "X-External-User-Id": external_user_id,
+      "Content-Type": "application/json",
+    };
+    if (config.injectWorkerHeaders && config.workerSecret) {
+      headers["X-Zubbl-Worker-Secret"] = config.workerSecret;
+      headers["X-Zubbl-Internal-Call"] = "true";
+    }
+
+    try {
+      const resp = await axios.post(
+        `${config.baseUrl.replace(/\/$/, "")}/sdk/test-enforcement`,
+        {},
+        { headers }
+      );
+      return { decision: "allow", status: resp.status, data: resp.data };
+    } catch (e) {
+      if (e.response && e.response.status === 429) {
+        return { decision: "block", status: 429, data: e.response.data };
+      }
+      throw e;
+    }
+  }
+
+  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,6 @@
 {
   "name": "zubbl-sdk",
-  "version": "1.1.8",
+  "version": "1.1.11",
   "description": "Zubbl SDK for secure policy enforcement (browser, Node, universal)",
   "main": "dist/zubbl-sdk.cjs.js",
   "module": "dist/zubbl-sdk.esm.js",