@sitepulse/web 1.0.0

package/dist/evaluator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * SitePulse Campaign Trigger & Audience Evaluation Engine (§8.3)
+ *
+ * Evaluates triggers (delay, scroll_percent, exit_intent, click, event)
+ * and matches audience rules against locally known visitor state.
+ *
+ * SILENT FAILURE GUARANTEE:
+ * All evaluations are enclosed in defensive try/catch blocks.
+ * A broken selector, malformed regex, or missing browser API will
+ * fail gracefully and silently without throwing into the host page.
+ */
+import { Trigger, Audience } from "@sitepulse/types";
+export interface VisitorAudienceState {
+    isNewVisitor: boolean;
+    deviceType: "desktop" | "mobile" | "tablet";
+    pathname: string;
+    sessionCount: number;
+}
+export declare function evaluateAudience(audience: Audience | undefined, state: VisitorAudienceState): boolean;
+export declare function attachTrigger(trigger: Trigger | undefined, onTriggered: () => void): () => void;

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+import { CampaignActionHandlers } from "./renderer";
+import type { Campaign } from "@sitepulse/types";
+export * from "./renderer";
+export * from "./evaluator";
+export interface SitePulseConfig {
+    siteId: string;
+    endpointUrl?: string;
+    campaignsEndpointUrl?: string;
+    flushIntervalMs?: number;
+    autoTrack?: boolean;
+    autoFetchCampaigns?: boolean;
+}
+export interface IngestPayloadEvent {
+    eventName: string;
+    anonymousId: string;
+    sessionId: string;
+    userId?: string;
+    properties: Record<string, unknown>;
+    page: {
+        url: string;
+        referrer?: string;
+        title?: string;
+    };
+    deviceType?: "desktop" | "mobile" | "tablet";
+    browser?: string;
+    os?: string;
+    timestamp: string;
+}
+declare class SitePulseClient {
+    private config;
+    private queue;
+    private flushTimer;
+    private initialized;
+    private lastUrl;
+    private registeredCampaignTeardowns;
+    init(config: SitePulseConfig): void;
+    track(eventName: string, properties?: Record<string, unknown>): void;
+    page(properties?: Record<string, unknown>): void;
+    flush(isUnloading?: boolean): void;
+    /**
+     * Fetches active campaigns for this site from the endpoint, caches in sessionStorage,
+     * and automatically registers each active campaign. (§8.3)
+     */
+    fetchAndRegisterActiveCampaigns(): Promise<void>;
+    /**
+     * Directly renders a Campaign into the DOM using the fixed block renderer.
+     * (§8.3 & §3.2: Zero-innerHTML guaranteed)
+     */
+    renderCampaign(campaign: Campaign, handlers?: CampaignActionHandlers): {
+        destroy: () => void;
+    } | null;
+    /**
+     * Registers a Campaign: Evaluates audience rules and trigger signals,
+     * then mounts DOM when matched. Returns a teardown function.
+     */
+    registerCampaign(campaign: Campaign): () => void;
+    private autoCapturePageViews;
+    private checkRouteChange;
+}
+export declare const SitePulse: SitePulseClient;
+export default SitePulse;