@xapp/stentor-form-widget-channel 1.85.0 → 1.87.0

package/lib/FormWidgetEnv.d.ts

@@ -30,6 +30,59 @@ export interface FormWidgetEnv {
          * If true, it will automatically open the form widget, remove the ability to close it, remove the shadow boxing effect.
          */
         readonly enabled?: boolean;
+        /**
+         * Trigger configuration for auto-opening the form widget.
+         * These triggers show the form based on user behavior, unlike `enabled` which shows immediately.
+         */
+        readonly triggers?: {
+            /**
+             * Milliseconds before showing the form (timer-based trigger)
+             */
+            readonly delay?: number;
+            /**
+             * Show when user has scrolled past this percentage of the page (0-100)
+             */
+            readonly scrollPercent?: number;
+            /**
+             * Show when mouse leaves the viewport (exit intent detection)
+             */
+            readonly exitIntent?: boolean;
+            /**
+             * Pixels from top of viewport to trigger exit intent (default: 50)
+             */
+            readonly exitIntentThreshold?: number;
+            /**
+             * Milliseconds of no mouse/keyboard activity before showing
+             */
+            readonly inactivity?: number;
+        };
+        /**
+         * URL patterns to match. Uses includes() for matching.
+         * If provided, triggers only fire on matching URLs.
+         */
+        readonly patterns?: string[];
+        /**
+         * Minimum viewport width in pixels. Triggers won't fire below this width.
+         */
+        readonly minimumWidth?: number;
+        /**
+         * Trigger combination mode.
+         * - 'any' (default): first trigger that fires opens the form
+         * - 'all': all configured triggers must fire before opening
+         *
+         * Note: With 'all' mode, the form opens as soon as all configured triggers
+         * have fired at least once. If only one trigger is configured, 'all' mode
+         * behaves identically to 'any' mode.
+         *
+         * @example
+         * // With mode: 'all' and triggers: { delay: 5000, scrollPercent: 25 }
+         * // Form opens when BOTH 5 seconds have passed AND user has scrolled 25%
+         */
+        readonly mode?: 'any' | 'all';
+        /**
+         * sessionStorage key for persisting dismissed state (default: 'xafw-auto-open-dismissed')
+         */
+        readonly sessionKey?: string;
     };
     /**
      * Optional, used for autocomplete suggestions.

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "1.85.0",
+    "version": "1.87.0",
     "description": "Form Widget Channel for stentor 📣",
     "types": "lib/index",
     "main": "lib/index",
@@ -18,18 +18,18 @@
         "@types/chai": "4.3.20",
         "@types/sinon": "10.0.20",
         "@types/sinon-chai": "3.2.12",
-        "@xapp/config": "0.2.3",
+        "@xapp/config": "0.3.0",
         "chai": "4.5.0",
         "mocha": "9.2.2",
         "sinon": "13.0.2",
         "sinon-chai": "3.7.0",
-        "stentor-models": "1.68.6",
+        "stentor-models": "1.69.9",
         "ts-node": "10.9.2",
         "typescript": "5.9.3"
     },
     "dependencies": {
-        "stentor-constants": "1.68.6",
-        "stentor-guards": "1.68.6"
+        "stentor-constants": "1.69.9",
+        "stentor-guards": "1.69.9"
     },
     "peerDependencies": {
         "stentor-models": "^1.0.0"
@@ -38,5 +38,5 @@
         "build": "tsc -d true -p .",
         "clean": "rm -rf ./lib/*"
     },
-    "gitHead": "7e88fa85fbd4c05a32caffe37099e72a0534b86c"
+    "gitHead": "e4e9a6ff1e817ce27c3df845376892b980d9adcc"
 }