sitepong 0.2.1 → 0.2.2

package/dist/index.d.mts

@@ -157,6 +157,137 @@ declare global {
     }
 }
 
+interface AutocaptureEvent {
+    type: 'click' | 'form_submit' | 'page_view';
+    timestamp: string;
+    properties: Record<string, unknown>;
+}
+
+/**
+ * Watchtower Web Tap Capture (Phase P3)
+ *
+ * Captures tap/screen_view/session lifecycle events per the Watchtower wire
+ * contract (docs/watchtower-mobile-spec.md §1) and uploads masked screen
+ * templates on fingerprint miss (§1.2).
+ *
+ * - Tap events come from the EXISTING autocapture click path (no duplicate
+ *   listeners) — the AutocaptureModule's selector/element resolution is reused.
+ * - Screen fingerprints are dHash'd (via @sitepong/capture-core, the reference
+ *   implementation) over a masked rasterization of the page. Rasterization is
+ *   done with the SVG-foreignObject trick over the replay serializer's masked
+ *   structural snapshot, always off the hot path (idle callbacks, throttled).
+ * - The click handler itself only records + enqueues; batching is 50 events /
+ *   10 s / pagehide. Rage classification is server-side — never sent here.
+ */
+
+/** Result of rasterizing the (already masked) page. */
+interface RasterResult {
+    /** Tightly packed RGBA bytes, width*height*4. */
+    rgba: Uint8Array;
+    width: number;
+    height: number;
+    /** Base64 PNG of the same masked canvas, or null when encoding failed. */
+    pngBase64: string | null;
+}
+interface PageRasterizer {
+    /** Resolve null (never throw) when the page cannot be rasterized. */
+    rasterize(): Promise<RasterResult | null>;
+}
+interface TransportResponse {
+    ok: boolean;
+    status: number;
+}
+type TapTransport = (url: string, body: string, opts: {
+    headers: Record<string, string>;
+    keepalive?: boolean;
+}) => Promise<TransportResponse>;
+/** Anything exposing the AutocaptureModule secondary-listener API. */
+interface AutocaptureSource {
+    addListener(cb: (event: AutocaptureEvent) => void): () => void;
+}
+interface WatchtowerCaptureConfig {
+    apiKey: string;
+    projectId: string;
+    /** Base endpoint — events go to `${endpoint}/api/taps`, templates to `${endpoint}/api/taps/template`. */
+    endpoint: string;
+    appVersion?: string;
+    /** Flush when the queue reaches this size (spec §1.3, default 50). */
+    maxBatchSize?: number;
+    /** Flush interval in ms (spec §1.3, default 10000). */
+    flushInterval?: number;
+    /** Min ms between rasterizations of the same route (default 1000). */
+    templateThrottleMs?: number;
+    /** Extra CSS selector blocked (greyed out) in the masked snapshot. */
+    blockSelector?: string;
+    /** CSS selector whose text is masked in the snapshot. */
+    maskSelector?: string;
+    debug?: boolean;
+    /** Injectable rasterizer (tests). Defaults to the DOM SVG-foreignObject rasterizer. */
+    rasterizer?: PageRasterizer;
+    /** Injectable transport (tests). Defaults to fetch. */
+    transport?: TapTransport;
+}
+declare class WatchtowerWebCapture {
+    private config;
+    private session;
+    private queue;
+    private flushTimer;
+    private flushFailures;
+    private disabled;
+    private active;
+    private distinctId;
+    private currentScreen;
+    private transport;
+    private rasterizer;
+    private detachAutocapture;
+    private ownAutocapture;
+    private originalPushState;
+    private originalReplaceState;
+    private popstateHandler;
+    private pagehideHandler;
+    private fpCache;
+    private uploadedFps;
+    private lastRasterAt;
+    private rasterInFlight;
+    constructor(config: WatchtowerCaptureConfig);
+    /**
+     * Start capturing. Pass the existing AutocaptureModule (via
+     * AnalyticsManager.getAutocaptureModule()) to reuse its click listener +
+     * selector resolution; when absent, a private clicks-only module is created.
+     */
+    start(source?: AutocaptureSource | null): void;
+    stop(): void;
+    isActive(): boolean;
+    getSessionId(): string;
+    /** Stamped as distinct_id on every subsequent event (identify() feeds this). */
+    setDistinctId(distinctId: string | null): void;
+    private onAutocaptureEvent;
+    /** Record a tap. Coordinates are viewport CSS px; normalization happens here. */
+    recordTap(input: {
+        selector: string;
+        label?: string;
+        role?: string;
+        clientX: number;
+        clientY: number;
+    }): void;
+    private setupNavigationTracking;
+    private handleRouteChange;
+    private setupPagehide;
+    private baseEvent;
+    private enqueue;
+    private startFlushTimer;
+    flush(opts?: {
+        keepalive?: boolean;
+    }): Promise<void>;
+    private headers;
+    private scheduleFingerprint;
+    private captureFingerprint;
+    private maybeUploadTemplate;
+    private combinedBlockSelector;
+    private pathname;
+    private log;
+}
+
 declare class ReplayManager {
     private config;
     private recording;
@@ -999,6 +1130,7 @@ interface WebManagerFactories {
     createReplay?: (cfg: Record<string, unknown>) => ReplayManager;
     createFingerprint?: (cfg: Record<string, unknown>) => FingerprintManager;
     createPerformance?: (cfg: Record<string, unknown>) => PerformanceManager;
+    createWatchtowerCapture?: (cfg: Record<string, unknown>) => WatchtowerWebCapture;
 }
 /**
  * Platform-entry-only: inject web-only manager factories. Called by
@@ -1069,6 +1201,22 @@ interface SitePongInitConfig extends SitePongConfig {
         /** Rolling buffer duration in ms — how many seconds of replay to keep before an error (default: 20000) */
         bufferDuration?: number;
     };
+    /** Watchtower tap capture (web) — tap timeline events + masked screen templates */
+    watchtower?: {
+        enabled?: boolean;
+        /** Project ID sent as X-Project-ID on /api/taps requests (required) */
+        projectId?: string;
+        /** Override base endpoint for /api/taps + /api/taps/template (default: main endpoint) */
+        endpoint?: string;
+        /** Flush at this many buffered events (default: 50) */
+        maxBatchSize?: number;
+        /** Flush interval in ms (default: 10000) */
+        flushInterval?: number;
+        /** Extra CSS selector blocked out of the masked screen template */
+        blockSelector?: string;
+        /** CSS selector whose text is masked in the screen template */
+        maskSelector?: string;
+    };
     /** Cron monitoring configuration */
     crons?: {
         enabled?: boolean;
@@ -1117,6 +1265,8 @@ declare class SitePongClient {
     private databaseTracker;
     private profiler;
     private remoteConfigManager;
+    private watchtowerCapture;
+    private watchtowerOptions;
     private currentScreen?;
     private envUnsubs;
     private identifyHooks;
@@ -1179,6 +1329,13 @@ declare class SitePongClient {
     stopReplay(): void;
     isReplayRecording(): boolean;
     getReplaySessionId(): string | null;
+    /**
+     * Start Watchtower web tap capture. Options merge over `watchtower` from
+     * init(); `projectId` is required (either here or in init config). Reuses
+     * the analytics AutocaptureModule's click listener when autocapture is on.
+     */
+    startWatchtowerCapture(options?: SitePongInitConfig['watchtower']): boolean;
+    stopWatchtowerCapture(): void;
     startTransaction(name: string, data?: Record<string, unknown>): string;
     endTransaction(id: string, status?: 'ok' | 'error'): void;
     startSpan(transactionId: string, name: string, data?: Record<string, unknown>): string;
@@ -1279,6 +1436,8 @@ declare const getDeviceSignals: () => Promise<DeviceSignals>;
 declare const getFraudCheck: () => Promise<FraudCheckResult>;
 declare const startReplay: () => boolean;
 declare const stopReplay: () => void;
+declare const startWatchtowerCapture: (options?: SitePongInitConfig["watchtower"]) => boolean;
+declare const stopWatchtowerCapture: () => void;
 declare const isReplayRecording: () => boolean;
 declare const getReplaySessionId: () => string | null;
 declare const startTransaction: (name: string, data?: Record<string, unknown>) => string;
@@ -1316,4 +1475,4 @@ declare const isRemoteConfigFeatureEnabled: (key: string, defaultValue?: boolean
 declare const onRemoteConfigChange: (listener: (config: RemoteConfig) => void) => () => void;
 declare const registerIdentifyHook: (hook: (userId: string) => void) => () => void;
 
-export { type CapturedError, type CronCheckinOptions, type CronHandle, DEFAULT_SUPERLINK_ENDPOINT, type DatabaseQueryEvent, type DatabaseTrackerConfig, type DeferredDeepLinkHandler, type DeviceInfo, type DeviceSignals, type EnvironmentAdapter, type ErrorContext, type FraudCheckResult, GroupTraits, type MetricOptions, type MutableRNEnvironmentAdapter, type PerformanceConfig, type PerformanceSpan, type PerformanceTransaction, type PlatformName, type ProfileData, type ProfileFrame, type ProfilerConfig, type RemoteConfig, type RemoteConfigFeatures, type RemoteConfigSampling, ReplayConfig, type ResourceTimingBreakdown, type SitePongConfig, type SitePongInitConfig, SuperLinkClient, type SuperLinkConfig, type SuperLinkDeepLink, type SuperLinkEventType, type SuperLinkFingerprint, type SuperLinkIdentityMetadata, type SuperLinkMatchRequest, type SuperLinkMatchResponse, type SuperLinkMatchType, type SuperLinkPlatform, type TraceContext, TracePropagator, TrackProperties, UserTraits, type VisitorIdResult, type WebManagerFactories, type WebVitals, addBreadcrumb, areFlagsReady, captureError, captureMessage, captureWebDeepLink, clearAnonymousId, clearUser, sitepong as client, completeFromScan, createTraceContext, cronCheckin, cronStart, cronWrap, dbTrack, dbTrackSync, sitepong as default, endSpan, endTransaction, extractIdentityMetadata, extractTrace, flush, flushMetrics, flushProfiles, generateSpanId, generateTraceId, getAllFlags, getAnonymousId, getDbNPlusOnePatterns, getDbQueryCount, getDeepLink, getDeviceSignals, getFlag, getFraudCheck, getLatestProfile, getMatchedDeepLink, getProfiles, getRemoteConfig, getReplaySessionId, getVariant, getVariantPayload, getVisitorId, getWebVitals, group, identify, init, initRN, initSuperLink, isInitialized, isRemoteConfigFeatureEnabled, isReplayRecording, metricDistribution, metricGauge, metricHistogram, metricIncrement, metricStartTimer, metricTime, onDeferredDeepLink, onRemoteConfigChange, parseUniversalLink, profile, propagateTrace, refreshFlags, registerIdentifyHook, registerWebManagerFactories, resetAnalytics, resetDbQueryCount, setAnonymousId, setContext, setCurrentScreen, setEnvironment, setRNGetCurrentScreen, setTags, setUser, startProfileSpan, startReplay, startSpan, startTransaction, stopReplay, superlinkClient, identify$1 as superlinkIdentify, track, trackPageView, waitForFlags, writeClipboardToken };
+export { type CapturedError, type CronCheckinOptions, type CronHandle, DEFAULT_SUPERLINK_ENDPOINT, type DatabaseQueryEvent, type DatabaseTrackerConfig, type DeferredDeepLinkHandler, type DeviceInfo, type DeviceSignals, type EnvironmentAdapter, type ErrorContext, type FraudCheckResult, GroupTraits, type MetricOptions, type MutableRNEnvironmentAdapter, type PerformanceConfig, type PerformanceSpan, type PerformanceTransaction, type PlatformName, type ProfileData, type ProfileFrame, type ProfilerConfig, type RemoteConfig, type RemoteConfigFeatures, type RemoteConfigSampling, ReplayConfig, type ResourceTimingBreakdown, type SitePongConfig, type SitePongInitConfig, SuperLinkClient, type SuperLinkConfig, type SuperLinkDeepLink, type SuperLinkEventType, type SuperLinkFingerprint, type SuperLinkIdentityMetadata, type SuperLinkMatchRequest, type SuperLinkMatchResponse, type SuperLinkMatchType, type SuperLinkPlatform, type TraceContext, TracePropagator, TrackProperties, UserTraits, type VisitorIdResult, type WebManagerFactories, type WebVitals, addBreadcrumb, areFlagsReady, captureError, captureMessage, captureWebDeepLink, clearAnonymousId, clearUser, sitepong as client, completeFromScan, createTraceContext, cronCheckin, cronStart, cronWrap, dbTrack, dbTrackSync, sitepong as default, endSpan, endTransaction, extractIdentityMetadata, extractTrace, flush, flushMetrics, flushProfiles, generateSpanId, generateTraceId, getAllFlags, getAnonymousId, getDbNPlusOnePatterns, getDbQueryCount, getDeepLink, getDeviceSignals, getFlag, getFraudCheck, getLatestProfile, getMatchedDeepLink, getProfiles, getRemoteConfig, getReplaySessionId, getVariant, getVariantPayload, getVisitorId, getWebVitals, group, identify, init, initRN, initSuperLink, isInitialized, isRemoteConfigFeatureEnabled, isReplayRecording, metricDistribution, metricGauge, metricHistogram, metricIncrement, metricStartTimer, metricTime, onDeferredDeepLink, onRemoteConfigChange, parseUniversalLink, profile, propagateTrace, refreshFlags, registerIdentifyHook, registerWebManagerFactories, resetAnalytics, resetDbQueryCount, setAnonymousId, setContext, setCurrentScreen, setEnvironment, setRNGetCurrentScreen, setTags, setUser, startProfileSpan, startReplay, startSpan, startTransaction, startWatchtowerCapture, stopReplay, stopWatchtowerCapture, superlinkClient, identify$1 as superlinkIdentify, track, trackPageView, waitForFlags, writeClipboardToken };

package/dist/index.d.ts

@@ -157,6 +157,137 @@ declare global {
     }
 }
 
+interface AutocaptureEvent {
+    type: 'click' | 'form_submit' | 'page_view';
+    timestamp: string;
+    properties: Record<string, unknown>;
+}
+
+/**
+ * Watchtower Web Tap Capture (Phase P3)
+ *
+ * Captures tap/screen_view/session lifecycle events per the Watchtower wire
+ * contract (docs/watchtower-mobile-spec.md §1) and uploads masked screen
+ * templates on fingerprint miss (§1.2).
+ *
+ * - Tap events come from the EXISTING autocapture click path (no duplicate
+ *   listeners) — the AutocaptureModule's selector/element resolution is reused.
+ * - Screen fingerprints are dHash'd (via @sitepong/capture-core, the reference
+ *   implementation) over a masked rasterization of the page. Rasterization is
+ *   done with the SVG-foreignObject trick over the replay serializer's masked
+ *   structural snapshot, always off the hot path (idle callbacks, throttled).
+ * - The click handler itself only records + enqueues; batching is 50 events /
+ *   10 s / pagehide. Rage classification is server-side — never sent here.
+ */
+
+/** Result of rasterizing the (already masked) page. */
+interface RasterResult {
+    /** Tightly packed RGBA bytes, width*height*4. */
+    rgba: Uint8Array;
+    width: number;
+    height: number;
+    /** Base64 PNG of the same masked canvas, or null when encoding failed. */
+    pngBase64: string | null;
+}
+interface PageRasterizer {
+    /** Resolve null (never throw) when the page cannot be rasterized. */
+    rasterize(): Promise<RasterResult | null>;
+}
+interface TransportResponse {
+    ok: boolean;
+    status: number;
+}
+type TapTransport = (url: string, body: string, opts: {
+    headers: Record<string, string>;
+    keepalive?: boolean;
+}) => Promise<TransportResponse>;
+/** Anything exposing the AutocaptureModule secondary-listener API. */
+interface AutocaptureSource {
+    addListener(cb: (event: AutocaptureEvent) => void): () => void;
+}
+interface WatchtowerCaptureConfig {
+    apiKey: string;
+    projectId: string;
+    /** Base endpoint — events go to `${endpoint}/api/taps`, templates to `${endpoint}/api/taps/template`. */
+    endpoint: string;
+    appVersion?: string;
+    /** Flush when the queue reaches this size (spec §1.3, default 50). */
+    maxBatchSize?: number;
+    /** Flush interval in ms (spec §1.3, default 10000). */
+    flushInterval?: number;
+    /** Min ms between rasterizations of the same route (default 1000). */
+    templateThrottleMs?: number;
+    /** Extra CSS selector blocked (greyed out) in the masked snapshot. */
+    blockSelector?: string;
+    /** CSS selector whose text is masked in the snapshot. */
+    maskSelector?: string;
+    debug?: boolean;
+    /** Injectable rasterizer (tests). Defaults to the DOM SVG-foreignObject rasterizer. */
+    rasterizer?: PageRasterizer;
+    /** Injectable transport (tests). Defaults to fetch. */
+    transport?: TapTransport;
+}
+declare class WatchtowerWebCapture {
+    private config;
+    private session;
+    private queue;
+    private flushTimer;
+    private flushFailures;
+    private disabled;
+    private active;
+    private distinctId;
+    private currentScreen;
+    private transport;
+    private rasterizer;
+    private detachAutocapture;
+    private ownAutocapture;
+    private originalPushState;
+    private originalReplaceState;
+    private popstateHandler;
+    private pagehideHandler;
+    private fpCache;
+    private uploadedFps;
+    private lastRasterAt;
+    private rasterInFlight;
+    constructor(config: WatchtowerCaptureConfig);
+    /**
+     * Start capturing. Pass the existing AutocaptureModule (via
+     * AnalyticsManager.getAutocaptureModule()) to reuse its click listener +
+     * selector resolution; when absent, a private clicks-only module is created.
+     */
+    start(source?: AutocaptureSource | null): void;
+    stop(): void;
+    isActive(): boolean;
+    getSessionId(): string;
+    /** Stamped as distinct_id on every subsequent event (identify() feeds this). */
+    setDistinctId(distinctId: string | null): void;
+    private onAutocaptureEvent;
+    /** Record a tap. Coordinates are viewport CSS px; normalization happens here. */
+    recordTap(input: {
+        selector: string;
+        label?: string;
+        role?: string;
+        clientX: number;
+        clientY: number;
+    }): void;
+    private setupNavigationTracking;
+    private handleRouteChange;
+    private setupPagehide;
+    private baseEvent;
+    private enqueue;
+    private startFlushTimer;
+    flush(opts?: {
+        keepalive?: boolean;
+    }): Promise<void>;
+    private headers;
+    private scheduleFingerprint;
+    private captureFingerprint;
+    private maybeUploadTemplate;
+    private combinedBlockSelector;
+    private pathname;
+    private log;
+}
+
 declare class ReplayManager {
     private config;
     private recording;
@@ -999,6 +1130,7 @@ interface WebManagerFactories {
     createReplay?: (cfg: Record<string, unknown>) => ReplayManager;
     createFingerprint?: (cfg: Record<string, unknown>) => FingerprintManager;
     createPerformance?: (cfg: Record<string, unknown>) => PerformanceManager;
+    createWatchtowerCapture?: (cfg: Record<string, unknown>) => WatchtowerWebCapture;
 }
 /**
  * Platform-entry-only: inject web-only manager factories. Called by
@@ -1069,6 +1201,22 @@ interface SitePongInitConfig extends SitePongConfig {
         /** Rolling buffer duration in ms — how many seconds of replay to keep before an error (default: 20000) */
         bufferDuration?: number;
     };
+    /** Watchtower tap capture (web) — tap timeline events + masked screen templates */
+    watchtower?: {
+        enabled?: boolean;
+        /** Project ID sent as X-Project-ID on /api/taps requests (required) */
+        projectId?: string;
+        /** Override base endpoint for /api/taps + /api/taps/template (default: main endpoint) */
+        endpoint?: string;
+        /** Flush at this many buffered events (default: 50) */
+        maxBatchSize?: number;
+        /** Flush interval in ms (default: 10000) */
+        flushInterval?: number;
+        /** Extra CSS selector blocked out of the masked screen template */
+        blockSelector?: string;
+        /** CSS selector whose text is masked in the screen template */
+        maskSelector?: string;
+    };
     /** Cron monitoring configuration */
     crons?: {
         enabled?: boolean;
@@ -1117,6 +1265,8 @@ declare class SitePongClient {
     private databaseTracker;
     private profiler;
     private remoteConfigManager;
+    private watchtowerCapture;
+    private watchtowerOptions;
     private currentScreen?;
     private envUnsubs;
     private identifyHooks;
@@ -1179,6 +1329,13 @@ declare class SitePongClient {
     stopReplay(): void;
     isReplayRecording(): boolean;
     getReplaySessionId(): string | null;
+    /**
+     * Start Watchtower web tap capture. Options merge over `watchtower` from
+     * init(); `projectId` is required (either here or in init config). Reuses
+     * the analytics AutocaptureModule's click listener when autocapture is on.
+     */
+    startWatchtowerCapture(options?: SitePongInitConfig['watchtower']): boolean;
+    stopWatchtowerCapture(): void;
     startTransaction(name: string, data?: Record<string, unknown>): string;
     endTransaction(id: string, status?: 'ok' | 'error'): void;
     startSpan(transactionId: string, name: string, data?: Record<string, unknown>): string;
@@ -1279,6 +1436,8 @@ declare const getDeviceSignals: () => Promise<DeviceSignals>;
 declare const getFraudCheck: () => Promise<FraudCheckResult>;
 declare const startReplay: () => boolean;
 declare const stopReplay: () => void;
+declare const startWatchtowerCapture: (options?: SitePongInitConfig["watchtower"]) => boolean;
+declare const stopWatchtowerCapture: () => void;
 declare const isReplayRecording: () => boolean;
 declare const getReplaySessionId: () => string | null;
 declare const startTransaction: (name: string, data?: Record<string, unknown>) => string;
@@ -1316,4 +1475,4 @@ declare const isRemoteConfigFeatureEnabled: (key: string, defaultValue?: boolean
 declare const onRemoteConfigChange: (listener: (config: RemoteConfig) => void) => () => void;
 declare const registerIdentifyHook: (hook: (userId: string) => void) => () => void;
 
-export { type CapturedError, type CronCheckinOptions, type CronHandle, DEFAULT_SUPERLINK_ENDPOINT, type DatabaseQueryEvent, type DatabaseTrackerConfig, type DeferredDeepLinkHandler, type DeviceInfo, type DeviceSignals, type EnvironmentAdapter, type ErrorContext, type FraudCheckResult, GroupTraits, type MetricOptions, type MutableRNEnvironmentAdapter, type PerformanceConfig, type PerformanceSpan, type PerformanceTransaction, type PlatformName, type ProfileData, type ProfileFrame, type ProfilerConfig, type RemoteConfig, type RemoteConfigFeatures, type RemoteConfigSampling, ReplayConfig, type ResourceTimingBreakdown, type SitePongConfig, type SitePongInitConfig, SuperLinkClient, type SuperLinkConfig, type SuperLinkDeepLink, type SuperLinkEventType, type SuperLinkFingerprint, type SuperLinkIdentityMetadata, type SuperLinkMatchRequest, type SuperLinkMatchResponse, type SuperLinkMatchType, type SuperLinkPlatform, type TraceContext, TracePropagator, TrackProperties, UserTraits, type VisitorIdResult, type WebManagerFactories, type WebVitals, addBreadcrumb, areFlagsReady, captureError, captureMessage, captureWebDeepLink, clearAnonymousId, clearUser, sitepong as client, completeFromScan, createTraceContext, cronCheckin, cronStart, cronWrap, dbTrack, dbTrackSync, sitepong as default, endSpan, endTransaction, extractIdentityMetadata, extractTrace, flush, flushMetrics, flushProfiles, generateSpanId, generateTraceId, getAllFlags, getAnonymousId, getDbNPlusOnePatterns, getDbQueryCount, getDeepLink, getDeviceSignals, getFlag, getFraudCheck, getLatestProfile, getMatchedDeepLink, getProfiles, getRemoteConfig, getReplaySessionId, getVariant, getVariantPayload, getVisitorId, getWebVitals, group, identify, init, initRN, initSuperLink, isInitialized, isRemoteConfigFeatureEnabled, isReplayRecording, metricDistribution, metricGauge, metricHistogram, metricIncrement, metricStartTimer, metricTime, onDeferredDeepLink, onRemoteConfigChange, parseUniversalLink, profile, propagateTrace, refreshFlags, registerIdentifyHook, registerWebManagerFactories, resetAnalytics, resetDbQueryCount, setAnonymousId, setContext, setCurrentScreen, setEnvironment, setRNGetCurrentScreen, setTags, setUser, startProfileSpan, startReplay, startSpan, startTransaction, stopReplay, superlinkClient, identify$1 as superlinkIdentify, track, trackPageView, waitForFlags, writeClipboardToken };
+export { type CapturedError, type CronCheckinOptions, type CronHandle, DEFAULT_SUPERLINK_ENDPOINT, type DatabaseQueryEvent, type DatabaseTrackerConfig, type DeferredDeepLinkHandler, type DeviceInfo, type DeviceSignals, type EnvironmentAdapter, type ErrorContext, type FraudCheckResult, GroupTraits, type MetricOptions, type MutableRNEnvironmentAdapter, type PerformanceConfig, type PerformanceSpan, type PerformanceTransaction, type PlatformName, type ProfileData, type ProfileFrame, type ProfilerConfig, type RemoteConfig, type RemoteConfigFeatures, type RemoteConfigSampling, ReplayConfig, type ResourceTimingBreakdown, type SitePongConfig, type SitePongInitConfig, SuperLinkClient, type SuperLinkConfig, type SuperLinkDeepLink, type SuperLinkEventType, type SuperLinkFingerprint, type SuperLinkIdentityMetadata, type SuperLinkMatchRequest, type SuperLinkMatchResponse, type SuperLinkMatchType, type SuperLinkPlatform, type TraceContext, TracePropagator, TrackProperties, UserTraits, type VisitorIdResult, type WebManagerFactories, type WebVitals, addBreadcrumb, areFlagsReady, captureError, captureMessage, captureWebDeepLink, clearAnonymousId, clearUser, sitepong as client, completeFromScan, createTraceContext, cronCheckin, cronStart, cronWrap, dbTrack, dbTrackSync, sitepong as default, endSpan, endTransaction, extractIdentityMetadata, extractTrace, flush, flushMetrics, flushProfiles, generateSpanId, generateTraceId, getAllFlags, getAnonymousId, getDbNPlusOnePatterns, getDbQueryCount, getDeepLink, getDeviceSignals, getFlag, getFraudCheck, getLatestProfile, getMatchedDeepLink, getProfiles, getRemoteConfig, getReplaySessionId, getVariant, getVariantPayload, getVisitorId, getWebVitals, group, identify, init, initRN, initSuperLink, isInitialized, isRemoteConfigFeatureEnabled, isReplayRecording, metricDistribution, metricGauge, metricHistogram, metricIncrement, metricStartTimer, metricTime, onDeferredDeepLink, onRemoteConfigChange, parseUniversalLink, profile, propagateTrace, refreshFlags, registerIdentifyHook, registerWebManagerFactories, resetAnalytics, resetDbQueryCount, setAnonymousId, setContext, setCurrentScreen, setEnvironment, setRNGetCurrentScreen, setTags, setUser, startProfileSpan, startReplay, startSpan, startTransaction, startWatchtowerCapture, stopReplay, stopWatchtowerCapture, superlinkClient, identify$1 as superlinkIdentify, track, trackPageView, waitForFlags, writeClipboardToken };

package/dist/index.js

@@ -2,8 +2,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-require('web-vitals');
-
 // src/flags/anonymous-id.ts
 var STORAGE_KEY = "sitepong_anonymous_id";
 function generateUUID() {
@@ -584,6 +582,7 @@ var DEFAULT_BLOCK_SELECTORS = [
 var MAX_TEXT_LENGTH = 255;
 var AutocaptureModule = class {
   constructor(config, callback) {
+    this.listeners = [];
     this.clickHandler = null;
     this.submitHandler = null;
     this.active = false;
@@ -598,6 +597,27 @@ var AutocaptureModule = class {
     };
     this.callback = callback;
   }
+  /**
+   * Register a secondary listener that receives the same events as the
+   * primary callback (e.g. Watchtower tap capture reusing the single click
+   * listener + selector resolution). Returns an unsubscribe function.
+   */
+  addListener(cb) {
+    this.listeners.push(cb);
+    return () => {
+      const idx = this.listeners.indexOf(cb);
+      if (idx >= 0) this.listeners.splice(idx, 1);
+    };
+  }
+  emit(event) {
+    this.callback(event);
+    for (const listener of this.listeners) {
+      try {
+        listener(event);
+      } catch {
+      }
+    }
+  }
   start() {
     if (this.active || typeof document === "undefined" || typeof document.addEventListener !== "function") return;
     this.active = true;
@@ -630,7 +650,7 @@ var AutocaptureModule = class {
       properties.$event_type = "click";
       properties.$x = e.clientX;
       properties.$y = e.clientY;
-      this.callback({
+      this.emit({
         type: "click",
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
         properties
@@ -652,7 +672,7 @@ var AutocaptureModule = class {
       };
       const elemProps = this.getElementProperties(form);
       Object.assign(properties, elemProps);
-      this.callback({
+      this.emit({
         type: "form_submit",
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
         properties
@@ -869,6 +889,14 @@ var AnalyticsManager = class {
     );
     this.autocaptureModule.start();
   }
+  /**
+   * The live AutocaptureModule (if click/form autocapture is enabled) —
+   * Watchtower tap capture attaches to it so there is only ONE document-level
+   * click listener and one selector/element resolution path.
+   */
+  getAutocaptureModule() {
+    return this.autocaptureModule;
+  }
   track(eventName, properties) {
     if (!this.config.enabled) return;
     const event = this.createEvent("track", { name: eventName, properties });
@@ -2380,6 +2408,8 @@ var SitePongClient = class {
     this.databaseTracker = null;
     this.profiler = null;
     this.remoteConfigManager = null;
+    this.watchtowerCapture = null;
+    this.watchtowerOptions = void 0;
     this.envUnsubs = [];
     this.identifyHooks = [];
     this.config = {
@@ -2499,6 +2529,12 @@ var SitePongClient = class {
     } else if (config.replay?.enabled) {
       this.log("Replay requested but not available on this platform (web only).");
     }
+    this.watchtowerOptions = config.watchtower;
+    if (config.watchtower?.enabled && webManagerFactories.createWatchtowerCapture) {
+      this.startWatchtowerCapture();
+    } else if (config.watchtower?.enabled) {
+      this.log("Watchtower capture requested but not available on this platform (web only).");
+    }
     if (config.crons?.enabled) {
       this.cronManager = new CronMonitorManager({
         apiKey: config.apiKey,
@@ -2738,6 +2774,7 @@ var SitePongClient = class {
         this.log("identify hook failed:", err);
       }
     }
+    this.watchtowerCapture?.setDistinctId(userId);
     if (!this.analyticsManager) {
       this.log("Analytics not enabled. Set analytics.enabled: true in init()");
       return;
@@ -2805,6 +2842,49 @@ var SitePongClient = class {
   getReplaySessionId() {
     return this.replayManager?.getSessionId() ?? null;
   }
+  // --- Watchtower tap capture (web) ---
+  /**
+   * Start Watchtower web tap capture. Options merge over `watchtower` from
+   * init(); `projectId` is required (either here or in init config). Reuses
+   * the analytics AutocaptureModule's click listener when autocapture is on.
+   */
+  startWatchtowerCapture(options) {
+    if (!webManagerFactories.createWatchtowerCapture) {
+      this.log("Watchtower capture not available on this platform (web only).");
+      return false;
+    }
+    if (!this.initialized || !this.config.apiKey) {
+      this.log("Watchtower capture requires init() to be called first.");
+      return false;
+    }
+    const opts = { ...this.watchtowerOptions, ...options };
+    if (!opts.projectId) {
+      this.log("Watchtower capture requires watchtower.projectId.");
+      return false;
+    }
+    if (this.watchtowerCapture) {
+      this.watchtowerCapture.stop();
+      this.watchtowerCapture = null;
+    }
+    this.watchtowerCapture = webManagerFactories.createWatchtowerCapture({
+      apiKey: this.config.apiKey,
+      projectId: opts.projectId,
+      endpoint: opts.endpoint || this.config.endpoint || DEFAULT_ENDPOINT3,
+      appVersion: this.config.release || void 0,
+      maxBatchSize: opts.maxBatchSize,
+      flushInterval: opts.flushInterval,
+      blockSelector: opts.blockSelector,
+      maskSelector: opts.maskSelector,
+      debug: this.config.debug
+    });
+    this.watchtowerCapture.start(this.analyticsManager?.getAutocaptureModule() ?? null);
+    return true;
+  }
+  stopWatchtowerCapture() {
+    if (!this.watchtowerCapture) return;
+    this.watchtowerCapture.stop();
+    this.watchtowerCapture = null;
+  }
   // --- Performance (Tier 7) ---
   startTransaction(name, data) {
     if (!this.performanceManager) {
@@ -2956,6 +3036,7 @@ var SitePongClient = class {
     if (this.replayManager) {
       this.replayManager.setUser(null);
     }
+    this.watchtowerCapture?.setDistinctId(null);
   }
   addBreadcrumb(breadcrumb) {
     this.log("Breadcrumb added:", breadcrumb);
@@ -3180,6 +3261,8 @@ var getDeviceSignals = sitepong.getDeviceSignals.bind(sitepong);
 var getFraudCheck = sitepong.getFraudCheck.bind(sitepong);
 var startReplay = sitepong.startReplay.bind(sitepong);
 var stopReplay = sitepong.stopReplay.bind(sitepong);
+var startWatchtowerCapture = sitepong.startWatchtowerCapture.bind(sitepong);
+var stopWatchtowerCapture = sitepong.stopWatchtowerCapture.bind(sitepong);
 var isReplayRecording = sitepong.isReplayRecording.bind(sitepong);
 var getReplaySessionId = sitepong.getReplaySessionId.bind(sitepong);
 var startTransaction = sitepong.startTransaction.bind(sitepong);
@@ -3293,7 +3376,9 @@ exports.startProfileSpan = startProfileSpan;
 exports.startReplay = startReplay;
 exports.startSpan = startSpan;
 exports.startTransaction = startTransaction;
+exports.startWatchtowerCapture = startWatchtowerCapture;
 exports.stopReplay = stopReplay;
+exports.stopWatchtowerCapture = stopWatchtowerCapture;
 exports.superlinkClient = superlinkClient;
 exports.superlinkIdentify = identify;
 exports.track = track;