swetrix 3.7.2 → 4.0.0

package/dist/swetrix.js.map

@@ -1 +1 @@
-{"version":3,"file":"swetrix.js","sources":["../src/utils.ts","../src/Lib.ts","../src/index.ts"],"sourcesContent":[null,null,null],"names":["findInSearch","exp","res","location","search","match","undefined","utmSourceRegex","utmCampaignRegex","utmMediumRegex","utmTermRegex","utmContentRegex","getLocale","navigator","languages","language","getTimezone","Intl","DateTimeFormat","resolvedOptions","timeZone","e","getReferrer","document","referrer","getUTMSource","getUTMMedium","getUTMCampaign","getUTMTerm","getUTMContent","getPath","options","result","pathname","hash","hashIndex","indexOf","substring","defaultActions","stop","Lib","constructor","projectID","this","pageData","pageViewsOptions","errorsOptions","perfStatsCollected","activePage","errorListenerExists","trackPathChange","bind","heartbeat","captureError","event","_a","sampleRate","Math","random","submitError","filename","lineno","colno","name","_b","error","message","_c","stackTrace","_d","stack","trackErrors","canTrack","window","addEventListener","removeEventListener","payload","evokeCallback","privateData","pid","errorPayload","pg","lc","tz","callback","callbackResult","Object","assign","sendRequest","track","data","ref","so","me","ca","te","co","trackPageViews","actions","interval","unique","setInterval","setTimeout","hbInterval","path","clearInterval","trackPage","getPerformanceStats","performance","getEntriesByType","perf","dns","domainLookupEnd","domainLookupStart","tls","secureConnectionStart","requestStart","conn","connectStart","connectEnd","response","responseEnd","responseStart","render","domComplete","domContentLoadedEventEnd","dom_load","page_load","loadEventStart","ttfb","heartbeatOnBackground","visibilityState","newPath","submitPageView","pvPayload","disabled","respectDNT","doNotTrack","devMode","hostname","webdriver","body","host","apiURL","fetch","method","headers","JSON","stringify","LIB_INSTANCE","Boolean","async","_prev","Promise","resolve","readyState"],"mappings":"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"}
+{"version":3,"file":"swetrix.js","sources":["../src/utils.ts","../src/Lib.ts","../src/index.ts"],"sourcesContent":[null,null,null],"names":["findInSearch","exp","res","location","search","match","undefined","utmSourceRegex","utmCampaignRegex","utmMediumRegex","utmTermRegex","utmContentRegex","isInBrowser","window","getLocale","navigator","languages","language","getTimezone","Intl","DateTimeFormat","resolvedOptions","timeZone","e","getReferrer","document","referrer","getUTMSource","getUTMMedium","getUTMCampaign","getUTMTerm","getUTMContent","getPath","options","result","pathname","hash","hashIndex","indexOf","substring","defaultActions","stop","DEFAULT_CACHE_DURATION","Lib","constructor","projectID","this","pageData","pageViewsOptions","errorsOptions","perfStatsCollected","activePage","errorListenerExists","cachedData","trackPathChange","bind","heartbeat","captureError","event","_a","sampleRate","Math","random","submitError","filename","lineno","colno","name","_b","error","message","_c","stackTrace","_d","stack","trackErrors","canTrack","addEventListener","removeEventListener","payload","evokeCallback","privateData","pid","errorPayload","pg","lc","tz","callback","callbackResult","Object","assign","sendRequest","track","data","ref","so","me","ca","te","co","profileId","trackPageViews","actions","interval","unique","setInterval","setTimeout","hbInterval","path","clearInterval","trackPage","getPerformanceStats","performance","getEntriesByType","perf","dns","domainLookupEnd","domainLookupStart","tls","secureConnectionStart","requestStart","conn","connectStart","connectEnd","response","responseEnd","responseStart","render","domComplete","domContentLoadedEventEnd","dom_load","page_load","loadEventStart","ttfb","getFeatureFlags","forceRefresh","requestedProfileId","now","Date","timestamp","flags","fetchFlagsAndExperiments","console","warn","apiBase","getApiBase","body","fetch","method","headers","JSON","stringify","ok","status","json","cachedProfileId","experiments","getFeatureFlag","key","defaultValue","clearFeatureFlagsCache","getExperiments","getExperiment","experimentId","defaultVariant","clearExperimentsCache","getProfileId","getSessionId","sessionId","apiURL","replace","heartbeatOnBackground","visibilityState","newPath","submitPageView","pvPayload","disabled","respectDNT","doNotTrack","devMode","hostname","webdriver","host","LIB_INSTANCE","async","Boolean","_prev","Promise","resolve","readyState"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swetrix",
-  "version": "3.7.2",
+  "version": "4.0.0",
   "description": "The JavaScript analytics client for Swetrix Analytics",
   "type": "module",
   "main": "dist/swetrix.cjs.js",

package/src/Lib.ts

@@ -32,6 +32,12 @@ export interface LibOptions {
 
   /** Set a custom URL of the API server (for selfhosted variants of Swetrix). */
   apiURL?: string
+
+  /**
+   * Optional profile ID for long-term user tracking.
+   * If set, it will be used for all pageviews and events unless overridden per-call.
+   */
+  profileId?: string
 }
 
 export interface TrackEventOptions {
@@ -45,6 +51,9 @@ export interface TrackEventOptions {
   meta?: {
     [key: string]: string | number | boolean | null | undefined
   }
+
+  /** Optional profile ID for long-term user tracking. Overrides the global profileId if set. */
+  profileId?: string
 }
 
 // Partial user-editable pageview payload
@@ -63,6 +72,9 @@ export interface IPageViewPayload {
   meta?: {
     [key: string]: string | number | boolean | null | undefined
   }
+
+  /** Optional profile ID for long-term user tracking. Overrides the global profileId if set. */
+  profileId?: string
 }
 
 // Partial user-editable error payload
@@ -95,6 +107,41 @@ interface IPerfPayload {
   ttfb: number
 }
 
+/**
+ * Options for evaluating feature flags.
+ */
+export interface FeatureFlagsOptions {
+  /**
+   * Optional profile ID for long-term user tracking.
+   * If not provided, an anonymous profile ID will be generated server-side based on IP and user agent.
+   * Overrides the global profileId if set.
+   */
+  profileId?: string
+}
+
+/**
+ * Options for evaluating experiments.
+ */
+export interface ExperimentOptions {
+  /**
+   * Optional profile ID for long-term user tracking.
+   * If not provided, an anonymous profile ID will be generated server-side based on IP and user agent.
+   * Overrides the global profileId if set.
+   */
+  profileId?: string
+}
+
+/**
+ * Cached feature flags and experiments with timestamp.
+ */
+interface CachedData {
+  flags: Record<string, boolean>
+  experiments: Record<string, string>
+  timestamp: number
+  /** The profileId used when fetching this cached data */
+  profileId?: string
+}
+
 /**
  * The object returned by `trackPageViews()`, used to stop tracking pages.
  */
@@ -174,6 +221,10 @@ export const defaultActions = {
 }
 
 const DEFAULT_API_HOST = 'https://api.swetrix.com/log'
+const DEFAULT_API_BASE = 'https://api.swetrix.com'
+
+// Default cache duration: 5 minutes
+const DEFAULT_CACHE_DURATION = 5 * 60 * 1000
 
 export class Lib {
   private pageData: PageData | null = null
@@ -182,6 +233,7 @@ export class Lib {
   private perfStatsCollected: boolean = false
   private activePage: string | null = null
   private errorListenerExists = false
+  private cachedData: CachedData | null = null
 
   constructor(private projectID: string, private options?: LibOptions) {
     this.trackPathChange = this.trackPathChange.bind(this)
@@ -294,6 +346,7 @@ export class Lib {
       ca: getUTMCampaign(),
       te: getUTMTerm(),
       co: getUTMContent(),
+      profileId: event.profileId ?? this.options?.profileId,
     }
     await this.sendRequest('custom', data)
   }
@@ -368,15 +421,304 @@ export class Lib {
     }
   }
 
+  /**
+   * Fetches all feature flags and experiments for the project.
+   * Results are cached for 5 minutes by default.
+   *
+   * @param options - Options for evaluating feature flags.
+   * @param forceRefresh - If true, bypasses the cache and fetches fresh data.
+   * @returns A promise that resolves to a record of flag keys to boolean values.
+   */
+  async getFeatureFlags(options?: FeatureFlagsOptions, forceRefresh?: boolean): Promise<Record<string, boolean>> {
+    if (!isInBrowser()) {
+      return {}
+    }
+
+    const requestedProfileId = options?.profileId ?? this.options?.profileId
+
+    // Check cache first - must match profileId and not be expired
+    if (!forceRefresh && this.cachedData) {
+      const now = Date.now()
+      const isSameProfile = this.cachedData.profileId === requestedProfileId
+      if (isSameProfile && now - this.cachedData.timestamp < DEFAULT_CACHE_DURATION) {
+        return this.cachedData.flags
+      }
+    }
+
+    try {
+      await this.fetchFlagsAndExperiments(options)
+      return this.cachedData?.flags || {}
+    } catch (error) {
+      console.warn('[Swetrix] Error fetching feature flags:', error)
+      return this.cachedData?.flags || {}
+    }
+  }
+
+  /**
+   * Internal method to fetch both feature flags and experiments from the API.
+   */
+  private async fetchFlagsAndExperiments(options?: FeatureFlagsOptions | ExperimentOptions): Promise<void> {
+    const apiBase = this.getApiBase()
+    const body: { pid: string; profileId?: string } = {
+      pid: this.projectID,
+    }
+
+    // Use profileId from options, or fall back to global profileId
+    const profileId = options?.profileId ?? this.options?.profileId
+    if (profileId) {
+      body.profileId = profileId
+    }
+
+    const response = await fetch(`${apiBase}/feature-flag/evaluate`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify(body),
+    })
+
+    if (!response.ok) {
+      console.warn('[Swetrix] Failed to fetch feature flags and experiments:', response.status)
+      return
+    }
+
+    const data = (await response.json()) as {
+      flags: Record<string, boolean>
+      experiments?: Record<string, string>
+    }
+
+    // Use profileId from options, or fall back to global profileId
+    const cachedProfileId = options?.profileId ?? this.options?.profileId
+
+    // Update cache with both flags and experiments
+    this.cachedData = {
+      flags: data.flags || {},
+      experiments: data.experiments || {},
+      timestamp: Date.now(),
+      profileId: cachedProfileId,
+    }
+  }
+
+  /**
+   * Gets the value of a single feature flag.
+   *
+   * @param key - The feature flag key.
+   * @param options - Options for evaluating the feature flag.
+   * @param defaultValue - Default value to return if the flag is not found. Defaults to false.
+   * @returns A promise that resolves to the boolean value of the flag.
+   */
+  async getFeatureFlag(key: string, options?: FeatureFlagsOptions, defaultValue: boolean = false): Promise<boolean> {
+    const flags = await this.getFeatureFlags(options)
+    return flags[key] ?? defaultValue
+  }
+
+  /**
+   * Clears the cached feature flags and experiments, forcing a fresh fetch on the next call.
+   */
+  clearFeatureFlagsCache(): void {
+    this.cachedData = null
+  }
+
+  /**
+   * Fetches all A/B test experiments for the project.
+   * Results are cached for 5 minutes by default (shared cache with feature flags).
+   *
+   * @param options - Options for evaluating experiments.
+   * @param forceRefresh - If true, bypasses the cache and fetches fresh data.
+   * @returns A promise that resolves to a record of experiment IDs to variant keys.
+   *
+   * @example
+   * ```typescript
+   * const experiments = await getExperiments()
+   * // experiments = { 'exp-123': 'variant-a', 'exp-456': 'control' }
+   * ```
+   */
+  async getExperiments(options?: ExperimentOptions, forceRefresh?: boolean): Promise<Record<string, string>> {
+    if (!isInBrowser()) {
+      return {}
+    }
+
+    const requestedProfileId = options?.profileId ?? this.options?.profileId
+
+    // Check cache first - must match profileId and not be expired
+    if (!forceRefresh && this.cachedData) {
+      const now = Date.now()
+      const isSameProfile = this.cachedData.profileId === requestedProfileId
+      if (isSameProfile && now - this.cachedData.timestamp < DEFAULT_CACHE_DURATION) {
+        return this.cachedData.experiments
+      }
+    }
+
+    try {
+      await this.fetchFlagsAndExperiments(options)
+      return this.cachedData?.experiments || {}
+    } catch (error) {
+      console.warn('[Swetrix] Error fetching experiments:', error)
+      return this.cachedData?.experiments || {}
+    }
+  }
+
+  /**
+   * Gets the variant key for a specific A/B test experiment.
+   *
+   * @param experimentId - The experiment ID.
+   * @param options - Options for evaluating the experiment.
+   * @param defaultVariant - Default variant key to return if the experiment is not found. Defaults to null.
+   * @returns A promise that resolves to the variant key assigned to this user, or defaultVariant if not found.
+   *
+   * @example
+   * ```typescript
+   * const variant = await getExperiment('checkout-redesign')
+   *
+   * if (variant === 'new-checkout') {
+   *   // Show new checkout flow
+   * } else {
+   *   // Show control (original) checkout
+   * }
+   * ```
+   */
+  async getExperiment(
+    experimentId: string,
+    options?: ExperimentOptions,
+    defaultVariant: string | null = null,
+  ): Promise<string | null> {
+    const experiments = await this.getExperiments(options)
+    return experiments[experimentId] ?? defaultVariant
+  }
+
+  /**
+   * Clears the cached experiments (alias for clearFeatureFlagsCache since they share the same cache).
+   */
+  clearExperimentsCache(): void {
+    this.cachedData = null
+  }
+
+  /**
+   * Gets the anonymous profile ID for the current visitor.
+   * If profileId was set via init options, returns that.
+   * Otherwise, requests server to generate one from IP/UA hash.
+   *
+   * This ID can be used for revenue attribution with payment providers.
+   *
+   * @returns A promise that resolves to the profile ID string, or null on error.
+   *
+   * @example
+   * ```typescript
+   * const profileId = await swetrix.getProfileId()
+   *
+   * // Pass to Paddle Checkout for revenue attribution
+   * Paddle.Checkout.open({
+   *   items: [{ priceId: 'pri_01234567890', quantity: 1 }],
+   *   customData: {
+   *     swetrix_profile_id: profileId,
+   *     swetrix_session_id: await swetrix.getSessionId()
+   *   }
+   * })
+   * ```
+   */
+  async getProfileId(): Promise<string | null> {
+    // If profileId is already set in options, return it
+    if (this.options?.profileId) {
+      return this.options.profileId
+    }
+
+    if (!isInBrowser()) {
+      return null
+    }
+
+    try {
+      const apiBase = this.getApiBase()
+      const response = await fetch(`${apiBase}/log/profile-id`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ pid: this.projectID }),
+      })
+
+      if (!response.ok) {
+        return null
+      }
+
+      const data = (await response.json()) as { profileId: string | null }
+      return data.profileId
+    } catch {
+      return null
+    }
+  }
+
+  /**
+   * Gets the current session ID for the visitor.
+   * Session IDs are generated server-side based on IP and user agent.
+   *
+   * This ID can be used for revenue attribution with payment providers.
+   *
+   * @returns A promise that resolves to the session ID string, or null on error.
+   *
+   * @example
+   * ```typescript
+   * const sessionId = await swetrix.getSessionId()
+   *
+   * // Pass to Paddle Checkout for revenue attribution
+   * Paddle.Checkout.open({
+   *   items: [{ priceId: 'pri_01234567890', quantity: 1 }],
+   *   customData: {
+   *     swetrix_profile_id: await swetrix.getProfileId(),
+   *     swetrix_session_id: sessionId
+   *   }
+   * })
+   * ```
+   */
+  async getSessionId(): Promise<string | null> {
+    if (!isInBrowser()) {
+      return null
+    }
+
+    try {
+      const apiBase = this.getApiBase()
+      const response = await fetch(`${apiBase}/log/session-id`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ pid: this.projectID }),
+      })
+
+      if (!response.ok) {
+        return null
+      }
+
+      const data = (await response.json()) as { sessionId: string | null }
+      return data.sessionId
+    } catch {
+      return null
+    }
+  }
+
+  /**
+   * Gets the API base URL (without /log suffix).
+   */
+  private getApiBase(): string {
+    if (this.options?.apiURL) {
+      // Remove trailing /log if present
+      return this.options.apiURL.replace(/\/log\/?$/, '')
+    }
+    return DEFAULT_API_BASE
+  }
+
   private heartbeat(): void {
     if (!this.pageViewsOptions?.heartbeatOnBackground && document.visibilityState === 'hidden') {
       return
     }
 
-    const data = {
+    const data: { pid: string; profileId?: string } = {
       pid: this.projectID,
     }
 
+    if (this.options?.profileId) {
+      data.profileId = this.options.profileId
+    }
+
     this.sendRequest('hb', data)
   }
 
@@ -425,6 +767,7 @@ export class Lib {
       ca: getUTMCampaign(),
       te: getUTMTerm(),
       co: getUTMContent(),
+      profileId: this.options?.profileId,
       ...payload,
     }
 

package/src/index.ts

@@ -9,6 +9,8 @@ import {
   defaultActions,
   IErrorEventPayload,
   IPageViewPayload,
+  FeatureFlagsOptions,
+  ExperimentOptions,
 } from './Lib.js'
 
 export let LIB_INSTANCE: Lib | null = null
@@ -120,6 +122,204 @@ export function pageview(options: IPageviewOptions): void {
   LIB_INSTANCE.submitPageView(options.payload, Boolean(options.unique), {})
 }
 
+/**
+ * Fetches all feature flags for the project.
+ * Results are cached for 5 minutes by default.
+ *
+ * @param options - Options for evaluating feature flags (visitorId, attributes).
+ * @param forceRefresh - If true, bypasses the cache and fetches fresh flags.
+ * @returns A promise that resolves to a record of flag keys to boolean values.
+ *
+ * @example
+ * ```typescript
+ * const flags = await getFeatureFlags({
+ *   visitorId: 'user-123',
+ *   attributes: { cc: 'US', dv: 'desktop' }
+ * })
+ *
+ * if (flags['new-checkout']) {
+ *   // Show new checkout flow
+ * }
+ * ```
+ */
+export async function getFeatureFlags(
+  options?: FeatureFlagsOptions,
+  forceRefresh?: boolean,
+): Promise<Record<string, boolean>> {
+  if (!LIB_INSTANCE) return {}
+
+  return LIB_INSTANCE.getFeatureFlags(options, forceRefresh)
+}
+
+/**
+ * Gets the value of a single feature flag.
+ *
+ * @param key - The feature flag key.
+ * @param options - Options for evaluating the feature flag (visitorId, attributes).
+ * @param defaultValue - Default value to return if the flag is not found. Defaults to false.
+ * @returns A promise that resolves to the boolean value of the flag.
+ *
+ * @example
+ * ```typescript
+ * const isEnabled = await getFeatureFlag('dark-mode', { visitorId: 'user-123' })
+ *
+ * if (isEnabled) {
+ *   // Enable dark mode
+ * }
+ * ```
+ */
+export async function getFeatureFlag(
+  key: string,
+  options?: FeatureFlagsOptions,
+  defaultValue: boolean = false,
+): Promise<boolean> {
+  if (!LIB_INSTANCE) return defaultValue
+
+  return LIB_INSTANCE.getFeatureFlag(key, options, defaultValue)
+}
+
+/**
+ * Clears the cached feature flags, forcing a fresh fetch on the next call.
+ * Useful when you know the user's context has changed significantly.
+ */
+export function clearFeatureFlagsCache(): void {
+  if (!LIB_INSTANCE) return
+
+  LIB_INSTANCE.clearFeatureFlagsCache()
+}
+
+/**
+ * Fetches all A/B test experiments for the project.
+ * Results are cached for 5 minutes by default (shared cache with feature flags).
+ *
+ * @param options - Options for evaluating experiments.
+ * @param forceRefresh - If true, bypasses the cache and fetches fresh data.
+ * @returns A promise that resolves to a record of experiment IDs to variant keys.
+ *
+ * @example
+ * ```typescript
+ * const experiments = await getExperiments()
+ * // experiments = { 'exp-123': 'variant-a', 'exp-456': 'control' }
+ *
+ * // Use the assigned variant
+ * const checkoutVariant = experiments['checkout-experiment-id']
+ * if (checkoutVariant === 'new-checkout') {
+ *   showNewCheckout()
+ * } else {
+ *   showOriginalCheckout()
+ * }
+ * ```
+ */
+export async function getExperiments(
+  options?: ExperimentOptions,
+  forceRefresh?: boolean,
+): Promise<Record<string, string>> {
+  if (!LIB_INSTANCE) return {}
+
+  return LIB_INSTANCE.getExperiments(options, forceRefresh)
+}
+
+/**
+ * Gets the variant key for a specific A/B test experiment.
+ *
+ * @param experimentId - The experiment ID.
+ * @param options - Options for evaluating the experiment.
+ * @param defaultVariant - Default variant key to return if the experiment is not found. Defaults to null.
+ * @returns A promise that resolves to the variant key assigned to this user, or defaultVariant if not found.
+ *
+ * @example
+ * ```typescript
+ * const variant = await getExperiment('checkout-redesign-experiment-id')
+ *
+ * if (variant === 'new-checkout') {
+ *   // Show new checkout flow
+ *   showNewCheckout()
+ * } else if (variant === 'control') {
+ *   // Show original checkout (control group)
+ *   showOriginalCheckout()
+ * } else {
+ *   // Experiment not running or user not included
+ *   showOriginalCheckout()
+ * }
+ * ```
+ */
+export async function getExperiment(
+  experimentId: string,
+  options?: ExperimentOptions,
+  defaultVariant: string | null = null,
+): Promise<string | null> {
+  if (!LIB_INSTANCE) return defaultVariant
+
+  return LIB_INSTANCE.getExperiment(experimentId, options, defaultVariant)
+}
+
+/**
+ * Clears the cached experiments, forcing a fresh fetch on the next call.
+ * This is an alias for clearFeatureFlagsCache since experiments and flags share the same cache.
+ */
+export function clearExperimentsCache(): void {
+  if (!LIB_INSTANCE) return
+
+  LIB_INSTANCE.clearExperimentsCache()
+}
+
+/**
+ * Gets the anonymous profile ID for the current visitor.
+ * If profileId was set via init options, returns that.
+ * Otherwise, requests server to generate one from IP/UA hash.
+ *
+ * This ID can be used for revenue attribution with payment providers like Paddle.
+ *
+ * @returns A promise that resolves to the profile ID string, or null on error.
+ *
+ * @example
+ * ```typescript
+ * const profileId = await getProfileId()
+ *
+ * // Pass to Paddle Checkout for revenue attribution
+ * Paddle.Checkout.open({
+ *   items: [{ priceId: 'pri_01234567890', quantity: 1 }],
+ *   customData: {
+ *     swetrix_profile_id: profileId,
+ *     swetrix_session_id: await getSessionId()
+ *   }
+ * })
+ * ```
+ */
+export async function getProfileId(): Promise<string | null> {
+  if (!LIB_INSTANCE) return null
+
+  return LIB_INSTANCE.getProfileId()
+}
+
+/**
+ * Gets the current session ID for the visitor.
+ * Session IDs are generated server-side based on IP and user agent.
+ *
+ * This ID can be used for revenue attribution with payment providers like Paddle.
+ *
+ * @returns A promise that resolves to the session ID string, or null on error.
+ *
+ * @example
+ * ```typescript
+ * const sessionId = await getSessionId()
+ *
+ * // Pass to Paddle Checkout for revenue attribution
+ * Paddle.Checkout.open({
+ *   items: [{ priceId: 'pri_01234567890', quantity: 1 }],
+ *   customData: {
+ *     swetrix_profile_id: await getProfileId(),
+ *     swetrix_session_id: sessionId
+ *   }
+ * })
+ * ```
+ */
+export async function getSessionId(): Promise<string | null> {
+  if (!LIB_INSTANCE) return null
+
+  return LIB_INSTANCE.getSessionId()
+}
+
 export {
   LibOptions,
   TrackEventOptions,
@@ -129,4 +329,6 @@ export {
   ErrorActions,
   IErrorEventPayload,
   IPageViewPayload,
+  FeatureFlagsOptions,
+  ExperimentOptions,
 }