@qoretechnologies/reqraft 0.10.64 → 0.10.65-pr.137.g62fcecc

package/src/tracking/core/tracker.ts

@@ -1,417 +0,0 @@
-import { ConsentStore } from './consent';
-import { EngagementClock } from './engagement';
-import { assign, ExperimentStore, type IAssignContext, type IAssignment } from './experiments';
-import { eventId, randomId } from './ids';
-import { Observable } from './observable';
-import { EventQueue, type ITransport } from './queue';
-import { SectionClock } from './sections';
-import { readJson, writeJson, type IStorage } from './storage';
-import {
-  resolveConfig,
-  storageKeys,
-  type IBatch,
-  type ITrackingConfig,
-  type IUtm,
-  type TEventType,
-  type TProps,
-  type TStorageKeys,
-  type TTrackingOptions,
-} from './types';
-import { parseUtm, utmParams } from './utm';
-
-/** What the page looks like right now (the browser layer reads it from `window`). */
-export interface IPageInfo {
-  /** `https://example.com` */
-  origin: string;
-  path: string;
-  search: string;
-  title: string;
-  referrer: string;
-  lang: string;
-  viewport: [number, number];
-  device?: IAssignContext['device'];
-}
-
-/** Everything the tracker needs from its host; tests pass fakes. */
-export interface ITrackerEnv {
-  local: IStorage;
-  session: IStorage;
-  transport: ITransport;
-  now: () => number;
-  setTimer: (fn: () => void, ms: number) => unknown;
-  clearTimer: (handle: unknown) => void;
-  page: () => IPageInfo;
-  fetchJson: (url: string, timeoutMs: number) => Promise<unknown>;
-  log?: (...args: unknown[]) => void;
-}
-
-interface IPageView {
-  id: string;
-  path: string;
-  start: number;
-  maxScrollPct: number;
-  summarySeq: number;
-  exposed: Set<string>;
-}
-
-interface IExposureWatch {
-  assignment: IAssignment;
-}
-
-/**
- * The tracker: identity, consent, the event queue, page views and their summaries,
- * experiment assignment and exposure. It has no DOM code of its own (see
- * `browser/attach.ts`), so it runs unchanged in tests and in any web property.
- * Everything product-specific (property, endpoints, storage prefix) is in `config`.
- *
- * Never throws into the page: every public method is wrapped.
- */
-export class Tracker {
-  readonly consent: ConsentStore;
-  readonly experiments: ExperimentStore;
-  readonly sections: SectionClock;
-  private readonly engagement: EngagementClock;
-  private readonly queue: EventQueue;
-  private pv: IPageView | null = null;
-  private lastUrl: string | null = null;
-  private readonly firstTouchUtm: IUtm | null;
-  private watches = new Set<IExposureWatch>();
-  private started = false;
-  /** The current page view id (null without consent): the browser layer re-measures sections on change. */
-  readonly pageViewId = new Observable<string | null>(null);
-  /** The storage keys under `config.storagePrefix`. */
-  readonly keys: TStorageKeys;
-  readonly config: ITrackingConfig;
-
-  constructor(
-    options: TTrackingOptions,
-    private readonly env: ITrackerEnv,
-  ) {
-    // A config built by hand (not through `resolveConfig`) still gets the defaults.
-    const config = resolveConfig(options);
-    this.config = config;
-    this.keys = storageKeys(config.storagePrefix);
-    this.consent = new ConsentStore(env.local, config.consentVersion, this.keys);
-    const first = env.page();
-    this.firstTouchUtm = parseUtm(first.search);
-    this.experiments = new ExperimentStore({
-      property: config.property,
-      endpoint: config.experimentsEndpoint,
-      local: env.local,
-      session: env.session,
-      now: env.now,
-      fetchJson: env.fetchJson,
-      keys: this.keys,
-      previewParam: config.previewParam,
-    });
-    this.experiments.applyPreviewFrom(first.search);
-    this.sections = new SectionClock(env.now());
-    this.engagement = new EngagementClock(config.engagedWindowMs);
-    this.queue = new EventQueue({
-      flushIntervalMs: config.flushIntervalMs,
-      maxQueued: config.maxQueued,
-      transport: env.transport,
-      envelope: () => this.envelope(),
-      now: env.now,
-      setTimer: env.setTimer,
-      clearTimer: env.clearTimer,
-      debug: config.debug ? (b) => env.log?.('[tracking] batch', b) : undefined,
-    });
-    this.sections.onSeen((id) => this.safe(() => this.onSectionSeen(id)));
-    this.consent.state.subscribe(() => this.safe(() => this.onConsentChange()));
-  }
-
-  /** Runs `fn` and swallows any error: analytics never breaks the page. */
-  private safe<T>(fn: () => T): T | undefined {
-    try {
-      return fn();
-    } catch (err) {
-      if (this.config.debug) this.env.log?.('[tracking] error', err);
-      return undefined;
-    }
-  }
-
-  private active = () => this.config.enabled && this.consent.granted();
-
-  /** The tracker's clock (the browser layer times sections with it). */
-  now = (): number => this.env.now();
-
-  // ── identity ────────────────────────────────────────────────────────────────
-
-  /** The visitor id: exists only with consent. */
-  vid(): string | null {
-    if (!this.active()) return null;
-    let vid = this.env.local.get(this.keys.vid);
-    if (!vid) {
-      vid = randomId(16);
-      this.env.local.set(this.keys.vid, vid);
-    }
-    return vid;
-  }
-
-  /** The session id: a new one after `sessionTimeoutMs` without an event. */
-  private sid(touch: boolean): string {
-    const now = this.env.now();
-    const s = readJson<{ id: string; last: number }>(this.env.session, this.keys.sid);
-    const id = s && now - s.last < this.config.sessionTimeoutMs ? s.id : randomId(12);
-    if (touch || !s || s.id !== id) writeJson(this.env.session, this.keys.sid, { id, last: now });
-    return id;
-  }
-
-  private envelope(): Omit<IBatch, 'events' | 'sent_at'> | null {
-    const vid = this.vid();
-    if (!vid) return null;
-    return { v: 1, property: this.config.property, vid, sid: this.sid(false), consent: 'granted' };
-  }
-
-  // ── consent ─────────────────────────────────────────────────────────────────
-
-  grant() {
-    this.safe(() => this.consent.answer('granted'));
-  }
-
-  /** Declines or withdraws: the visitor id and everything tied to it are deleted, nothing more is sent. */
-  deny() {
-    this.safe(() => this.consent.answer('denied'));
-  }
-
-  private onConsentChange() {
-    if (this.consent.granted()) {
-      if (!this.config.enabled) return;
-      this.vid();
-      if (this.firstTouchUtm && !this.env.session.get(this.keys.utm)) writeJson(this.env.session, this.keys.utm, this.firstTouchUtm);
-      this.beginPageView();
-      void this.experiments.load();
-      return;
-    }
-    this.queue.clear();
-    [this.keys.vid, this.keys.exposed].forEach((k) => this.env.local.remove(k));
-    [this.keys.sid, this.keys.utm].forEach((k) => this.env.session.remove(k));
-    this.pv = null;
-    this.pageViewId.set(null);
-  }
-
-  // ── lifecycle ───────────────────────────────────────────────────────────────
-
-  /** Call once when the page has loaded: starts the first page view if consent was given earlier. */
-  start() {
-    this.safe(() => {
-      // Idempotent: React StrictMode mounts twice in development.
-      if (this.started) return;
-      this.started = true;
-      void this.experiments.load();
-      if (!this.active()) return;
-      this.vid();
-      this.beginPageView();
-    });
-  }
-
-  /** A route change in a single-page app: closes the current page view and starts a new one. */
-  pageview() {
-    this.safe(() => {
-      const page = this.env.page();
-      if (this.pv && this.lastUrl === page.path + page.search) return;
-      this.experiments.applyPreviewFrom(page.search);
-      if (!this.active()) return;
-      if (this.pv) this.summary(true);
-      this.beginPageView();
-    });
-  }
-
-  private beginPageView() {
-    const page = this.env.page();
-    const now = this.env.now();
-    const previous = this.lastUrl;
-    this.pv = { id: eventId(), path: page.path, start: now, maxScrollPct: 0, summarySeq: 0, exposed: new Set() };
-    this.lastUrl = page.path + page.search;
-    this.sections.reset(now);
-    this.engagement.reset();
-    this.pageViewId.set(this.pv.id);
-    const firstOfSession = !this.env.session.get(this.keys.sid);
-    const utm = parseUtm(page.search) ?? (firstOfSession ? this.firstTouchUtm : null);
-    this.record('pageview', {
-      // The first page view carries the document referrer; later SPA views the previous page.
-      referrer: previous ? `${page.origin}${previous}` : page.referrer || null,
-      title: page.title,
-      ...(utm ? { utm } : {}),
-      viewport: page.viewport,
-      lang: page.lang,
-    });
-    // Watches whose trigger is the render itself fire once per page view.
-    this.watches.forEach((w) => w.assignment.trigger == null && this.expose(w.assignment, 'render'));
-    this.watches.forEach((w) => w.assignment.trigger != null && this.sections.register(w.assignment.trigger, false));
-  }
-
-  /**
-   * A cumulative summary of the page view. Sent when the tab is hidden (`final:
-   * false`, the visitor may come back) and when the page is left (`final: true`);
-   * the one with the highest `seq` for a `pv_id` is the complete one.
-   */
-  summary(final: boolean) {
-    this.safe(() => {
-      if (!this.pv || !this.active()) return;
-      const now = this.env.now();
-      this.pv.summarySeq += 1;
-      this.record('page_summary', {
-        duration_ms: Math.max(0, Math.round(now - this.pv.start)),
-        engaged_ms: this.engagement.total(now),
-        max_scroll_pct: this.pv.maxScrollPct,
-        exit_section: this.sections.current(),
-        sections: this.sections.summary(now),
-        seq: this.pv.summarySeq,
-        final,
-      });
-    });
-  }
-
-  // ── signals from the browser layer ─────────────────────────────────────────
-
-  activity() {
-    this.safe(() => this.engagement.activity(this.env.now()));
-  }
-
-  scrolled(pct: number) {
-    this.safe(() => {
-      if (this.pv) this.pv.maxScrollPct = Math.max(this.pv.maxScrollPct, Math.min(100, Math.round(pct)));
-    });
-  }
-
-  setTabVisible(visible: boolean) {
-    this.safe(() => {
-      const now = this.env.now();
-      this.sections.setTabVisible(visible, now);
-      this.engagement.setTabVisible(visible, now);
-      if (!visible) {
-        this.summary(false);
-        void this.flush('beacon');
-      }
-    });
-  }
-
-  /** The page is going away (`pagehide`). */
-  leave() {
-    this.safe(() => {
-      this.summary(true);
-      void this.flush('beacon');
-    });
-  }
-
-  flush(mode: 'fetch' | 'beacon' = 'fetch') {
-    return this.safe(() => this.queue.flush(mode)) ?? Promise.resolve();
-  }
-
-  // ── events ──────────────────────────────────────────────────────────────────
-
-  /** Queues an event of any type (nothing happens without consent). */
-  record(type: TEventType, props?: TProps) {
-    this.safe(() => {
-      if (!this.active() || !this.pv) return;
-      this.sid(true);
-      this.queue.push({
-        id: eventId(),
-        type,
-        ts: new Date(this.env.now()).toISOString(),
-        pv_id: this.pv.id,
-        path: this.pv.path,
-        ...(props && Object.keys(props).length ? { props } : {}),
-      });
-    });
-  }
-
-  heartbeat() {
-    this.record('heartbeat');
-  }
-
-  click(props: { target: string; placement?: string | null; label?: string | null; href?: string | null }) {
-    this.record('click', props);
-  }
-
-  /** A conversion the server's goals can match (`signup-started`, …). */
-  goal(name: string, value?: number) {
-    this.record('goal', value == null ? { goal: name } : { goal: name, value });
-  }
-
-  /** A named event with free-form props (`form-submitted`, `plan-picked`, …). */
-  custom(name: string, props: TProps = {}) {
-    this.record('custom', { ...props, name });
-  }
-
-  // ── experiments ─────────────────────────────────────────────────────────────
-
-  /**
-   * The variant for this visitor. Preview override first, then the running
-   * definition; the control whenever consent, the definitions or targeting say no.
-   */
-  decide(key: string, fallbackControl = 'a'): IAssignment {
-    return (
-      this.safe(() => {
-        const def = this.experiments.get(key);
-        const trigger = def?.trigger?.section ?? null;
-        // An ended test shows its winner to everybody (consent or not, previews or not).
-        if (def?.status === 'concluded') return assign(def, null, { path: this.env.page().path });
-        const preview = this.experiments.previewOf(key);
-        if (preview) return { key, variant: preview, enrolled: false, reason: 'preview', trigger } as IAssignment;
-        if (!this.active()) return { key, variant: fallbackControl, enrolled: false, reason: 'no-consent', trigger } as IAssignment;
-        if (!def) return { key, variant: fallbackControl, enrolled: false, reason: 'not-running', trigger: null } as IAssignment;
-        const page = this.env.page();
-        return assign(def, this.vid(), { path: page.path, device: page.device, lang: page.lang });
-      }) ?? { key, variant: fallbackControl, enrolled: false, reason: 'not-running', trigger: null }
-    );
-  }
-
-  /**
-   * Logs the exposure once per page view when the trigger section is seen (or at
-   * once for `trigger: null`). Returns an unsubscribe for when the variant unmounts.
-   */
-  watchExposure(assignment: IAssignment): () => void {
-    if (!assignment.enrolled) return () => undefined;
-    const watch: IExposureWatch = { assignment };
-    this.watches.add(watch);
-    this.safe(() => {
-      if (assignment.trigger == null) this.expose(assignment, 'render');
-      else {
-        this.sections.register(assignment.trigger, false);
-        if (this.sections.isSeen(assignment.trigger)) this.expose(assignment, 'view');
-      }
-    });
-    return () => void this.watches.delete(watch);
-  }
-
-  private onSectionSeen(id: string) {
-    this.watches.forEach((w) => w.assignment.trigger === id && this.expose(w.assignment, 'view'));
-  }
-
-  private expose(a: IAssignment, trigger: 'view' | 'render') {
-    if (!this.pv || !this.active() || this.pv.exposed.has(a.key)) return;
-    this.pv.exposed.add(a.key);
-    const exposed = readJson<Record<string, string>>(this.env.local, this.keys.exposed) ?? {};
-    if (exposed[a.key] !== a.variant) writeJson(this.env.local, this.keys.exposed, { ...exposed, [a.key]: a.variant });
-    this.record('exposure', { experiment: a.key, variant: a.variant, trigger });
-  }
-
-  // ── sign-up attribution ─────────────────────────────────────────────────────
-
-  /**
-   * Adds `qa_exp=key:variant,…` (experiments this visitor was exposed to; the server's
-   * sign-up flow reads this parameter, §5.4 of the contract) and the
-   * session's first-touch `utm_*` to a sign-up URL — nothing else, never the vid.
-   * Without consent the URL is returned unchanged.
-   */
-  decorateSignupUrl(url: string): string {
-    return (
-      this.safe(() => {
-        if (!this.active()) return url;
-        const u = new URL(url);
-        const exposed = readJson<Record<string, string>>(this.env.local, this.keys.exposed) ?? {};
-        const pairs = Object.entries(exposed)
-          .filter(([k, v]) => k && v)
-          .sort(([a], [b]) => a.localeCompare(b))
-          .map(([k, v]) => `${k}:${v}`);
-        if (pairs.length) u.searchParams.set('qa_exp', pairs.join(','));
-        const utm = readJson<IUtm>(this.env.session, this.keys.utm) ?? this.firstTouchUtm;
-        utmParams(utm).forEach(([k, v]) => u.searchParams.set(k, v));
-        return u.toString();
-      }) ?? url
-    );
-  }
-}

package/src/tracking/core/types.ts

@@ -1,162 +0,0 @@
-/**
- * Wire types of the first-party tracker. The contract (event shapes, batch envelope,
- * experiment definitions) is owned by qorus-api `design/analytics-and-experiments-design.md`
- * (§4 collector, §5 experiments); change it there first, then here.
- */
-
-export type TConsentState = 'unknown' | 'granted' | 'denied';
-
-/** Event types the collector knows. New ones are allowed without a schema change (§4). */
-export type TEventType =
-  | 'pageview'
-  | 'page_summary'
-  | 'click'
-  | 'heartbeat'
-  | 'exposure'
-  | 'goal'
-  | 'custom'
-  | (string & Record<never, never>);
-
-export type TProps = Record<string, unknown>;
-
-export interface ITrackedEvent {
-  /** Random id: makes the write idempotent (retries, beacon + fetch fallback). */
-  id: string;
-  type: TEventType;
-  /** ISO timestamp of when it happened in the browser. */
-  ts: string;
-  pv_id: string;
-  path: string;
-  props?: TProps;
-}
-
-export interface IBatch {
-  v: 1;
-  property: string;
-  vid: string;
-  sid: string;
-  sent_at: string;
-  consent: 'granted';
-  events: ITrackedEvent[];
-}
-
-export interface IUtm {
-  source?: string;
-  medium?: string;
-  campaign?: string;
-  term?: string;
-  content?: string;
-}
-
-/** Public fields of a running experiment (the experiments endpoint, `?property=…`). */
-export interface IExperimentVariant {
-  key: string;
-  weight: number;
-  control?: boolean;
-}
-
-export interface IExperimentDefinition {
-  key: string;
-  /**
-   * `running` (assign and log), or `concluded`: everybody sees `winner`, nothing is logged. A
-   * concluded entry carries only `key`, `status` and `winner`; its `variants` are normalised to [].
-   */
-  status?: 'running' | 'concluded' | (string & Record<never, never>);
-  winner?: string | null;
-  /** Counter of the running experiment's phase (a removed version starts a new one). */
-  phase?: number;
-  variants: IExperimentVariant[];
-  /** Share of visitors enrolled, 0..1 (the rest see the control, no exposure). */
-  traffic: number;
-  targeting?: { paths?: string[] | null; device?: string | null; lang?: string | null } | null;
-  /** The element whose being seen counts as exposure; none → exposure on render. */
-  trigger?: { section?: string | null } | null;
-}
-
-/** Everything the tracker needs from its host. Every product-specific value lives here. */
-export interface ITrackingConfig {
-  /**
-   * Which product the events belong to (`landing`, `ide`, `admin`, …). The server keeps each
-   * property's events, goals and experiments apart, and the experiments list is fetched for it.
-   */
-  property: string;
-  /** Collector URL (`POST`, the batch envelope of §4 of the contract). */
-  endpoint: string;
-  /** Running-experiments URL (`GET`); `?property=` is appended. */
-  experimentsEndpoint: string;
-  /** Master switch: false → nothing is ever sent, experiments serve the control. */
-  enabled: boolean;
-  /** Bump when the consent text changes materially: stored answers of older versions are asked again. */
-  consentVersion: number;
-  /**
-   * Prefix of every localStorage / sessionStorage key the tracker writes (default `qa.`, the
-   * contract's). Two products on one origin need different prefixes, or they share one consent
-   * answer, one visitor id and one experiments cache.
-   */
-  storagePrefix: string;
-  /** Query parameter of a shareable variant preview (`?qa_variant=key:variant`). */
-  previewParam: string;
-  /** Log every batch to the console instead of silently sending. */
-  debug: boolean;
-  flushIntervalMs: number;
-  /** Flush as soon as this many events are queued. */
-  maxQueued: number;
-  heartbeatMs: number;
-  sessionTimeoutMs: number;
-  /** An interaction within this window counts the time as engaged. */
-  engagedWindowMs: number;
-}
-
-/** The config fields every product must set: nothing product-specific has a default. */
-export type TRequiredTrackingConfig = 'property' | 'endpoint' | 'experimentsEndpoint';
-
-export const DEFAULT_STORAGE_PREFIX = 'qa.';
-
-export const DEFAULT_CONFIG: Omit<ITrackingConfig, TRequiredTrackingConfig> = {
-  enabled: true,
-  consentVersion: 1,
-  storagePrefix: DEFAULT_STORAGE_PREFIX,
-  previewParam: 'qa_variant',
-  debug: false,
-  flushIntervalMs: 5000,
-  maxQueued: 20,
-  heartbeatMs: 15000,
-  sessionTimeoutMs: 30 * 60 * 1000,
-  engagedWindowMs: 10000,
-};
-
-/** What a product passes: the required fields, and any default it wants to change. */
-export type TTrackingOptions = Partial<ITrackingConfig> & Pick<ITrackingConfig, TRequiredTrackingConfig>;
-
-/** The full config: `options` over `DEFAULT_CONFIG` (an `undefined` option keeps the default). */
-export const resolveConfig = (options: TTrackingOptions): ITrackingConfig => {
-  const set = Object.fromEntries(Object.entries(options).filter(([, v]) => v !== undefined));
-  return { ...DEFAULT_CONFIG, ...set } as ITrackingConfig;
-};
-
-/** The storage keys for one prefix (first-party, removable in one sweep). */
-export const storageKeys = (prefix: string = DEFAULT_STORAGE_PREFIX) => ({
-  /** localStorage: `granted` | `denied` */
-  consent: `${prefix}consent`,
-  /** localStorage: the consent version that was answered */
-  consentVersion: `${prefix}consent.v`,
-  /** localStorage: the visitor id (exists only with consent) */
-  vid: `${prefix}vid`,
-  /** sessionStorage: `{ id, last }` */
-  sid: `${prefix}sid`,
-  /** sessionStorage: first-touch utm of this session */
-  utm: `${prefix}utm`,
-  /** localStorage: `{ experimentKey: variant }` the visitor was exposed to (sign-up attribution) */
-  exposed: `${prefix}exp`,
-  /** sessionStorage: preview overrides from the preview query parameter */
-  preview: `${prefix}preview`,
-  /** localStorage: last fetched public experiment definitions */
-  experimentsCache: `${prefix}experiments`,
-  /** localStorage: an in-app version switch per experiment (`{ key: variant }`), never logged */
-  editorVariants: `${prefix}editor.variants`,
-});
-
-export type TStorageKeys = ReturnType<typeof storageKeys>;
-
-/** The keys with the default prefix (`qa.consent`, `qa.vid`, …). */
-export const KEYS: TStorageKeys = storageKeys(DEFAULT_STORAGE_PREFIX);

package/src/tracking/core/utm.ts

@@ -1,23 +0,0 @@
-import type { IUtm } from './types';
-
-const UTM_FIELDS = ['source', 'medium', 'campaign', 'term', 'content'] as const;
-
-/** The `utm_*` parameters of a query string, or null when there are none. */
-export const parseUtm = (search: string): IUtm | null => {
-  let params: URLSearchParams;
-  try {
-    params = new URLSearchParams(search);
-  } catch {
-    return null;
-  }
-  const utm: IUtm = {};
-  for (const f of UTM_FIELDS) {
-    const v = params.get(`utm_${f}`)?.trim();
-    if (v) utm[f] = v.slice(0, 200);
-  }
-  return Object.keys(utm).length ? utm : null;
-};
-
-/** `{ source: 'x' }` → `[['utm_source', 'x']]`, in a stable order. */
-export const utmParams = (utm: IUtm | null | undefined): [string, string][] =>
-  utm ? UTM_FIELDS.filter((f) => utm[f]).map((f) => [`utm_${f}`, utm[f] as string]) : [];

package/src/tracking/index.ts

@@ -1,72 +0,0 @@
-/**
- * First-party tracking, consent and A/B testing for any Qore web app.
- *
- * How to use it: design/TRACKING.md in this repo.
- * The contract (events, experiments, storage): qorus-api design/analytics-and-experiments-design.md.
- *
- * Layers (each only imports the ones above it):
- *   core/     plain TypeScript, no DOM: ids, consent, queue, sections, hashing, assignment, Tracker
- *   browser/  wiring to window/document: transport, IntersectionObserver, listeners
- *   react/    <TrackingProvider>, useConsent, useExperiment, <Experiment>
- * Nothing product-specific lives here: the property, endpoints, consent version and storage
- * prefix come from the config each app passes to `createBrowserTracker`.
- */
-import { attachToPage, type IAttached } from './browser/attach';
-import { browserEnv } from './browser/env';
-import { Tracker } from './core/tracker';
-import { resolveConfig, type TTrackingOptions } from './core/types';
-
-export { Tracker } from './core/tracker';
-export type { IPageInfo, ITrackerEnv } from './core/tracker';
-export { ConsentStore } from './core/consent';
-export {
-  assign,
-  bucketRanges,
-  controlOf,
-  DEFAULT_PREVIEW_PARAM,
-  ExperimentStore,
-  normaliseDefinition,
-  parsePreview,
-  pathMatches,
-} from './core/experiments';
-export type { IAssignContext, IAssignment, TAssignmentReason, TExperimentsStatus } from './core/experiments';
-export { fnv1a32, hashV2 } from './core/hash';
-export { Observable } from './core/observable';
-export { EventQueue } from './core/queue';
-export type { ITransport } from './core/queue';
-export { effectiveRatio, SectionClock } from './core/sections';
-export type { ISectionSummary } from './core/sections';
-export { memoryStorage, readJson, safeStorage, writeJson } from './core/storage';
-export type { IStorage } from './core/storage';
-export { parseUtm, utmParams } from './core/utm';
-export { DEFAULT_CONFIG, DEFAULT_STORAGE_PREFIX, KEYS, resolveConfig, storageKeys } from './core/types';
-export type {
-  IBatch,
-  IExperimentDefinition,
-  IExperimentVariant,
-  ITrackedEvent,
-  ITrackingConfig,
-  IUtm,
-  TConsentState,
-  TEventType,
-  TProps,
-  TRequiredTrackingConfig,
-  TStorageKeys,
-  TTrackingOptions,
-} from './core/types';
-export { attachToPage } from './browser/attach';
-export type { IAttached } from './browser/attach';
-export { browserEnv, browserTransport, deviceOf } from './browser/env';
-
-/** A tracker for a real browser page. Call `attach()` once the page is up (`<TrackingProvider>` does). */
-export const createBrowserTracker = (options: TTrackingOptions): { tracker: Tracker; attach: () => IAttached } => {
-  const config = resolveConfig(options);
-  const tracker = new Tracker(config, browserEnv(config.endpoint));
-  return { tracker, attach: () => attachToPage(tracker, config.heartbeatMs) };
-};
-
-export { trackClick, trackSection } from './markup';
-export type { TTrackAttributes } from './markup';
-export * from './react';
-export { createMemoryTracker } from './testing';
-export type { IMemoryTracker, IMemoryTrackerOptions } from './testing';

package/src/tracking/markup.ts

@@ -1,17 +0,0 @@
-/**
- * The markup contract as props, for places where JSX `data-*` attributes cannot be
- * written directly (a Reqore panel action or a tier's `actionButtonProps` are
- * object literals). In JSX, `data-track-click="…"` works just as well.
- *
- *   <ReqoreButton {...trackClick('get-started', 'cta')} … />
- *   bottomActions={[{ ...primaryCta, ...trackClick('contact', 'pricing-panel'), label: … }]}
- */
-export type TTrackAttributes = Record<`data-track-${string}`, string>;
-
-export const trackClick = (target: string, placement?: string, label?: string): TTrackAttributes => ({
-  'data-track-click': target,
-  ...(placement ? { 'data-track-placement': placement } : {}),
-  ...(label ? { 'data-track-label': label } : {}),
-});
-
-export const trackSection = (id: string): TTrackAttributes => ({ 'data-track-section': id });