saasco-sdk 0.1.43 → 0.1.44

package/package.json

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

package/src/lib/analytics.d.ts

@@ -1,4 +1,5 @@
 import { FacebookPixelIntegrationConfig } from './integrations/facebook-pixel';
+import { PinterestTagIntegrationConfig } from './integrations/pinterest-tag';
 import { TikTokPixelIntegrationConfig } from './integrations/tiktok-pixel';
 declare global {
     interface Window {
@@ -29,8 +30,9 @@ type DoRequestResponse = {
 export type IntegrationConfigBase = {
     type: string;
     config: Record<string, any>;
+    debug?: boolean;
 };
-export type IntegrationsConfig = (FacebookPixelIntegrationConfig | TikTokPixelIntegrationConfig)[];
+export type IntegrationsConfig = (FacebookPixelIntegrationConfig | PinterestTagIntegrationConfig | TikTokPixelIntegrationConfig)[];
 export declare class Saasco {
     private config;
     private lastPageViewPath;
@@ -59,6 +61,7 @@ export declare class Saasco {
         };
         enabled?: boolean;
         debug?: boolean;
+        debugVerbose?: boolean;
         integrations?: IntegrationsConfig;
     });
     init(): void;
@@ -114,5 +117,18 @@ export declare class Saasco {
      * @returns
      */
     private initAutoPageTracking;
+    getIntegrationsStats(): {
+        currentEnvironment: import("./integrations/integration-manager").IntegrationEnvironment;
+        integrations: {
+            name: string;
+            status: import("./integrations/integration-manager").IntegrationStatus;
+            environments: import("./integrations/integration-manager").IntegrationEnvironment[];
+        }[];
+        queueLength: number;
+        readyCount: number;
+        periodicFlushEnabled: boolean;
+        flushInterval: number;
+        context: import("./integrations/integration-manager").AnalyticsContext;
+    };
 }
 export {};

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

@@ -31,4 +31,4 @@ export type StandardFacebookEvent = (typeof standardFacebookEvents)[number];
 /**
  * Create a Facebook Pixel integration instance
  */
-export declare function createFacebookPixelIntegration(config: FacebookPixelConfig): Integration;
+export declare function createFacebookPixelIntegration(config: FacebookPixelConfig, debug?: boolean): Integration;

package/src/lib/integrations/index.d.ts

@@ -1,3 +1,4 @@
 export * from './integration-manager';
 export * from './facebook-pixel';
+export * from './pinterest-tag';
 export * from './tiktok-pixel';

package/src/lib/integrations/integration-manager.d.ts

@@ -1,3 +1,4 @@
+import { LogLevel } from '../utils';
 export type EventType = 'identify' | 'track';
 export type AnalyticsContext = {
     distinctId?: string | null;
@@ -26,7 +27,7 @@ export type Integration = {
     /**
      * The function to initialize the integration
      */
-    init?: () => Promise<void> | void;
+    init?: (context?: AnalyticsContext) => Promise<void> | void;
     /**
      * The function to track an event
      */
@@ -43,9 +44,9 @@ export type IntegrationState = {
 };
 export type ManagerConfig = {
     /**
-     * Enable debug mode
+     * Enable logger level
      */
-    debug?: boolean;
+    loggerLevel?: LogLevel;
     /**
      * Max queue size, once it exceeds this number, the oldest event will be dropped
      */
@@ -59,14 +60,6 @@ export type ManagerConfig = {
      */
     flushInterval?: number;
 };
-export declare class Logger {
-    private label;
-    private debug;
-    constructor(label?: string, debug?: boolean);
-    log(...args: unknown[]): void;
-    warn(...args: unknown[]): void;
-    error(...args: unknown[]): void;
-}
 export declare class IntegrationManager {
     private context;
     private integrations;
@@ -121,5 +114,6 @@ export declare class IntegrationManager {
         readyCount: number;
         periodicFlushEnabled: boolean;
         flushInterval: number;
+        context: AnalyticsContext;
     };
 }

package/src/lib/integrations/pinterest-tag.d.ts

@@ -0,0 +1,37 @@
+import { IntegrationConfigBase } from '../analytics';
+import { Integration } from './integration-manager';
+declare global {
+    interface Window {
+        pintrk?: Pintrk;
+        _pintrk?: Pintrk;
+    }
+    interface Pintrk {
+        (...args: any[]): void;
+        queue?: any[];
+        loaded?: boolean;
+        version?: string;
+    }
+}
+export type PinterestEventMapping = {
+    [key: string]: StandardPinterestEvent;
+};
+export type PinterestTagIntegrationConfig = IntegrationConfigBase & {
+    type: 'pinterest-tag';
+    config: PinterestTagConfig;
+};
+export type PinterestTagConfig = {
+    tagId: string;
+    eventMapping?: PinterestEventMapping;
+    automaticConfiguration?: boolean;
+};
+/**
+ * Standard Pinterest events
+ * Reference: https://www.pinterest.com/_/_/help/business/article/event-code
+ */
+export declare const standardPinterestEvents: readonly ["checkout", "addtocart", "pagevisit", "signup", "watchvideo", "lead", "search", "viewcategory", "custom", "addpaymentinfo", "addtowishlist", "initiatecheckout", "subscribe", "viewcontent"];
+export type StandardPinterestEvent = (typeof standardPinterestEvents)[number];
+/**
+ * Create a Pinterest Tag integration instance
+ * Documentation: https://help.pinterest.com/en/business/article/install-the-pinterest-tag
+ */
+export declare function createPinterestTagIntegration(config: PinterestTagConfig, debug?: boolean): Integration;

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

@@ -56,4 +56,4 @@ export type StandardTikTokEvent = (typeof standardTikTokEvents)[number];
 /**
  * Create a TikTok Pixel integration instance
  */
-export declare function createTikTokPixelIntegration(config: TikTokPixelConfig): Integration;
+export declare function createTikTokPixelIntegration(config: TikTokPixelConfig, debug?: boolean): Integration;

package/src/lib/utils/getIntegrationLoggerLevel.d.ts

@@ -0,0 +1,8 @@
+import { LogLevel } from './logger';
+export declare const isServer: boolean;
+/**
+ * Get the logger level for a specific integration
+ * Supports URL parameters like saasco-debug-{integration-type}=true
+ * If debug is true or URL param is true, sets level to DEBUG (3), otherwise WARN
+ */
+export declare function getIntegrationLoggerLevel(integrationName: string, debug?: boolean): LogLevel;

package/src/lib/utils/index.d.ts

@@ -1,2 +1,3 @@
 export * from './logger';
+export * from './getIntegrationLoggerLevel';
 export * from './uuid';

package/src/lib/utils/logger.d.ts

@@ -1,14 +1,21 @@
+export declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3
+}
 export type AnalyticsLoggerConfig = {
-    debug: boolean;
+    level: LogLevel;
     label: string;
 };
 export declare class AnalyticsLogger {
     private config;
     constructor(config: AnalyticsLoggerConfig);
+    debug(...args: any[]): void;
     /**
      * Log debug information
      */
-    log(...args: any[]): void;
+    info(...args: any[]): void;
     /**
      * Log warning information
      */