@chordcommerce/analytics 1.19.0-beta.1 → 1.21.0-beta.3

package/dist/cjs/types/input.d.ts

@@ -394,3 +394,248 @@ export interface PaymentInfoEnteredInput<T extends ObjectTypes = ObjectTypes> {
      */
     value?: number;
 }
+export interface OrderCompletedProductInput {
+    /**
+     * Product affiliation (for example, "Google Store")
+     */
+    affiliation?: string;
+    /**
+     * Brand associated with the product
+     */
+    brand?: string;
+    /**
+     * Product belongs to a bundle
+     */
+    bundle?: boolean;
+    /**
+     * Number of SKUs in the bundle
+     */
+    bundleSize?: number;
+    /**
+     * Product category
+     */
+    category?: string;
+    /**
+     * Coupon code associated with the product
+     */
+    coupon?: string;
+    /**
+     * Quantity sold via cross-selling
+     */
+    crossSoldQuantity?: number;
+    /**
+     * Short description of the product
+     */
+    description?: string;
+    /**
+     * Image URL of the product
+     */
+    imageUrl?: string;
+    /**
+     * Database ID of the line item
+     */
+    lineItemId?: string;
+    /**
+     * Name of the product
+     */
+    name: string;
+    /**
+     * Option values of the product variant
+     */
+    optionValues?: string[];
+    /**
+     * Position in the product list
+     */
+    position?: number;
+    /**
+     * Price ($) of the product
+     */
+    price: number;
+    /**
+     * Database ID of the product
+     */
+    productId: string;
+    /**
+     * Quantity of the product
+     */
+    quantity: number;
+    /**
+     * Revenue ($) with discounts and coupons added in
+     */
+    revenue: number;
+    /**
+     * SKU of the product variant
+     */
+    sku: string;
+    /**
+     * Slug of the product
+     */
+    slug?: string;
+    /**
+     * URL of the product page
+     */
+    url?: string;
+    /**
+     * Name of the product variant
+     */
+    variant?: string;
+    /**
+     * Metadata of the product variant
+     */
+    variantMetadata?: {
+        [key: string]: any;
+    };
+    [property: string]: any;
+}
+export interface OrderCompletedShippingMethodDetailsInput {
+    /**
+     * Code of shipping method (for example, "standard_shipping")
+     */
+    shippingCode?: string;
+    /**
+     * Name of shipping method (for example, "Standard Shipping")
+     */
+    shippingMethod?: string;
+}
+export interface OrderCompletedInput {
+    /**
+     * Store or affiliation from which this transaction occurred
+     */
+    affiliation?: string;
+    /**
+     * Order metadata "campaign_id"
+     */
+    campaignId?: number;
+    /**
+     * Order category
+     */
+    category?: string;
+    /**
+     * Channel where order was placed (for example, "chord")
+     */
+    channel?: string;
+    /**
+     * Checkout ID
+     */
+    checkoutId?: string;
+    /**
+     * Checkout provider (for example, "stripe")
+     */
+    checkoutType?: string;
+    /**
+     * Transaction coupon redeemed with the transaction
+     */
+    coupon?: string;
+    /**
+     * Currency code of the transaction (for example, "USD")
+     */
+    currency: string;
+    /**
+     * Total discount associated with the transaction
+     */
+    discount?: number;
+    /**
+     * Email address associated with the order
+     */
+    email?: string;
+    /**
+     * First name in the shipping address for the order
+     */
+    firstName?: string;
+    /**
+     * Order contains a subscription
+     */
+    hasSubscription?: boolean;
+    /**
+     * Order is a recurring subscription order
+     */
+    isRecurring?: boolean;
+    /**
+     * Last name in the shipping address for the order
+     */
+    lastName?: string;
+    /**
+     * Metadata of the order
+     */
+    metadata?: {
+        [key: string]: any;
+    };
+    /**
+     * Date and time order was placed
+     */
+    orderDate: string;
+    /**
+     * Order/transaction ID
+     */
+    orderId: string;
+    /**
+     * Phone number associated with the order
+     */
+    phone?: string;
+    /**
+     * Products in the order
+     */
+    products: OrderCompletedProductInput[];
+    /**
+     * URL for customer to share to receive referral credit
+     */
+    purlLink?: string;
+    /**
+     * ID for referral that customer used to place the order
+     */
+    referralIdentifierId?: string;
+    /**
+     * Indicates whether the customer is new or returning
+     */
+    repeat?: boolean;
+    /**
+     * Revenue ($) associated with the transaction (excluding shipping and tax)
+     */
+    revenue: number;
+    /**
+     * Shipping cost associated with the transaction
+     */
+    shipping?: number;
+    /**
+     * City in the shipping address for the order
+     */
+    shippingCity?: string;
+    /**
+     * Country in the shipping address for the order
+     */
+    shippingCountry?: string;
+    /**
+     * Shipping method details
+     */
+    shippingMethodDetails?: OrderCompletedShippingMethodDetailsInput;
+    /**
+     * State in the shipping address for the order
+     */
+    shippingState?: string;
+    /**
+     * Zipcode in the shipping address for the order
+     */
+    shippingZipcode?: string;
+    /**
+     * Order total after discounts but before taxes and shipping
+     */
+    subtotal?: number;
+    /**
+     * Total tax associated with the transaction
+     */
+    tax?: number;
+    /**
+     * Order metadata "template_id"
+     */
+    templateId?: number;
+    /**
+     * Revenue ($) with discounts and coupons added in
+     */
+    total: number;
+    /**
+     * Tracking IDs for third party integrations
+     */
+    trackingIds?: {
+        [key: string]: any;
+    };
+}

package/dist/client/index.d.ts

@@ -1,4 +1,4 @@
-import type { AnyAnalytics, EventProperties, Options, ValidateResult, ChordAnalyticsOptions, AnyOptions, CartViewedInput, IdentifyTraits, CheckoutStartedInput, CheckoutStepCompletedInput, CheckoutStepViewedInput, EmailCapturedInput, ProductListViewedInput, ProductListFilteredInput, ProductAddedInput, ProductClickedInput, VariantClickedInput, ProductRemovedInput, ProductViewedInput, ProductsSearchedInput, CouponAppliedInput, CouponDeniedInput, CouponEnteredInput, CouponRemovedInput, SignedInInput, SignedOutInput, SignedUpInput, LoginStartedInput, ObjectTypes, SubscriptionCancelledInput, NavigationClickedInput, PaymentInfoEnteredInput } from '../types/index.js';
+import type { AnyAnalytics, EventProperties, Options, ValidateResult, ChordAnalyticsOptions, AnyOptions, CartViewedInput, IdentifyTraits, CheckoutStartedInput, CheckoutStepCompletedInput, CheckoutStepViewedInput, EmailCapturedInput, ProductListViewedInput, ProductListFilteredInput, ProductAddedInput, ProductClickedInput, VariantClickedInput, ProductRemovedInput, ProductViewedInput, ProductsSearchedInput, CouponAppliedInput, CouponDeniedInput, CouponEnteredInput, CouponRemovedInput, SignedInInput, SignedOutInput, SignedUpInput, LoginStartedInput, ObjectTypes, OrderCompletedInput, SubscriptionCancelledInput, NavigationClickedInput, PaymentInfoEnteredInput } from '../types/index.js';
 import { AnalyticsMiddleware } from '../types/client.js';
 export interface ChordAnalyticsSnippet {
     _loadOptions: ChordAnalyticsOptions<ObjectTypes>;
@@ -45,6 +45,20 @@ export declare class ChordAnalytics<T extends ObjectTypes = ObjectTypes> {
      */
     private consentReadyPromise;
     constructor(options: ChordAnalyticsOptions<T>);
+    /**
+     * Persist the consent event queue to sessionStorage for recovery on instance recreation.
+     * Validates queue size before storing to prevent QuotaExceededError.
+     */
+    private persistQueueToStorage;
+    /**
+     * Restore pending events from sessionStorage (keeps events less than 5 min old).
+     * Called on new instance initialization.
+     */
+    private restoreQueueFromStorage;
+    /**
+     * Clear the persisted queue from sessionStorage after successful flush.
+     */
+    private clearQueueFromStorage;
     /**
      * Initialize CDP snippet and wait for it to be ready.
      * Fires initial consent track event after CDP is fully initialized to avoid circular await.
@@ -66,6 +80,7 @@ export declare class ChordAnalytics<T extends ObjectTypes = ObjectTypes> {
     private waitForConsent;
     /**
      * Queue an event to be sent when consent is ready.
+     * Persists to sessionStorage for recovery on instance recreation.
      * Starts a consent watcher if not already active.
      */
     private queueEventForConsent;
@@ -75,6 +90,7 @@ export declare class ChordAnalytics<T extends ObjectTypes = ObjectTypes> {
     private watchForConsentAndFlush;
     /**
      * Flush all queued events now that consent is ready.
+     * Clears sessionStorage after successful flush.
      */
     private flushConsentQueue;
     /**
@@ -159,4 +175,5 @@ export declare class ChordAnalytics<T extends ObjectTypes = ObjectTypes> {
     trackSubscriptionCancelled: (props: SubscriptionCancelledInput, options?: AnyOptions) => Promise<void>;
     trackNavigationClicked: (props: NavigationClickedInput, options?: AnyOptions) => Promise<void>;
     trackPaymentInfoEntered: (props: PaymentInfoEnteredInput, options?: AnyOptions) => Promise<void>;
+    trackOrderCompleted: (props: OrderCompletedInput, options?: AnyOptions) => Promise<void>;
 }

package/dist/client/index.js

@@ -12,6 +12,10 @@ import { addCdpConsent } from './consent/index.js';
 import { eventSchemas } from '../validators/index.js';
 import { pruneNullValues } from '../utils.js';
 const DEBUG_MODE_STORAGE_KEY = 'chordcommerce/analytics/debug';
+const CONSENT_QUEUE_STORAGE_KEY = 'chordcommerce/analytics/consent-queue';
+const CONSENT_QUEUE_TTL_MS = 5 * 60 * 1000; // 5 minutes
+const CONSENT_QUEUE_MAX_SIZE_BYTES = 100 * 1024; // 100KB max queue size
+const CONSENT_QUEUE_MAX_EVENTS = 50; // Max number of events to queue
 export class ChordAnalytics {
     constructor(options) {
         var _a, _b, _c;
@@ -45,6 +49,123 @@ export class ChordAnalytics {
          * Promise that resolves when consent is ready (shared across all queued events)
          */
         this.consentReadyPromise = null;
+        /**
+         * Persist the consent event queue to sessionStorage for recovery on instance recreation.
+         * Validates queue size before storing to prevent QuotaExceededError.
+         */
+        this.persistQueueToStorage = () => {
+            if (typeof window === 'undefined' || !window.sessionStorage)
+                return;
+            try {
+                // Limit number of events to prevent unbounded queue growth
+                const eventsToStore = this.consentEventQueue.slice(-CONSENT_QUEUE_MAX_EVENTS);
+                const persistedEvents = eventsToStore.map((item) => ({
+                    type: item.type,
+                    args: item.args,
+                    timestamp: item.timestamp,
+                }));
+                const serialized = JSON.stringify(persistedEvents);
+                // Check serialized size before attempting to store
+                const sizeInBytes = new Blob([serialized]).size;
+                if (sizeInBytes > CONSENT_QUEUE_MAX_SIZE_BYTES) {
+                    this.logger(`[Chord Analytics]: Consent queue too large (${Math.round(sizeInBytes / 1024)}KB), skipping persistence`);
+                    return;
+                }
+                window.sessionStorage.setItem(CONSENT_QUEUE_STORAGE_KEY, serialized);
+            }
+            catch (error) {
+                this.logger('[Chord Analytics]: Error persisting queue to storage:', error);
+            }
+        };
+        /**
+         * Restore pending events from sessionStorage (keeps events less than 5 min old).
+         * Called on new instance initialization.
+         */
+        this.restoreQueueFromStorage = () => {
+            if (typeof window === 'undefined' || !window.sessionStorage)
+                return;
+            try {
+                const stored = window.sessionStorage.getItem(CONSENT_QUEUE_STORAGE_KEY);
+                if (!stored)
+                    return;
+                let persistedEvents;
+                try {
+                    persistedEvents = JSON.parse(stored);
+                }
+                catch (parseError) {
+                    this.logger('[Chord Analytics]: Invalid JSON in stored consent queue, clearing storage:', parseError);
+                    window.sessionStorage.removeItem(CONSENT_QUEUE_STORAGE_KEY);
+                    return;
+                }
+                // Validate that parsed data is an array
+                if (!Array.isArray(persistedEvents)) {
+                    this.logger('[Chord Analytics]: Stored consent queue is not an array, clearing storage');
+                    window.sessionStorage.removeItem(CONSENT_QUEUE_STORAGE_KEY);
+                    return;
+                }
+                const now = Date.now();
+                // Filter out expired events and events with invalid structure
+                const validEvents = persistedEvents.filter((event) => {
+                    // Validate event structure
+                    if (typeof event !== 'object' || event === null)
+                        return false;
+                    if (!['track', 'page', 'identify'].includes(event.type))
+                        return false;
+                    if (!Array.isArray(event.args))
+                        return false;
+                    if (typeof event.timestamp !== 'number')
+                        return false;
+                    // Filter out expired events
+                    return now - event.timestamp < CONSENT_QUEUE_TTL_MS;
+                });
+                if (validEvents.length === 0) {
+                    window.sessionStorage.removeItem(CONSENT_QUEUE_STORAGE_KEY);
+                    return;
+                }
+                if (this.options.enableLogging && this.options.debug) {
+                    // eslint-disable-next-line no-console
+                    console.log(`[Chord Analytics DEBUG]: Restoring ${validEvents.length} events from sessionStorage`);
+                }
+                // Add restored events to the queue
+                validEvents.forEach((event) => {
+                    this.consentEventQueue.push({
+                        type: event.type,
+                        args: event.args,
+                        timestamp: event.timestamp,
+                        // eslint-disable-next-line @typescript-eslint/no-empty-function
+                        resolve: () => { },
+                    });
+                });
+                // Start watching for consent if we restored events
+                if (validEvents.length > 0 && !this.consentWatcherActive) {
+                    this.consentWatcherActive = true;
+                    this.watchForConsentAndFlush();
+                }
+            }
+            catch (error) {
+                this.logger('[Chord Analytics]: Error restoring queue from storage:', error);
+                // Clear corrupted storage
+                try {
+                    window.sessionStorage.removeItem(CONSENT_QUEUE_STORAGE_KEY);
+                }
+                catch (_a) {
+                    // Ignore cleanup errors
+                }
+            }
+        };
+        /**
+         * Clear the persisted queue from sessionStorage after successful flush.
+         */
+        this.clearQueueFromStorage = () => {
+            if (typeof window === 'undefined' || !window.sessionStorage)
+                return;
+            try {
+                window.sessionStorage.removeItem(CONSENT_QUEUE_STORAGE_KEY);
+            }
+            catch (error) {
+                this.logger('[Chord Analytics]: Error clearing queue from storage:', error);
+            }
+        };
         /**
          * Set debug mode for Chord Analytics
          * @param enabled - Whether debug mode should be enabled
@@ -115,11 +236,19 @@ export class ChordAnalytics {
         });
         /**
          * Queue an event to be sent when consent is ready.
+         * Persists to sessionStorage for recovery on instance recreation.
          * Starts a consent watcher if not already active.
          */
         this.queueEventForConsent = (type, args) => {
             return new Promise((resolve) => {
-                this.consentEventQueue.push({ type, args, resolve });
+                this.consentEventQueue.push({
+                    type,
+                    args,
+                    timestamp: Date.now(),
+                    resolve,
+                });
+                // Persist queue to sessionStorage for recovery on instance recreation
+                this.persistQueueToStorage();
                 // Start watching for consent if not already
                 if (!this.consentWatcherActive) {
                     this.consentWatcherActive = true;
@@ -137,10 +266,17 @@ export class ChordAnalytics {
         });
         /**
          * Flush all queued events now that consent is ready.
+         * Clears sessionStorage after successful flush.
          */
         this.flushConsentQueue = () => __awaiter(this, void 0, void 0, function* () {
             const queue = [...this.consentEventQueue];
             this.consentEventQueue = [];
+            // Clear persisted queue from storage since we're processing them now
+            this.clearQueueFromStorage();
+            if (this.options.enableLogging && this.options.debug) {
+                // eslint-disable-next-line no-console
+                console.log(`[Chord Analytics DEBUG]: Flushing ${queue.length} queued events`);
+            }
             const sendPromises = queue.map((item) => __awaiter(this, void 0, void 0, function* () {
                 try {
                     switch (item.type) {
@@ -313,12 +449,7 @@ export class ChordAnalytics {
                         }));
                     }
                     if (cdpPromises.length > 0) {
-                        Promise.allSettled(cdpPromises)
-                            .then(() => resolve())
-                            .catch((error) => {
-                            this.logger(error);
-                            resolve();
-                        });
+                        Promise.allSettled(cdpPromises).then(() => resolve());
                     }
                     else {
                         resolve();
@@ -422,28 +553,36 @@ export class ChordAnalytics {
         this.sendPageEvent = (options, props = {}) => __awaiter(this, void 0, void 0, function* () {
             // Configure CDP with fresh consent before sending
             this.configureConsentOnCdp();
-            try {
+            yield new Promise((resolve) => {
                 const pagePromises = [];
-                const a = this.ccdp();
-                if (a && typeof a.page === 'function') {
-                    pagePromises.push(new Promise((resolve) => {
-                        a.page(Object.assign(Object.assign({}, props), { meta: this.meta() }), options, () => resolve());
-                    }));
+                try {
+                    const a = this.ccdp();
+                    if (a && typeof a.page === 'function') {
+                        pagePromises.push(new Promise((cdpResolve) => {
+                            a.page(Object.assign(Object.assign({}, props), { meta: this.meta() }), options, () => cdpResolve());
+                        }));
+                    }
+                    const b = this.cdp();
+                    if (b && typeof b.page === 'function') {
+                        pagePromises.push(new Promise((cdpResolve) => {
+                            b.page(Object.assign(Object.assign({}, props), { meta: this.meta() }), options, () => cdpResolve());
+                        }));
+                    }
+                    if (pagePromises.length > 0) {
+                        Promise.allSettled(pagePromises).then((results) => {
+                            this.logger('page event sent', results);
+                            resolve();
+                        });
+                    }
+                    else {
+                        resolve();
+                    }
                 }
-                const b = this.cdp();
-                if (b && typeof b.page === 'function') {
-                    pagePromises.push(new Promise((resolve) => {
-                        b.page(Object.assign(Object.assign({}, props), { meta: this.meta() }), options, () => resolve());
-                    }));
+                catch (error) {
+                    this.logger(error);
+                    resolve();
                 }
-                // We don't return the promise to maintain the void return type
-                Promise.allSettled(pagePromises).then((results) => {
-                    this.logger('page event sent', results);
-                });
-            }
-            catch (error) {
-                this.logger(error);
-            }
+            });
         });
         this.reset = () => __awaiter(this, void 0, void 0, function* () {
             var _d;
@@ -871,6 +1010,82 @@ export class ChordAnalytics {
             }
             return this.track('Payment Info Entered', payload, options);
         });
+        this.trackOrderCompleted = (props, options) => __awaiter(this, void 0, void 0, function* () {
+            var _122, _123, _124, _125;
+            const formatter = (_124 = (_123 = (_122 = this.options) === null || _122 === void 0 ? void 0 : _122.formatters) === null || _123 === void 0 ? void 0 : _123.events) === null || _124 === void 0 ? void 0 : _124.orderCompleted;
+            const payload = {
+                affiliation: props === null || props === void 0 ? void 0 : props.affiliation,
+                campaign_id: props === null || props === void 0 ? void 0 : props.campaignId,
+                category: props === null || props === void 0 ? void 0 : props.category,
+                channel: props === null || props === void 0 ? void 0 : props.channel,
+                checkout_id: props === null || props === void 0 ? void 0 : props.checkoutId,
+                checkout_type: props === null || props === void 0 ? void 0 : props.checkoutType,
+                coupon: props === null || props === void 0 ? void 0 : props.coupon,
+                currency: props === null || props === void 0 ? void 0 : props.currency,
+                discount: props === null || props === void 0 ? void 0 : props.discount,
+                email: props === null || props === void 0 ? void 0 : props.email,
+                first_name: props === null || props === void 0 ? void 0 : props.firstName,
+                has_subscription: props === null || props === void 0 ? void 0 : props.hasSubscription,
+                is_recurring: props === null || props === void 0 ? void 0 : props.isRecurring,
+                last_name: props === null || props === void 0 ? void 0 : props.lastName,
+                metadata: props === null || props === void 0 ? void 0 : props.metadata,
+                order_date: props === null || props === void 0 ? void 0 : props.orderDate,
+                order_id: props === null || props === void 0 ? void 0 : props.orderId,
+                phone: props === null || props === void 0 ? void 0 : props.phone,
+                products: (_125 = props === null || props === void 0 ? void 0 : props.products) === null || _125 === void 0 ? void 0 : _125.map((p, i) => {
+                    var _a;
+                    return ({
+                        affiliation: p === null || p === void 0 ? void 0 : p.affiliation,
+                        brand: p === null || p === void 0 ? void 0 : p.brand,
+                        bundle: p === null || p === void 0 ? void 0 : p.bundle,
+                        bundle_size: p === null || p === void 0 ? void 0 : p.bundleSize,
+                        category: p === null || p === void 0 ? void 0 : p.category,
+                        coupon: p === null || p === void 0 ? void 0 : p.coupon,
+                        cross_sold_quantity: p === null || p === void 0 ? void 0 : p.crossSoldQuantity,
+                        description: p === null || p === void 0 ? void 0 : p.description,
+                        image_url: p === null || p === void 0 ? void 0 : p.imageUrl,
+                        line_item_id: p === null || p === void 0 ? void 0 : p.lineItemId,
+                        name: p === null || p === void 0 ? void 0 : p.name,
+                        option_values: p === null || p === void 0 ? void 0 : p.optionValues,
+                        position: (_a = p === null || p === void 0 ? void 0 : p.position) !== null && _a !== void 0 ? _a : i + 1,
+                        price: p === null || p === void 0 ? void 0 : p.price,
+                        product_id: p === null || p === void 0 ? void 0 : p.productId,
+                        quantity: p === null || p === void 0 ? void 0 : p.quantity,
+                        revenue: p === null || p === void 0 ? void 0 : p.revenue,
+                        sku: p === null || p === void 0 ? void 0 : p.sku,
+                        slug: p === null || p === void 0 ? void 0 : p.slug,
+                        url: p === null || p === void 0 ? void 0 : p.url,
+                        variant: p === null || p === void 0 ? void 0 : p.variant,
+                        variant_metadata: p === null || p === void 0 ? void 0 : p.variantMetadata,
+                    });
+                }),
+                purl_link: props === null || props === void 0 ? void 0 : props.purlLink,
+                referral_identifier_id: props === null || props === void 0 ? void 0 : props.referralIdentifierId,
+                repeat: props === null || props === void 0 ? void 0 : props.repeat,
+                revenue: props === null || props === void 0 ? void 0 : props.revenue,
+                shipping: props === null || props === void 0 ? void 0 : props.shipping,
+                shipping_city: props === null || props === void 0 ? void 0 : props.shippingCity,
+                shipping_country: props === null || props === void 0 ? void 0 : props.shippingCountry,
+                shipping_method_details: (props === null || props === void 0 ? void 0 : props.shippingMethodDetails)
+                    ? {
+                        shipping_code: props.shippingMethodDetails.shippingCode,
+                        shipping_method: props.shippingMethodDetails.shippingMethod,
+                    }
+                    : undefined,
+                shipping_state: props === null || props === void 0 ? void 0 : props.shippingState,
+                shipping_zipcode: props === null || props === void 0 ? void 0 : props.shippingZipcode,
+                subtotal: props === null || props === void 0 ? void 0 : props.subtotal,
+                tax: props === null || props === void 0 ? void 0 : props.tax,
+                template_id: props === null || props === void 0 ? void 0 : props.templateId,
+                total: props === null || props === void 0 ? void 0 : props.total,
+                tracking_ids: props === null || props === void 0 ? void 0 : props.trackingIds,
+            };
+            if (typeof formatter === 'function') {
+                const formattedPayload = formatter(props, payload);
+                return this.track('Order Completed', formattedPayload, options);
+            }
+            return this.track('Order Completed', payload, options);
+        });
         const debug = ((_a = window === null || window === void 0 ? void 0 : window.localStorage) === null || _a === void 0 ? void 0 : _a.getItem(DEBUG_MODE_STORAGE_KEY)) === 'true';
         const defaults = {
             debug,
@@ -883,6 +1098,8 @@ export class ChordAnalytics {
             const consentManager = addCdpConsent(this.options);
             this.consentConfig = consentManager.getConsentConfig() || null;
         }
+        // Restore any pending events from sessionStorage (survives instance recreation)
+        this.restoreQueueFromStorage();
         if (((_b = this.options) === null || _b === void 0 ? void 0 : _b.cdpDomain) && ((_c = this.options) === null || _c === void 0 ? void 0 : _c.cdpWriteKey) && window) {
             window[this.options.namespace] = (window === null || window === void 0 ? void 0 : window[this.options.namespace]) || this;
             this.initializeCdp();

package/dist/setupTests.js

@@ -2,3 +2,26 @@
 import { jest } from '@jest/globals';
 // Make jest available globally
 globalThis.jest = jest;
+// Mock sessionStorage for tests
+const sessionStorageMock = (() => {
+    let store = {};
+    return {
+        getItem: (key) => store[key] || null,
+        setItem: (key, value) => {
+            store[key] = value;
+        },
+        removeItem: (key) => {
+            delete store[key];
+        },
+        clear: () => {
+            store = {};
+        },
+    };
+})();
+Object.defineProperty(window, 'sessionStorage', {
+    value: sessionStorageMock,
+});
+// Clear sessionStorage before each test to ensure test isolation
+beforeEach(() => {
+    sessionStorageMock.clear();
+});