@preprio/toolkit 0.1.0-beta.1

package/dist/nextjs/index.d.cts

@@ -0,0 +1,90 @@
+import { NextRequest, NextResponse } from 'next/server';
+export { PreprToolbar, PreprTrackingPixel, PreprTrackingPixelProps } from './components';
+
+interface PreprMiddlewareOptions {
+    /** Enable preview-mode headers (segment/AB overrides, preview bar). */
+    preview?: boolean;
+    /** Override the version reported in Prepr-Package (mainly for tests). */
+    version?: string;
+}
+
+/**
+ * Next.js middleware entry point. Despite the `create` prefix this runs
+ * per-request — it does not return a handler. Pass an existing `NextResponse`
+ * as the second argument to chain with other middleware.
+ */
+declare function createPreprMiddleware(request: NextRequest, options?: PreprMiddlewareOptions): NextResponse;
+declare function createPreprMiddleware(request: NextRequest, response: NextResponse, options?: PreprMiddlewareOptions): NextResponse;
+
+interface PreprSegment {
+    readonly _id: string;
+    readonly name: string;
+}
+interface PreprToolbarProps {
+    readonly activeSegment: string | null;
+    readonly activeVariant: string | null;
+    /** Available segments to personalize on. */
+    readonly segments?: readonly PreprSegment[];
+    /** @deprecated Alias for `segments`. */
+    readonly data?: readonly PreprSegment[];
+}
+type PreprVariant = 'A' | 'B';
+interface PreprHeaders {
+    readonly 'prepr-customer-id'?: string;
+    readonly 'Prepr-Segments'?: string;
+    readonly 'Prepr-ABtesting'?: PreprVariant;
+    readonly 'Prepr-Preview-Bar'?: 'true';
+    readonly 'Prepr-Context-utm_source'?: string;
+    readonly 'Prepr-Context-utm_medium'?: string;
+    readonly 'Prepr-Context-utm_term'?: string;
+    readonly 'Prepr-Context-utm_content'?: string;
+    readonly 'Prepr-Context-utm_campaign'?: string;
+    readonly 'Prepr-Context-initial_referral'?: string;
+    readonly 'Prepr-Visitor-IP'?: string;
+    readonly 'Prepr-Hubspot-Id'?: string;
+    readonly 'Prepr-Customer-Id-Created'?: 'true';
+    readonly 'Prepr-User-Agent'?: string;
+}
+type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
+
+/** Prepr Customer ID for the current request. Server-only. */
+declare function getPreprUUID(): Promise<string | null>;
+/** Active segment for the current request. Server-only. */
+declare function getActiveSegment(): Promise<string | null>;
+/** Active A/B variant for the current request. Server-only. */
+declare function getActiveVariant(): Promise<string | null>;
+/** All Prepr headers for the current request, to forward to a GraphQL fetch. Server-only. */
+declare function getPreprHeaders(): Promise<PreprHeaders>;
+/**
+ * Props needed to mount `PreprToolbar`, from the current request's headers plus
+ * a Prepr GraphQL token.
+ *
+ * Ungated: call it only when your app is in preview mode. Resolve that however
+ * your deployment already does (`VERCEL_ENV`, a branch check, your own flag) —
+ * the toolkit reads no environment variables of its own.
+ *
+ * Never throws: segment-fetch failures degrade to an empty segment list, so a
+ * bad or missing token can't crash the host app.
+ */
+declare function getToolbarProps(token: string): Promise<PreprToolbarProps>;
+
+/** Error thrown by the token helpers and the segments fetch. */
+declare class PreprError extends Error {
+    readonly code: PreprErrorCode;
+    readonly context?: string | undefined;
+    readonly originalError?: Error | undefined;
+    constructor(message: string, code: PreprErrorCode, context?: string | undefined, originalError?: Error | undefined);
+}
+/**
+ * Asserts `token` is the full `https://graphql.prepr.io/<token>` URL.
+ * @throws PreprError if the token is missing or not an HTTPS URL.
+ */
+declare function validatePreprToken(token: string): void;
+/**
+ * Pulls the access token out of a GraphQL URL: `https://graphql.prepr.io/abc123`
+ * -> `abc123`.
+ * @throws PreprError if the URL is not a valid `graphql.prepr.io` URL.
+ */
+declare function extractAccessToken(graphqlUrl: string): string;
+
+export { PreprError, type PreprMiddlewareOptions, createPreprMiddleware, extractAccessToken, getActiveSegment, getActiveVariant, getPreprHeaders, getPreprUUID, getToolbarProps, validatePreprToken };

package/dist/nextjs/index.d.ts

@@ -0,0 +1,90 @@
+import { NextRequest, NextResponse } from 'next/server';
+export { PreprToolbar, PreprTrackingPixel, PreprTrackingPixelProps } from './components';
+
+interface PreprMiddlewareOptions {
+    /** Enable preview-mode headers (segment/AB overrides, preview bar). */
+    preview?: boolean;
+    /** Override the version reported in Prepr-Package (mainly for tests). */
+    version?: string;
+}
+
+/**
+ * Next.js middleware entry point. Despite the `create` prefix this runs
+ * per-request — it does not return a handler. Pass an existing `NextResponse`
+ * as the second argument to chain with other middleware.
+ */
+declare function createPreprMiddleware(request: NextRequest, options?: PreprMiddlewareOptions): NextResponse;
+declare function createPreprMiddleware(request: NextRequest, response: NextResponse, options?: PreprMiddlewareOptions): NextResponse;
+
+interface PreprSegment {
+    readonly _id: string;
+    readonly name: string;
+}
+interface PreprToolbarProps {
+    readonly activeSegment: string | null;
+    readonly activeVariant: string | null;
+    /** Available segments to personalize on. */
+    readonly segments?: readonly PreprSegment[];
+    /** @deprecated Alias for `segments`. */
+    readonly data?: readonly PreprSegment[];
+}
+type PreprVariant = 'A' | 'B';
+interface PreprHeaders {
+    readonly 'prepr-customer-id'?: string;
+    readonly 'Prepr-Segments'?: string;
+    readonly 'Prepr-ABtesting'?: PreprVariant;
+    readonly 'Prepr-Preview-Bar'?: 'true';
+    readonly 'Prepr-Context-utm_source'?: string;
+    readonly 'Prepr-Context-utm_medium'?: string;
+    readonly 'Prepr-Context-utm_term'?: string;
+    readonly 'Prepr-Context-utm_content'?: string;
+    readonly 'Prepr-Context-utm_campaign'?: string;
+    readonly 'Prepr-Context-initial_referral'?: string;
+    readonly 'Prepr-Visitor-IP'?: string;
+    readonly 'Prepr-Hubspot-Id'?: string;
+    readonly 'Prepr-Customer-Id-Created'?: 'true';
+    readonly 'Prepr-User-Agent'?: string;
+}
+type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
+
+/** Prepr Customer ID for the current request. Server-only. */
+declare function getPreprUUID(): Promise<string | null>;
+/** Active segment for the current request. Server-only. */
+declare function getActiveSegment(): Promise<string | null>;
+/** Active A/B variant for the current request. Server-only. */
+declare function getActiveVariant(): Promise<string | null>;
+/** All Prepr headers for the current request, to forward to a GraphQL fetch. Server-only. */
+declare function getPreprHeaders(): Promise<PreprHeaders>;
+/**
+ * Props needed to mount `PreprToolbar`, from the current request's headers plus
+ * a Prepr GraphQL token.
+ *
+ * Ungated: call it only when your app is in preview mode. Resolve that however
+ * your deployment already does (`VERCEL_ENV`, a branch check, your own flag) —
+ * the toolkit reads no environment variables of its own.
+ *
+ * Never throws: segment-fetch failures degrade to an empty segment list, so a
+ * bad or missing token can't crash the host app.
+ */
+declare function getToolbarProps(token: string): Promise<PreprToolbarProps>;
+
+/** Error thrown by the token helpers and the segments fetch. */
+declare class PreprError extends Error {
+    readonly code: PreprErrorCode;
+    readonly context?: string | undefined;
+    readonly originalError?: Error | undefined;
+    constructor(message: string, code: PreprErrorCode, context?: string | undefined, originalError?: Error | undefined);
+}
+/**
+ * Asserts `token` is the full `https://graphql.prepr.io/<token>` URL.
+ * @throws PreprError if the token is missing or not an HTTPS URL.
+ */
+declare function validatePreprToken(token: string): void;
+/**
+ * Pulls the access token out of a GraphQL URL: `https://graphql.prepr.io/abc123`
+ * -> `abc123`.
+ * @throws PreprError if the URL is not a valid `graphql.prepr.io` URL.
+ */
+declare function extractAccessToken(graphqlUrl: string): string;
+
+export { PreprError, type PreprMiddlewareOptions, createPreprMiddleware, extractAccessToken, getActiveSegment, getActiveVariant, getPreprHeaders, getPreprUUID, getToolbarProps, validatePreprToken };

package/dist/nextjs/index.js

@@ -0,0 +1,352 @@
+// src/nextjs/middleware.ts
+import { NextResponse } from "next/server";
+
+// src/version.ts
+var VERSION = "0.1.0-beta.1";
+
+// src/core/constants.ts
+var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
+var COOKIE_SEGMENT = "Prepr-Segments";
+var COOKIE_VARIANT = "Prepr-ABtesting";
+var COOKIE_UID = "__prepr_uid";
+var COOKIE_HUBSPOT = "hubspotutk";
+var PARAM_SEGMENT = "prepr_preview_segment";
+var PARAM_VARIANT = "prepr_preview_ab";
+var PARAM_HIDE_BAR = "prepr_hide_bar";
+var ONE_YEAR_SECONDS = 60 * 60 * 24 * 365;
+
+// src/core/middleware.ts
+var UTM_PARAMS = [
+  "utm_source",
+  "utm_medium",
+  "utm_term",
+  "utm_content",
+  "utm_campaign"
+];
+function parseCookies(request) {
+  const cookies = /* @__PURE__ */ new Map();
+  const header = request.headers.get("cookie");
+  if (!header) return cookies;
+  for (const part of header.split(";")) {
+    const eq = part.indexOf("=");
+    if (eq === -1) continue;
+    const name = part.slice(0, eq).trim();
+    const value = part.slice(eq + 1).trim();
+    if (!name) continue;
+    cookies.set(name, decodeURIComponent(value));
+  }
+  return cookies;
+}
+function processPreprRequest(request, opts) {
+  const requestHeaders = new Headers(request.headers);
+  const responseCookies = [];
+  const requestCookies = parseCookies(request);
+  const searchParams = new URL(request.url).searchParams;
+  for (const key of UTM_PARAMS) {
+    const value = searchParams.get(key);
+    if (value !== null) {
+      requestHeaders.set(`Prepr-Context-${key}`, value);
+    }
+  }
+  const referer = request.headers.get("referer");
+  if (referer) {
+    requestHeaders.set("Prepr-Context-initial_referral", referer);
+  }
+  const userAgent = request.headers.get("user-agent");
+  if (userAgent) {
+    requestHeaders.set("Prepr-User-Agent", userAgent);
+  }
+  requestHeaders.set("Prepr-Package", `@preprio/toolkit@${opts?.version ?? VERSION}`);
+  const ip = request.headers.get("Cf-Connecting-Ip") ?? request.headers.get("x-real-ip");
+  if (ip) {
+    requestHeaders.set("Prepr-Visitor-IP", ip);
+  }
+  const hutkCookie = requestCookies.get(COOKIE_HUBSPOT);
+  if (hutkCookie) {
+    requestHeaders.set("Prepr-Hubspot-Id", hutkCookie);
+  }
+  let uid = requestCookies.get(COOKIE_UID);
+  if (!uid) {
+    uid = crypto.randomUUID();
+    responseCookies.push({
+      name: COOKIE_UID,
+      value: uid,
+      maxAge: ONE_YEAR_SECONDS,
+      path: "/"
+    });
+    requestHeaders.set("Prepr-Customer-Id-Created", "true");
+  }
+  requestHeaders.set("Prepr-Customer-Id", uid);
+  if (!opts?.preview) {
+    return { requestHeaders, responseCookies };
+  }
+  const hasPreviewParams = searchParams.has(PARAM_SEGMENT) || searchParams.has(PARAM_VARIANT);
+  if (!hasPreviewParams) {
+    const previewModeCookie = requestCookies.get(COOKIE_PREVIEW_MODE);
+    const previewModeEnabled = previewModeCookie !== "false";
+    if (!previewModeEnabled) {
+      return { requestHeaders, responseCookies };
+    }
+  }
+  requestHeaders.set("Prepr-Preview-Bar", "true");
+  const isLivePreview = searchParams.get(PARAM_HIDE_BAR) === "true";
+  if (!isLivePreview) {
+    const segmentCookie = requestCookies.get(COOKIE_SEGMENT);
+    if (segmentCookie) {
+      requestHeaders.set("Prepr-Segments", segmentCookie);
+    }
+    const abCookie = requestCookies.get(COOKIE_VARIANT);
+    if (abCookie) {
+      requestHeaders.set("Prepr-ABtesting", abCookie);
+    }
+  }
+  const previewAb = searchParams.get(PARAM_VARIANT);
+  if (previewAb !== null) {
+    requestHeaders.set("Prepr-ABtesting", previewAb);
+    if (!isLivePreview) {
+      responseCookies.push({
+        name: COOKIE_VARIANT,
+        value: previewAb,
+        maxAge: ONE_YEAR_SECONDS,
+        path: "/"
+      });
+    }
+  }
+  const previewSegment = searchParams.get(PARAM_SEGMENT);
+  if (previewSegment !== null) {
+    requestHeaders.set("Prepr-Segments", previewSegment);
+    if (!isLivePreview) {
+      responseCookies.push({
+        name: COOKIE_SEGMENT,
+        value: previewSegment,
+        maxAge: ONE_YEAR_SECONDS,
+        path: "/"
+      });
+    }
+  }
+  return { requestHeaders, responseCookies };
+}
+
+// src/nextjs/middleware.ts
+function createPreprMiddleware(request, responseOrOptions, maybeOptions) {
+  let chainedResponse;
+  let options;
+  if (responseOrOptions instanceof NextResponse) {
+    chainedResponse = responseOrOptions;
+    options = maybeOptions;
+  } else {
+    options = responseOrOptions;
+  }
+  const { requestHeaders, responseCookies } = processPreprRequest(request, options);
+  const response = chainedResponse ?? NextResponse.next({ request: { headers: requestHeaders } });
+  if (chainedResponse) {
+    requestHeaders.forEach((value, key) => {
+      response.headers.set(key, value);
+    });
+  }
+  for (const cookie of responseCookies) {
+    response.cookies.set(cookie.name, cookie.value, {
+      maxAge: cookie.maxAge,
+      path: cookie.path
+    });
+  }
+  return response;
+}
+
+// src/nextjs/server.ts
+import { headers } from "next/headers";
+
+// src/core/server.ts
+var PreprError = class extends Error {
+  constructor(message, code, context, originalError) {
+    super(message);
+    this.code = code;
+    this.context = context;
+    this.originalError = originalError;
+    this.name = "PreprError";
+  }
+};
+function getPreprUUIDFromHeaders(headers2) {
+  return headers2.get("prepr-customer-id");
+}
+function getActiveSegmentFromHeaders(headers2) {
+  return headers2.get("Prepr-Segments");
+}
+function getActiveVariantFromHeaders(headers2) {
+  return headers2.get("Prepr-ABtesting");
+}
+var PREPR_HEADER_KEYS = [
+  "prepr-customer-id",
+  "Prepr-Segments",
+  "Prepr-ABtesting",
+  "Prepr-Preview-Bar",
+  "Prepr-Context-utm_source",
+  "Prepr-Context-utm_medium",
+  "Prepr-Context-utm_term",
+  "Prepr-Context-utm_content",
+  "Prepr-Context-utm_campaign",
+  "Prepr-Context-initial_referral",
+  "Prepr-Visitor-IP",
+  "Prepr-Hubspot-Id",
+  "Prepr-Customer-Id-Created",
+  "Prepr-User-Agent"
+];
+function getPreprHeadersFromHeaders(headers2) {
+  const preprHeaders = {};
+  const copy = (key) => {
+    const value = headers2.get(key);
+    if (value !== null) {
+      preprHeaders[key] = value;
+    }
+  };
+  for (const key of PREPR_HEADER_KEYS) {
+    copy(key);
+  }
+  return preprHeaders;
+}
+function validatePreprToken(token) {
+  if (!token) {
+    throw new PreprError("Token is required", "MISSING_TOKEN", "validatePreprToken");
+  }
+  if (!token.startsWith("https://")) {
+    throw new PreprError(
+      "Token must be a valid HTTPS URL",
+      "INVALID_TOKEN",
+      "validatePreprToken"
+    );
+  }
+}
+function extractAccessToken(graphqlUrl) {
+  let url;
+  try {
+    url = new URL(graphqlUrl);
+  } catch (error) {
+    throw new PreprError(
+      "Token must be a valid URL",
+      "INVALID_TOKEN",
+      "extractAccessToken",
+      error instanceof Error ? error : new Error(String(error))
+    );
+  }
+  if (url.hostname !== "graphql.prepr.io") {
+    throw new PreprError(
+      "Token must be a graphql.prepr.io URL",
+      "INVALID_TOKEN",
+      "extractAccessToken"
+    );
+  }
+  const pathParts = url.pathname.split("/");
+  const token = pathParts[pathParts.length - 1];
+  if (!token) {
+    throw new PreprError(
+      "Token URL is missing an access token segment",
+      "INVALID_TOKEN",
+      "extractAccessToken"
+    );
+  }
+  return token;
+}
+async function getPreprEnvironmentSegments(token) {
+  validatePreprToken(token);
+  try {
+    const response = await fetch(token, {
+      headers: {
+        "User-Agent": `Prepr-Preview-Bar/${VERSION}`,
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      body: JSON.stringify({
+        query: `{
+                _Segments {
+                    _id
+                    name
+                }
+            }`
+      })
+    });
+    if (!response.ok) {
+      throw new PreprError(
+        `HTTP ${response.status}: ${response.statusText}`,
+        "HTTP_ERROR",
+        "getPreprEnvironmentSegments"
+      );
+    }
+    const json = await response.json();
+    if (!json || !json.data || !json.data._Segments) {
+      throw new PreprError(
+        "Invalid response format from Prepr API",
+        "INVALID_RESPONSE",
+        "getPreprEnvironmentSegments"
+      );
+    }
+    return json.data._Segments;
+  } catch (error) {
+    if (error instanceof PreprError) {
+      throw error;
+    }
+    throw new PreprError(
+      "Failed to fetch segments from Prepr API",
+      "FETCH_ERROR",
+      "getPreprEnvironmentSegments",
+      error instanceof Error ? error : new Error(String(error))
+    );
+  }
+}
+async function getToolbarPropsFromHeaders(headers2, token) {
+  let segments = [];
+  try {
+    segments = await getPreprEnvironmentSegments(token);
+  } catch {
+    segments = [];
+  }
+  return {
+    activeSegment: getActiveSegmentFromHeaders(headers2),
+    activeVariant: getActiveVariantFromHeaders(headers2),
+    segments,
+    data: segments
+  };
+}
+
+// src/nextjs/server.ts
+async function readHeaders() {
+  return await headers();
+}
+async function getPreprUUID() {
+  const h = await readHeaders();
+  return getPreprUUIDFromHeaders(h);
+}
+async function getActiveSegment() {
+  const h = await readHeaders();
+  return getActiveSegmentFromHeaders(h);
+}
+async function getActiveVariant() {
+  const h = await readHeaders();
+  return getActiveVariantFromHeaders(h);
+}
+async function getPreprHeaders() {
+  const h = await readHeaders();
+  return getPreprHeadersFromHeaders(h);
+}
+async function getToolbarProps(token) {
+  const h = await readHeaders();
+  return getToolbarPropsFromHeaders(h, token);
+}
+
+// src/nextjs/index.ts
+import {
+  PreprToolbar,
+  PreprTrackingPixel
+} from "./components";
+export {
+  PreprError,
+  PreprToolbar,
+  PreprTrackingPixel,
+  createPreprMiddleware,
+  extractAccessToken,
+  getActiveSegment,
+  getActiveVariant,
+  getPreprHeaders,
+  getPreprUUID,
+  getToolbarProps,
+  validatePreprToken
+};

package/dist/pixel-DVSJQC0K.d.cts

@@ -0,0 +1,94 @@
+type Dictionary = Record<string, unknown>;
+declare const dictionaries: {
+    en: Dictionary;
+    nl: Dictionary;
+};
+type Locale = keyof typeof dictionaries;
+
+interface PreprSegment {
+    readonly _id: string;
+    readonly name: string;
+}
+interface PreprToolbarOptions {
+    debug?: boolean;
+    locale?: Locale;
+}
+interface PreprToolbarProps {
+    readonly activeSegment: string | null;
+    readonly activeVariant: string | null;
+    /** Available segments to personalize on. */
+    readonly segments?: readonly PreprSegment[];
+    /** @deprecated Alias for `segments`. */
+    readonly data?: readonly PreprSegment[];
+}
+type PreprHeaderName = 'prepr-customer-id' | 'Prepr-Segments' | 'Prepr-ABtesting' | 'Prepr-User-Agent';
+type PreprVariant = 'A' | 'B';
+type PreprEnvironment = 'preview' | 'production';
+type PreprEventType = 'segment_changed' | 'variant_changed' | 'edit_mode_toggled' | 'preview_mode_toggled' | 'getScrollPosition' | 'loaded' | 'field_edit_requested';
+interface PreprHeaders {
+    readonly 'prepr-customer-id'?: string;
+    readonly 'Prepr-Segments'?: string;
+    readonly 'Prepr-ABtesting'?: PreprVariant;
+    readonly 'Prepr-Preview-Bar'?: 'true';
+    readonly 'Prepr-Context-utm_source'?: string;
+    readonly 'Prepr-Context-utm_medium'?: string;
+    readonly 'Prepr-Context-utm_term'?: string;
+    readonly 'Prepr-Context-utm_content'?: string;
+    readonly 'Prepr-Context-utm_campaign'?: string;
+    readonly 'Prepr-Context-initial_referral'?: string;
+    readonly 'Prepr-Visitor-IP'?: string;
+    readonly 'Prepr-Hubspot-Id'?: string;
+    readonly 'Prepr-Customer-Id-Created'?: 'true';
+    readonly 'Prepr-User-Agent'?: string;
+}
+type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
+
+/**
+ * Loader + typed facade for Prepr's CDN tracking pixel, so consumers don't have
+ * to paste a `<script>` tag. The pixel itself lives on the CDN; this only sets
+ * up the handoff.
+ *
+ * The CDN script expects a queue stub to already exist when it loads, so the
+ * contract must be reproduced exactly:
+ *   - `window.prepr` pushes `arguments` onto `.queue` until the real script
+ *     lands and replaces `.process`.
+ *   - `.t` must be a `Date.now()` timestamp.
+ *   - The tag is inserted async, `src` cache-busted every 24h via
+ *     `Math.ceil(Date.now() / cacheTime) * cacheTime`.
+ */
+/** Config accepted by the CDN pixel. */
+interface PreprPixelConfig {
+    destinations?: {
+        googleTagManager?: boolean;
+    };
+    variantImpressionThreshold?: number;
+}
+type PreprQueueArgs = unknown[];
+interface PreprQueueFn {
+    (...args: PreprQueueArgs): void;
+    queue: PreprQueueArgs[];
+    t: number;
+    process?: (...args: PreprQueueArgs) => void;
+}
+declare global {
+    interface Window {
+        prepr?: PreprQueueFn;
+    }
+}
+/**
+ * Install the queue stub, inject the pixel script, then queue
+ * `('init', trackingId, config?)` and `('event', 'pageload')` in that order.
+ *
+ * Idempotent, and a no-op outside a browser.
+ */
+declare function loadTrackingPixel(trackingId: string, config?: PreprPixelConfig): void;
+/**
+ * Send a tracking event through `window.prepr`. Only depends on `window.prepr`
+ * existing, never on how it got installed. Warns once and returns quietly when
+ * no pixel is present.
+ */
+declare function trackEvent(name: string, data?: string | Record<string, unknown>): void;
+/** Loader-independent like `trackEvent`; warns once if no pixel is installed. */
+declare function setTrackingParam(key: string, value: string): void;
+
+export { type Locale as L, type PreprSegment as P, type PreprVariant as a, type PreprToolbarProps as b, type PreprToolbarOptions as c, type PreprErrorCode as d, type PreprHeaders as e, type PreprEnvironment as f, type PreprEventType as g, type PreprHeaderName as h, type PreprPixelConfig as i, loadTrackingPixel as l, setTrackingParam as s, trackEvent as t };