sitepong 0.2.7 → 0.2.9

package/dist/entries/rn.d.ts

@@ -1,4 +1,5 @@
 import React, { ReactNode, ReactElement } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
  * Platform-agnostic storage interface.
@@ -771,6 +772,78 @@ interface WatchtowerProviderProps {
  */
 declare function WatchtowerProvider(props: WatchtowerProviderProps): React.ReactElement;
 
+interface StructuralCaptureConfig {
+    /** Ingest base URL, e.g. https://ingest.sitepong.com */
+    endpoint: string;
+    /** Project API key (sent as X-API-Key). */
+    apiKey: string;
+    /** Project id (sent as X-Project-ID for the ingest cross-check). */
+    projectId?: string;
+    /** Stable session id (defaults to a generated one). */
+    sessionId?: string;
+    /** Wire platform label, e.g. react-native-ios. */
+    platform?: string;
+    sampleIntervalMs?: number;
+    flushIntervalMs?: number;
+    debug?: boolean;
+}
+declare class StructuralCapture {
+    private readonly recorder;
+    private currentIndex;
+    private started;
+    private sampleTimer;
+    private flushTimer;
+    private screen;
+    private prevScreen;
+    private cfg;
+    private sessionId;
+    private running;
+    private sentCount;
+    private flushing;
+    private readonly scrollOffsets;
+    private overloadSkip;
+    private appStateSub;
+    private readonly teardowns;
+    private now;
+    isRunning(): boolean;
+    getSessionId(): string;
+    start(cfg: StructuralCaptureConfig): void;
+    /** Best-effort flush the pre-crash tail before the app tears down. */
+    private installCrashFlush;
+    /** Flush on background/inactive so timer suspension doesn't strand the tail. */
+    private installBackgroundFlush;
+    private sample;
+    setScreen(name: string): void;
+    /** Resolve a native touch to a node + emit a tap. `target` is the RN
+     *  nativeTag from `nativeEvent.target`. */
+    handleTap(target: number, pageX: number, pageY: number): void;
+    /** Feed a scroll/drag delta from a touch onto the nearest scrollable ancestor
+     *  of the touched node. `target` is the RN nativeTag under the finger; `dx`/`dy`
+     *  are content-offset deltas (px, sign = content motion). Native-driven scroll
+     *  never reaches the fiber walk, so this is the only way the replay can ride the
+     *  scroll instead of freezing on a stale frame. */
+    handleScroll(target: number, dx: number, dy: number): void;
+    /** Public best-effort flush — used by the shared RN error handler to push the
+     *  pre-crash tail (the in-class ErrorUtils hook covers apps that don't call
+     *  setupRNErrorHandler; both are idempotent via the `flushing` guard). */
+    flushNow(): Promise<void>;
+    private flush;
+    stop(): Promise<void>;
+}
+/** Process-wide singleton (one capture per app session). */
+declare const structuralCapture: StructuralCapture;
+
+interface StructuralCaptureProviderProps extends Omit<StructuralCaptureConfig, 'sessionId'> {
+    sessionId?: string;
+    children: React.ReactNode;
+}
+declare function StructuralCaptureProvider({ children, ...cfg }: StructuralCaptureProviderProps): react_jsx_runtime.JSX.Element;
+/** Mark the active screen (drives screen_view + navigation outcome detection). */
+declare function useStructuralScreen(name: string): void;
+
+/** Install the commit hook once. Safe to call repeatedly. */
+declare function installStructuralHook(): void;
+
 /**
  * React Native Network Interception
  *
@@ -1164,4 +1237,4 @@ declare function reportConversion(props?: Record<string, unknown>): Promise<bool
  */
 declare function setRNStorage(storage: StorageAdapter | null): void;
 
-export { type AsyncStorageLike, type DeferredDeepLinkHandler, type ErrorContext, type GroupTraits, type IconSpec, type LiveActivityAttributes, type LiveActivityContentState, type NavigationRef, type NavigationTrackerOptions, type NetworkInterceptionOptions, type ProgressSpec, RNAutocaptureModule, type RNAutocaptureOptions, type RNDeviceInfo, type RNErrorHandlerOptions, RNPerformanceManager, type RemoteConfig, type ScreenRecordingConfig, SensitiveView, type SitePongConfig, type SitePongInitConfig, SitePongRNProvider, type SitePongRNProviderProps, type StartLiveActivityOptions, type StartedLiveActivity, type SuperLinkConfig, type SuperLinkDeepLink, type SuperLinkEventType, type SuperLinkFingerprint, type SuperLinkIdentityMetadata, type SuperLinkMatchType, type SuperLinkPlatform, type SymbolWeight, type TextStyle, type TextWeight, type TrackProperties, type TrackedDatabaseOptions, type UserTraits, type WatchtowerConfig, WatchtowerProvider, type WatchtowerProviderProps, type WidgetSyncOptions, addBreadcrumb, addSensitiveView, areFlagsReady, areLiveActivitiesEnabled, captureError, captureMessage, clearAnonymousId, clearUser, collectDeviceInfo, completeFromScan, createAsyncStorageAdapter, createNavigationTracker, createSuperLinkListener, createTrackedDatabase, endLiveActivity, fetchNativeDeviceSignals, fetchPersistentDeviceId, flush, flushScreenRecording, flushScreenRecordingOnError, getAllFlags, getAnonymousId, getFlag, getMatchedDeepLink, getRemoteConfig, getVariant, getVariantPayload, getWatchtowerSessionId, group, handleUniversalLink, identify$1 as identify, initRN, initSuperLinkRN, isInitialized, isRemoteConfigFeatureEnabled, isScreenRecording, markColdStart, onDeferredDeepLink, onPushTokenUpdate, onRemoteConfigChange, parseUniversalLink, refreshFlags, registerDeviceToken, registerLiveActivityToken, registerPushToStartToken, registerPushToken, removeSensitiveView, reportConversion, resetAnalytics, setAnonymousId, setContext, setCurrentScreen, setRNStorage, setTags, setUser, setWatchtowerUser, setupNetworkInterception, setupRNErrorHandler, startLiveActivity, startScreenRecording, startWatchtower, stopScreenRecording, stopWatchtower, stopWidgetSync, subscribeNavigationToWatchtower, identify as superlinkIdentify, syncWidgets, track, triggerWidgetRefresh, updateLiveActivity, updateWidgetData, useAppState, useRNPerformance, useRemoteConfig, useScreenTrack, useSitePongRNContext, waitForFlags };
+export { type AsyncStorageLike, type DeferredDeepLinkHandler, type ErrorContext, type GroupTraits, type IconSpec, type LiveActivityAttributes, type LiveActivityContentState, type NavigationRef, type NavigationTrackerOptions, type NetworkInterceptionOptions, type ProgressSpec, RNAutocaptureModule, type RNAutocaptureOptions, type RNDeviceInfo, type RNErrorHandlerOptions, RNPerformanceManager, type RemoteConfig, type ScreenRecordingConfig, SensitiveView, type SitePongConfig, type SitePongInitConfig, SitePongRNProvider, type SitePongRNProviderProps, type StartLiveActivityOptions, type StartedLiveActivity, StructuralCapture, type StructuralCaptureConfig, StructuralCaptureProvider, type StructuralCaptureProviderProps, type SuperLinkConfig, type SuperLinkDeepLink, type SuperLinkEventType, type SuperLinkFingerprint, type SuperLinkIdentityMetadata, type SuperLinkMatchType, type SuperLinkPlatform, type SymbolWeight, type TextStyle, type TextWeight, type TrackProperties, type TrackedDatabaseOptions, type UserTraits, type WatchtowerConfig, WatchtowerProvider, type WatchtowerProviderProps, type WidgetSyncOptions, addBreadcrumb, addSensitiveView, areFlagsReady, areLiveActivitiesEnabled, captureError, captureMessage, clearAnonymousId, clearUser, collectDeviceInfo, completeFromScan, createAsyncStorageAdapter, createNavigationTracker, createSuperLinkListener, createTrackedDatabase, endLiveActivity, fetchNativeDeviceSignals, fetchPersistentDeviceId, flush, flushScreenRecording, flushScreenRecordingOnError, getAllFlags, getAnonymousId, getFlag, getMatchedDeepLink, getRemoteConfig, getVariant, getVariantPayload, getWatchtowerSessionId, group, handleUniversalLink, identify$1 as identify, initRN, initSuperLinkRN, installStructuralHook, isInitialized, isRemoteConfigFeatureEnabled, isScreenRecording, markColdStart, onDeferredDeepLink, onPushTokenUpdate, onRemoteConfigChange, parseUniversalLink, refreshFlags, registerDeviceToken, registerLiveActivityToken, registerPushToStartToken, registerPushToken, removeSensitiveView, reportConversion, resetAnalytics, setAnonymousId, setContext, setCurrentScreen, setRNStorage, setTags, setUser, setWatchtowerUser, setupNetworkInterception, setupRNErrorHandler, startLiveActivity, startScreenRecording, startWatchtower, stopScreenRecording, stopWatchtower, stopWidgetSync, structuralCapture, subscribeNavigationToWatchtower, identify as superlinkIdentify, syncWidgets, track, triggerWidgetRefresh, updateLiveActivity, updateWidgetData, useAppState, useRNPerformance, useRemoteConfig, useScreenTrack, useSitePongRNContext, useStructuralScreen, waitForFlags };