@perspective-ai/sdk 1.0.1 → 1.1.2

package/dist/browser.cjs

@@ -38,7 +38,7 @@ __export(browser_exports, {
 module.exports = __toCommonJS(browser_exports);
 
 // src/constants.ts
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = "1.1.2";
 var FEATURES = {
   RESIZE: 1 << 0,
   // 0b0001
@@ -67,26 +67,9 @@ var BRAND_KEYS = {
   darkBg: "brand.dark.bg",
   darkText: "brand.dark.text"
 };
-var UTM_PARAMS = [
-  "utm_source",
-  "utm_medium",
-  "utm_campaign",
-  "utm_term",
-  "utm_content"
-];
 var RESERVED_PARAMS = /* @__PURE__ */ new Set([
-  PARAM_KEYS.embed,
-  PARAM_KEYS.embedType,
-  PARAM_KEYS.theme,
-  BRAND_KEYS.primary,
-  BRAND_KEYS.secondary,
-  BRAND_KEYS.bg,
-  BRAND_KEYS.text,
-  BRAND_KEYS.darkPrimary,
-  BRAND_KEYS.darkSecondary,
-  BRAND_KEYS.darkBg,
-  BRAND_KEYS.darkText,
-  ...UTM_PARAMS
+  ...Object.values(PARAM_KEYS),
+  ...Object.values(BRAND_KEYS)
 ]);
 var DATA_ATTRS = {
   widget: "data-perspective-widget",
@@ -101,7 +84,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)
@@ -135,9 +120,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 = {};
@@ -262,13 +316,12 @@ function getOrCreateAnonId() {
     return crypto.randomUUID();
   }
 }
-function getUtmParams() {
+function getParentSearchParams() {
   if (!hasDom()) return {};
   const params = {};
   const searchParams = new URLSearchParams(window.location.search);
-  for (const key of UTM_PARAMS) {
-    const value = searchParams.get(key);
-    if (value) {
+  for (const [key, value] of searchParams.entries()) {
+    if (!RESERVED_PARAMS.has(key)) {
       params[key] = value;
     }
   }
@@ -291,8 +344,8 @@ function buildIframeUrl(researchId, type, host, customParams, brand, themeOverri
   } else {
     url.searchParams.set(PARAM_KEYS.theme, themeOverride || THEME_VALUES.light);
   }
-  const utmParams = getUtmParams();
-  for (const [key, value] of Object.entries(utmParams)) {
+  const parentParams = getParentSearchParams();
+  for (const [key, value] of Object.entries(parentParams)) {
     url.searchParams.set(key, value);
   }
   const setColor = (key, color) => {
@@ -1616,6 +1669,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;
@@ -1795,6 +1849,8 @@ function destroy(researchId) {
 function destroyAll() {
   instances.forEach((instance) => instance.unmount());
   instances.clear();
+  triggerCleanups.forEach((cleanup) => cleanup());
+  triggerCleanups.clear();
   styledButtons.clear();
   teardownButtonThemeListener();
 }
@@ -1821,9 +1877,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();