shopkit-analytics 1.0.1 → 1.0.3

package/dist/{index-GODWc1s6.d.mts → index-th6sBtE3.d.mts}

@@ -1,5 +1,6 @@
 import { TEvent } from './types.mjs';
-import { T as TrackingAdapter } from './subscriber-sWesj_5p.mjs';
+import { T as TrackingAdapter, a as TAdapterParams, b as IBaseAdapterParams } from './subscriber-BoyOlh9t.mjs';
+import { E as ExperimentData } from './types-C__2IBCj.mjs';
 import { AnalyticsEventName, ShopifyAnalyticsProduct, ShopifyPageViewPayload } from '@shopify/hydrogen-react';
 
 /**
@@ -78,8 +79,29 @@ declare abstract class BaseAdapter implements TrackingAdapter {
     /**
      * Track an event
      * @param event The event to track
+     * @param params Optional adapter-specific parameters
      */
-    abstract trackEvent(event: TEvent): Promise<void>;
+    abstract trackEvent(event: TEvent, params?: TAdapterParams): Promise<void>;
+    /**
+     * Extract adapter-specific parameters for this adapter
+     * @param params The adapter parameters object
+     * @returns Adapter-specific parameters or empty object
+     */
+    protected getAdapterParams(params?: TAdapterParams): IBaseAdapterParams;
+    /**
+     * Get custom event name or fall back to default
+     * @param params The adapter parameters object
+     * @param defaultName The default event name to use
+     * @returns Custom event name or default
+     */
+    protected getEventName(params: TAdapterParams | undefined, defaultName: string): string;
+    /**
+     * Merge standard event data with adapter-specific parameters
+     * @param params The adapter parameters object
+     * @param standardData The standard event data
+     * @returns Merged data with adapter-specific overrides
+     */
+    protected mergeEventData(standardData: Record<string, any>, params: TAdapterParams | undefined): Record<string, any>;
     /**
      * Get a configuration value
      * @param key The configuration key
@@ -92,17 +114,30 @@ declare abstract class BaseAdapter implements TrackingAdapter {
      * @returns Affiliate parameters or null if not available
      */
     protected getAffiliateParams(): Record<string, string> | null;
+    /**
+     * Get experiment parameters from cookies
+     * @returns Experiment parameters
+     */
+    protected getExperimentParams(): ExperimentData;
     /**
      * Enhance event parameters with affiliate data
      * @param params The original parameters
      * @returns Parameters enhanced with affiliate data
      */
     protected enhanceWithAffiliateParams(params: Record<string, any>): Record<string, any>;
+    /**
+     * Enhance event parameters with experiment data
+     * @param params The original parameters
+     * @returns Parameters enhanced with experiment data
+     */
+    protected enhanceWithExperimentParams(params: Record<string, any>): Record<string, any>;
 }
 
 declare global {
     interface Window {
-        fbq?: (type: string, eventName: string, params?: Record<string, any>) => void;
+        fbq?: (type: string, eventName: string, params?: Record<string, any>, options?: {
+            eventID?: string;
+        }) => void;
     }
 }
 /**
@@ -113,6 +148,11 @@ interface PixelAdapterConfig {
      * Facebook Pixel ID
      */
     pixelId: string;
+    /**
+     * Enable server-side CAPI backup
+     * @default true - CAPI is enabled by default for better data reliability
+     */
+    enableCAPI?: boolean;
 }
 /**
  * Facebook Pixel tracking adapter
@@ -128,8 +168,17 @@ declare class PixelAdapter extends BaseAdapter {
     /**
      * Track an event with Facebook Pixel
      * @param event The event to track
+     * @param adapterParams Optional adapter-specific parameters
      */
-    trackEvent(event: TEvent): Promise<void>;
+    trackEvent(event: TEvent, adapterParams?: TAdapterParams): Promise<void>;
+    /**
+     * Track event on client-side (browser pixel)
+     */
+    private trackClientSide;
+    /**
+     * Track event on server-side (CAPI) as backup
+     */
+    private trackServerSide;
     /**
      * Track a page view event
      * @param event The page view event
@@ -175,11 +224,6 @@ declare class PixelAdapter extends BaseAdapter {
      * @param event The purchase event
      */
     private trackPurchase;
-    /**
-     * Convert an event to Facebook Pixel parameters
-     * @param event The event to convert
-     */
-    private eventToParams;
 }
 
 declare global {
@@ -212,8 +256,9 @@ declare class GoogleAdapter extends BaseAdapter {
     /**
      * Track an event with Google Analytics
      * @param event The event to track
+     * @param adapterParams Optional adapter-specific parameters
      */
-    trackEvent(event: TEvent): Promise<void>;
+    trackEvent(event: TEvent, adapterParams?: TAdapterParams): Promise<void>;
     /**
      * Track a page view event
      * @param event The page view event
@@ -314,66 +359,79 @@ declare class MoengageAdapter extends BaseAdapter {
     /**
      * Track an event with MoenGage SDK
      * @param event The event to track
+     * @param adapterParams Optional adapter-specific parameters
      */
-    trackEvent(event: TEvent): Promise<void>;
+    trackEvent(event: TEvent, adapterParams?: TAdapterParams): Promise<void>;
     /**
      * Track a page view event
      * @param event The page view event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackPageView;
     /**
      * Track a button click event
      * @param event The button click event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackButtonClick;
     /**
      * Track a form submission event
      * @param event The form submission event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackFormSubmission;
     /**
      * Track a product view event
      * @param event The product view event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackProductView;
     /**
      * Track an add to cart event
      * @param event The add to cart event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackAddToCart;
     /**
      * Track a remove from cart event
      * @param event The remove from cart event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackRemoveFromCart;
     /**
      * Track a checkout started event
      * @param event The checkout started event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackCheckoutStarted;
     /**
      * Track a checkout completed event
      * @param event The checkout completed event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackCheckoutCompleted;
     /**
      * Track a search event
      * @param event The search event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackSearch;
     /**
      * Track a user signup event
      * @param event The user signup event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackUserSignup;
     /**
      * Track a user login event
      * @param event The user login event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackUserLogin;
     /**
      * Track a custom event
      * @param event The custom event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackCustomEvent;
     /**
@@ -419,41 +477,49 @@ declare class PostHogAdapter extends BaseAdapter {
     /**
      * Track an event with PostHog
      * @param event The event to track
+     * @param adapterParams Optional adapter-specific parameters
      */
-    trackEvent(event: TEvent): Promise<void>;
+    trackEvent(event: TEvent, adapterParams?: TAdapterParams): Promise<void>;
     /**
      * Track a page view event
      * @param event The page view event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackPageView;
     /**
      * Track a product view event
      * @param event The product view event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackProductView;
     /**
      * Track an add to cart event
      * @param event The add to cart event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackAddToCart;
     /**
      * Track a checkout started event
      * @param event The checkout started event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackCheckoutStarted;
     /**
      * Track a checkout completed event
      * @param event The checkout completed event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackCheckoutCompleted;
     /**
      * Track a search event
      * @param event The search event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackSearch;
     /**
      * Track an add payment info event
      * @param event The add payment info event
+     * @param adapterParams Optional adapter-specific parameters
      */
     private trackAddPaymentInfo;
     /**
@@ -530,7 +596,7 @@ declare class ShopifyAdapter extends BaseAdapter {
     /**
      * Track an event using Shopify Analytics
      */
-    trackEvent(event: TEvent): Promise<void>;
+    trackEvent(event: TEvent, adapterParams?: TAdapterParams): Promise<void>;
     /**
      * Check if Shopify session is properly established
      */
@@ -565,18 +631,20 @@ declare class KwikPassAdapter extends BaseAdapter {
     initialize(): Promise<void>;
     /**
      * Track an event using KwikPass
+     * @param event The event to track
+     * @param adapterParams Optional adapter-specific parameters
      */
-    trackEvent(event: TEvent): Promise<void>;
+    trackEvent(event: TEvent, adapterParams?: TAdapterParams): Promise<void>;
     /**
      * Send event to KwikPass platform
      */
     private sendKwikPassEvent;
     /**
-     * Track product view event
+     * Track collection view event
      */
     private trackCollectionView;
     /**
-     * Track collection view event
+     * Track product view event
      */
     private trackProductView;
     /**
@@ -609,8 +677,10 @@ declare class KwikCheckoutAdapter extends BaseAdapter {
     initialize(): Promise<void>;
     /**
      * Track an event using GoKwik
+     * @param event The event to track
+     * @param adapterParams Optional adapter-specific parameters
      */
-    trackEvent(event: TEvent): Promise<void>;
+    trackEvent(event: TEvent, adapterParams?: TAdapterParams): Promise<void>;
     /**
      * Send event to GoKwik platform
      */

package/dist/index.d.mts

@@ -1,12 +1,16 @@
 import React from 'react';
-import { G as GoogleAdapterConfig, P as PixelAdapterConfig, M as MoengageAdapterConfig, a as PostHogAdapterConfig, S as ShopifyAdapterConfig, K as KwikPassConfig, b as KwikCheckoutConfig, L as LoggerConfig } from './index-GODWc1s6.mjs';
-export { B as BaseAdapter, d as GoogleAdapter, i as KwikCheckoutAdapter, h as KwikPassAdapter, j as Logger, e as MoengageAdapter, c as PixelAdapter, f as PostHogAdapter, g as ShopifyAdapter, m as createAdapterLogger, k as createLogger, l as logger } from './index-GODWc1s6.mjs';
-import { T as TrackingAdapter } from './subscriber-sWesj_5p.mjs';
-export { e as eventSubscriber } from './subscriber-sWesj_5p.mjs';
+import { G as GoogleAdapterConfig, P as PixelAdapterConfig, M as MoengageAdapterConfig, a as PostHogAdapterConfig, S as ShopifyAdapterConfig, K as KwikPassConfig, b as KwikCheckoutConfig, L as LoggerConfig } from './index-th6sBtE3.mjs';
+export { B as BaseAdapter, d as GoogleAdapter, i as KwikCheckoutAdapter, h as KwikPassAdapter, j as Logger, e as MoengageAdapter, c as PixelAdapter, f as PostHogAdapter, g as ShopifyAdapter, m as createAdapterLogger, k as createLogger, l as logger } from './index-th6sBtE3.mjs';
+import { T as TrackingAdapter } from './subscriber-BoyOlh9t.mjs';
+export { I as IAdapterParams, b as IBaseAdapterParams, a as TAdapterParams, e as eventSubscriber } from './subscriber-BoyOlh9t.mjs';
 import { A as AffiliateConfig } from './affiliate-tracker-BgHwibPv.mjs';
 export { k as AffiliateData, j as AffiliateParams, a as AffiliateTracker, i as AffiliateTrackerProps, d as captureAffiliateParams, e as clearAffiliateParams, g as getAffiliateParams, f as getAffiliateSource, h as hasAffiliateData, c as useAffiliateSource, u as useAffiliateTracker, b as useHasAffiliateData } from './affiliate-tracker-BgHwibPv.mjs';
-export { BaseEvent, EventType, IAddPaymentInfoEvent, IAddToCartEvent, IAddressAddedGKEvent, IAddressCompletedGKEvent, IAddressSelectedGKEvent, IBeginCheckoutEvent, IButtonClickEvent, ICartPageLandEvent, ICartViewedEvent, ICheckoutCompletedEvent, ICheckoutPaymentEvent, ICheckoutStartedEvent, ICloseCartEvent, ICouponCopiedEvent, ICustomEvent, ICustomerLoggedInEvent, ICustomerRegisteredEvent, IFilterAppliedEvent, IFirstVisitEvent, IFormStartEvent, IFormSubmissionEvent, IItemPurchasedEvent, IKPMPPhoneNumberLoggedInEvent, IKPMPShopifyLoggedInEvent, IKPMPSuccessfullyLoggedOutEvent, IKPMPTruecallerLoggedInEvent, IKPMPWhatsAppLoggedInEvent, IKPPhoneNumberLoggedInEvent, IKPShopifyLoggedInEvent, IKPSuccessfullyLoggedOutEvent, IKPTruecallerLoggedInEvent, IKPWhatsAppLoggedInEvent, IMobileAddedGKEvent, INewsletterSubscriptionEvent, IOrderCompletedEvent, IOrderPlacedEvent, IOrderSuccessEvent, IPCollectionViewEvent, IPageViewEvent, IPagesScreensPerSessionEvent, IPaymentCompletedGKEvent, IPaymentMethodSelectedGKEvent, IPinCodeAddedGKEvent, IProductViewEvent, IPurchaseEvent, IQuantityChangeEvent, IRemoveFromCartEvent, IScrollEvent, ISearchEvent, ISessionStartEvent, IShopifyAbandonedCheckoutEvent, IShopifyAddToCartEvent, IShopifyCheckoutStartedEvent, IShopifyCheckoutUpdatedEvent, IShopifyOrderFulfilledEvent, IShopifyRemoveFromCartEvent, IShopifyUpdateCartEvent, ISpinformResultEvent, IStartedCheckoutGKEvent, IStartedOrderEvent, IUpdateCartEvent, IUserEngagementEvent, IUserLoginEvent, IUserSignupEvent, IViewContentEvent, IViewItemEvent, IViewSearchResultsEvent, IViewedProductEvent, TEvent } from './types.mjs';
-export { DEFAULT_CURRENCY, EventNames, HARDCODED_HANDLE, eventPublisher, initTracking, initializeEventTracking, publishEvent } from './events/index.mjs';
+export { BaseEvent, EventType, IAddPaymentInfoEvent, IAddToCartEvent, IAddressAddedGKEvent, IAddressCompletedGKEvent, IAddressSelectedGKEvent, IBeginCheckoutEvent, IButtonClickEvent, ICartViewedEvent, ICheckoutCompletedEvent, ICheckoutPaymentEvent, ICheckoutStartedEvent, ICustomEvent, IFirstVisitEvent, IFormStartEvent, IFormSubmissionEvent, IMobileAddedGKEvent, IOrderCompletedEvent, IOrderPlacedEvent, IOrderSuccessEvent, IPCollectionViewEvent, IPageViewEvent, IPaymentCompletedGKEvent, IPaymentMethodSelectedGKEvent, IPinCodeAddedGKEvent, IProductViewEvent, IPurchaseEvent, IRemoveFromCartEvent, IScrollEvent, ISearchEvent, ISessionStartEvent, IStartedCheckoutGKEvent, IUserEngagementEvent, IUserLoginEvent, IUserSignupEvent, IViewContentEvent, IViewItemEvent, IViewSearchResultsEvent, IViewedProductEvent, TEvent } from './types.mjs';
+export { DEFAULT_CURRENCY, EventNames, eventPublisher, initTracking, initializeEventTracking, publishEvent } from './events/index.mjs';
+export { E as ExperimentData } from './types-C__2IBCj.mjs';
+export { PRIMA_EXPERIMENT_COOKIES, PRIMA_EXPERIMENT_COOKIE_NAMES, getExperimentParams, hasExperimentData } from './experiment/index.mjs';
+export { generateEventId, getBrowserInfo } from './utils/index.mjs';
+export { FacebookCAPIConfig, FacebookCAPIService, createFacebookCAPIService } from './services/index.mjs';
 import '@shopify/hydrogen-react';
 
 interface ShopkitAnalyticsConfig {

package/dist/index.d.ts

@@ -1,12 +1,16 @@
 import React from 'react';
-import { G as GoogleAdapterConfig, P as PixelAdapterConfig, M as MoengageAdapterConfig, a as PostHogAdapterConfig, S as ShopifyAdapterConfig, K as KwikPassConfig, b as KwikCheckoutConfig, L as LoggerConfig } from './index-BnNRgdUv.js';
-export { B as BaseAdapter, d as GoogleAdapter, i as KwikCheckoutAdapter, h as KwikPassAdapter, j as Logger, e as MoengageAdapter, c as PixelAdapter, f as PostHogAdapter, g as ShopifyAdapter, m as createAdapterLogger, k as createLogger, l as logger } from './index-BnNRgdUv.js';
-import { T as TrackingAdapter } from './subscriber-43gnCKWe.js';
-export { e as eventSubscriber } from './subscriber-43gnCKWe.js';
+import { G as GoogleAdapterConfig, P as PixelAdapterConfig, M as MoengageAdapterConfig, a as PostHogAdapterConfig, S as ShopifyAdapterConfig, K as KwikPassConfig, b as KwikCheckoutConfig, L as LoggerConfig } from './index-D_8w5bL_.js';
+export { B as BaseAdapter, d as GoogleAdapter, i as KwikCheckoutAdapter, h as KwikPassAdapter, j as Logger, e as MoengageAdapter, c as PixelAdapter, f as PostHogAdapter, g as ShopifyAdapter, m as createAdapterLogger, k as createLogger, l as logger } from './index-D_8w5bL_.js';
+import { T as TrackingAdapter } from './subscriber-BDAm_BAi.js';
+export { I as IAdapterParams, b as IBaseAdapterParams, a as TAdapterParams, e as eventSubscriber } from './subscriber-BDAm_BAi.js';
 import { A as AffiliateConfig } from './affiliate-tracker-BgHwibPv.js';
 export { k as AffiliateData, j as AffiliateParams, a as AffiliateTracker, i as AffiliateTrackerProps, d as captureAffiliateParams, e as clearAffiliateParams, g as getAffiliateParams, f as getAffiliateSource, h as hasAffiliateData, c as useAffiliateSource, u as useAffiliateTracker, b as useHasAffiliateData } from './affiliate-tracker-BgHwibPv.js';
-export { BaseEvent, EventType, IAddPaymentInfoEvent, IAddToCartEvent, IAddressAddedGKEvent, IAddressCompletedGKEvent, IAddressSelectedGKEvent, IBeginCheckoutEvent, IButtonClickEvent, ICartPageLandEvent, ICartViewedEvent, ICheckoutCompletedEvent, ICheckoutPaymentEvent, ICheckoutStartedEvent, ICloseCartEvent, ICouponCopiedEvent, ICustomEvent, ICustomerLoggedInEvent, ICustomerRegisteredEvent, IFilterAppliedEvent, IFirstVisitEvent, IFormStartEvent, IFormSubmissionEvent, IItemPurchasedEvent, IKPMPPhoneNumberLoggedInEvent, IKPMPShopifyLoggedInEvent, IKPMPSuccessfullyLoggedOutEvent, IKPMPTruecallerLoggedInEvent, IKPMPWhatsAppLoggedInEvent, IKPPhoneNumberLoggedInEvent, IKPShopifyLoggedInEvent, IKPSuccessfullyLoggedOutEvent, IKPTruecallerLoggedInEvent, IKPWhatsAppLoggedInEvent, IMobileAddedGKEvent, INewsletterSubscriptionEvent, IOrderCompletedEvent, IOrderPlacedEvent, IOrderSuccessEvent, IPCollectionViewEvent, IPageViewEvent, IPagesScreensPerSessionEvent, IPaymentCompletedGKEvent, IPaymentMethodSelectedGKEvent, IPinCodeAddedGKEvent, IProductViewEvent, IPurchaseEvent, IQuantityChangeEvent, IRemoveFromCartEvent, IScrollEvent, ISearchEvent, ISessionStartEvent, IShopifyAbandonedCheckoutEvent, IShopifyAddToCartEvent, IShopifyCheckoutStartedEvent, IShopifyCheckoutUpdatedEvent, IShopifyOrderFulfilledEvent, IShopifyRemoveFromCartEvent, IShopifyUpdateCartEvent, ISpinformResultEvent, IStartedCheckoutGKEvent, IStartedOrderEvent, IUpdateCartEvent, IUserEngagementEvent, IUserLoginEvent, IUserSignupEvent, IViewContentEvent, IViewItemEvent, IViewSearchResultsEvent, IViewedProductEvent, TEvent } from './types.js';
-export { DEFAULT_CURRENCY, EventNames, HARDCODED_HANDLE, eventPublisher, initTracking, initializeEventTracking, publishEvent } from './events/index.js';
+export { BaseEvent, EventType, IAddPaymentInfoEvent, IAddToCartEvent, IAddressAddedGKEvent, IAddressCompletedGKEvent, IAddressSelectedGKEvent, IBeginCheckoutEvent, IButtonClickEvent, ICartViewedEvent, ICheckoutCompletedEvent, ICheckoutPaymentEvent, ICheckoutStartedEvent, ICustomEvent, IFirstVisitEvent, IFormStartEvent, IFormSubmissionEvent, IMobileAddedGKEvent, IOrderCompletedEvent, IOrderPlacedEvent, IOrderSuccessEvent, IPCollectionViewEvent, IPageViewEvent, IPaymentCompletedGKEvent, IPaymentMethodSelectedGKEvent, IPinCodeAddedGKEvent, IProductViewEvent, IPurchaseEvent, IRemoveFromCartEvent, IScrollEvent, ISearchEvent, ISessionStartEvent, IStartedCheckoutGKEvent, IUserEngagementEvent, IUserLoginEvent, IUserSignupEvent, IViewContentEvent, IViewItemEvent, IViewSearchResultsEvent, IViewedProductEvent, TEvent } from './types.js';
+export { DEFAULT_CURRENCY, EventNames, eventPublisher, initTracking, initializeEventTracking, publishEvent } from './events/index.js';
+export { E as ExperimentData } from './types-C__2IBCj.js';
+export { PRIMA_EXPERIMENT_COOKIES, PRIMA_EXPERIMENT_COOKIE_NAMES, getExperimentParams, hasExperimentData } from './experiment/index.js';
+export { generateEventId, getBrowserInfo } from './utils/index.js';
+export { FacebookCAPIConfig, FacebookCAPIService, createFacebookCAPIService } from './services/index.js';
 import '@shopify/hydrogen-react';
 
 interface ShopkitAnalyticsConfig {