shopkit-analytics 1.0.2 → 1.0.4

package/dist/utils/index.js

@@ -0,0 +1,93 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/event-id.ts
+var event_id_exports = {};
+__export(event_id_exports, {
+  generateEventId: () => generateEventId,
+  getBrowserInfo: () => getBrowserInfo,
+  getClientIpAddress: () => getClientIpAddress
+});
+module.exports = __toCommonJS(event_id_exports);
+function generateEventId(eventType) {
+  const timestamp = Date.now();
+  const randomString = Math.random().toString(36).substring(2, 8);
+  return `${timestamp}_${randomString}_${eventType}`;
+}
+function getBrowserInfo() {
+  if (typeof window === "undefined") {
+    return {};
+  }
+  const userAgent = navigator.userAgent;
+  const fbc = getFacebookClickId();
+  const fbp = getFacebookBrowserId();
+  return {
+    clientUserAgent: userAgent,
+    fbc,
+    fbp
+  };
+}
+function getFacebookClickId() {
+  if (typeof window === "undefined") {
+    return void 0;
+  }
+  const urlParams = new URLSearchParams(window.location.search);
+  const fbclid = urlParams.get("fbclid");
+  if (fbclid) {
+    return `fb.1.${Date.now()}.${fbclid}`;
+  }
+  const cookies = document.cookie.split(";");
+  for (const cookie of cookies) {
+    const [name, value] = cookie.trim().split("=");
+    if (name === "_fbc") {
+      return value;
+    }
+  }
+  return void 0;
+}
+function getFacebookBrowserId() {
+  if (typeof window === "undefined") {
+    return void 0;
+  }
+  const cookies = document.cookie.split(";");
+  for (const cookie of cookies) {
+    const [name, value] = cookie.trim().split("=");
+    if (name === "_fbp") {
+      return value;
+    }
+  }
+  return void 0;
+}
+function getClientIpAddress(request) {
+  if (!request) {
+    return void 0;
+  }
+  const forwarded = request.headers.get("x-forwarded-for");
+  const realIp = request.headers.get("x-real-ip");
+  const cfConnectingIp = request.headers.get("cf-connecting-ip");
+  return forwarded?.split(",")[0] || realIp || cfConnectingIp || void 0;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateEventId,
+  getBrowserInfo,
+  getClientIpAddress
+});
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/event-id.ts"],"sourcesContent":["/**\n * Generate a unique event ID for deduplication\n * Format: timestamp_randomString_eventType\n */\nexport function generateEventId(eventType: string): string {\n  const timestamp = Date.now();\n  const randomString = Math.random().toString(36).substring(2, 8);\n  return `${timestamp}_${randomString}_${eventType}`;\n}\n\n/**\n * Extract browser information for CAPI user data\n */\nexport function getBrowserInfo(): {\n  clientUserAgent?: string;\n  fbc?: string;\n  fbp?: string;\n} {\n  if (typeof window === \"undefined\") {\n    return {};\n  }\n\n  const userAgent = navigator.userAgent;\n\n  // Get Facebook click ID from URL or cookies\n  const fbc = getFacebookClickId();\n  const fbp = getFacebookBrowserId();\n\n  return {\n    clientUserAgent: userAgent,\n    fbc,\n    fbp,\n  };\n}\n\n/**\n * Get Facebook click ID (fbc) from URL parameters or cookies\n */\nfunction getFacebookClickId(): string | undefined {\n  if (typeof window === \"undefined\") {\n    return undefined;\n  }\n\n  // Check URL parameters first\n  const urlParams = new URLSearchParams(window.location.search);\n  const fbclid = urlParams.get(\"fbclid\");\n\n  if (fbclid) {\n    return `fb.1.${Date.now()}.${fbclid}`;\n  }\n\n  // Check cookies\n  const cookies = document.cookie.split(\";\");\n  for (const cookie of cookies) {\n    const [name, value] = cookie.trim().split(\"=\");\n    if (name === \"_fbc\") {\n      return value;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Get Facebook browser ID (fbp) from cookies\n */\nfunction getFacebookBrowserId(): string | undefined {\n  if (typeof window === \"undefined\") {\n    return undefined;\n  }\n\n  const cookies = document.cookie.split(\";\");\n  for (const cookie of cookies) {\n    const [name, value] = cookie.trim().split(\"=\");\n    if (name === \"_fbp\") {\n      return value;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Get client IP address (this will be handled server-side)\n */\nexport function getClientIpAddress(request?: Request): string | undefined {\n  if (!request) {\n    return undefined;\n  }\n\n  // Try different headers for IP address\n  const forwarded = request.headers.get(\"x-forwarded-for\");\n  const realIp = request.headers.get(\"x-real-ip\");\n  const cfConnectingIp = request.headers.get(\"cf-connecting-ip\");\n\n  return forwarded?.split(\",\")[0] || realIp || cfConnectingIp || undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,SAAS,gBAAgB,WAA2B;AACzD,QAAM,YAAY,KAAK,IAAI;AAC3B,QAAM,eAAe,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,UAAU,GAAG,CAAC;AAC9D,SAAO,GAAG,SAAS,IAAI,YAAY,IAAI,SAAS;AAClD;AAKO,SAAS,iBAId;AACA,MAAI,OAAO,WAAW,aAAa;AACjC,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,YAAY,UAAU;AAG5B,QAAM,MAAM,mBAAmB;AAC/B,QAAM,MAAM,qBAAqB;AAEjC,SAAO;AAAA,IACL,iBAAiB;AAAA,IACjB;AAAA,IACA;AAAA,EACF;AACF;AAKA,SAAS,qBAAyC;AAChD,MAAI,OAAO,WAAW,aAAa;AACjC,WAAO;AAAA,EACT;AAGA,QAAM,YAAY,IAAI,gBAAgB,OAAO,SAAS,MAAM;AAC5D,QAAM,SAAS,UAAU,IAAI,QAAQ;AAErC,MAAI,QAAQ;AACV,WAAO,QAAQ,KAAK,IAAI,CAAC,IAAI,MAAM;AAAA,EACrC;AAGA,QAAM,UAAU,SAAS,OAAO,MAAM,GAAG;AACzC,aAAW,UAAU,SAAS;AAC5B,UAAM,CAAC,MAAM,KAAK,IAAI,OAAO,KAAK,EAAE,MAAM,GAAG;AAC7C,QAAI,SAAS,QAAQ;AACnB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAKA,SAAS,uBAA2C;AAClD,MAAI,OAAO,WAAW,aAAa;AACjC,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,SAAS,OAAO,MAAM,GAAG;AACzC,aAAW,UAAU,SAAS;AAC5B,UAAM,CAAC,MAAM,KAAK,IAAI,OAAO,KAAK,EAAE,MAAM,GAAG;AAC7C,QAAI,SAAS,QAAQ;AACnB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,mBAAmB,SAAuC;AACxE,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AAGA,QAAM,YAAY,QAAQ,QAAQ,IAAI,iBAAiB;AACvD,QAAM,SAAS,QAAQ,QAAQ,IAAI,WAAW;AAC9C,QAAM,iBAAiB,QAAQ,QAAQ,IAAI,kBAAkB;AAE7D,SAAO,WAAW,MAAM,GAAG,EAAE,CAAC,KAAK,UAAU,kBAAkB;AACjE;","names":[]}

package/dist/utils/index.mjs

@@ -0,0 +1,12 @@
+"use client";
+import {
+  generateEventId,
+  getBrowserInfo,
+  getClientIpAddress
+} from "../chunk-4RDPDMGW.mjs";
+export {
+  generateEventId,
+  getBrowserInfo,
+  getClientIpAddress
+};
+//# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shopkit-analytics",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "A comprehensive analytics package combining event tracking and affiliate tracking for e-commerce applications with multiple platform adapters",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -21,11 +21,26 @@
       "import": "./dist/affiliate/index.mjs",
       "require": "./dist/affiliate/index.js"
     },
+    "./experiment": {
+      "types": "./dist/experiment/index.d.ts",
+      "import": "./dist/experiment/index.mjs",
+      "require": "./dist/experiment/index.js"
+    },
     "./adapters": {
       "types": "./dist/adapters/index.d.ts",
       "import": "./dist/adapters/index.mjs",
       "require": "./dist/adapters/index.js"
     },
+    "./services": {
+      "types": "./dist/services/index.d.ts",
+      "import": "./dist/services/index.mjs",
+      "require": "./dist/services/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.mjs",
+      "require": "./dist/utils/index.js"
+    },
     "./types": {
       "types": "./dist/types.d.ts",
       "import": "./dist/types.mjs",
@@ -34,6 +49,7 @@
   },
   "files": [
     "dist",
+    "templates",
     "README.md",
     "LICENSE"
   ],
@@ -55,6 +71,8 @@
     "tracking",
     "events",
     "affiliate",
+    "experiment",
+    "ab-testing",
     "utm",
     "google-analytics",
     "facebook-pixel",

package/templates/nextjs/README.md

@@ -0,0 +1,206 @@
+# Facebook CAPI Setup Guide for Next.js
+
+This guide helps you set up Facebook Conversions API (CAPI) server-side tracking with the @shopkit/analytics package.
+
+## Quick Setup
+
+### 1. Environment Variables
+
+Add these to your `.env.local` file:
+
+```bash
+# Required for Facebook CAPI
+FACEBOOK_CAPI_ACCESS_TOKEN="your_facebook_access_token"
+NEXT_PUBLIC_PIXEL_ID="123456789"
+
+# Optional (for testing)
+FACEBOOK_TEST_EVENT_CODE="TEST12345"
+```
+
+### 2. Create API Route
+
+**For Next.js App Router (app directory):**
+
+Create `app/api/events/route.ts` and copy the contents from `api-events-route.ts` in this directory.
+
+**For Next.js Pages Router (pages directory):**
+
+Create `pages/api/events.ts`:
+
+```typescript
+import { createFacebookCAPIService } from "@shopkit/analytics/services";
+import { TEvent } from "@shopkit/analytics/types";
+import type { NextApiRequest, NextApiResponse } from "next";
+
+function getClientIpAddress(req: NextApiRequest): string | undefined {
+  const forwarded = req.headers["x-forwarded-for"];
+  const realIp = req.headers["x-real-ip"];
+  const cfConnectingIp = req.headers["cf-connecting-ip"];
+
+  if (typeof forwarded === "string") {
+    return forwarded.split(",")[0];
+  }
+  if (typeof realIp === "string") {
+    return realIp;
+  }
+  if (typeof cfConnectingIp === "string") {
+    return cfConnectingIp;
+  }
+  return undefined;
+}
+
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  if (req.method !== "POST") {
+    return res.status(405).json({ error: "Method not allowed" });
+  }
+
+  try {
+    const { events, userInfo } = req.body;
+
+    if (!Array.isArray(events) || events.length === 0) {
+      return res.status(400).json({ error: "Invalid events data" });
+    }
+
+    const capiService = createFacebookCAPIService({
+      accessToken: process.env.FACEBOOK_CAPI_ACCESS_TOKEN!,
+      pixelId: process.env.NEXT_PUBLIC_PIXEL_ID!,
+      testEventCode: process.env.FACEBOOK_TEST_EVENT_CODE,
+    });
+
+    if (!capiService) {
+      console.warn("Facebook CAPI service not available - missing configuration");
+      return res.status(500).json({ error: "CAPI service not configured" });
+    }
+
+    const enhancedUserInfo = {
+      ...userInfo,
+      clientIpAddress: getClientIpAddress(req),
+    };
+
+    await capiService.sendEvents(events as TEvent[], enhancedUserInfo);
+
+    return res.json({
+      success: true,
+      message: `Successfully sent ${events.length} events to Facebook CAPI`,
+    });
+  } catch (error) {
+    console.error("API Events Error:", error);
+    return res.status(500).json({ error: "Failed to process events" });
+  }
+}
+```
+
+### 3. CAPI Configuration (Enabled by Default)
+
+```typescript
+import { ShopkitAnalytics } from "@shopkit/analytics";
+
+<ShopkitAnalytics
+  config={{
+    facebookPixel: {
+      pixelId: process.env.NEXT_PUBLIC_PIXEL_ID!,
+      // enableCAPI: true, // Default: enabled for better data reliability
+      // enableCAPI: false, // Uncomment to disable server-side tracking
+    },
+  }}
+>
+  <YourApp />
+</ShopkitAnalytics>
+```
+
+**Important**: CAPI is **enabled by default** to provide better data reliability and privacy compliance. The system will gracefully handle cases where the API endpoint is not set up - client-side tracking will continue to work normally.
+
+## Getting Facebook Access Token
+
+1. Go to [Facebook Business Manager](https://business.facebook.com/)
+2. Navigate to **Business Settings** → **System Users**
+3. Create a new system user or select existing one
+4. Generate an access token with these permissions:
+   - `ads_management`
+   - `business_management`
+5. Copy the access token to your environment variables
+
+## Testing
+
+### Development Testing
+
+1. Set the test event code in your environment:
+   ```bash
+   FACEBOOK_TEST_EVENT_CODE="TEST12345"
+   ```
+
+2. Trigger some events in your app
+
+3. Check Facebook Events Manager → Test Events to see if events are received
+
+### Production Verification
+
+1. Remove or comment out `FACEBOOK_TEST_EVENT_CODE`
+2. Monitor Facebook Events Manager for real events
+3. Check your server logs for any CAPI errors
+
+## Troubleshooting
+
+### Common Issues
+
+1. **"CAPI service not configured"**
+   - Ensure `FACEBOOK_CAPI_ACCESS_TOKEN` and `NEXT_PUBLIC_PIXEL_ID` are set
+   - Verify environment variables are loaded correctly
+
+2. **"Method not allowed" (Pages Router)**
+   - Ensure you're using POST requests
+   - Check the API route is created correctly
+
+3. **Events not appearing in Facebook**
+   - Verify your access token has correct permissions
+   - Check if test event code is set (events go to Test Events tool)
+   - Monitor server logs for error messages
+
+4. **CORS errors**
+   - API route should be on the same domain as your app
+   - Next.js API routes handle CORS automatically
+
+### Debug Logging
+
+Enable debug logging to see detailed information:
+
+```typescript
+<ShopkitAnalytics
+  config={{
+    logger: {
+      enabled: true,
+      level: "debug",
+      prettyPrint: true,
+    },
+    facebookPixel: {
+      pixelId: process.env.NEXT_PUBLIC_PIXEL_ID!,
+      enableCAPI: true,
+    },
+  }}
+/>
+```
+
+## How It Works
+
+1. **Event Triggered**: User performs an action (add to cart, etc.)
+2. **Dual Tracking**: Event sent to both client-side pixel and server-side CAPI (enabled by default)
+3. **Event ID**: Unique ID prevents double counting
+4. **Enhanced Data**: Automatically includes experiment and affiliate data
+5. **Deduplication**: Facebook uses event ID to merge client/server events
+6. **Graceful Fallback**: If API endpoint is missing, only client-side tracking runs (no errors)
+
+### Default Behavior
+
+- **CAPI is enabled by default** for all Facebook Pixel configurations
+- **No setup required** for basic client-side tracking
+- **API endpoint optional** - system works without it (client-side only)
+- **Better data quality** when API endpoint is properly configured
+
+## Support
+
+- Check the main package README for more details
+- Monitor browser console and server logs for errors
+- Use Facebook's Test Events tool during development

package/templates/nextjs/api-events-route.ts

@@ -0,0 +1,62 @@
+import { createFacebookCAPIService } from "@shopkit/analytics/services";
+import { TEvent } from "@shopkit/analytics/types";
+
+/**
+ * Get client IP address from request headers
+ */
+function getClientIpAddress(request: Request): string | undefined {
+  // Try different headers for IP address
+  const forwarded = request.headers.get("x-forwarded-for");
+  const realIp = request.headers.get("x-real-ip");
+  const cfConnectingIp = request.headers.get("cf-connecting-ip");
+
+  return forwarded?.split(",")[0] || realIp || cfConnectingIp || undefined;
+}
+
+export async function POST(request: Request) {
+  try {
+    const { events, userInfo } = await request.json();
+
+    // Validate events array
+    if (!Array.isArray(events) || events.length === 0) {
+      return Response.json({ error: "Invalid events data" }, { status: 400 });
+    }
+
+    // Create CAPI service with explicit configuration
+    const capiService = createFacebookCAPIService({
+      accessToken: process.env.FACEBOOK_CAPI_ACCESS_TOKEN!,
+      pixelId: process.env.NEXT_PUBLIC_PIXEL_ID!,
+      testEventCode: process.env.FACEBOOK_TEST_EVENT_CODE,
+    });
+
+    if (!capiService) {
+      console.warn(
+        "Facebook CAPI service not available - missing configuration"
+      );
+      return Response.json(
+        { error: "CAPI service not configured" },
+        { status: 500 }
+      );
+    }
+
+    // Enhance user info with server-side data
+    const enhancedUserInfo = {
+      ...userInfo,
+      clientIpAddress: getClientIpAddress(request),
+    };
+
+    // Send events to Facebook CAPI
+    await capiService.sendEvents(events as TEvent[], enhancedUserInfo);
+
+    return Response.json({
+      success: true,
+      message: `Successfully sent ${events.length} events to Facebook CAPI`,
+    });
+  } catch (error) {
+    console.error("API Events Error:", error);
+    return Response.json(
+      { error: "Failed to process events" },
+      { status: 500 }
+    );
+  }
+}

package/dist/chunk-3NR2AKE4.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * Event types that can be tracked across the application\n */\nexport enum EventType {\n  PRODUCT_VIEW = \"product_view\",\n  PAGE_VIEW = \"page_view\",\n  BUTTON_CLICK = \"button_click\",\n  FORM_SUBMISSION = \"form_submission\",\n  VIEW_ITEM = \"view_item\",\n  VIEWED_PRODUCT = \"viewed_product\",\n  CHECKOUT_PAYMENT = \"checkout_payment\",\n  COLLECTION_VIEW = \"collection_view\",\n  ADD_TO_CART = \"add_to_cart\",\n  REMOVE_FROM_CART = \"remove_from_cart\",\n  CHECKOUT_STARTED = \"checkout_started\",\n  CHECKOUT_COMPLETED = \"checkout_completed\",\n  SEARCH = \"search\",\n  USER_SIGNUP = \"user_signup\",\n  USER_LOGIN = \"user_login\",\n  CUSTOM = \"custom\",\n  USER_ENGAGEMENT = \"user_engagement\",\n  SESSION_START = \"session_start\",\n  FIRST_VISIT = \"first_visit\",\n  SCROLL = \"scroll\",\n  FORM_START = \"form_start\",\n  ADD_PAYMENT_INFO = \"add_payment_info\",\n  CART_VIEWED = \"cart_viewed\",\n  VIEW_CONTENT = \"view_content\",\n  PURCHASE = \"purchase\",\n  VIEW_SEARCH_RESULTS = \"view_search_results\",\n  ORDER_PLACED = \"order_placed\",\n  BEGIN_CHECKOUT = \"begin_checkout\",\n\n  // GoKwik Checkout events (actually used)\n  STARTED_CHECKOUT_GK = \"started_checkout_gk\",\n  MOBILE_ADDED_GK = \"mobile_added_gk\",\n  ADDRESS_SELECTED_GK = \"address_selected_gk\",\n  ADDRESS_COMPLETED_GK = \"address_completed_gk\",\n  PAYMENT_METHOD_SELECTED_GK = \"payment_method_selected_gk\",\n  PAYMENT_COMPLETED_GK = \"payment_completed_gk\",\n  ORDER_SUCCESS = \"order_success\",\n  ORDER_COMPLETED = \"order_completed\",\n  PIN_CODE_ADDED_GK = \"pin_code_added_gk\",\n  ADDRESS_ADDED_GK = \"address_added_gk\",\n}\n\n/**\n * Base event interface that all events should implement\n */\nexport interface BaseEvent {\n  type: EventType;\n  timestamp?: number;\n  eventId?: string;\n  event_category?: string;\n  description?: string;\n  [key: string]: any;\n}\n\n/**\n * Page view event\n */\nexport interface IPageViewEvent extends BaseEvent {\n  type: EventType.PAGE_VIEW;\n  path: string;\n  title: string;\n  referrer?: string;\n  // GA4 specific parameters\n  batch_ordering_id?: string;\n  batch_page_id?: string;\n  campaign?: string;\n  campaign_id?: string;\n  content?: string;\n  debug_mode?: boolean;\n  engagement_time_msec?: number;\n  entrances?: number;\n  ga_session_id?: string;\n  ga_session_number?: number;\n  gclid?: string;\n  ignore_referrer?: boolean;\n  medium?: string;\n  page_location?: string;\n  page_path?: string;\n  page_referrer?: string;\n  page_title?: string;\n  page_source?: string;\n  page_term?: string;\n  user_id?: string;\n  user_properties?: Record<string, any>;\n  session_engaged?: boolean;\n}\n\n/**\n * User engagement event\n */\nexport interface IUserEngagementEvent extends BaseEvent {\n  type: EventType.USER_ENGAGEMENT;\n  engagementTime?: number; // in seconds\n  pagePath?: string;\n  pageTitle?: string;\n  scrollDepth?: number; // in percentage\n  formId?: string;\n  formName?: string;\n  formFields?: Array<{\n    fieldName: string;\n    fieldValue: string;\n  }>;\n  buttonId?: string;\n  buttonText?: string;\n  location?: string;\n  customProperties?: Record<string, any>;\n  // GA4 specific parameters\n  batch_ordering_id?: string;\n  batch_page_id?: string;\n  campaign?: string;\n  ga_session_id?: string;\n  ga_session_number?: number;\n  gclid?: string;\n  ignore_referrer?: boolean;\n  medium?: string;\n  page_location?: string;\n  page_path?: string;\n  page_referrer?: string;\n  page_title?: string;\n  source?: string;\n  srsltid?: string;\n  term?: string;\n  user_id?: string;\n  user_properties?: Record<string, any>;\n  session_engaged?: boolean;\n}\n\n/**\n * Session start event\n */\nexport interface ISessionStartEvent extends BaseEvent {\n  type: EventType.SESSION_START;\n  sessionId: string;\n  userId?: string;\n  userAgent?: string;\n  referrer?: string;\n  pagePath: string;\n  pageTitle: string;\n  timestamp: number;\n  customProperties?: Record<string, any>;\n}\n\n/**\n * First visit event\n */\nexport interface IFirstVisitEvent extends BaseEvent {\n  type: EventType.FIRST_VISIT;\n  userId?: string;\n  userAgent?: string;\n  referrer?: string;\n  pagePath: string;\n  pageTitle: string;\n  timestamp: number;\n  customProperties?: Record<string, any>;\n}\n\n/**\n * Scroll event\n */\nexport interface IScrollEvent extends BaseEvent {\n  type: EventType.SCROLL;\n  scrollDepth: number; // in percentage\n  pagePath: string;\n  pageTitle: string;\n  timestamp: number;\n  customProperties?: Record<string, any>;\n  // GA4 specific parameters\n  batch_ordering_id?: string;\n  batch_page_id?: string;\n  engagement_time_msec?: number;\n  ga_session_id?: string;\n  ga_session_number?: number;\n  ignore_referrer?: boolean;\n  page_location?: string;\n  page_referrer?: string;\n  page_title?: string;\n  percent_scrolled?: number;\n}\n\n/**\n * Form start event\n */\nexport interface IFormStartEvent extends BaseEvent {\n  type: EventType.FORM_START;\n  formId: string;\n  formName?: string;\n  pagePath: string;\n  pageTitle: string;\n  timestamp: number;\n  customProperties?: Record<string, any>;\n}\n\n/**\n * Form submission event\n */\nexport interface IFormSubmissionEvent extends BaseEvent {\n  type: EventType.FORM_SUBMISSION;\n  formId: string;\n  formName?: string;\n  success: boolean;\n  pagePath: string;\n  pageTitle: string;\n  timestamp: number;\n  customProperties?: Record<string, any>;\n}\n\n/**\n * User signup event\n */\nexport interface IUserSignupEvent extends BaseEvent {\n  type: EventType.USER_SIGNUP;\n  userId?: string;\n  method?: string;\n  success: boolean;\n  pagePath: string;\n  pageTitle: string;\n  timestamp: number;\n  customProperties?: Record<string, any>;\n}\n\n/**\n * User login event\n */\nexport interface IUserLoginEvent extends BaseEvent {\n  type: EventType.USER_LOGIN;\n  userId?: string;\n  method?: string;\n  success: boolean;\n  pagePath: string;\n  pageTitle: string;\n  timestamp: number;\n  customProperties?: Record<string, any>;\n}\n\n/**\n * Button click event\n */\nexport interface IButtonClickEvent extends BaseEvent {\n  type: EventType.BUTTON_CLICK;\n  buttonId?: string;\n  buttonText?: string;\n  location: string;\n}\n\n/**\n * View item event for e-commerce tracking\n */\nexport interface IViewItemEvent extends BaseEvent {\n  type: EventType.VIEW_ITEM;\n  currency: string;\n  value: number;\n  items: Array<{\n    item_id: string;\n    item_name: string;\n    price: number;\n    currency: string;\n  }>;\n  // GA4 specific parameters\n  batch_ordering_id?: string;\n  batch_page_id?: string;\n  campaign?: string;\n  ecomm_pagetype?: string;\n  ecomm_prodid?: string;\n  ecomm_totalvalue?: number;\n  engagement_time_msec?: number;\n  ga_session_id?: string;\n  ga_session_number?: number;\n  gclid?: string;\n  ignore_referrer?: boolean;\n  medium?: string;\n  page_location?: string;\n  page_path?: string;\n  page_referrer?: string;\n  page_title?: string;\n  source?: string;\n  srsltid?: string;\n  term?: string;\n  user_id?: string;\n  user_properties?: Record<string, any>;\n  session_engaged?: boolean;\n}\n\n/**\n * Checkout payment event\n */\nexport interface ICheckoutPaymentEvent extends BaseEvent {\n  type: EventType.CHECKOUT_PAYMENT;\n  cartValue: number;\n  currency: string;\n  itemCount: number;\n  items: Array<{\n    productId: string;\n    productName: string;\n    price: number;\n    quantity: number;\n  }>;\n}\n\n/**\n * Viewed product event after 20 seconds\n */\nexport interface IViewedProductEvent extends BaseEvent {\n  type: EventType.VIEWED_PRODUCT;\n  productId: string;\n  productName: string;\n  price: number;\n  currency: string;\n  viewDuration: number;\n}\n\nexport interface IPCollectionViewEvent extends BaseEvent {\n  type: EventType.COLLECTION_VIEW;\n  productId: string;\n  productName: string;\n  price?: number;\n  currency?: string;\n  category?: string;\n}\n\n/**\n * Add to cart event\n */\nexport interface IAddToCartEvent extends BaseEvent {\n  type: EventType.ADD_TO_CART;\n  productId: string;\n  productName: string;\n  price: number;\n  currency?: string;\n  quantity?: number;\n  variant?: string;\n  // GA4 specific parameters\n  batch_ordering_id?: string;\n  batch_page_id?: string;\n  ecomm_pagetype?: string;\n  ecomm_prodid?: string;\n  ecomm_totalvalue?: number;\n  value?: number;\n  engagement_time_msec?: number;\n  ga_session_id?: string;\n  ga_session_number?: number;\n  ignore_referrer?: boolean;\n  page_location?: string;\n  page_referrer?: string;\n  page_title?: string;\n  user_id?: string;\n  user_properties?: Record<string, any>;\n  session_engaged?: boolean;\n}\n\n/**\n * Remove from cart event\n */\nexport interface IRemoveFromCartEvent extends BaseEvent {\n  type: EventType.REMOVE_FROM_CART;\n  productId: string;\n  productName: string;\n  price: number;\n  currency?: string;\n  quantity: number;\n  variant?: string;\n}\n\n/**\n * Checkout started event\n */\nexport interface ICheckoutStartedEvent extends BaseEvent {\n  type: EventType.CHECKOUT_STARTED;\n  cartValue: number;\n  currency?: string;\n  itemCount: number;\n  items: Array<{\n    productId: string;\n    productName: string;\n    price: number;\n    quantity: number;\n    variant?: string;\n  }>;\n  coupon?: string;\n  discount?: number | string;\n}\n\n/**\n * Checkout completed event\n */\nexport interface ICheckoutCompletedEvent extends BaseEvent {\n  type: EventType.CHECKOUT_COMPLETED;\n  orderId: string;\n  cartValue: number;\n  currency?: string;\n  itemCount: number;\n  items: Array<{\n    productId: string;\n    productName: string;\n    price: number;\n    quantity: number;\n    variant?: string;\n  }>;\n}\n\n/**\n * Cart viewed event\n */\nexport interface ICartViewedEvent extends BaseEvent {\n  type: EventType.CART_VIEWED;\n  cartId: string;\n  products: Array<{\n    variantId: string;\n    price: number;\n    quantity: number;\n  }>;\n}\n\n/**\n * Search event\n */\nexport interface ISearchEvent extends BaseEvent {\n  type: EventType.SEARCH;\n  searchTerm: string;\n  content_ids: string[];\n  resultsCount?: number;\n}\n\n/**\n * View content event (for Facebook Pixel ViewContent)\n */\nexport interface IViewContentEvent extends BaseEvent {\n  type: EventType.VIEW_CONTENT;\n  content_type?: string;\n  content_ids?: string[];\n  content_name?: string;\n  content_category?: string;\n  value?: number;\n  currency?: string;\n  items?: Array<any>;\n  // GA4 specific parameters\n  batch_ordering_id?: string;\n  batch_page_id?: string;\n  campaign?: string;\n  ga_session_id?: string;\n  engagement_time_msec?: number;\n  session_engaged?: boolean;\n  page_title?: string;\n  page_location?: string;\n  page_referrer?: string;\n  user_id?: string;\n  user_properties?: Record<string, any>;\n}\n\n/**\n * Purchase event (for Facebook Pixel Purchase)\n */\nexport interface IPurchaseEvent extends BaseEvent {\n  type: EventType.PURCHASE;\n  value: number;\n  currency?: string;\n  content_type?: string;\n  content_ids?: string[];\n  num_items?: number;\n  contents?: Array<{\n    id: string;\n    quantity: number;\n    item_price?: number;\n  }>;\n  transaction_id?: string;\n  coupon?: string;\n  shipping?: number;\n  tax?: number;\n  items?: Array<any>;\n  // GA4 specific parameters\n  batch_ordering_id?: string;\n  batch_page_id?: string;\n  campaign?: string;\n  ga_session_id?: string;\n  engagement_time_msec?: number;\n  session_engaged?: boolean;\n  page_title?: string;\n  page_location?: string;\n  page_referrer?: string;\n  user_id?: string;\n  user_properties?: Record<string, any>;\n}\n\n/**\n * View search results event (for GA4)\n */\nexport interface IViewSearchResultsEvent extends BaseEvent {\n  type: EventType.VIEW_SEARCH_RESULTS;\n  search_term?: string;\n  // GA4 specific parameters\n  batch_ordering_id?: string;\n  batch_page_id?: string;\n  campaign?: string;\n  campaign_id?: string;\n  content?: string;\n  ga_session_id?: string;\n  ga_session_number?: number;\n  gclid?: string;\n  medium?: string;\n  page_location?: string;\n  page_path?: string;\n  page_referrer?: string;\n  page_title?: string;\n  source?: string;\n  srsltid?: string;\n  term?: string;\n  user_id?: string;\n  user_properties?: Record<string, any>;\n  session_engaged?: boolean;\n  engagement_time_msec?: number;\n}\n\n/**\n * Order placed event (for GA4)\n */\nexport interface IOrderPlacedEvent extends BaseEvent {\n  type: EventType.ORDER_PLACED;\n  transaction_id?: string;\n  order_id?: string;\n  total_amount?: number;\n  value: number;\n  currency?: string;\n  items?: Array<any>;\n  // GA4 specific parameters\n  batch_ordering_id?: string;\n  batch_page_id?: string;\n  coupon?: string;\n  discount?: number;\n  engagement_time_msec?: number;\n  ga_session_id?: string;\n  ga_session_number?: number;\n  ignore_referrer?: boolean;\n  page_location?: string;\n  page_referrer?: string;\n  page_title?: string;\n  payment_type?: string;\n  shipping?: number;\n  shipping_name?: string;\n  tax?: number;\n  user_id?: string;\n  user_properties?: Record<string, any>;\n  session_engaged?: boolean;\n}\n\n/**\n * Begin checkout event (for GA4)\n */\nexport interface IBeginCheckoutEvent extends BaseEvent {\n  type: EventType.BEGIN_CHECKOUT;\n  currency?: string;\n  value: number;\n  coupon?: string;\n  items?: Array<any>;\n  // GA4 specific parameters\n  batch_ordering_id?: string;\n  batch_page_id?: string;\n  ecomm_pagetype?: string;\n  ecomm_prodid?: string;\n  ecomm_totalvalue?: number;\n  engagement_time_msec?: number;\n  ga_session_id?: string;\n  ga_session_number?: number;\n  ignore_referrer?: boolean;\n  page_location?: string;\n  page_referrer?: string;\n  page_title?: string;\n  user_id?: string;\n  user_properties?: Record<string, any>;\n  session_engaged?: boolean;\n}\n\n/**\n * Custom event for any other tracking needs\n */\nexport interface ICustomEvent extends BaseEvent {\n  type: EventType.CUSTOM;\n  name: string;\n  properties?: Record<string, any>;\n}\n\n/**\n * Add Payment Info event\n */\nexport interface IAddPaymentInfoEvent extends BaseEvent {\n  type: EventType.ADD_PAYMENT_INFO;\n  cartValue: number;\n  currency?: string;\n  itemCount: number;\n  paymentType?: string;\n  items: Array<{\n    productId: string;\n    productName: string;\n    price: number;\n    quantity: number;\n    variant?: string;\n  }>;\n}\n\n/**\n * Started checkout GK event\n */\nexport interface IStartedCheckoutGKEvent extends BaseEvent {\n  type: EventType.STARTED_CHECKOUT_GK;\n  cartValue?: number;\n  currency?: string;\n}\n\n/**\n * Mobile added GK event\n */\nexport interface IMobileAddedGKEvent extends BaseEvent {\n  type: EventType.MOBILE_ADDED_GK;\n  mobile?: string;\n}\n\n/**\n * Address selected GK event\n */\nexport interface IAddressSelectedGKEvent extends BaseEvent {\n  type: EventType.ADDRESS_SELECTED_GK;\n  addressId?: string;\n}\n\n/**\n * Address completed GK event\n */\nexport interface IAddressCompletedGKEvent extends BaseEvent {\n  type: EventType.ADDRESS_COMPLETED_GK;\n  addressId?: string;\n}\n\n/**\n * Payment method selected GK event\n */\nexport interface IPaymentMethodSelectedGKEvent extends BaseEvent {\n  type: EventType.PAYMENT_METHOD_SELECTED_GK;\n  paymentMethod?: string;\n}\n\n/**\n * Payment completed GK event\n */\nexport interface IPaymentCompletedGKEvent extends BaseEvent {\n  type: EventType.PAYMENT_COMPLETED_GK;\n  amount?: number;\n  currency?: string;\n}\n\n/**\n * Order success event\n */\nexport interface IOrderSuccessEvent extends BaseEvent {\n  type: EventType.ORDER_SUCCESS;\n  orderId?: string;\n  amount?: number;\n  currency?: string;\n}\n\n/**\n * Order completed event\n */\nexport interface IOrderCompletedEvent extends BaseEvent {\n  type: EventType.ORDER_COMPLETED;\n  orderId?: string;\n  amount?: number;\n  currency?: string;\n}\n\n/**\n * PIN code added GK event\n */\nexport interface IPinCodeAddedGKEvent extends BaseEvent {\n  type: EventType.PIN_CODE_ADDED_GK;\n  pinCode?: string;\n}\n\n/**\n * Address added GK event\n */\nexport interface IAddressAddedGKEvent extends BaseEvent {\n  type: EventType.ADDRESS_ADDED_GK;\n  addressId?: string;\n}\n\n/**\n * Product view event\n */\nexport interface IProductViewEvent extends BaseEvent {\n  type: EventType.PRODUCT_VIEW;\n  event_category: string;\n  description: string;\n  productId: string;\n  productName: string;\n  price: number;\n  currency?: string;\n  category?: string;\n}\n\n/**\n * Union type of all possible events\n */\nexport type TEvent =\n  | IProductViewEvent\n  | IPageViewEvent\n  | IButtonClickEvent\n  | IFormSubmissionEvent\n  | IViewItemEvent\n  | IPCollectionViewEvent\n  | IAddToCartEvent\n  | IRemoveFromCartEvent\n  | ICheckoutStartedEvent\n  | ICheckoutCompletedEvent\n  | ICartViewedEvent\n  | ISearchEvent\n  | IUserSignupEvent\n  | IUserLoginEvent\n  | IViewContentEvent\n  | IPurchaseEvent\n  | IViewSearchResultsEvent\n  | IOrderPlacedEvent\n  | IBeginCheckoutEvent\n  | ICustomEvent\n  | IUserEngagementEvent\n  | ISessionStartEvent\n  | IFirstVisitEvent\n  | IScrollEvent\n  | IFormStartEvent\n  | IAddPaymentInfoEvent\n  | IStartedCheckoutGKEvent\n  | IMobileAddedGKEvent\n  | IAddressSelectedGKEvent\n  | IAddressCompletedGKEvent\n  | IPaymentMethodSelectedGKEvent\n  | IPaymentCompletedGKEvent\n  | IOrderSuccessEvent\n  | IOrderCompletedEvent\n  | IPinCodeAddedGKEvent\n  | IAddressAddedGKEvent\n  | IViewedProductEvent\n  | ICheckoutPaymentEvent;\n"],"mappings":";;;AAGO,IAAK,YAAL,kBAAKA,eAAL;AACL,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,eAAY;AACZ,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,qBAAkB;AAClB,EAAAA,WAAA,eAAY;AACZ,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,qBAAkB;AAClB,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,wBAAqB;AACrB,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,gBAAa;AACb,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,qBAAkB;AAClB,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,gBAAa;AACb,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,cAAW;AACX,EAAAA,WAAA,yBAAsB;AACtB,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,oBAAiB;AAGjB,EAAAA,WAAA,yBAAsB;AACtB,EAAAA,WAAA,qBAAkB;AAClB,EAAAA,WAAA,yBAAsB;AACtB,EAAAA,WAAA,0BAAuB;AACvB,EAAAA,WAAA,gCAA6B;AAC7B,EAAAA,WAAA,0BAAuB;AACvB,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,qBAAkB;AAClB,EAAAA,WAAA,uBAAoB;AACpB,EAAAA,WAAA,sBAAmB;AAxCT,SAAAA;AAAA,GAAA;","names":["EventType"]}