@active-reach/web-sdk 1.0.0

package/dist/inapp/AegisInAppManager.d.ts

@@ -0,0 +1,126 @@
+/**
+ * AegisInAppManager - Web SDK In-App Messaging Module
+ *
+ * Real-time SSE architecture with client-side evaluation.
+ *
+ * Security:
+ * - XSS Protection: Uses DOM APIs (createElement, textContent) instead of innerHTML
+ * - URL Validation: Prevents javascript: protocol injection
+ * - CSP Compatible: No inline styles in HTML strings
+ *
+ * Architecture:
+ * - Connects to SSE endpoint for real-time campaign updates
+ * - Initial fetch on load, then SSE for updates
+ * - Caches campaigns locally in memory
+ * - Evaluates trigger rules client-side
+ * - Tracks events (impression, click, dismiss) asynchronously
+ */
+export interface InAppCampaign {
+    id: string;
+    type: 'modal' | 'banner' | 'tooltip' | 'full_screen' | 'half_interstitial' | 'alert' | 'pip';
+    sub_type?: string;
+    title: string;
+    body: string;
+    image_url?: string;
+    video_url?: string;
+    action_url?: string;
+    button_text?: string;
+    background_color?: string;
+    text_color?: string;
+    priority: number;
+    expires_at?: string;
+    frequency?: {
+        max_impressions?: number;
+        max_impressions_per_day?: number;
+        cooldown_seconds?: number;
+    };
+    interactive_config?: Record<string, unknown>;
+    client_trigger?: {
+        type: string;
+        config?: Record<string, unknown>;
+    };
+    assigned_variant_id?: string;
+}
+export interface AegisInAppConfig {
+    writeKey: string;
+    apiHost?: string;
+    userId?: string;
+    contactId?: string;
+    organizationId?: string;
+    debugMode?: boolean;
+    enableSSE?: boolean;
+}
+export declare class AegisInAppManager {
+    private writeKey;
+    private apiHost;
+    private userId?;
+    private contactId?;
+    private organizationId?;
+    private debugMode;
+    private enableSSE;
+    private campaigns;
+    private displayedCampaigns;
+    private eventSource?;
+    private isInitialized;
+    private reconnectAttempts;
+    private maxReconnectAttempts;
+    constructor(config: AegisInAppConfig);
+    initialize(): Promise<void>;
+    updateUserId(userId: string): void;
+    updateContactId(contactId: string): void;
+    private connectSSE;
+    private disconnectSSE;
+    private attemptReconnect;
+    private refreshCampaigns;
+    private detectDeviceType;
+    private isNewUser;
+    private getABAssignments;
+    private processABAssignments;
+    private getVariantId;
+    private tryDisplayNextCampaign;
+    private displayCampaign;
+    /**
+     * Renders interactive sub-type campaigns (spin wheel, NPS, quiz, etc.)
+     * using DOM-safe rendering. These sub-types use the campaign's
+     * interactive_config payload for type-specific behavior.
+     */
+    private renderInteractive;
+    private renderNPSSurvey;
+    private renderCountdownOffer;
+    private renderStarRating;
+    private renderQuickPoll;
+    private renderQuiz;
+    private createOverlay;
+    private createCTAButton;
+    private addCloseButton;
+    private renderBanner;
+    private renderModal;
+    private renderFullScreen;
+    private renderHalfInterstitial;
+    private renderAlert;
+    private renderPIP;
+    private removeBanner;
+    private removeModal;
+    private renderTooltip;
+    private addAnimationStyles;
+    private sanitizeUrl;
+    private sanitizeColor;
+    /**
+     * Track in-app event via the standard Event Ingress pipeline.
+     *
+     * Events flow: SDK → Event Ingress → Kafka → Governance Consumer
+     * → Event Engine → ClickHouse (in_app_events + events_with_ttl)
+     *
+     * The event_type uses the canonical prefix `in_app.` so the event
+     * switchboard maps it to the correct canonical form:
+     *   in_app.impression → engagement.view
+     *   in_app.clicked    → engagement.click
+     *   in_app.dismissed  → engagement.dismiss
+     */
+    private trackEvent;
+    private log;
+    destroy(options?: {
+        clearABState?: boolean;
+    }): void;
+}
+//# sourceMappingURL=AegisInAppManager.d.ts.map

package/dist/inapp/AegisInAppManager.d.ts.map

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

package/dist/inapp/index.d.ts

@@ -0,0 +1,4 @@
+export { AegisInAppManager } from './AegisInAppManager';
+export type { InAppCampaign, AegisInAppConfig } from './AegisInAppManager';
+export { renderPreview } from './renderPreview';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/inapp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/inapp/renderPreview.d.ts

@@ -0,0 +1,25 @@
+/**
+ * renderPreview — Static Preview Renderer for Dashboard iframe (Critical Fix A)
+ *
+ * Used exclusively by the sandboxed iframe preview route
+ * (`/api/preview/in-app/route.tsx`). Renders a single campaign into the
+ * current document body using the same rendering logic as the production SDK.
+ *
+ * Data flow:
+ *   editor-sidebar.tsx → onChange → formState → postMessage({type:'preview_update', config})
+ *   → iframe receives message → calls renderPreview(config)
+ *
+ * This ensures 100% fidelity between the dashboard editor preview and
+ * production rendering — both use the same SDK code.
+ */
+import type { InAppCampaign } from './AegisInAppManager';
+/**
+ * Renders a single in-app campaign into the current document for preview.
+ *
+ * Creates a temporary AegisInAppManager with preview-only config (no tracking,
+ * no SSE, no network requests). Calls the same rendering pipeline as production.
+ */
+export declare function renderPreview(config: InAppCampaign & {
+    interactive_config?: Record<string, unknown>;
+}): void;
+//# sourceMappingURL=renderPreview.d.ts.map

package/dist/inapp/renderPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderPreview.d.ts","sourceRoot":"","sources":["../../src/inapp/renderPreview.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAoC5G"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { Aegis } from './core/analytics';
+declare const aegis: Aegis;
+export default aegis;
+export { Aegis } from './core/analytics';
+export type { AegisConfig, CellEndpoint, CellRegion } from './types/config';
+export type { AegisEvent, TrackEvent, IdentifyEvent, PageEvent, GroupEvent, AliasEvent, EventContext, BatchPayload, BatchResponse, } from './types/events';
+export type { Plugin, PluginRegistry } from './types/plugin';
+export { debounce, throttle } from './utils/debounce';
+export type { ConsentPreferences, ConsentCategory, ConsentStatus, } from './utils/consent';
+export { AegisInAppManager } from './inapp';
+export type { InAppCampaign, AegisInAppConfig } from './inapp';
+export { renderPreview } from './inapp';
+export { AegisPlacementManager } from './placements/AegisPlacementManager';
+export type { PlacementContent, PlacementSlot, AegisPlacementConfig, } from './placements/AegisPlacementManager';
+export { AegisWidgetManager } from './widgets';
+export type { WidgetConfig, GamificationPrize, AegisWidgetConfig, } from './widgets';
+export { TriggerEngine } from './triggers';
+export type { TriggerRule, ScrollDepthConfig, TimeOnPageConfig, ExitIntentConfig, InactivityConfig, TriggerEvent, } from './triggers';
+export { SdkConfigPoller } from './core/sdk-config-poller';
+export type { SdkConfig, SdkConfigPollerOptions, ConfigChangeCallback } from './core/sdk-config-poller';
+export { AegisWebPush } from './push/AegisWebPush';
+export type { AegisWebPushConfig, AegisAPIClient, ContactIdentity, PushEventTracker, } from './push/AegisWebPush';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,QAAA,MAAM,KAAK,OAAc,CAAC;AAE1B,eAAe,KAAK,CAAC;AAErB,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,oBAAoB,GACrB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAExG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}