@perspective-ai/sdk 1.1.0 → 1.1.2

package/dist/browser.js

@@ -1,5 +1,5 @@
 // src/constants.ts
-var SDK_VERSION = "1.1.0";
+var SDK_VERSION = "1.1.2";
 var FEATURES = {
   RESIZE: 1 << 0,
   // 0b0001
@@ -45,7 +45,9 @@ var DATA_ATTRS = {
   brand: "data-perspective-brand",
   brandDark: "data-perspective-brand-dark",
   theme: "data-perspective-theme",
-  noStyle: "data-perspective-no-style"
+  noStyle: "data-perspective-no-style",
+  autoOpen: "data-perspective-auto-open",
+  showOnce: "data-perspective-show-once"
 };
 var MESSAGE_TYPES = {
   // SDK -> Iframe (initialization)
@@ -79,9 +81,78 @@ var THEME_VALUES = {
   system: "system"
 };
 var STORAGE_KEYS = {
-  anonId: "perspective-anon-id"
+  anonId: "perspective-anon-id",
+  triggerShown: "perspective-trigger-shown"
 };
 
+// src/triggers.ts
+function parseTriggerAttr(value) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith("timeout:")) {
+    const delay = parseInt(trimmed.slice("timeout:".length), 10);
+    if (isNaN(delay) || delay < 0) {
+      throw new Error(`Invalid timeout delay: "${value}"`);
+    }
+    return { type: "timeout", delay };
+  }
+  if (trimmed === "timeout") {
+    return { type: "timeout", delay: 5e3 };
+  }
+  if (trimmed === "exit-intent") {
+    return { type: "exit-intent" };
+  }
+  throw new Error(
+    `Unknown trigger type: "${value}". Expected "timeout:<ms>" or "exit-intent".`
+  );
+}
+function setupTrigger(config, callback) {
+  if (config.type === "timeout") {
+    const timer = setTimeout(callback, config.delay);
+    return () => clearTimeout(timer);
+  }
+  if (config.type === "exit-intent") {
+    const handler = (e) => {
+      if (e.clientY <= 0) {
+        callback();
+        document.removeEventListener("mouseleave", handler);
+      }
+    };
+    document.addEventListener("mouseleave", handler);
+    return () => document.removeEventListener("mouseleave", handler);
+  }
+  const _exhaustive = config;
+  throw new Error(
+    `Unknown trigger type: ${_exhaustive.type}`
+  );
+}
+function storageKey(researchId) {
+  return `${STORAGE_KEYS.triggerShown}:${researchId}`;
+}
+function parseShowOnceAttr(value) {
+  if (!value) return "session";
+  const trimmed = value.trim();
+  if (trimmed === "visitor") return "visitor";
+  if (trimmed === "false") return false;
+  return "session";
+}
+function shouldShow(researchId, showOnce) {
+  if (showOnce === false) return true;
+  try {
+    const storage = showOnce === "visitor" ? localStorage : sessionStorage;
+    return storage.getItem(storageKey(researchId)) === null;
+  } catch {
+    return true;
+  }
+}
+function markShown(researchId, showOnce) {
+  if (showOnce === false) return;
+  try {
+    const storage = showOnce === "visitor" ? localStorage : sessionStorage;
+    storage.setItem(storageKey(researchId), "1");
+  } catch {
+  }
+}
+
 // src/config.ts
 var DEFAULT_HOST = "https://getperspective.ai";
 var globalConfig = {};
@@ -1559,6 +1630,7 @@ function createFullpage(config) {
 
 // src/browser.ts
 var instances = /* @__PURE__ */ new Map();
+var triggerCleanups = /* @__PURE__ */ new Map();
 var configCache = /* @__PURE__ */ new Map();
 var styledButtons = /* @__PURE__ */ new Map();
 var buttonThemeMediaQuery = null;
@@ -1738,6 +1810,8 @@ function destroy(researchId) {
 function destroyAll() {
   instances.forEach((instance) => instance.unmount());
   instances.clear();
+  triggerCleanups.forEach((cleanup) => cleanup());
+  triggerCleanups.clear();
   styledButtons.clear();
   teardownButtonThemeListener();
 }
@@ -1764,9 +1838,29 @@ function autoInit() {
     if (el.hasAttribute("data-perspective-initialized")) return;
     el.setAttribute("data-perspective-initialized", "true");
     const researchId = el.getAttribute(DATA_ATTRS.popup);
-    if (researchId) {
-      const params = parseParamsAttr(el);
-      const brandConfig = extractBrandConfig(el);
+    if (!researchId) return;
+    const params = parseParamsAttr(el);
+    const brandConfig = extractBrandConfig(el);
+    const autoOpenAttr = el.getAttribute(DATA_ATTRS.autoOpen);
+    if (autoOpenAttr) {
+      try {
+        const trigger = parseTriggerAttr(autoOpenAttr);
+        const showOnce = parseShowOnceAttr(
+          el.getAttribute(DATA_ATTRS.showOnce)
+        );
+        if (shouldShow(researchId, showOnce)) {
+          triggerCleanups.get(researchId)?.();
+          const cleanup = setupTrigger(trigger, () => {
+            triggerCleanups.delete(researchId);
+            markShown(researchId, showOnce);
+            init({ researchId, type: "popup", params, ...brandConfig });
+          });
+          triggerCleanups.set(researchId, cleanup);
+        }
+      } catch (e) {
+        console.warn("[Perspective]", e.message);
+      }
+    } else {
       styleButton(el, DEFAULT_THEME, brandConfig);
       el.addEventListener("click", (e) => {
         e.preventDefault();