shopkit-analytics 1.0.0

package/dist/index.mjs

@@ -0,0 +1,190 @@
+"use client";
+import {
+  initTracking,
+  initializeEventTracking
+} from "./chunk-P4OJDCEZ.mjs";
+import {
+  AffiliateTracker_default,
+  captureAffiliateParams,
+  clearAffiliateParams,
+  getAffiliateParams,
+  getAffiliateSource,
+  hasAffiliateData,
+  useAffiliateSource,
+  useAffiliateTracker,
+  useHasAffiliateData
+} from "./chunk-TNXTKEGS.mjs";
+import {
+  BaseAdapter,
+  DEFAULT_CURRENCY,
+  EventNames,
+  GoogleAdapter,
+  HARDCODED_HANDLE,
+  KwikCheckoutAdapter,
+  KwikPassAdapter,
+  MoengageAdapter,
+  PixelAdapter,
+  PostHogAdapter,
+  ShopifyAdapter,
+  createAdapterLogger,
+  createLogger,
+  logger
+} from "./chunk-4MZH5OLR.mjs";
+import {
+  EventType
+} from "./chunk-3TQR5DOP.mjs";
+import {
+  eventPublisher,
+  eventSubscriber,
+  publishEvent
+} from "./chunk-JVEGG6JV.mjs";
+
+// src/ShopkitAnalytics.tsx
+import { useEffect } from "react";
+import { useShopifyCookies } from "@shopify/hydrogen-react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var ShopkitAnalytics = ({
+  config,
+  children,
+  onInitialized,
+  onError
+}) => {
+  useShopifyCookies({
+    hasUserConsent: true,
+    domain: config.shopify?.domain || ""
+  });
+  useEffect(() => {
+    const initializeAnalytics = async () => {
+      if (config.autoInitialize === false) return;
+      const loggerConfig = {
+        enabled: config.logger?.enabled ?? config.enableDebugLogs ?? true,
+        level: config.logger?.level ?? "info",
+        name: "@shopkit/analytics",
+        prettyPrint: config.logger?.prettyPrint ?? false
+      };
+      const logger2 = createLogger(loggerConfig);
+      try {
+        logger2.info("Starting initialization...");
+        const adapters = [];
+        const addLoggerConfig = (adapterConfig) => ({
+          ...adapterConfig,
+          enableDebugLogs: loggerConfig.enabled,
+          logLevel: loggerConfig.level
+        });
+        if (config.googleAnalytics) {
+          const gaAdapter = new GoogleAdapter(
+            addLoggerConfig(config.googleAnalytics)
+          );
+          adapters.push(gaAdapter);
+          logger2.info("Added Google Analytics adapter");
+        }
+        if (config.facebookPixel) {
+          const pixelAdapter = new PixelAdapter(
+            addLoggerConfig(config.facebookPixel)
+          );
+          adapters.push(pixelAdapter);
+          logger2.info("Added Facebook Pixel adapter");
+        }
+        if (config.moengage) {
+          const moengageAdapter = new MoengageAdapter(
+            addLoggerConfig(config.moengage)
+          );
+          adapters.push(moengageAdapter);
+          logger2.info("Added MoEngage adapter");
+        }
+        if (config.posthog) {
+          const posthogAdapter = new PostHogAdapter(
+            addLoggerConfig(config.posthog)
+          );
+          adapters.push(posthogAdapter);
+          logger2.info("Added PostHog adapter");
+        }
+        if (config.shopify) {
+          const shopifyAdapter = new ShopifyAdapter(
+            addLoggerConfig(config.shopify)
+          );
+          adapters.push(shopifyAdapter);
+          logger2.info("Added Shopify Analytics adapter");
+        }
+        if (config.kwikpass) {
+          const kwikpassAdapter = new KwikPassAdapter(
+            addLoggerConfig(config.kwikpass)
+          );
+          adapters.push(kwikpassAdapter);
+          logger2.info("Added KwikPass Analytics adapter");
+        }
+        if (config.kwikcheckout) {
+          const kwikcheckoutAdapter = new KwikCheckoutAdapter(
+            addLoggerConfig(config.kwikcheckout)
+          );
+          adapters.push(kwikcheckoutAdapter);
+          logger2.info("Added KwikCheckout Analytics adapter");
+        }
+        if (config.customAdapters) {
+          adapters.push(...config.customAdapters);
+          logger2.info(`Added ${config.customAdapters.length} custom adapters`);
+        }
+        if (adapters.length === 0) {
+          logger2.warn("No analytics adapters configured");
+        } else {
+          await initializeEventTracking(adapters);
+          logger2.info("Event tracking initialized with adapters", {
+            adapters: adapters.map((a) => a.name)
+          });
+        }
+        logger2.info("Initialization completed successfully");
+        onInitialized?.();
+      } catch (err) {
+        const error = err instanceof Error ? err : new Error("Unknown initialization error");
+        logger2.error("Initialization failed", error);
+        onError?.(error);
+      }
+    };
+    initializeAnalytics();
+  }, [config, onInitialized, onError]);
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    config.affiliate?.enabled !== false && /* @__PURE__ */ jsx(
+      AffiliateTracker_default,
+      {
+        config: config.affiliate?.config,
+        autoCapture: config.affiliate?.autoCapture
+      }
+    ),
+    children ? /* @__PURE__ */ jsx(Fragment, { children }) : null
+  ] });
+};
+var ShopkitAnalytics_default = ShopkitAnalytics;
+export {
+  AffiliateTracker_default as AffiliateTracker,
+  BaseAdapter,
+  DEFAULT_CURRENCY,
+  EventNames,
+  EventType,
+  GoogleAdapter,
+  HARDCODED_HANDLE,
+  KwikCheckoutAdapter,
+  KwikPassAdapter,
+  MoengageAdapter,
+  PixelAdapter,
+  PostHogAdapter,
+  ShopifyAdapter,
+  ShopkitAnalytics_default as ShopkitAnalytics,
+  captureAffiliateParams,
+  clearAffiliateParams,
+  createAdapterLogger,
+  createLogger,
+  ShopkitAnalytics_default as default,
+  eventPublisher,
+  eventSubscriber,
+  getAffiliateParams,
+  getAffiliateSource,
+  hasAffiliateData,
+  initTracking,
+  initializeEventTracking,
+  logger,
+  publishEvent,
+  useAffiliateSource,
+  useAffiliateTracker,
+  useHasAffiliateData
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ShopkitAnalytics.tsx"],"sourcesContent":["\"use client\";\n\nimport React, { useEffect } from \"react\";\nimport { useShopifyCookies } from \"@shopify/hydrogen-react\";\nimport { initializeEventTracking } from \"./events/init\";\nimport { AffiliateTracker } from \"./affiliate\";\nimport { createLogger, type LoggerConfig } from \"./logger\";\nimport {\n  GoogleAdapter,\n  PixelAdapter,\n  MoengageAdapter,\n  PostHogAdapter,\n  ShopifyAdapter,\n  KwikPassAdapter,\n  KwikCheckoutAdapter,\n} from \"./adapters\";\nimport type {\n  GoogleAdapterConfig,\n  PixelAdapterConfig,\n  MoengageAdapterConfig,\n  PostHogAdapterConfig,\n  ShopifyAdapterConfig,\n  KwikPassConfig,\n  KwikCheckoutConfig,\n} from \"./adapters\";\nimport type { TrackingAdapter } from \"./events/subscriber\";\nimport type { AffiliateConfig } from \"./affiliate/types\";\n\nexport interface ShopkitAnalyticsConfig {\n  // Analytics Adapters\n  googleAnalytics?: GoogleAdapterConfig;\n  facebookPixel?: PixelAdapterConfig;\n  moengage?: MoengageAdapterConfig;\n  posthog?: PostHogAdapterConfig;\n  shopify?: ShopifyAdapterConfig;\n  kwikpass?: KwikPassConfig;\n  kwikcheckout?: KwikCheckoutConfig;\n  customAdapters?: TrackingAdapter[];\n\n  // Affiliate Tracking\n  affiliate?: {\n    enabled?: boolean;\n    config?: Partial<AffiliateConfig>;\n    autoCapture?: boolean;\n  };\n\n  // Logger Settings\n  logger?: LoggerConfig;\n\n  // General Settings (deprecated - use logger.enabled instead)\n  enableDebugLogs?: boolean;\n  autoInitialize?: boolean;\n}\n\nexport interface ShopkitAnalyticsProps {\n  config: ShopkitAnalyticsConfig;\n  children?: React.ReactNode;\n  onInitialized?: () => void;\n  onError?: (error: Error) => void;\n}\n\nconst ShopkitAnalytics: React.FC<ShopkitAnalyticsProps> = ({\n  config,\n  children,\n  onInitialized,\n  onError,\n}) => {\n  // Enable Shopify cookies if Shopify adapter is configured\n  useShopifyCookies({\n    hasUserConsent: true,\n    domain: config.shopify?.domain || \"\",\n  });\n\n  useEffect(() => {\n    const initializeAnalytics = async () => {\n      if (config.autoInitialize === false) return;\n\n      // Create logger instance\n      const loggerConfig: LoggerConfig = {\n        enabled: config.logger?.enabled ?? config.enableDebugLogs ?? true,\n        level: config.logger?.level ?? \"info\",\n        name: \"@shopkit/analytics\",\n        prettyPrint: config.logger?.prettyPrint ?? false,\n      };\n\n      const logger = createLogger(loggerConfig);\n\n      try {\n        logger.info(\"Starting initialization...\");\n\n        const adapters: TrackingAdapter[] = [];\n\n        // Helper function to add logger config to adapter config\n        const addLoggerConfig = (adapterConfig: any) => ({\n          ...adapterConfig,\n          enableDebugLogs: loggerConfig.enabled,\n          logLevel: loggerConfig.level,\n        });\n\n        // Google Analytics 4\n        if (config.googleAnalytics) {\n          const gaAdapter = new GoogleAdapter(\n            addLoggerConfig(config.googleAnalytics)\n          );\n          adapters.push(gaAdapter);\n          logger.info(\"Added Google Analytics adapter\");\n        }\n\n        // Facebook Pixel\n        if (config.facebookPixel) {\n          const pixelAdapter = new PixelAdapter(\n            addLoggerConfig(config.facebookPixel)\n          );\n          adapters.push(pixelAdapter);\n          logger.info(\"Added Facebook Pixel adapter\");\n        }\n\n        // MoEngage\n        if (config.moengage) {\n          const moengageAdapter = new MoengageAdapter(\n            addLoggerConfig(config.moengage)\n          );\n          adapters.push(moengageAdapter);\n          logger.info(\"Added MoEngage adapter\");\n        }\n\n        // PostHog\n        if (config.posthog) {\n          const posthogAdapter = new PostHogAdapter(\n            addLoggerConfig(config.posthog)\n          );\n          adapters.push(posthogAdapter);\n          logger.info(\"Added PostHog adapter\");\n        }\n\n        // Shopify Analytics\n        if (config.shopify) {\n          const shopifyAdapter = new ShopifyAdapter(\n            addLoggerConfig(config.shopify)\n          );\n          adapters.push(shopifyAdapter);\n          logger.info(\"Added Shopify Analytics adapter\");\n        }\n\n        // KwikPass Analytics\n        if (config.kwikpass) {\n          const kwikpassAdapter = new KwikPassAdapter(\n            addLoggerConfig(config.kwikpass)\n          );\n          adapters.push(kwikpassAdapter);\n          logger.info(\"Added KwikPass Analytics adapter\");\n        }\n\n        // KwikCheckout Analytics\n        if (config.kwikcheckout) {\n          const kwikcheckoutAdapter = new KwikCheckoutAdapter(\n            addLoggerConfig(config.kwikcheckout)\n          );\n          adapters.push(kwikcheckoutAdapter);\n          logger.info(\"Added KwikCheckout Analytics adapter\");\n        }\n\n        // Custom adapters\n        if (config.customAdapters) {\n          adapters.push(...config.customAdapters);\n          logger.info(`Added ${config.customAdapters.length} custom adapters`);\n        }\n\n        if (adapters.length === 0) {\n          logger.warn(\"No analytics adapters configured\");\n        } else {\n          // Initialize the event tracking system\n          await initializeEventTracking(adapters);\n          logger.info(\"Event tracking initialized with adapters\", {\n            adapters: adapters.map((a) => a.name),\n          });\n        }\n\n        logger.info(\"Initialization completed successfully\");\n        onInitialized?.();\n      } catch (err) {\n        const error =\n          err instanceof Error\n            ? err\n            : new Error(\"Unknown initialization error\");\n        logger.error(\"Initialization failed\", error);\n        onError?.(error);\n      }\n    };\n\n    initializeAnalytics();\n  }, [config, onInitialized, onError]);\n\n  return (\n    <>\n      {/* Affiliate Tracker */}\n      {config.affiliate?.enabled !== false && (\n        <AffiliateTracker\n          config={config.affiliate?.config}\n          autoCapture={config.affiliate?.autoCapture}\n        />\n      )}\n\n      {children ? <>{children}</> : null}\n    </>\n  );\n};\n\nexport default ShopkitAnalytics;\n"],"mappings":"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","names":["logger"]}

package/dist/subscriber-43gnCKWe.d.ts

@@ -0,0 +1,80 @@
+import { TEvent } from './types.js';
+
+/**
+ * Interface for tracking adapters
+ */
+interface TrackingAdapter {
+    /**
+     * Name of the tracking adapter
+     */
+    name: string;
+    /**
+     * Whether the adapter is enabled
+     */
+    isEnabled: () => boolean;
+    /**
+     * Initialize the adapter
+     */
+    initialize: () => Promise<void>;
+    /**
+     * Track an event
+     */
+    trackEvent: (event: TEvent) => Promise<void>;
+}
+/**
+ * EventSubscriber class responsible for managing tracking adapters and forwarding events
+ */
+declare class EventSubscriber {
+    private static instance;
+    private adapters;
+    private initialized;
+    private eventQueue;
+    private unsubscribe;
+    /**
+     * Private constructor to enforce singleton pattern
+     */
+    private constructor();
+    /**
+     * Get the singleton instance of EventSubscriber
+     */
+    static getInstance(): EventSubscriber;
+    /**
+     * Register a tracking adapter
+     * @param adapter The tracking adapter to register
+     */
+    registerAdapter(adapter: TrackingAdapter): void;
+    /**
+     * Unregister a tracking adapter by name
+     * @param adapterName The name of the adapter to unregister
+     */
+    unregisterAdapter(adapterName: string): void;
+    /**
+     * Initialize all registered adapters
+     */
+    initialize(): Promise<void>;
+    /**
+     * Initialize a single adapter
+     * @param adapter The adapter to initialize
+     */
+    private initializeAdapter;
+    /**
+     * Handle an event by forwarding it to all enabled adapters
+     * @param event The event to handle
+     */
+    private handleEvent;
+    /**
+     * Process any events that were queued before initialization
+     */
+    private processEventQueue;
+    /**
+     * Shutdown the subscriber and all adapters
+     */
+    shutdown(): void;
+    /**
+     * Get all registered adapters
+     */
+    getAdapters(): TrackingAdapter[];
+}
+declare const eventSubscriber: EventSubscriber;
+
+export { type TrackingAdapter as T, eventSubscriber as e };

package/dist/subscriber-IFZJU57V.mjs

@@ -0,0 +1,8 @@
+"use client";
+import {
+  eventSubscriber
+} from "./chunk-JVEGG6JV.mjs";
+export {
+  eventSubscriber
+};
+//# sourceMappingURL=subscriber-IFZJU57V.mjs.map

package/dist/subscriber-IFZJU57V.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/subscriber-sWesj_5p.d.mts

@@ -0,0 +1,80 @@
+import { TEvent } from './types.mjs';
+
+/**
+ * Interface for tracking adapters
+ */
+interface TrackingAdapter {
+    /**
+     * Name of the tracking adapter
+     */
+    name: string;
+    /**
+     * Whether the adapter is enabled
+     */
+    isEnabled: () => boolean;
+    /**
+     * Initialize the adapter
+     */
+    initialize: () => Promise<void>;
+    /**
+     * Track an event
+     */
+    trackEvent: (event: TEvent) => Promise<void>;
+}
+/**
+ * EventSubscriber class responsible for managing tracking adapters and forwarding events
+ */
+declare class EventSubscriber {
+    private static instance;
+    private adapters;
+    private initialized;
+    private eventQueue;
+    private unsubscribe;
+    /**
+     * Private constructor to enforce singleton pattern
+     */
+    private constructor();
+    /**
+     * Get the singleton instance of EventSubscriber
+     */
+    static getInstance(): EventSubscriber;
+    /**
+     * Register a tracking adapter
+     * @param adapter The tracking adapter to register
+     */
+    registerAdapter(adapter: TrackingAdapter): void;
+    /**
+     * Unregister a tracking adapter by name
+     * @param adapterName The name of the adapter to unregister
+     */
+    unregisterAdapter(adapterName: string): void;
+    /**
+     * Initialize all registered adapters
+     */
+    initialize(): Promise<void>;
+    /**
+     * Initialize a single adapter
+     * @param adapter The adapter to initialize
+     */
+    private initializeAdapter;
+    /**
+     * Handle an event by forwarding it to all enabled adapters
+     * @param event The event to handle
+     */
+    private handleEvent;
+    /**
+     * Process any events that were queued before initialization
+     */
+    private processEventQueue;
+    /**
+     * Shutdown the subscriber and all adapters
+     */
+    shutdown(): void;
+    /**
+     * Get all registered adapters
+     */
+    getAdapters(): TrackingAdapter[];
+}
+declare const eventSubscriber: EventSubscriber;
+
+export { type TrackingAdapter as T, eventSubscriber as e };