sitepong 0.2.13 → 0.2.15

package/dist/index.d.mts

@@ -222,6 +222,17 @@ interface WatchtowerCaptureConfig {
     /** CSS selector whose text is masked in the snapshot. */
     maskSelector?: string;
     debug?: boolean;
+    /**
+     * Release channel / environment to tag events with (development | preview |
+     * production | …). Defaults to 'production' on web. A channel listed in
+     * `ignoreChannels` suppresses capture entirely.
+     */
+    channel?: string;
+    /**
+     * Channels for which capture is a complete no-op (default ['development']).
+     * Set to [] to capture every channel.
+     */
+    ignoreChannels?: string[];
     /** Injectable rasterizer (tests). Defaults to the DOM SVG-foreignObject rasterizer. */
     rasterizer?: PageRasterizer;
     /** Injectable transport (tests). Defaults to fetch. */
@@ -234,6 +245,10 @@ declare class WatchtowerWebCapture {
     private flushTimer;
     private flushFailures;
     private disabled;
+    /** Resolved release channel tagged on every event. */
+    private channel;
+    /** When true, this channel is ignored → start() is a complete no-op. */
+    private channelSuppressed;
     private active;
     private distinctId;
     private currentScreen;
@@ -1216,6 +1231,14 @@ interface SitePongInitConfig extends SitePongConfig {
         blockSelector?: string;
         /** CSS selector whose text is masked in the screen template */
         maskSelector?: string;
+        /**
+         * Release channel / environment tagged on events (development | preview |
+         * production | …). Defaults to the SDK `environment` (usually 'production').
+         * A channel in `ignoreChannels` suppresses capture entirely.
+         */
+        channel?: string;
+        /** Channels for which capture is a no-op (default ['development']). */
+        ignoreChannels?: string[];
     };
     /** Cron monitoring configuration */
     crons?: {
@@ -1319,7 +1342,7 @@ declare class SitePongClient {
      * Register a callback invoked whenever identify(userId) is called.
      * Used by platform entries (e.g. RN) to wire side effects like push re-registration.
      */
-    registerIdentifyHook(hook: (userId: string) => void): () => void;
+    registerIdentifyHook(hook: (userId: string, traits?: UserTraits) => void): () => void;
     group(groupId: string, traits?: GroupTraits): void;
     resetAnalytics(): void;
     getVisitorId(): Promise<VisitorIdResult>;
@@ -1473,6 +1496,6 @@ declare const flushProfiles: () => Promise<void>;
 declare const getRemoteConfig: () => RemoteConfig | null;
 declare const isRemoteConfigFeatureEnabled: (key: string, defaultValue?: boolean) => boolean;
 declare const onRemoteConfigChange: (listener: (config: RemoteConfig) => void) => () => void;
-declare const registerIdentifyHook: (hook: (userId: string) => void) => () => void;
+declare const registerIdentifyHook: (hook: (userId: string, traits?: UserTraits) => 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, startWatchtowerCapture, stopReplay, stopWatchtowerCapture, superlinkClient, identify$1 as superlinkIdentify, track, trackPageView, waitForFlags, writeClipboardToken };

package/dist/index.d.ts

@@ -222,6 +222,17 @@ interface WatchtowerCaptureConfig {
     /** CSS selector whose text is masked in the snapshot. */
     maskSelector?: string;
     debug?: boolean;
+    /**
+     * Release channel / environment to tag events with (development | preview |
+     * production | …). Defaults to 'production' on web. A channel listed in
+     * `ignoreChannels` suppresses capture entirely.
+     */
+    channel?: string;
+    /**
+     * Channels for which capture is a complete no-op (default ['development']).
+     * Set to [] to capture every channel.
+     */
+    ignoreChannels?: string[];
     /** Injectable rasterizer (tests). Defaults to the DOM SVG-foreignObject rasterizer. */
     rasterizer?: PageRasterizer;
     /** Injectable transport (tests). Defaults to fetch. */
@@ -234,6 +245,10 @@ declare class WatchtowerWebCapture {
     private flushTimer;
     private flushFailures;
     private disabled;
+    /** Resolved release channel tagged on every event. */
+    private channel;
+    /** When true, this channel is ignored → start() is a complete no-op. */
+    private channelSuppressed;
     private active;
     private distinctId;
     private currentScreen;
@@ -1216,6 +1231,14 @@ interface SitePongInitConfig extends SitePongConfig {
         blockSelector?: string;
         /** CSS selector whose text is masked in the screen template */
         maskSelector?: string;
+        /**
+         * Release channel / environment tagged on events (development | preview |
+         * production | …). Defaults to the SDK `environment` (usually 'production').
+         * A channel in `ignoreChannels` suppresses capture entirely.
+         */
+        channel?: string;
+        /** Channels for which capture is a no-op (default ['development']). */
+        ignoreChannels?: string[];
     };
     /** Cron monitoring configuration */
     crons?: {
@@ -1319,7 +1342,7 @@ declare class SitePongClient {
      * Register a callback invoked whenever identify(userId) is called.
      * Used by platform entries (e.g. RN) to wire side effects like push re-registration.
      */
-    registerIdentifyHook(hook: (userId: string) => void): () => void;
+    registerIdentifyHook(hook: (userId: string, traits?: UserTraits) => void): () => void;
     group(groupId: string, traits?: GroupTraits): void;
     resetAnalytics(): void;
     getVisitorId(): Promise<VisitorIdResult>;
@@ -1473,6 +1496,6 @@ declare const flushProfiles: () => Promise<void>;
 declare const getRemoteConfig: () => RemoteConfig | null;
 declare const isRemoteConfigFeatureEnabled: (key: string, defaultValue?: boolean) => boolean;
 declare const onRemoteConfigChange: (listener: (config: RemoteConfig) => void) => () => void;
-declare const registerIdentifyHook: (hook: (userId: string) => void) => () => void;
+declare const registerIdentifyHook: (hook: (userId: string, traits?: UserTraits) => 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, startWatchtowerCapture, stopReplay, stopWatchtowerCapture, superlinkClient, identify$1 as superlinkIdentify, track, trackPageView, waitForFlags, writeClipboardToken };

package/dist/index.js

@@ -2770,7 +2770,7 @@ var SitePongClient = class {
     }
     for (const hook of this.identifyHooks) {
       try {
-        hook(userId);
+        hook(userId, traits);
       } catch (err) {
         this.log("identify hook failed:", err);
       }
@@ -2876,6 +2876,10 @@ var SitePongClient = class {
       flushInterval: opts.flushInterval,
       blockSelector: opts.blockSelector,
       maskSelector: opts.maskSelector,
+      // Channel defaults to the SDK environment; ignoreChannels defaults to
+      // ['development'] inside the capture when omitted.
+      channel: opts.channel ?? this.config.environment,
+      ignoreChannels: opts.ignoreChannels,
       debug: this.config.debug
     });
     this.watchtowerCapture.start(this.analyticsManager?.getAutocaptureModule() ?? null);