@active-reach/web-sdk 1.0.0

package/dist/widgets/AegisWidgetManager.d.ts

@@ -0,0 +1,194 @@
+/**
+ * AegisWidgetManager - Web SDK Widget Module
+ *
+ * Smart Pull architecture for persistent web widgets.
+ *
+ * Features:
+ * - Gamification (spin wheel, scratch card) with server-side prize generation
+ * - Chat bubbles (WhatsApp, support)
+ * - Social proof toasts (real-time purchase notifications)
+ * - Feedback forms (NPS, surveys)
+ *
+ * Security:
+ * - XSS Protection: Uses DOM APIs instead of innerHTML
+ * - Server-side prize generation prevents client manipulation
+ * - URL validation prevents javascript: protocol injection
+ *
+ * Architecture:
+ * - Fetches widget configs from /v1/widgets/config on page load
+ * - Integrates with TriggerEngine for behavioral triggers
+ * - Tracks widget events (show, click, dismiss, submit)
+ * - Server-side prize generation for gamification
+ */
+import { TriggerEngine } from '../triggers/TriggerEngine';
+export interface WidgetConfig {
+    widget_id: string;
+    widget_type: 'chat_bubble' | 'spin_wheel' | 'scratch_card' | 'toast' | 'feedback_form' | 'exit_intent_popup';
+    name: string;
+    config: Record<string, any>;
+    position?: string;
+    priority: number;
+    trigger_rules?: {
+        type: 'exit_intent' | 'scroll_depth' | 'time_on_page' | 'immediate';
+        config?: Record<string, any>;
+    };
+}
+export interface GamificationPrize {
+    prize_label: string;
+    prize_value?: string;
+    coupon_code?: string;
+    play_id: string;
+}
+export interface AegisWidgetConfig {
+    writeKey: string;
+    apiHost?: string;
+    userId?: string;
+    contactId?: string;
+    organizationId?: string;
+    debugMode?: boolean;
+    triggerEngine?: TriggerEngine;
+    enablePrefetch?: boolean;
+    cssCustomization?: WidgetCSSCustomization;
+    onEvent?: (eventType: string, data: any) => void;
+    /** Source platform passed as X-Source-Platform header so the API
+     *  can filter campaigns whose display_rules.sources restricts them
+     *  to specific integrations (e.g. 'shopify', 'woocommerce'). */
+    sourcePlatform?: 'web' | 'shopify' | 'woocommerce' | 'mobile_sdk';
+}
+export interface WidgetCSSCustomization {
+    exitIntent?: {
+        backgroundColor?: string;
+        textColor?: string;
+        accentColor?: string;
+        borderRadius?: string;
+        fontFamily?: string;
+        overlayOpacity?: number;
+    };
+    spinWheel?: {
+        backgroundColor?: string;
+        textColor?: string;
+        accentColor?: string;
+        borderRadius?: string;
+        fontFamily?: string;
+        wheelColors?: string[];
+        buttonColor?: string;
+    };
+    chatBubble?: {
+        backgroundColor?: string;
+        textColor?: string;
+        position?: 'bottom_right' | 'bottom_left' | 'top_right' | 'top_left';
+        size?: 'small' | 'medium' | 'large';
+    };
+}
+export interface PrefetchWidgetConfig {
+    exit_intent?: {
+        enabled: boolean;
+        type: 'cart_recovery' | 'lead_gen';
+        tier?: string;
+        title?: string;
+        message?: string;
+        discount_code?: string;
+        discount_percentage?: number;
+        cta_text?: string;
+        cta_url?: string;
+        background_color?: string;
+        text_color?: string;
+        accent_color?: string;
+        show_cart_items?: boolean;
+        show_timer?: boolean;
+        timer_minutes?: number;
+        priority: number;
+        mobile_triggers?: {
+            scroll_velocity?: boolean;
+            scroll_threshold?: number;
+            scroll_min_position?: number;
+            scroll_cooldown?: number;
+            idle_timer?: boolean;
+            idle_seconds?: number;
+            visibility_change?: boolean;
+            back_button?: boolean;
+        };
+    };
+    spin_wheel?: {
+        enabled: boolean;
+        type: 'lead_gen' | 'cart_recovery';
+        title?: string;
+        prizes?: any[];
+        priority: number;
+    };
+}
+export interface CartData {
+    cart_id: string;
+    cart_total: number;
+    cart_currency: string;
+    cart_items: Array<{
+        product_id: string;
+        product_name?: string;
+        quantity: number;
+        price?: number;
+    }>;
+}
+export declare class AegisWidgetManager {
+    private writeKey;
+    private apiHost;
+    private userId?;
+    private contactId?;
+    private organizationId?;
+    private debugMode;
+    private triggerEngine?;
+    private enablePrefetch;
+    private cssCustomization;
+    private onEvent?;
+    private sourcePlatform?;
+    private widgets;
+    private renderedWidgets;
+    private isInitialized;
+    private prefetchWidgetConfigs;
+    private cartData?;
+    constructor(config: AegisWidgetConfig);
+    updateCSSCustomization(customization: WidgetCSSCustomization): void;
+    private emitEvent;
+    initialize(): Promise<void>;
+    setCartData(cartData: CartData): void;
+    private detectPlatformCart;
+    private normalizeShopifyCart;
+    private normalizeWooCart;
+    private normalizeMagentoCart;
+    private preloadWidgetAssets;
+    private fetchPrefetchConfigs;
+    private fetchWidgets;
+    private renderImmediateWidgets;
+    private setupTriggerListeners;
+    private setupExitIntentWithPrefetch;
+    private sendCartAbandonmentBeacon;
+    private renderWidget;
+    private renderChatBubble;
+    private renderSpinWheel;
+    private renderSpinWheelWidget;
+    private validatePhone;
+    private validateEmail;
+    private submitSpinWheel;
+    private showSpinWheelPrize;
+    private detectGeoRegion;
+    private getUTMParams;
+    private getSessionId;
+    private getAnonymousId;
+    private renderScratchCard;
+    private renderToast;
+    private renderFeedbackForm;
+    private renderExitIntentPopup;
+    private generatePrize;
+    private showPrizeResult;
+    private submitFeedback;
+    private trackEvent;
+    private sanitizeUrl;
+    private sanitizeColor;
+    private getDeviceType;
+    private isMobileDevice;
+    private addAnimationStyles;
+    private renderCartRecoveryPopup;
+    private renderLeadGenPopup;
+    private interpolateCartVariables;
+    private log;
+}
+//# sourceMappingURL=AegisWidgetManager.d.ts.map

package/dist/widgets/AegisWidgetManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AegisWidgetManager.d.ts","sourceRoot":"","sources":["../../src/widgets/AegisWidgetManager.ts"],"names":[],"mappings":"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"}

package/dist/widgets/index.d.ts

@@ -0,0 +1,3 @@
+export { AegisWidgetManager } from './AegisWidgetManager';
+export type { WidgetConfig, GamificationPrize, AegisWidgetConfig } from './AegisWidgetManager';
+//# sourceMappingURL=index.d.ts.map

package/dist/widgets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/widgets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@active-reach/web-sdk",
+  "version": "1.0.0",
+  "description": "Web SDK for Active Reach Intelligence — event tracking, identity resolution, in-app messaging, web push, and placements",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "browser": "./dist/aegis.min.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/integrations/react.d.ts",
+      "import": "./dist/react.js",
+      "default": "./dist/react.js"
+    },
+    "./push": {
+      "types": "./dist/push/AegisWebPush.d.ts",
+      "import": "./dist/push/AegisWebPush.js",
+      "default": "./dist/push/AegisWebPush.js"
+    },
+    "./cdn": "./dist/aegis.min.js",
+    "./snippet": "./dist/snippet.min.js",
+    "./service-worker": "./dist/aegis-sw.js"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "analytics",
+    "tracking",
+    "customer-data",
+    "web-sdk",
+    "event-tracking",
+    "active-reach",
+    "active-reach-intelligence",
+    "marketing-automation"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "vite build && node scripts/build-cdn.js && npm run build:snippet && npm run build:types",
+    "build:snippet": "node scripts/minify-snippet.js",
+    "build:types": "tsc --project tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts,.tsx",
+    "typecheck": "tsc --noEmit",
+    "dev": "vite build --watch"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/react": "^18.3.1",
+    "typescript": "^5.6.2",
+    "vite": "^6.4.2",
+    "vitest": "^3.2.1",
+    "eslint": "^9.16.0",
+    "terser": "^5.27.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  }
+}