@liquidcommercedev/rmn-sdk 1.5.0-beta.1 → 1.5.0-beta.3

package/dist/index.cjs

@@ -3,6 +3,7 @@
 exports.RMN_SPOT_TYPE = void 0;
 (function (RMN_SPOT_TYPE) {
     // Reserve Bar Spot Types
+    RMN_SPOT_TYPE["RB_HOMEPAGE_HERO"] = "rbHomepageHero";
     RMN_SPOT_TYPE["RB_HOMEPAGE_HERO_THREE_TILE"] = "rbHomepageHeroThreeTile";
     RMN_SPOT_TYPE["RB_HOMEPAGE_HERO_TWO_TILE"] = "rbHomepageHeroTwoTile";
     RMN_SPOT_TYPE["RB_HOMEPAGE_HERO_FULL_IMAGE"] = "rbHomepageHeroFullImage";
@@ -18196,7 +18197,8 @@ class EventService {
         })();
     }
     /**
-     * Fires an event using the navigator.sendBeacon method and redirects the user if the event is a click event.
+     * Fires an event using the navigator.sendBeacon method or a fallback method if sendBeacon is not available.
+     * If the event is a click event and a redirect URL is found, it redirects the user to that URL.
      *
      * @param {IFireEventParams} params - The parameters for firing the event.
      * @param {RMN_SPOT_EVENT} params.event - The event type.
@@ -18204,26 +18206,65 @@ class EventService {
      * @returns {Promise<void>} - A promise that resolves when the event is fired.
      */
     async fireEvent({ event, eventUrl }) {
-        const didFireEvent = navigator.sendBeacon(eventUrl);
-        if (didFireEvent && event === exports.RMN_SPOT_EVENT.CLICK) {
-            window.location.href = this.getRedirectUrlFromPayload(eventUrl);
+        var _a;
+        try {
+            const didFireEvent = ((_a = navigator === null || navigator === void 0 ? void 0 : navigator.sendBeacon) === null || _a === void 0 ? void 0 : _a.call(navigator, eventUrl)) || (await this.fallbackEventFire(eventUrl));
+            if (!didFireEvent) {
+                return;
+            }
+            if (event === exports.RMN_SPOT_EVENT.CLICK) {
+                const redirectUrl = this.getRedirectUrlFromPayload(eventUrl);
+                if (redirectUrl) {
+                    window.location.href = redirectUrl;
+                }
+            }
+        }
+        catch (_b) {
+            // Handle errors silently
+        }
+    }
+    // Fallback method using fetch if sendBeacon isn't available
+    async fallbackEventFire(url) {
+        try {
+            const racePromise = Promise.race([
+                // Promise #1: The fetch request
+                fetch(url, {
+                    method: 'POST',
+                    keepalive: true,
+                }),
+                // Promise #2: The timeout
+                new Promise((_, reject) => setTimeout(() => reject(new Error('Request timeout')), 2000)),
+            ]);
+            /**
+             * Prevent requests from hanging indefinitely
+             * Improve user experience by failing fast
+             * Handle slow network conditions gracefully
+             * Ensure resources are freed up in a timely manner
+             */
+            const response = await racePromise;
+            return response.ok;
+        }
+        catch (_a) {
+            return false;
         }
     }
     /**
      * Extracts and decodes a URL from a base64-encoded query parameter.
      *
      * @param {string} url - The URL containing the base64-encoded query parameter.
-     * @returns {string} - The decoded URL or an empty string if decoding fails.
+     * @returns {string | null} - The decoded URL or null if not found or invalid.
      */
     getRedirectUrlFromPayload(url) {
-        var _a, _b;
-        const base64String = (_a = new URL(url).searchParams.get('e')) !== null && _a !== void 0 ? _a : '';
         try {
+            const base64String = new URL(url).searchParams.get('e');
+            if (!base64String) {
+                return null;
+            }
             const data = JSON.parse(atob(base64String));
-            return (_b = data.ur) !== null && _b !== void 0 ? _b : '';
+            return data.ur || null;
         }
-        catch (_c) {
-            return '';
+        catch (_a) {
+            return null;
         }
     }
 }

package/dist/index.esm.js

@@ -1,6 +1,7 @@
 var RMN_SPOT_TYPE;
 (function (RMN_SPOT_TYPE) {
     // Reserve Bar Spot Types
+    RMN_SPOT_TYPE["RB_HOMEPAGE_HERO"] = "rbHomepageHero";
     RMN_SPOT_TYPE["RB_HOMEPAGE_HERO_THREE_TILE"] = "rbHomepageHeroThreeTile";
     RMN_SPOT_TYPE["RB_HOMEPAGE_HERO_TWO_TILE"] = "rbHomepageHeroTwoTile";
     RMN_SPOT_TYPE["RB_HOMEPAGE_HERO_FULL_IMAGE"] = "rbHomepageHeroFullImage";
@@ -18194,7 +18195,8 @@ class EventService {
         })();
     }
     /**
-     * Fires an event using the navigator.sendBeacon method and redirects the user if the event is a click event.
+     * Fires an event using the navigator.sendBeacon method or a fallback method if sendBeacon is not available.
+     * If the event is a click event and a redirect URL is found, it redirects the user to that URL.
      *
      * @param {IFireEventParams} params - The parameters for firing the event.
      * @param {RMN_SPOT_EVENT} params.event - The event type.
@@ -18202,26 +18204,65 @@ class EventService {
      * @returns {Promise<void>} - A promise that resolves when the event is fired.
      */
     async fireEvent({ event, eventUrl }) {
-        const didFireEvent = navigator.sendBeacon(eventUrl);
-        if (didFireEvent && event === RMN_SPOT_EVENT.CLICK) {
-            window.location.href = this.getRedirectUrlFromPayload(eventUrl);
+        var _a;
+        try {
+            const didFireEvent = ((_a = navigator === null || navigator === void 0 ? void 0 : navigator.sendBeacon) === null || _a === void 0 ? void 0 : _a.call(navigator, eventUrl)) || (await this.fallbackEventFire(eventUrl));
+            if (!didFireEvent) {
+                return;
+            }
+            if (event === RMN_SPOT_EVENT.CLICK) {
+                const redirectUrl = this.getRedirectUrlFromPayload(eventUrl);
+                if (redirectUrl) {
+                    window.location.href = redirectUrl;
+                }
+            }
+        }
+        catch (_b) {
+            // Handle errors silently
+        }
+    }
+    // Fallback method using fetch if sendBeacon isn't available
+    async fallbackEventFire(url) {
+        try {
+            const racePromise = Promise.race([
+                // Promise #1: The fetch request
+                fetch(url, {
+                    method: 'POST',
+                    keepalive: true,
+                }),
+                // Promise #2: The timeout
+                new Promise((_, reject) => setTimeout(() => reject(new Error('Request timeout')), 2000)),
+            ]);
+            /**
+             * Prevent requests from hanging indefinitely
+             * Improve user experience by failing fast
+             * Handle slow network conditions gracefully
+             * Ensure resources are freed up in a timely manner
+             */
+            const response = await racePromise;
+            return response.ok;
+        }
+        catch (_a) {
+            return false;
         }
     }
     /**
      * Extracts and decodes a URL from a base64-encoded query parameter.
      *
      * @param {string} url - The URL containing the base64-encoded query parameter.
-     * @returns {string} - The decoded URL or an empty string if decoding fails.
+     * @returns {string | null} - The decoded URL or null if not found or invalid.
      */
     getRedirectUrlFromPayload(url) {
-        var _a, _b;
-        const base64String = (_a = new URL(url).searchParams.get('e')) !== null && _a !== void 0 ? _a : '';
         try {
+            const base64String = new URL(url).searchParams.get('e');
+            if (!base64String) {
+                return null;
+            }
             const data = JSON.parse(atob(base64String));
-            return (_b = data.ur) !== null && _b !== void 0 ? _b : '';
+            return data.ur || null;
         }
-        catch (_c) {
-            return '';
+        catch (_a) {
+            return null;
         }
     }
 }

package/dist/types/enums.d.ts

@@ -1,4 +1,5 @@
 export declare enum RMN_SPOT_TYPE {
+    RB_HOMEPAGE_HERO = "rbHomepageHero",
     RB_HOMEPAGE_HERO_THREE_TILE = "rbHomepageHeroThreeTile",
     RB_HOMEPAGE_HERO_TWO_TILE = "rbHomepageHeroTwoTile",
     RB_HOMEPAGE_HERO_FULL_IMAGE = "rbHomepageHeroFullImage",

package/dist/types/modules/element/element.interface.d.ts

@@ -1,4 +1,4 @@
-import type { RMN_SPOT_TYPE } from 'enums';
+import type { RMN_FILTER_PROPERTIES, RMN_SPOT_TYPE } from 'enums';
 import type { ICarouselOptions, ICreateCarouselElementParams } from 'modules/element/component/carousel';
 import type { ICreateSpotElementParams } from 'modules/element/component/spot';
 import type { RmnFilterType } from 'modules/selection';
@@ -21,12 +21,15 @@ export interface IInjectSpotElementConfig {
     overlay?: ISpotOverlay;
     carousel?: ICarouselOptions;
 }
+export type IInjectSpotElementFilterType = Partial<Omit<RmnFilterType, RMN_FILTER_PROPERTIES.KEYWORDS> & {
+    exactMatch?: string;
+}>;
 export interface IInjectSpotElement {
     placementId: string;
     spotType: RMN_SPOT_TYPE | string;
     count?: number;
     config?: Omit<IInjectSpotElementConfig, 'url'>;
-    filter?: Partial<RmnFilterType>;
+    filter?: IInjectSpotElementFilterType;
 }
 export interface ICreateElementConfig {
     spot?: RMN_SPOT_TYPE;

package/dist/types/modules/event/event.service.d.ts

@@ -27,7 +27,8 @@ export declare class EventService {
     private handleIntersectionObserver;
     private fireImpressionEvent;
     /**
-     * Fires an event using the navigator.sendBeacon method and redirects the user if the event is a click event.
+     * Fires an event using the navigator.sendBeacon method or a fallback method if sendBeacon is not available.
+     * If the event is a click event and a redirect URL is found, it redirects the user to that URL.
      *
      * @param {IFireEventParams} params - The parameters for firing the event.
      * @param {RMN_SPOT_EVENT} params.event - The event type.
@@ -35,11 +36,12 @@ export declare class EventService {
      * @returns {Promise<void>} - A promise that resolves when the event is fired.
      */
     private fireEvent;
+    private fallbackEventFire;
     /**
      * Extracts and decodes a URL from a base64-encoded query parameter.
      *
      * @param {string} url - The URL containing the base64-encoded query parameter.
-     * @returns {string} - The decoded URL or an empty string if decoding fails.
+     * @returns {string | null} - The decoded URL or null if not found or invalid.
      */
     private getRedirectUrlFromPayload;
 }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@liquidcommercedev/rmn-sdk",
   "description": "LiquidCommerce RMN SDK",
   "author": "LiquidCommerce Tech",
-  "version": "1.5.0-beta.1",
+  "version": "1.5.0-beta.3",
   "homepage": "https://docs.liquidcommerce.co/rmn-sdk",
   "main": "./dist/index.cjs",
   "module": "./dist/index.esm.js",