@perspective-ai/sdk 1.0.1 → 1.1.2

package/dist/constants.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 // src/constants.ts
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = "1.1.2";
 var FEATURES = {
   RESIZE: 1 << 0,
   // 0b0001
@@ -30,26 +30,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",
@@ -64,7 +47,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)
@@ -104,7 +89,8 @@ var MODE_VALUES = {
   simulated: "simulated"
 };
 var STORAGE_KEYS = {
-  anonId: "perspective-anon-id"
+  anonId: "perspective-anon-id",
+  triggerShown: "perspective-trigger-shown"
 };
 
 exports.BRAND_KEYS = BRAND_KEYS;
@@ -120,6 +106,5 @@ exports.RESERVED_PARAMS = RESERVED_PARAMS;
 exports.SDK_VERSION = SDK_VERSION;
 exports.STORAGE_KEYS = STORAGE_KEYS;
 exports.THEME_VALUES = THEME_VALUES;
-exports.UTM_PARAMS = UTM_PARAMS;
 //# sourceMappingURL=constants.cjs.map
 //# sourceMappingURL=constants.cjs.map

package/dist/constants.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts"],"names":[],"mappings":"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","file":"constants.cjs","sourcesContent":["/**\n * Shared constants for Perspective Embed SDK\n * This file is SSR-safe - no DOM access at import time\n * Used by both SDK bundle and the main Perspective app\n */\n\n// ============================================================================\n// SDK Version & Features\n// ============================================================================\n\n/** SDK version for handshake protocol */\nexport const SDK_VERSION = \"1.0.0\";\n\n/** Feature flags as bitset for version negotiation */\nexport const FEATURES = {\n  RESIZE: 1 << 0, // 0b0001\n  THEME_SYNC: 1 << 1, // 0b0010\n  ANON_ID: 1 << 2, // 0b0100\n  SCROLLBAR_STYLES: 1 << 3, // 0b1000\n} as const;\n\n/** Current SDK feature set */\nexport const CURRENT_FEATURES =\n  FEATURES.RESIZE |\n  FEATURES.THEME_SYNC |\n  FEATURES.ANON_ID |\n  FEATURES.SCROLLBAR_STYLES;\n\n// ============================================================================\n// URL Parameter Keys\n// ============================================================================\n\n// Embed parameters\nexport const PARAM_KEYS = {\n  embed: \"embed\",\n  embedType: \"embed_type\",\n  theme: \"theme\",\n} as const;\n\nexport type ParamKey = (typeof PARAM_KEYS)[keyof typeof PARAM_KEYS];\n\n// ============================================================================\n// Brand Color Keys\n// ============================================================================\n\nexport const BRAND_KEYS = {\n  // Light mode\n  primary: \"brand.primary\",\n  secondary: \"brand.secondary\",\n  bg: \"brand.bg\",\n  text: \"brand.text\",\n\n  // Dark mode\n  darkPrimary: \"brand.dark.primary\",\n  darkSecondary: \"brand.dark.secondary\",\n  darkBg: \"brand.dark.bg\",\n  darkText: \"brand.dark.text\",\n} as const;\n\nexport type BrandKey = (typeof BRAND_KEYS)[keyof typeof BRAND_KEYS];\n\n// ============================================================================\n// UTM Parameters (auto-forwarded from parent URL)\n// ============================================================================\n\nexport const UTM_PARAMS = [\n  \"utm_source\",\n  \"utm_medium\",\n  \"utm_campaign\",\n  \"utm_term\",\n  \"utm_content\",\n] as const;\n\nexport type UtmParam = (typeof UTM_PARAMS)[number];\n\n// ============================================================================\n// Reserved Parameters (cannot be overridden via custom params)\n// ============================================================================\n\nexport const RESERVED_PARAMS: Set<string> = new Set([\n  PARAM_KEYS.embed,\n  PARAM_KEYS.embedType,\n  PARAM_KEYS.theme,\n  BRAND_KEYS.primary,\n  BRAND_KEYS.secondary,\n  BRAND_KEYS.bg,\n  BRAND_KEYS.text,\n  BRAND_KEYS.darkPrimary,\n  BRAND_KEYS.darkSecondary,\n  BRAND_KEYS.darkBg,\n  BRAND_KEYS.darkText,\n  ...UTM_PARAMS,\n]);\n\n// ============================================================================\n// Data Attributes (HTML declarative initialization)\n// ============================================================================\n\nexport const DATA_ATTRS = {\n  widget: \"data-perspective-widget\",\n  popup: \"data-perspective-popup\",\n  slider: \"data-perspective-slider\",\n  float: \"data-perspective-float\", // Primary name\n  chat: \"data-perspective-chat\", // Legacy alias\n  fullpage: \"data-perspective-fullpage\",\n  params: \"data-perspective-params\",\n  brand: \"data-perspective-brand\",\n  brandDark: \"data-perspective-brand-dark\",\n  theme: \"data-perspective-theme\",\n  noStyle: \"data-perspective-no-style\",\n} as const;\n\nexport type DataAttr = (typeof DATA_ATTRS)[keyof typeof DATA_ATTRS];\n\n// ============================================================================\n// PostMessage Event Types\n// ============================================================================\n\nexport const MESSAGE_TYPES = {\n  // SDK -> Iframe (initialization)\n  init: \"perspective:init\",\n\n  // Iframe -> SDK\n  ready: \"perspective:ready\",\n  resize: \"perspective:resize\",\n  submit: \"perspective:submit\",\n  close: \"perspective:close\",\n  error: \"perspective:error\",\n  redirect: \"perspective:redirect\",\n\n  // SDK -> Iframe (internal)\n  anonId: \"perspective:anon-id\",\n  injectStyles: \"perspective:inject-styles\",\n  themeChange: \"perspective:theme-change\",\n\n  // Iframe -> SDK (internal)\n  requestScrollbarStyles: \"perspective:request-scrollbar-styles\",\n} as const;\n\nexport type MessageType = (typeof MESSAGE_TYPES)[keyof typeof MESSAGE_TYPES];\n\n// ============================================================================\n// Error Codes\n// ============================================================================\n\nexport const ERROR_CODES = {\n  SDK_OUTDATED: \"SDK_OUTDATED\",\n  INVALID_RESEARCH: \"INVALID_RESEARCH\",\n  UNKNOWN: \"UNKNOWN\",\n} as const;\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\n// ============================================================================\n// Param Values (for boolean-like string params)\n// ============================================================================\n\nexport const PARAM_VALUES = {\n  true: \"true\",\n  false: \"false\",\n} as const;\n\n// ============================================================================\n// Theme Values\n// ============================================================================\n\nexport const THEME_VALUES = {\n  dark: \"dark\",\n  light: \"light\",\n  system: \"system\",\n} as const;\n\nexport type ThemeValue = (typeof THEME_VALUES)[keyof typeof THEME_VALUES];\n\n// ============================================================================\n// Interview Mode Values (for mode param)\n// ============================================================================\n\nexport const MODE_VALUES = {\n  preview: \"preview\",\n  restart: \"restart\",\n  normal: \"normal\",\n  simulated: \"simulated\",\n} as const;\n\nexport type ModeValue = (typeof MODE_VALUES)[keyof typeof MODE_VALUES];\n\n// ============================================================================\n// localStorage Keys\n// ============================================================================\n\nexport const STORAGE_KEYS = {\n  anonId: \"perspective-anon-id\",\n} as const;\n"]}
+{"version":3,"sources":["../src/constants.ts"],"names":[],"mappings":";;;AAWO,IAAM,WAAA,GAAc;AAGpB,IAAM,QAAA,GAAW;AAAA,EACtB,QAAQ,CAAA,IAAK,CAAA;AAAA;AAAA,EACb,YAAY,CAAA,IAAK,CAAA;AAAA;AAAA,EACjB,SAAS,CAAA,IAAK,CAAA;AAAA;AAAA,EACd,kBAAkB,CAAA,IAAK;AAAA;AACzB;AAGO,IAAM,mBACX,QAAA,CAAS,MAAA,GACT,SAAS,UAAA,GACT,QAAA,CAAS,UACT,QAAA,CAAS;AAOJ,IAAM,UAAA,GAAa;AAAA,EACxB,KAAA,EAAO,OAAA;AAAA,EACP,SAAA,EAAW,YAAA;AAAA,EACX,KAAA,EAAO;AACT;AAQO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,OAAA,EAAS,eAAA;AAAA,EACT,SAAA,EAAW,iBAAA;AAAA,EACX,EAAA,EAAI,UAAA;AAAA,EACJ,IAAA,EAAM,YAAA;AAAA;AAAA,EAGN,WAAA,EAAa,oBAAA;AAAA,EACb,aAAA,EAAe,sBAAA;AAAA,EACf,MAAA,EAAQ,eAAA;AAAA,EACR,QAAA,EAAU;AACZ;AAQO,IAAM,eAAA,uBAAmC,GAAA,CAAI;AAAA,EAClD,GAAG,MAAA,CAAO,MAAA,CAAO,UAAU,CAAA;AAAA,EAC3B,GAAG,MAAA,CAAO,MAAA,CAAO,UAAU;AAC7B,CAAC;AAMM,IAAM,UAAA,GAAa;AAAA,EACxB,MAAA,EAAQ,yBAAA;AAAA,EACR,KAAA,EAAO,wBAAA;AAAA,EACP,MAAA,EAAQ,yBAAA;AAAA,EACR,KAAA,EAAO,wBAAA;AAAA;AAAA,EACP,IAAA,EAAM,uBAAA;AAAA;AAAA,EACN,QAAA,EAAU,2BAAA;AAAA,EACV,MAAA,EAAQ,yBAAA;AAAA,EACR,KAAA,EAAO,wBAAA;AAAA,EACP,SAAA,EAAW,6BAAA;AAAA,EACX,KAAA,EAAO,wBAAA;AAAA,EACP,OAAA,EAAS,2BAAA;AAAA,EACT,QAAA,EAAU,4BAAA;AAAA,EACV,QAAA,EAAU;AACZ;AAQO,IAAM,aAAA,GAAgB;AAAA;AAAA,EAE3B,IAAA,EAAM,kBAAA;AAAA;AAAA,EAGN,KAAA,EAAO,mBAAA;AAAA,EACP,MAAA,EAAQ,oBAAA;AAAA,EACR,MAAA,EAAQ,oBAAA;AAAA,EACR,KAAA,EAAO,mBAAA;AAAA,EACP,KAAA,EAAO,mBAAA;AAAA,EACP,QAAA,EAAU,sBAAA;AAAA;AAAA,EAGV,MAAA,EAAQ,qBAAA;AAAA,EACR,YAAA,EAAc,2BAAA;AAAA,EACd,WAAA,EAAa,0BAAA;AAAA;AAAA,EAGb,sBAAA,EAAwB;AAC1B;AAQO,IAAM,WAAA,GAAc;AAAA,EACzB,YAAA,EAAc,cAAA;AAAA,EACd,gBAAA,EAAkB,kBAAA;AAAA,EAClB,OAAA,EAAS;AACX;AAQO,IAAM,YAAA,GAAe;AAAA,EAC1B,IAAA,EAAM,MAAA;AAAA,EACN,KAAA,EAAO;AACT;AAMO,IAAM,YAAA,GAAe;AAAA,EAC1B,IAAA,EAAM,MAAA;AAAA,EACN,KAAA,EAAO,OAAA;AAAA,EACP,MAAA,EAAQ;AACV;AAQO,IAAM,WAAA,GAAc;AAAA,EACzB,OAAA,EAAS,SAAA;AAAA,EACT,OAAA,EAAS,SAAA;AAAA,EACT,MAAA,EAAQ,QAAA;AAAA,EACR,SAAA,EAAW;AACb;AAQO,IAAM,YAAA,GAAe;AAAA,EAC1B,MAAA,EAAQ,qBAAA;AAAA,EACR,YAAA,EAAc;AAChB","file":"constants.cjs","sourcesContent":["/**\n * Shared constants for Perspective Embed SDK\n * This file is SSR-safe - no DOM access at import time\n * Used by both SDK bundle and the main Perspective app\n */\n\n// ============================================================================\n// SDK Version & Features\n// ============================================================================\n\n/** SDK version for handshake protocol */\nexport const SDK_VERSION = \"1.1.2\";\n\n/** Feature flags as bitset for version negotiation */\nexport const FEATURES = {\n  RESIZE: 1 << 0, // 0b0001\n  THEME_SYNC: 1 << 1, // 0b0010\n  ANON_ID: 1 << 2, // 0b0100\n  SCROLLBAR_STYLES: 1 << 3, // 0b1000\n} as const;\n\n/** Current SDK feature set */\nexport const CURRENT_FEATURES =\n  FEATURES.RESIZE |\n  FEATURES.THEME_SYNC |\n  FEATURES.ANON_ID |\n  FEATURES.SCROLLBAR_STYLES;\n\n// ============================================================================\n// URL Parameter Keys\n// ============================================================================\n\n// Embed parameters\nexport const PARAM_KEYS = {\n  embed: \"embed\",\n  embedType: \"embed_type\",\n  theme: \"theme\",\n} as const;\n\nexport type ParamKey = (typeof PARAM_KEYS)[keyof typeof PARAM_KEYS];\n\n// ============================================================================\n// Brand Color Keys\n// ============================================================================\n\nexport const BRAND_KEYS = {\n  // Light mode\n  primary: \"brand.primary\",\n  secondary: \"brand.secondary\",\n  bg: \"brand.bg\",\n  text: \"brand.text\",\n\n  // Dark mode\n  darkPrimary: \"brand.dark.primary\",\n  darkSecondary: \"brand.dark.secondary\",\n  darkBg: \"brand.dark.bg\",\n  darkText: \"brand.dark.text\",\n} as const;\n\nexport type BrandKey = (typeof BRAND_KEYS)[keyof typeof BRAND_KEYS];\n\n// ============================================================================\n// Reserved Parameters (cannot be overridden via custom params or parent URL)\n// ============================================================================\n\nexport const RESERVED_PARAMS: Set<string> = new Set([\n  ...Object.values(PARAM_KEYS),\n  ...Object.values(BRAND_KEYS),\n]);\n\n// ============================================================================\n// Data Attributes (HTML declarative initialization)\n// ============================================================================\n\nexport const DATA_ATTRS = {\n  widget: \"data-perspective-widget\",\n  popup: \"data-perspective-popup\",\n  slider: \"data-perspective-slider\",\n  float: \"data-perspective-float\", // Primary name\n  chat: \"data-perspective-chat\", // Legacy alias\n  fullpage: \"data-perspective-fullpage\",\n  params: \"data-perspective-params\",\n  brand: \"data-perspective-brand\",\n  brandDark: \"data-perspective-brand-dark\",\n  theme: \"data-perspective-theme\",\n  noStyle: \"data-perspective-no-style\",\n  autoOpen: \"data-perspective-auto-open\",\n  showOnce: \"data-perspective-show-once\",\n} as const;\n\nexport type DataAttr = (typeof DATA_ATTRS)[keyof typeof DATA_ATTRS];\n\n// ============================================================================\n// PostMessage Event Types\n// ============================================================================\n\nexport const MESSAGE_TYPES = {\n  // SDK -> Iframe (initialization)\n  init: \"perspective:init\",\n\n  // Iframe -> SDK\n  ready: \"perspective:ready\",\n  resize: \"perspective:resize\",\n  submit: \"perspective:submit\",\n  close: \"perspective:close\",\n  error: \"perspective:error\",\n  redirect: \"perspective:redirect\",\n\n  // SDK -> Iframe (internal)\n  anonId: \"perspective:anon-id\",\n  injectStyles: \"perspective:inject-styles\",\n  themeChange: \"perspective:theme-change\",\n\n  // Iframe -> SDK (internal)\n  requestScrollbarStyles: \"perspective:request-scrollbar-styles\",\n} as const;\n\nexport type MessageType = (typeof MESSAGE_TYPES)[keyof typeof MESSAGE_TYPES];\n\n// ============================================================================\n// Error Codes\n// ============================================================================\n\nexport const ERROR_CODES = {\n  SDK_OUTDATED: \"SDK_OUTDATED\",\n  INVALID_RESEARCH: \"INVALID_RESEARCH\",\n  UNKNOWN: \"UNKNOWN\",\n} as const;\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\n// ============================================================================\n// Param Values (for boolean-like string params)\n// ============================================================================\n\nexport const PARAM_VALUES = {\n  true: \"true\",\n  false: \"false\",\n} as const;\n\n// ============================================================================\n// Theme Values\n// ============================================================================\n\nexport const THEME_VALUES = {\n  dark: \"dark\",\n  light: \"light\",\n  system: \"system\",\n} as const;\n\nexport type ThemeValue = (typeof THEME_VALUES)[keyof typeof THEME_VALUES];\n\n// ============================================================================\n// Interview Mode Values (for mode param)\n// ============================================================================\n\nexport const MODE_VALUES = {\n  preview: \"preview\",\n  restart: \"restart\",\n  normal: \"normal\",\n  simulated: \"simulated\",\n} as const;\n\nexport type ModeValue = (typeof MODE_VALUES)[keyof typeof MODE_VALUES];\n\n// ============================================================================\n// localStorage Keys\n// ============================================================================\n\nexport const STORAGE_KEYS = {\n  anonId: \"perspective-anon-id\",\n  triggerShown: \"perspective-trigger-shown\",\n} as const;\n"]}

package/dist/constants.d.cts

@@ -4,7 +4,7 @@
  * Used by both SDK bundle and the main Perspective app
  */
 /** SDK version for handshake protocol */
-declare const SDK_VERSION = "1.0.0";
+declare const SDK_VERSION = "1.1.2";
 /** Feature flags as bitset for version negotiation */
 declare const FEATURES: {
     readonly RESIZE: number;
@@ -31,8 +31,6 @@ declare const BRAND_KEYS: {
     readonly darkText: "brand.dark.text";
 };
 type BrandKey = (typeof BRAND_KEYS)[keyof typeof BRAND_KEYS];
-declare const UTM_PARAMS: readonly ["utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
-type UtmParam = (typeof UTM_PARAMS)[number];
 declare const RESERVED_PARAMS: Set<string>;
 declare const DATA_ATTRS: {
     readonly widget: "data-perspective-widget";
@@ -46,6 +44,8 @@ declare const DATA_ATTRS: {
     readonly brandDark: "data-perspective-brand-dark";
     readonly theme: "data-perspective-theme";
     readonly noStyle: "data-perspective-no-style";
+    readonly autoOpen: "data-perspective-auto-open";
+    readonly showOnce: "data-perspective-show-once";
 };
 type DataAttr = (typeof DATA_ATTRS)[keyof typeof DATA_ATTRS];
 declare const MESSAGE_TYPES: {
@@ -87,6 +87,7 @@ declare const MODE_VALUES: {
 type ModeValue = (typeof MODE_VALUES)[keyof typeof MODE_VALUES];
 declare const STORAGE_KEYS: {
     readonly anonId: "perspective-anon-id";
+    readonly triggerShown: "perspective-trigger-shown";
 };
 
-export { BRAND_KEYS, type BrandKey, CURRENT_FEATURES, DATA_ATTRS, type DataAttr, ERROR_CODES, type ErrorCode, FEATURES, MESSAGE_TYPES, MODE_VALUES, type MessageType, type ModeValue, PARAM_KEYS, PARAM_VALUES, type ParamKey, RESERVED_PARAMS, SDK_VERSION, STORAGE_KEYS, THEME_VALUES, type ThemeValue, UTM_PARAMS, type UtmParam };
+export { BRAND_KEYS, type BrandKey, CURRENT_FEATURES, DATA_ATTRS, type DataAttr, ERROR_CODES, type ErrorCode, FEATURES, MESSAGE_TYPES, MODE_VALUES, type MessageType, type ModeValue, PARAM_KEYS, PARAM_VALUES, type ParamKey, RESERVED_PARAMS, SDK_VERSION, STORAGE_KEYS, THEME_VALUES, type ThemeValue };

package/dist/constants.d.ts

@@ -4,7 +4,7 @@
  * Used by both SDK bundle and the main Perspective app
  */
 /** SDK version for handshake protocol */
-declare const SDK_VERSION = "1.0.0";
+declare const SDK_VERSION = "1.1.2";
 /** Feature flags as bitset for version negotiation */
 declare const FEATURES: {
     readonly RESIZE: number;
@@ -31,8 +31,6 @@ declare const BRAND_KEYS: {
     readonly darkText: "brand.dark.text";
 };
 type BrandKey = (typeof BRAND_KEYS)[keyof typeof BRAND_KEYS];
-declare const UTM_PARAMS: readonly ["utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
-type UtmParam = (typeof UTM_PARAMS)[number];
 declare const RESERVED_PARAMS: Set<string>;
 declare const DATA_ATTRS: {
     readonly widget: "data-perspective-widget";
@@ -46,6 +44,8 @@ declare const DATA_ATTRS: {
     readonly brandDark: "data-perspective-brand-dark";
     readonly theme: "data-perspective-theme";
     readonly noStyle: "data-perspective-no-style";
+    readonly autoOpen: "data-perspective-auto-open";
+    readonly showOnce: "data-perspective-show-once";
 };
 type DataAttr = (typeof DATA_ATTRS)[keyof typeof DATA_ATTRS];
 declare const MESSAGE_TYPES: {
@@ -87,6 +87,7 @@ declare const MODE_VALUES: {
 type ModeValue = (typeof MODE_VALUES)[keyof typeof MODE_VALUES];
 declare const STORAGE_KEYS: {
     readonly anonId: "perspective-anon-id";
+    readonly triggerShown: "perspective-trigger-shown";
 };
 
-export { BRAND_KEYS, type BrandKey, CURRENT_FEATURES, DATA_ATTRS, type DataAttr, ERROR_CODES, type ErrorCode, FEATURES, MESSAGE_TYPES, MODE_VALUES, type MessageType, type ModeValue, PARAM_KEYS, PARAM_VALUES, type ParamKey, RESERVED_PARAMS, SDK_VERSION, STORAGE_KEYS, THEME_VALUES, type ThemeValue, UTM_PARAMS, type UtmParam };
+export { BRAND_KEYS, type BrandKey, CURRENT_FEATURES, DATA_ATTRS, type DataAttr, ERROR_CODES, type ErrorCode, FEATURES, MESSAGE_TYPES, MODE_VALUES, type MessageType, type ModeValue, PARAM_KEYS, PARAM_VALUES, type ParamKey, RESERVED_PARAMS, SDK_VERSION, STORAGE_KEYS, THEME_VALUES, type ThemeValue };

package/dist/constants.js

@@ -1,5 +1,5 @@
 // src/constants.ts
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = "1.1.2";
 var FEATURES = {
   RESIZE: 1 << 0,
   // 0b0001
@@ -28,26 +28,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",
@@ -62,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)
@@ -102,9 +87,10 @@ var MODE_VALUES = {
   simulated: "simulated"
 };
 var STORAGE_KEYS = {
-  anonId: "perspective-anon-id"
+  anonId: "perspective-anon-id",
+  triggerShown: "perspective-trigger-shown"
 };
 
-export { BRAND_KEYS, CURRENT_FEATURES, DATA_ATTRS, ERROR_CODES, FEATURES, MESSAGE_TYPES, MODE_VALUES, PARAM_KEYS, PARAM_VALUES, RESERVED_PARAMS, SDK_VERSION, STORAGE_KEYS, THEME_VALUES, UTM_PARAMS };
+export { BRAND_KEYS, CURRENT_FEATURES, DATA_ATTRS, ERROR_CODES, FEATURES, MESSAGE_TYPES, MODE_VALUES, PARAM_KEYS, PARAM_VALUES, RESERVED_PARAMS, SDK_VERSION, STORAGE_KEYS, THEME_VALUES };
 //# sourceMappingURL=constants.js.map
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts"],"names":[],"mappings":"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","file":"constants.js","sourcesContent":["/**\n * Shared constants for Perspective Embed SDK\n * This file is SSR-safe - no DOM access at import time\n * Used by both SDK bundle and the main Perspective app\n */\n\n// ============================================================================\n// SDK Version & Features\n// ============================================================================\n\n/** SDK version for handshake protocol */\nexport const SDK_VERSION = \"1.0.0\";\n\n/** Feature flags as bitset for version negotiation */\nexport const FEATURES = {\n  RESIZE: 1 << 0, // 0b0001\n  THEME_SYNC: 1 << 1, // 0b0010\n  ANON_ID: 1 << 2, // 0b0100\n  SCROLLBAR_STYLES: 1 << 3, // 0b1000\n} as const;\n\n/** Current SDK feature set */\nexport const CURRENT_FEATURES =\n  FEATURES.RESIZE |\n  FEATURES.THEME_SYNC |\n  FEATURES.ANON_ID |\n  FEATURES.SCROLLBAR_STYLES;\n\n// ============================================================================\n// URL Parameter Keys\n// ============================================================================\n\n// Embed parameters\nexport const PARAM_KEYS = {\n  embed: \"embed\",\n  embedType: \"embed_type\",\n  theme: \"theme\",\n} as const;\n\nexport type ParamKey = (typeof PARAM_KEYS)[keyof typeof PARAM_KEYS];\n\n// ============================================================================\n// Brand Color Keys\n// ============================================================================\n\nexport const BRAND_KEYS = {\n  // Light mode\n  primary: \"brand.primary\",\n  secondary: \"brand.secondary\",\n  bg: \"brand.bg\",\n  text: \"brand.text\",\n\n  // Dark mode\n  darkPrimary: \"brand.dark.primary\",\n  darkSecondary: \"brand.dark.secondary\",\n  darkBg: \"brand.dark.bg\",\n  darkText: \"brand.dark.text\",\n} as const;\n\nexport type BrandKey = (typeof BRAND_KEYS)[keyof typeof BRAND_KEYS];\n\n// ============================================================================\n// UTM Parameters (auto-forwarded from parent URL)\n// ============================================================================\n\nexport const UTM_PARAMS = [\n  \"utm_source\",\n  \"utm_medium\",\n  \"utm_campaign\",\n  \"utm_term\",\n  \"utm_content\",\n] as const;\n\nexport type UtmParam = (typeof UTM_PARAMS)[number];\n\n// ============================================================================\n// Reserved Parameters (cannot be overridden via custom params)\n// ============================================================================\n\nexport const RESERVED_PARAMS: Set<string> = new Set([\n  PARAM_KEYS.embed,\n  PARAM_KEYS.embedType,\n  PARAM_KEYS.theme,\n  BRAND_KEYS.primary,\n  BRAND_KEYS.secondary,\n  BRAND_KEYS.bg,\n  BRAND_KEYS.text,\n  BRAND_KEYS.darkPrimary,\n  BRAND_KEYS.darkSecondary,\n  BRAND_KEYS.darkBg,\n  BRAND_KEYS.darkText,\n  ...UTM_PARAMS,\n]);\n\n// ============================================================================\n// Data Attributes (HTML declarative initialization)\n// ============================================================================\n\nexport const DATA_ATTRS = {\n  widget: \"data-perspective-widget\",\n  popup: \"data-perspective-popup\",\n  slider: \"data-perspective-slider\",\n  float: \"data-perspective-float\", // Primary name\n  chat: \"data-perspective-chat\", // Legacy alias\n  fullpage: \"data-perspective-fullpage\",\n  params: \"data-perspective-params\",\n  brand: \"data-perspective-brand\",\n  brandDark: \"data-perspective-brand-dark\",\n  theme: \"data-perspective-theme\",\n  noStyle: \"data-perspective-no-style\",\n} as const;\n\nexport type DataAttr = (typeof DATA_ATTRS)[keyof typeof DATA_ATTRS];\n\n// ============================================================================\n// PostMessage Event Types\n// ============================================================================\n\nexport const MESSAGE_TYPES = {\n  // SDK -> Iframe (initialization)\n  init: \"perspective:init\",\n\n  // Iframe -> SDK\n  ready: \"perspective:ready\",\n  resize: \"perspective:resize\",\n  submit: \"perspective:submit\",\n  close: \"perspective:close\",\n  error: \"perspective:error\",\n  redirect: \"perspective:redirect\",\n\n  // SDK -> Iframe (internal)\n  anonId: \"perspective:anon-id\",\n  injectStyles: \"perspective:inject-styles\",\n  themeChange: \"perspective:theme-change\",\n\n  // Iframe -> SDK (internal)\n  requestScrollbarStyles: \"perspective:request-scrollbar-styles\",\n} as const;\n\nexport type MessageType = (typeof MESSAGE_TYPES)[keyof typeof MESSAGE_TYPES];\n\n// ============================================================================\n// Error Codes\n// ============================================================================\n\nexport const ERROR_CODES = {\n  SDK_OUTDATED: \"SDK_OUTDATED\",\n  INVALID_RESEARCH: \"INVALID_RESEARCH\",\n  UNKNOWN: \"UNKNOWN\",\n} as const;\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\n// ============================================================================\n// Param Values (for boolean-like string params)\n// ============================================================================\n\nexport const PARAM_VALUES = {\n  true: \"true\",\n  false: \"false\",\n} as const;\n\n// ============================================================================\n// Theme Values\n// ============================================================================\n\nexport const THEME_VALUES = {\n  dark: \"dark\",\n  light: \"light\",\n  system: \"system\",\n} as const;\n\nexport type ThemeValue = (typeof THEME_VALUES)[keyof typeof THEME_VALUES];\n\n// ============================================================================\n// Interview Mode Values (for mode param)\n// ============================================================================\n\nexport const MODE_VALUES = {\n  preview: \"preview\",\n  restart: \"restart\",\n  normal: \"normal\",\n  simulated: \"simulated\",\n} as const;\n\nexport type ModeValue = (typeof MODE_VALUES)[keyof typeof MODE_VALUES];\n\n// ============================================================================\n// localStorage Keys\n// ============================================================================\n\nexport const STORAGE_KEYS = {\n  anonId: \"perspective-anon-id\",\n} as const;\n"]}
+{"version":3,"sources":["../src/constants.ts"],"names":[],"mappings":";AAWO,IAAM,WAAA,GAAc;AAGpB,IAAM,QAAA,GAAW;AAAA,EACtB,QAAQ,CAAA,IAAK,CAAA;AAAA;AAAA,EACb,YAAY,CAAA,IAAK,CAAA;AAAA;AAAA,EACjB,SAAS,CAAA,IAAK,CAAA;AAAA;AAAA,EACd,kBAAkB,CAAA,IAAK;AAAA;AACzB;AAGO,IAAM,mBACX,QAAA,CAAS,MAAA,GACT,SAAS,UAAA,GACT,QAAA,CAAS,UACT,QAAA,CAAS;AAOJ,IAAM,UAAA,GAAa;AAAA,EACxB,KAAA,EAAO,OAAA;AAAA,EACP,SAAA,EAAW,YAAA;AAAA,EACX,KAAA,EAAO;AACT;AAQO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,OAAA,EAAS,eAAA;AAAA,EACT,SAAA,EAAW,iBAAA;AAAA,EACX,EAAA,EAAI,UAAA;AAAA,EACJ,IAAA,EAAM,YAAA;AAAA;AAAA,EAGN,WAAA,EAAa,oBAAA;AAAA,EACb,aAAA,EAAe,sBAAA;AAAA,EACf,MAAA,EAAQ,eAAA;AAAA,EACR,QAAA,EAAU;AACZ;AAQO,IAAM,eAAA,uBAAmC,GAAA,CAAI;AAAA,EAClD,GAAG,MAAA,CAAO,MAAA,CAAO,UAAU,CAAA;AAAA,EAC3B,GAAG,MAAA,CAAO,MAAA,CAAO,UAAU;AAC7B,CAAC;AAMM,IAAM,UAAA,GAAa;AAAA,EACxB,MAAA,EAAQ,yBAAA;AAAA,EACR,KAAA,EAAO,wBAAA;AAAA,EACP,MAAA,EAAQ,yBAAA;AAAA,EACR,KAAA,EAAO,wBAAA;AAAA;AAAA,EACP,IAAA,EAAM,uBAAA;AAAA;AAAA,EACN,QAAA,EAAU,2BAAA;AAAA,EACV,MAAA,EAAQ,yBAAA;AAAA,EACR,KAAA,EAAO,wBAAA;AAAA,EACP,SAAA,EAAW,6BAAA;AAAA,EACX,KAAA,EAAO,wBAAA;AAAA,EACP,OAAA,EAAS,2BAAA;AAAA,EACT,QAAA,EAAU,4BAAA;AAAA,EACV,QAAA,EAAU;AACZ;AAQO,IAAM,aAAA,GAAgB;AAAA;AAAA,EAE3B,IAAA,EAAM,kBAAA;AAAA;AAAA,EAGN,KAAA,EAAO,mBAAA;AAAA,EACP,MAAA,EAAQ,oBAAA;AAAA,EACR,MAAA,EAAQ,oBAAA;AAAA,EACR,KAAA,EAAO,mBAAA;AAAA,EACP,KAAA,EAAO,mBAAA;AAAA,EACP,QAAA,EAAU,sBAAA;AAAA;AAAA,EAGV,MAAA,EAAQ,qBAAA;AAAA,EACR,YAAA,EAAc,2BAAA;AAAA,EACd,WAAA,EAAa,0BAAA;AAAA;AAAA,EAGb,sBAAA,EAAwB;AAC1B;AAQO,IAAM,WAAA,GAAc;AAAA,EACzB,YAAA,EAAc,cAAA;AAAA,EACd,gBAAA,EAAkB,kBAAA;AAAA,EAClB,OAAA,EAAS;AACX;AAQO,IAAM,YAAA,GAAe;AAAA,EAC1B,IAAA,EAAM,MAAA;AAAA,EACN,KAAA,EAAO;AACT;AAMO,IAAM,YAAA,GAAe;AAAA,EAC1B,IAAA,EAAM,MAAA;AAAA,EACN,KAAA,EAAO,OAAA;AAAA,EACP,MAAA,EAAQ;AACV;AAQO,IAAM,WAAA,GAAc;AAAA,EACzB,OAAA,EAAS,SAAA;AAAA,EACT,OAAA,EAAS,SAAA;AAAA,EACT,MAAA,EAAQ,QAAA;AAAA,EACR,SAAA,EAAW;AACb;AAQO,IAAM,YAAA,GAAe;AAAA,EAC1B,MAAA,EAAQ,qBAAA;AAAA,EACR,YAAA,EAAc;AAChB","file":"constants.js","sourcesContent":["/**\n * Shared constants for Perspective Embed SDK\n * This file is SSR-safe - no DOM access at import time\n * Used by both SDK bundle and the main Perspective app\n */\n\n// ============================================================================\n// SDK Version & Features\n// ============================================================================\n\n/** SDK version for handshake protocol */\nexport const SDK_VERSION = \"1.1.2\";\n\n/** Feature flags as bitset for version negotiation */\nexport const FEATURES = {\n  RESIZE: 1 << 0, // 0b0001\n  THEME_SYNC: 1 << 1, // 0b0010\n  ANON_ID: 1 << 2, // 0b0100\n  SCROLLBAR_STYLES: 1 << 3, // 0b1000\n} as const;\n\n/** Current SDK feature set */\nexport const CURRENT_FEATURES =\n  FEATURES.RESIZE |\n  FEATURES.THEME_SYNC |\n  FEATURES.ANON_ID |\n  FEATURES.SCROLLBAR_STYLES;\n\n// ============================================================================\n// URL Parameter Keys\n// ============================================================================\n\n// Embed parameters\nexport const PARAM_KEYS = {\n  embed: \"embed\",\n  embedType: \"embed_type\",\n  theme: \"theme\",\n} as const;\n\nexport type ParamKey = (typeof PARAM_KEYS)[keyof typeof PARAM_KEYS];\n\n// ============================================================================\n// Brand Color Keys\n// ============================================================================\n\nexport const BRAND_KEYS = {\n  // Light mode\n  primary: \"brand.primary\",\n  secondary: \"brand.secondary\",\n  bg: \"brand.bg\",\n  text: \"brand.text\",\n\n  // Dark mode\n  darkPrimary: \"brand.dark.primary\",\n  darkSecondary: \"brand.dark.secondary\",\n  darkBg: \"brand.dark.bg\",\n  darkText: \"brand.dark.text\",\n} as const;\n\nexport type BrandKey = (typeof BRAND_KEYS)[keyof typeof BRAND_KEYS];\n\n// ============================================================================\n// Reserved Parameters (cannot be overridden via custom params or parent URL)\n// ============================================================================\n\nexport const RESERVED_PARAMS: Set<string> = new Set([\n  ...Object.values(PARAM_KEYS),\n  ...Object.values(BRAND_KEYS),\n]);\n\n// ============================================================================\n// Data Attributes (HTML declarative initialization)\n// ============================================================================\n\nexport const DATA_ATTRS = {\n  widget: \"data-perspective-widget\",\n  popup: \"data-perspective-popup\",\n  slider: \"data-perspective-slider\",\n  float: \"data-perspective-float\", // Primary name\n  chat: \"data-perspective-chat\", // Legacy alias\n  fullpage: \"data-perspective-fullpage\",\n  params: \"data-perspective-params\",\n  brand: \"data-perspective-brand\",\n  brandDark: \"data-perspective-brand-dark\",\n  theme: \"data-perspective-theme\",\n  noStyle: \"data-perspective-no-style\",\n  autoOpen: \"data-perspective-auto-open\",\n  showOnce: \"data-perspective-show-once\",\n} as const;\n\nexport type DataAttr = (typeof DATA_ATTRS)[keyof typeof DATA_ATTRS];\n\n// ============================================================================\n// PostMessage Event Types\n// ============================================================================\n\nexport const MESSAGE_TYPES = {\n  // SDK -> Iframe (initialization)\n  init: \"perspective:init\",\n\n  // Iframe -> SDK\n  ready: \"perspective:ready\",\n  resize: \"perspective:resize\",\n  submit: \"perspective:submit\",\n  close: \"perspective:close\",\n  error: \"perspective:error\",\n  redirect: \"perspective:redirect\",\n\n  // SDK -> Iframe (internal)\n  anonId: \"perspective:anon-id\",\n  injectStyles: \"perspective:inject-styles\",\n  themeChange: \"perspective:theme-change\",\n\n  // Iframe -> SDK (internal)\n  requestScrollbarStyles: \"perspective:request-scrollbar-styles\",\n} as const;\n\nexport type MessageType = (typeof MESSAGE_TYPES)[keyof typeof MESSAGE_TYPES];\n\n// ============================================================================\n// Error Codes\n// ============================================================================\n\nexport const ERROR_CODES = {\n  SDK_OUTDATED: \"SDK_OUTDATED\",\n  INVALID_RESEARCH: \"INVALID_RESEARCH\",\n  UNKNOWN: \"UNKNOWN\",\n} as const;\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\n// ============================================================================\n// Param Values (for boolean-like string params)\n// ============================================================================\n\nexport const PARAM_VALUES = {\n  true: \"true\",\n  false: \"false\",\n} as const;\n\n// ============================================================================\n// Theme Values\n// ============================================================================\n\nexport const THEME_VALUES = {\n  dark: \"dark\",\n  light: \"light\",\n  system: \"system\",\n} as const;\n\nexport type ThemeValue = (typeof THEME_VALUES)[keyof typeof THEME_VALUES];\n\n// ============================================================================\n// Interview Mode Values (for mode param)\n// ============================================================================\n\nexport const MODE_VALUES = {\n  preview: \"preview\",\n  restart: \"restart\",\n  normal: \"normal\",\n  simulated: \"simulated\",\n} as const;\n\nexport type ModeValue = (typeof MODE_VALUES)[keyof typeof MODE_VALUES];\n\n// ============================================================================\n// localStorage Keys\n// ============================================================================\n\nexport const STORAGE_KEYS = {\n  anonId: \"perspective-anon-id\",\n  triggerShown: \"perspective-trigger-shown\",\n} as const;\n"]}

package/dist/index.cjs

@@ -58,7 +58,7 @@ if (hasDom()) {
 }
 
 // src/constants.ts
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = "1.1.2";
 var FEATURES = {
   RESIZE: 1 << 0,
   // 0b0001
@@ -87,26 +87,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",
@@ -121,7 +104,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)
@@ -150,7 +135,8 @@ var THEME_VALUES = {
   system: "system"
 };
 var STORAGE_KEYS = {
-  anonId: "perspective-anon-id"
+  anonId: "perspective-anon-id",
+  triggerShown: "perspective-trigger-shown"
 };
 
 // src/utils.ts
@@ -220,13 +206,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;
     }
   }
@@ -249,8 +234,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) => {
@@ -1572,6 +1557,74 @@ function createFullpage(config) {
   };
 }
 
+// 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 {
+  }
+}
+
 exports.BRAND_KEYS = BRAND_KEYS;
 exports.CURRENT_FEATURES = CURRENT_FEATURES;
 exports.DATA_ATTRS = DATA_ATTRS;
@@ -1586,7 +1639,12 @@ exports.createFloatBubble = createFloatBubble;
 exports.createFullpage = createFullpage;
 exports.createWidget = createWidget;
 exports.getConfig = getConfig;
+exports.markShown = markShown;
 exports.openPopup = openPopup;
 exports.openSlider = openSlider;
+exports.parseShowOnceAttr = parseShowOnceAttr;
+exports.parseTriggerAttr = parseTriggerAttr;
+exports.setupTrigger = setupTrigger;
+exports.shouldShow = shouldShow;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map