@gurulu/web 1.0.2 → 1.2.0

package/dist/index.js

@@ -1,3 +1,132 @@
+// src/activation.ts
+function fnv1a32(str) {
+  let h = 2166136261;
+  for (let i = 0;i < str.length; i++) {
+    h ^= str.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  return h >>> 0;
+}
+function activationBucket(key, uid) {
+  return fnv1a32(`${key}:${uid}`) % 1e4 / 1e4;
+}
+var EMPTY = {
+  workspace_id: "",
+  popups: [],
+  tours: [],
+  personalizations: [],
+  experiments: []
+};
+
+class GuruluActivation {
+  cfg;
+  data = null;
+  pending = null;
+  exposed = new Set;
+  served = new Set;
+  constructor(cfg) {
+    this.cfg = cfg;
+  }
+  async refresh(opts) {
+    if (this.pending)
+      return this.pending;
+    const f = this.cfg.fetchImpl ?? (typeof fetch !== "undefined" ? fetch.bind(globalThis) : null);
+    if (!f)
+      return EMPTY;
+    const uid = this.cfg.getUid();
+    const sp = new URLSearchParams;
+    if (uid)
+      sp.set("uid", uid);
+    const winHref = typeof window !== "undefined" && window.location ? window.location.href : "";
+    const url = opts?.url ?? winHref;
+    if (url)
+      sp.set("url", url);
+    const ua = typeof navigator !== "undefined" && navigator.userAgent ? navigator.userAgent : "";
+    const device = opts?.device ?? (/Mobi|Android/i.test(ua) ? "mobile" : "desktop");
+    sp.set("device", device);
+    this.pending = (async () => {
+      try {
+        const res = await f(`${this.cfg.endpoint}/v1/activate?${sp.toString()}`, {
+          method: "GET",
+          headers: { Authorization: `Bearer ${this.cfg.workspaceKey}` },
+          credentials: "omit"
+        });
+        if (!res.ok)
+          return this.data ?? EMPTY;
+        this.data = await res.json();
+        return this.data;
+      } catch {
+        return this.data ?? EMPTY;
+      } finally {
+        this.pending = null;
+      }
+    })();
+    return this.pending;
+  }
+  getPopups() {
+    return this.data?.popups ?? [];
+  }
+  getTours() {
+    return this.data?.tours ?? [];
+  }
+  getContent(slot) {
+    const p = (this.data?.personalizations ?? []).find((x) => x.slot_key === slot);
+    if (!p)
+      return null;
+    if (!this.served.has(p.key)) {
+      this.served.add(p.key);
+      this.cfg.track("personalization_served", {
+        personalization_key: p.key,
+        variant_key: p.variant_key,
+        is_holdout: p.is_holdout
+      });
+    }
+    return p.content;
+  }
+  getVariant(experimentKey) {
+    const e = (this.data?.experiments ?? []).find((x) => x.key === experimentKey);
+    if (!e)
+      return null;
+    const variant = e.assigned_variant ?? assignLocalVariant(experimentKey, this.cfg.getUid(), e.variants);
+    if (variant && !this.exposed.has(experimentKey)) {
+      this.exposed.add(experimentKey);
+      this.cfg.track("experiment_exposed", {
+        experiment_key: experimentKey,
+        variant_key: variant
+      });
+    }
+    return variant;
+  }
+  trackPopup(key, action) {
+    this.cfg.track(`popup_${action}`, { popup_key: key });
+  }
+  trackTour(key, action, stepIndex) {
+    this.cfg.track(`tour_${action}`, {
+      tour_key: key,
+      ...stepIndex !== undefined ? { step_index: stepIndex } : {}
+    });
+  }
+  async saveTourProgress(tourKey, body) {}
+  snapshot() {
+    return this.data ?? EMPTY;
+  }
+}
+function assignLocalVariant(key, uid, variants) {
+  const valid = variants.filter((v) => v.weight > 0 && v.key.length > 0);
+  if (valid.length === 0 || !uid)
+    return null;
+  const total = valid.reduce((s, v) => s + v.weight, 0);
+  if (total <= 0)
+    return null;
+  const bucket = activationBucket(key, uid);
+  let cum = 0;
+  for (const v of valid) {
+    cum += v.weight / total;
+    if (bucket < cum)
+      return v.key;
+  }
+  return valid[valid.length - 1].key;
+}
 // src/consent.ts
 var DEFAULT_API_URL = "https://api.gurulu.io";
 var STORAGE_PREFIX = "gurulu_consent_";
@@ -351,6 +480,44 @@ function startClickAutocapture(track) {
   };
 }
 
+// src/autocapture/error.ts
+var MAX_STACK = 2000;
+var MAX_MESSAGE = 1000;
+function startErrorAutocapture(track) {
+  if (typeof window === "undefined")
+    return { stop: () => {
+      return;
+    } };
+  const onError = (ev) => {
+    const err = ev.error;
+    track({
+      message: String(ev.message ?? err?.message ?? "Error").slice(0, MAX_MESSAGE),
+      error_type: err?.name ?? "Error",
+      ...ev.filename ? { source: ev.filename } : {},
+      ...typeof ev.lineno === "number" ? { lineno: ev.lineno } : {},
+      ...typeof ev.colno === "number" ? { colno: ev.colno } : {},
+      ...err?.stack ? { stack: String(err.stack).slice(0, MAX_STACK) } : {}
+    });
+  };
+  const onRejection = (ev) => {
+    const reason = ev.reason;
+    const isErr = reason instanceof Error;
+    track({
+      message: String(isErr ? reason.message : reason).slice(0, MAX_MESSAGE),
+      error_type: isErr ? reason.name : "UnhandledRejection",
+      ...isErr && reason.stack ? { stack: String(reason.stack).slice(0, MAX_STACK) } : {}
+    });
+  };
+  window.addEventListener("error", onError);
+  window.addEventListener("unhandledrejection", onRejection);
+  return {
+    stop() {
+      window.removeEventListener("error", onError);
+      window.removeEventListener("unhandledrejection", onRejection);
+    }
+  };
+}
+
 // src/autocapture/form.ts
 var SENSITIVE_INPUT_TYPES = new Set(["password", "tel"]);
 function isSensitiveField(el) {
@@ -701,6 +868,8 @@ function startAutocapture(cfg, sinks) {
     handles.push(startScrollAutocapture(sinks.scrollDepth));
   if (merged.web_vitals)
     handles.push(startWebVitalsAutocapture(sinks.webVital));
+  if (merged.js_error)
+    handles.push(startErrorAutocapture(sinks.jsError));
   return {
     stopAll() {
       for (const h of handles) {
@@ -1173,6 +1342,7 @@ class Gurulu {
   autocaptureHandle = null;
   testMode = false;
   consent;
+  activation;
   init(opts) {
     if (this.initialized) {
       if (opts.debug && typeof console !== "undefined") {
@@ -1193,6 +1363,12 @@ class Gurulu {
       autoBanner: opts.consent_mode === "banner_required"
     });
     this.consent.init();
+    this.activation = new GuruluActivation({
+      endpoint: opts.endpoint ?? DEFAULT_ENDPOINT,
+      workspaceKey: opts.workspaceKey,
+      getUid: () => getPersonId() ?? this.anonymousId ?? "",
+      track: (key, props) => this.track(key, props)
+    });
     const transport = {
       endpoint: opts.endpoint ?? DEFAULT_ENDPOINT,
       workspaceKey: opts.workspaceKey,
@@ -1234,7 +1410,8 @@ class Gurulu {
       formStarted: (p) => this.queueEvent("form_started", "interaction", p),
       formSubmitted: (p) => this.queueEvent("form_submitted", "interaction", p),
       scrollDepth: (p) => this.queueEvent("scroll_depth", "interaction", p),
-      webVital: (p) => this.queueEvent("web_vital", "interaction", p)
+      webVital: (p) => this.queueEvent("web_vital", "interaction", p),
+      jsError: (p) => this.queueEvent("js_error", "interaction", p)
     });
     this.initialized = true;
   }
@@ -1380,6 +1557,9 @@ var publicSdk = {
   get consent() {
     return singleton.consent;
   },
+  get activation() {
+    return singleton.activation;
+  },
   VERSION
 };
 function autoBootstrap() {
@@ -1424,6 +1604,7 @@ export {
   NetworkError,
   InitError,
   GuruluConsent,
+  GuruluActivation,
   Gurulu,
   ConsentBlockedError
 };

package/dist/react.d.ts

@@ -0,0 +1,10 @@
+import { type ReactNode } from 'react';
+import type { GuruluPublicSDK, InitOptions } from './index.ts';
+export type GuruluProviderProps = InitOptions & {
+    children: ReactNode;
+};
+/** Uygulama kökünü sar — mount'ta gurulu.init (idempotent). */
+export declare function GuruluProvider({ children, ...opts }: GuruluProviderProps): ReactNode;
+/** Singleton SDK — track/identify/page/... handler'larında kullan. */
+export declare function useGurulu(): GuruluPublicSDK;
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,OAAO,CAAC;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,CAAC;AAExE,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,mBAAmB,GAAG,SAAS,CAOpF;AAED,sEAAsE;AACtE,wBAAgB,SAAS,IAAI,eAAe,CAE3C"}