saasco-sdk 0.1.33 → 0.1.35

package/index.cjs.js

@@ -7,7 +7,7 @@ var psl = require('psl');
 var uuid$1 = require('@lukeed/uuid');
 var zod = require('zod');
 
-var version = "0.1.33";
+var version = "0.1.35";
 
 const timezones = {
   'Asia/Barnaul': 'RU',
@@ -556,6 +556,7 @@ function getBrowserContext() {
 
 const isBrowser$1 = typeof window !== 'undefined';
 const isServer$1 = !isBrowser$1;
+const standardFacebookEvents = ['AddPaymentInfo', 'AddToCart', 'AddToWishlist', 'CompleteRegistration', 'Contact', 'CustomizeProduct', 'Donate', 'FindLocation', 'InitiateCheckout', 'Lead', 'Purchase', 'Schedule', 'Search', 'StartTrial', 'SubmitApplication', 'Subscribe', 'ViewContent'];
 /**
  * Create a Facebook Pixel integration instance
  */
@@ -566,7 +567,9 @@ function createFacebookPixelIntegration(config) {
     environments: ['client'],
     init: () => tslib.__awaiter(this, void 0, void 0, function* () {
       if (isServer$1) {
-        throw new Error('Facebook Pixel cannot be initialized on server');
+        // On server, Facebook Pixel is a no-op but doesn't throw
+        // This allows the integration to be registered but remain inactive
+        return;
       }
       // Check if Facebook Pixel is already loaded
       if (window.fbq || window._fbq) {
@@ -659,7 +662,10 @@ function createFacebookPixelIntegration(config) {
 }
 function getFacebookEventName(eventName, eventMapping) {
   // Convert default saasco page view event by default
-  if (eventName === 'Page View') return 'PageView';
+  if (eventName === 'Page View') {
+    const mappedEvent = 'ViewContent';
+    return mappedEvent;
+  }
   if (!eventMapping) return eventName;
   return eventMapping[eventName] || eventName;
 }
@@ -684,7 +690,9 @@ function trackFacebookEvent(eventName, properties, eventMapping) {
     if (properties['predicted_ltv'] !== undefined) fbParams['predicted_ltv'] = properties['predicted_ltv'];
     window.fbq('track', fbEventName, fbParams);
   } else {
-    window.fbq('track', fbEventName);
+    const isStandardEvent = standardFacebookEvents.includes(fbEventName);
+    const trackType = isStandardEvent ? 'track' : 'trackCustom';
+    window.fbq(trackType, fbEventName);
   }
 }
 function coerceMetaConversionsAmValues(properties) {
@@ -945,10 +953,9 @@ class IntegrationManager {
       if (integration.init) {
         try {
           state.status = 'loading';
-          this.logger.log(`init ${integration.name}`);
           yield integration.init();
           state.status = 'ready';
-          this.logger.log(`ready ${integration.name}`);
+          this.logger.log(`${integration.name} integration ready`);
           this.flush();
         } catch (e) {
           state.status = 'error';
@@ -1055,11 +1062,9 @@ class IntegrationManager {
     if (this.config.flushInterval <= 0) return;
     this.flushTimer = setInterval(() => {
       if (this.globalQueue.length > 0) {
-        this.logger.log('periodic flush triggered');
         this.flush();
       }
     }, this.config.flushInterval);
-    this.logger.log(`periodic flushing enabled: ${this.config.flushInterval}ms`);
   }
   /**
    * Setup page unload handler for client environment
@@ -1075,7 +1080,6 @@ class IntegrationManager {
     // Use both beforeunload and pagehide for better coverage
     window.addEventListener('beforeunload', this.unloadHandler);
     window.addEventListener('pagehide', this.unloadHandler);
-    this.logger.log('page unload handlers registered');
   }
   /** Debug helpers */
   getStats() {
@@ -1317,6 +1321,10 @@ class Saasco {
     });
     // Set initial context
     this.integrationManager.setContext({});
+    // Initialize integrations immediately (works on both client and server)
+    this.initIntegrations().catch(error => {
+      this.logger.log('Error initializing integrations:', error);
+    });
   }
   init() {
     if (this.isInitialized) {
@@ -1332,10 +1340,6 @@ class Saasco {
     this.logger.log('Saasco initialized', this.config);
     if (this.config.debug) this.logger.log('Debug mode active. This will log all events to the console.');
     if (!this.config.enabled) this.logger.log('Analytics is disabled. No requests will be sent to the server.');
-    // Initialize integrations asynchronously
-    this.initIntegrations().catch(error => {
-      this.logger.log('Error initializing integrations:', error);
-    });
     this.initAutoPageTracking();
     this.isInitialized = true;
   }
@@ -1626,5 +1630,6 @@ exports.browserContextSchema = browserContextSchema;
 exports.createFacebookPixelIntegration = createFacebookPixelIntegration;
 exports.getBrowserContext = getBrowserContext;
 exports.initializeFacebookPixel = initializeFacebookPixel;
+exports.standardFacebookEvents = standardFacebookEvents;
 exports.timezones = timezones;
 exports.trackFacebookEvent = trackFacebookEvent;

package/index.esm.js

@@ -3,7 +3,7 @@ import { isValid, parse } from 'psl';
 import { v4 } from '@lukeed/uuid';
 import { z } from 'zod';
 
-var version = "0.1.33";
+var version = "0.1.35";
 
 const timezones = {
   'Asia/Barnaul': 'RU',
@@ -552,6 +552,7 @@ function getBrowserContext() {
 
 const isBrowser$1 = typeof window !== 'undefined';
 const isServer$1 = !isBrowser$1;
+const standardFacebookEvents = ['AddPaymentInfo', 'AddToCart', 'AddToWishlist', 'CompleteRegistration', 'Contact', 'CustomizeProduct', 'Donate', 'FindLocation', 'InitiateCheckout', 'Lead', 'Purchase', 'Schedule', 'Search', 'StartTrial', 'SubmitApplication', 'Subscribe', 'ViewContent'];
 /**
  * Create a Facebook Pixel integration instance
  */
@@ -562,7 +563,9 @@ function createFacebookPixelIntegration(config) {
     environments: ['client'],
     init: () => __awaiter(this, void 0, void 0, function* () {
       if (isServer$1) {
-        throw new Error('Facebook Pixel cannot be initialized on server');
+        // On server, Facebook Pixel is a no-op but doesn't throw
+        // This allows the integration to be registered but remain inactive
+        return;
       }
       // Check if Facebook Pixel is already loaded
       if (window.fbq || window._fbq) {
@@ -655,7 +658,10 @@ function createFacebookPixelIntegration(config) {
 }
 function getFacebookEventName(eventName, eventMapping) {
   // Convert default saasco page view event by default
-  if (eventName === 'Page View') return 'PageView';
+  if (eventName === 'Page View') {
+    const mappedEvent = 'ViewContent';
+    return mappedEvent;
+  }
   if (!eventMapping) return eventName;
   return eventMapping[eventName] || eventName;
 }
@@ -680,7 +686,9 @@ function trackFacebookEvent(eventName, properties, eventMapping) {
     if (properties['predicted_ltv'] !== undefined) fbParams['predicted_ltv'] = properties['predicted_ltv'];
     window.fbq('track', fbEventName, fbParams);
   } else {
-    window.fbq('track', fbEventName);
+    const isStandardEvent = standardFacebookEvents.includes(fbEventName);
+    const trackType = isStandardEvent ? 'track' : 'trackCustom';
+    window.fbq(trackType, fbEventName);
   }
 }
 function coerceMetaConversionsAmValues(properties) {
@@ -941,10 +949,9 @@ class IntegrationManager {
       if (integration.init) {
         try {
           state.status = 'loading';
-          this.logger.log(`init ${integration.name}`);
           yield integration.init();
           state.status = 'ready';
-          this.logger.log(`ready ${integration.name}`);
+          this.logger.log(`${integration.name} integration ready`);
           this.flush();
         } catch (e) {
           state.status = 'error';
@@ -1051,11 +1058,9 @@ class IntegrationManager {
     if (this.config.flushInterval <= 0) return;
     this.flushTimer = setInterval(() => {
       if (this.globalQueue.length > 0) {
-        this.logger.log('periodic flush triggered');
         this.flush();
       }
     }, this.config.flushInterval);
-    this.logger.log(`periodic flushing enabled: ${this.config.flushInterval}ms`);
   }
   /**
    * Setup page unload handler for client environment
@@ -1071,7 +1076,6 @@ class IntegrationManager {
     // Use both beforeunload and pagehide for better coverage
     window.addEventListener('beforeunload', this.unloadHandler);
     window.addEventListener('pagehide', this.unloadHandler);
-    this.logger.log('page unload handlers registered');
   }
   /** Debug helpers */
   getStats() {
@@ -1313,6 +1317,10 @@ class Saasco {
     });
     // Set initial context
     this.integrationManager.setContext({});
+    // Initialize integrations immediately (works on both client and server)
+    this.initIntegrations().catch(error => {
+      this.logger.log('Error initializing integrations:', error);
+    });
   }
   init() {
     if (this.isInitialized) {
@@ -1328,10 +1336,6 @@ class Saasco {
     this.logger.log('Saasco initialized', this.config);
     if (this.config.debug) this.logger.log('Debug mode active. This will log all events to the console.');
     if (!this.config.enabled) this.logger.log('Analytics is disabled. No requests will be sent to the server.');
-    // Initialize integrations asynchronously
-    this.initIntegrations().catch(error => {
-      this.logger.log('Error initializing integrations:', error);
-    });
     this.initAutoPageTracking();
     this.isInitialized = true;
   }
@@ -1615,4 +1619,4 @@ const browserContextSchema = z.object({
   $utmAdId: z.string().nullable()
 });
 
-export { IntegrationManager, Logger, Saasco, browserContextSchema, createFacebookPixelIntegration, getBrowserContext, initializeFacebookPixel, timezones, trackFacebookEvent };
+export { IntegrationManager, Logger, Saasco, browserContextSchema, createFacebookPixelIntegration, getBrowserContext, initializeFacebookPixel, standardFacebookEvents, timezones, trackFacebookEvent };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "saasco-sdk",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "dependencies": {
     "tslib": "^2.3.0",
     "@lukeed/uuid": "^2.0.1",

package/src/lib/integrations/facebook-pixel.d.ts

@@ -17,7 +17,8 @@ export type FacebookPixelConfig = {
     pixelId: string;
     eventMapping?: FacebookEventMapping;
 };
-export type StandardFacebookEvent = 'AddPaymentInfo' | 'AddToCart' | 'AddToWishlist' | 'CompleteRegistration' | 'Contact' | 'CustomizeProduct' | 'Donate' | 'FindLocation' | 'InitiateCheckout' | 'Lead' | 'Purchase' | 'Schedule' | 'Search' | 'StartTrial' | 'SubmitApplication' | 'Subscribe' | 'ViewContent';
+export declare const standardFacebookEvents: readonly ["AddPaymentInfo", "AddToCart", "AddToWishlist", "CompleteRegistration", "Contact", "CustomizeProduct", "Donate", "FindLocation", "InitiateCheckout", "Lead", "Purchase", "Schedule", "Search", "StartTrial", "SubmitApplication", "Subscribe", "ViewContent"];
+export type StandardFacebookEvent = (typeof standardFacebookEvents)[number];
 /**
  * Create a Facebook Pixel integration instance
  */