@preprio/toolkit 0.5.0-rc.1 → 0.6.0-alpha.0

package/dist/index.cjs

@@ -33,6 +33,7 @@ __export(src_exports, {
   getPreprHeadersFromHeaders: () => getPreprHeadersFromHeaders,
   getPreprUUIDFromHeaders: () => getPreprUUIDFromHeaders,
   getToolbarPropsFromHeaders: () => getToolbarPropsFromHeaders,
+  isPersonalizedResponse: () => isPersonalizedResponse,
   loadTrackingPixel: () => loadTrackingPixel,
   processPreprRequest: () => processPreprRequest,
   resolveFeatures: () => resolveFeatures,
@@ -44,7 +45,7 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 
 // src/version.ts
-var VERSION = "0.5.0-rc.1";
+var VERSION = "0.6.0-alpha.0";
 
 // src/core/features.ts
 function isEnabled(config) {
@@ -312,7 +313,6 @@ function createElementCache(query, ttl = 1e3) {
 }
 
 // src/core/iframe-bridge.ts
-var debug = createScopedLogger("iframe-bridge");
 var EDITOR_BASE_DOMAIN = "prepr.io";
 function isAllowedEditorOrigin(origin, allowed) {
   if (allowed) return allowed.includes(origin);
@@ -330,7 +330,6 @@ function isAllowedEditorOrigin(origin, allowed) {
 }
 function createIframeBridge(store, options = {}) {
   const allowedOrigins = options.allowedEditorOrigins;
-  const onScrollToField = options.onScrollToField;
   let parentOrigin = null;
   const onKeyDown = (event) => {
     const key = event.key.toLowerCase();
@@ -354,15 +353,6 @@ function createIframeBridge(store, options = {}) {
       const currentScrollY = window.scrollY || document.documentElement.scrollTop;
       sendPreprEvent("getScrollPosition", { value: currentScrollY });
     }
-    if (data?.event === "prepr:scrollToField") {
-      if (typeof data.field !== "string" || !data.field) return;
-      if (data.id !== void 0 && typeof data.id !== "string") return;
-      try {
-        onScrollToField?.({ field: data.field, id: data.id });
-      } catch (error) {
-        debug.warn("scrollToField handler failed", error);
-      }
-    }
   };
   return {
     start() {
@@ -387,7 +377,7 @@ var import_stega2 = require("@vercel/stega");
 
 // src/core/stega/clean.ts
 var import_stega = require("@vercel/stega");
-var debug2 = createScopedLogger("stega:clean");
+var debug = createScopedLogger("stega:clean");
 function stegaClean(text) {
   if (!text) return text;
   return (0, import_stega.vercelStegaClean)(text);
@@ -400,7 +390,7 @@ function decodeStega(str) {
       return decoded;
     }
   } catch (error) {
-    debug2.log("error decoding stega data", error);
+    debug.log("error decoding stega data", error);
     const match = str.match(/{"origin.*?}/);
     if (match) {
       try {
@@ -409,7 +399,7 @@ function decodeStega(str) {
           return decodedMatch;
         }
       } catch (innerError) {
-        debug2.log("error decoding stega regex match", innerError);
+        debug.log("error decoding stega regex match", innerError);
       }
     }
   }
@@ -445,37 +435,15 @@ function isRenderedElement(element) {
   if (!style) return true;
   return style.visibility !== "hidden" && style.display !== "none";
 }
-function parseEditHref(href) {
-  try {
-    const url = new URL(href, window.location.origin);
-    return {
-      id: url.pathname.split("/").pop() || void 0,
-      field: url.searchParams.get("field") || void 0,
-      locale: url.searchParams.get("locale") || void 0
-    };
-  } catch {
-    return {};
-  }
-}
-function setOrRemove(element, name, value) {
-  if (value) {
-    element.setAttribute(name, value);
-  } else {
-    element.removeAttribute(name);
-  }
-}
 function tagEncodedElement(element, decoded) {
   element.setAttribute("data-prepr-encoded", "");
   element.setAttribute("data-prepr-href", decoded.href);
   element.setAttribute("data-prepr-origin", decoded.origin);
-  const { id, field, locale } = parseEditHref(decoded.href);
-  setOrRemove(element, "data-prepr-id", id);
-  setOrRemove(element, "data-prepr-field", field);
-  setOrRemove(element, "data-prepr-locale", locale);
 }
 
 // src/core/stega/auto-clean.ts
-var debug3 = createScopedLogger("stega:auto-clean");
+var debug2 = createScopedLogger("stega:auto-clean");
+var HYDRATION_RETRY_MS = 100;
 function createStegaAutoClean(options) {
   const stripText = options?.enabled ?? true;
   let observer = null;
@@ -484,8 +452,29 @@ function createStegaAutoClean(options) {
   let pendingHidden = /* @__PURE__ */ new Set();
   let pendingDirty = /* @__PURE__ */ new Set();
   let debounceTimeout = null;
+  const isHydrated = options?.isHydrated;
+  let pendingHydration = /* @__PURE__ */ new Set();
+  let hydrationTimeout = null;
+  function retryPendingHydration() {
+    hydrationTimeout = null;
+    processing = true;
+    const batch = [...pendingHydration];
+    pendingHydration.clear();
+    batch.forEach((textNode) => {
+      if (textNode.isConnected) cleanTextNode(textNode);
+    });
+    processing = false;
+  }
   function cleanTextNode(textNode) {
     if (isIgnoredTextNode(textNode)) return false;
+    if (isHydrated && !isHydrated(textNode)) {
+      pendingHydration.add(textNode);
+      hydrationTimeout ?? (hydrationTimeout = setTimeout(
+        retryPendingHydration,
+        HYDRATION_RETRY_MS
+      ));
+      return false;
+    }
     const textContent = textNode.textContent;
     const info = cleaned.get(textNode);
     const settled = stripText ? info?.cleaned : info?.original;
@@ -518,7 +507,7 @@ function createStegaAutoClean(options) {
       }
       pendingHidden.add(textNode);
     } catch (error) {
-      debug3.log("error cleaning text node", error);
+      debug2.log("error cleaning text node", error);
     }
     return false;
   }
@@ -604,13 +593,17 @@ function createStegaAutoClean(options) {
     if (observer || typeof window === "undefined") return;
     scanAndClean();
     setupObserver();
-    debug3.log("stega auto-clean started");
+    debug2.log("stega auto-clean started");
   }
   function stop() {
     if (debounceTimeout) {
       clearTimeout(debounceTimeout);
       debounceTimeout = null;
     }
+    if (hydrationTimeout) {
+      clearTimeout(hydrationTimeout);
+      hydrationTimeout = null;
+    }
     if (observer) {
       observer.disconnect();
       observer = null;
@@ -618,13 +611,14 @@ function createStegaAutoClean(options) {
     cleaned = /* @__PURE__ */ new WeakMap();
     pendingHidden = /* @__PURE__ */ new Set();
     pendingDirty = /* @__PURE__ */ new Set();
-    debug3.log("stega auto-clean stopped");
+    pendingHydration = /* @__PURE__ */ new Set();
+    debug2.log("stega auto-clean stopped");
   }
   return { start, stop };
 }
 
 // src/core/stega/elements.ts
-var debug4 = createScopedLogger("stega:elements");
+var debug3 = createScopedLogger("stega:elements");
 var StegaElements = class {
   constructor(decode = decodeStega) {
     this.observer = null;
@@ -669,7 +663,7 @@ var StegaElements = class {
     walkTextNodes(document.body, (textNode) => {
       if (this.tagFromTextNode(textNode)) encodedCount++;
     });
-    debug4.log("document scan complete, encoded", encodedCount, "elements");
+    debug3.log("document scan complete, encoded", encodedCount, "elements");
     this.elements = document.querySelectorAll("[data-prepr-encoded]");
   }
   /** `onUpdate` fires after each debounced batch, for refreshing derived state. */
@@ -725,9 +719,6 @@ var StegaElements = class {
       element.removeAttribute("data-prepr-encoded");
       element.removeAttribute("data-prepr-href");
       element.removeAttribute("data-prepr-origin");
-      element.removeAttribute("data-prepr-id");
-      element.removeAttribute("data-prepr-field");
-      element.removeAttribute("data-prepr-locale");
       element.classList.remove("prepr-overlay-active");
     });
     this.elements = void 0;
@@ -735,7 +726,7 @@ var StegaElements = class {
 };
 
 // src/core/stega/overlay.ts
-var debug5 = createScopedLogger("stega:overlay");
+var debug4 = createScopedLogger("stega:overlay");
 var StegaOverlay = class {
   constructor(onEdit) {
     this.overlay = null;
@@ -780,8 +771,7 @@ var StegaOverlay = class {
     const origin = element.getAttribute("data-prepr-origin");
     const id = element.getAttribute("data-prepr-id") ?? void 0;
     const field = element.getAttribute("data-prepr-field") ?? void 0;
-    const locale = element.getAttribute("data-prepr-locale") ?? void 0;
-    debug5.log("showing overlay", { href, origin });
+    debug4.log("showing overlay", { href, origin });
     const overlay = this.overlay;
     overlay.style.display = "block";
     overlay.style.top = `${rect.top + window.scrollY - 2}px`;
@@ -813,7 +803,7 @@ var StegaOverlay = class {
         tooltip.style.left = `${left}px`;
       });
       tooltip.onclick = () => {
-        this.onEdit({ href, origin, id, field, locale });
+        this.onEdit({ href, origin, id, field });
       };
     }
     this.currentElement = element;
@@ -853,7 +843,7 @@ var StegaOverlay = class {
 };
 
 // src/core/stega/proximity.ts
-var debug6 = createScopedLogger("stega:proximity");
+var debug5 = createScopedLogger("stega:proximity");
 var StegaProximity = class {
   constructor() {
     this.highlighted = /* @__PURE__ */ new Set();
@@ -888,9 +878,9 @@ var StegaProximity = class {
       );
       const nodes = this.getEncodedElements();
       nodes.forEach((el) => this.observer.observe(el));
-      debug6.log("observing", nodes.length, "encoded elements");
+      debug5.log("observing", nodes.length, "encoded elements");
     } catch (error) {
-      debug6.log("error setting up IntersectionObserver", error);
+      debug5.log("error setting up IntersectionObserver", error);
     }
   }
   stopObserving() {
@@ -960,7 +950,7 @@ function removeStegaStyles() {
 }
 
 // src/core/stega/scan.ts
-var debug7 = createScopedLogger("stega:scan");
+var debug6 = createScopedLogger("stega:scan");
 var EDITOR_MODE_STYLES = "[data-prepr-encoded]{cursor:pointer}";
 function createStegaController(opts) {
   const tooltipEnabled = opts.tooltip ?? true;
@@ -993,13 +983,12 @@ function createStegaController(opts) {
       href: encoded.getAttribute("data-prepr-href") ?? "",
       origin: encoded.getAttribute("data-prepr-origin") ?? "",
       id: encoded.getAttribute("data-prepr-id") ?? void 0,
-      field: encoded.getAttribute("data-prepr-field") ?? void 0,
-      locale: encoded.getAttribute("data-prepr-locale") ?? void 0
+      field: encoded.getAttribute("data-prepr-field") ?? void 0
     });
   };
   const start = () => {
     if (initialized) {
-      debug7.log("already initialized, skipping setup");
+      debug6.log("already initialized, skipping setup");
       return;
     }
     if (!tooltipEnabled) {
@@ -1009,7 +998,7 @@ function createStegaController(opts) {
       });
       document.addEventListener("click", handleClick, { capture: true });
       initialized = true;
-      debug7.log("stega controller started (editor mode)");
+      debug6.log("stega controller started (editor mode)");
       return;
     }
     injectStegaStyles();
@@ -1040,7 +1029,7 @@ function createStegaController(opts) {
       passive: true
     });
     initialized = true;
-    debug7.log("stega controller started");
+    debug6.log("stega controller started");
   };
   const stop = () => {
     if (!initialized) return;
@@ -1049,7 +1038,7 @@ function createStegaController(opts) {
       elements.cleanup();
       removeStegaStyles();
       initialized = false;
-      debug7.log("stega controller stopped (editor mode)");
+      debug6.log("stega controller stopped (editor mode)");
       return;
     }
     if (throttledMouseMove) {
@@ -1069,43 +1058,11 @@ function createStegaController(opts) {
     elements.cleanup();
     removeStegaStyles();
     initialized = false;
-    debug7.log("stega controller stopped");
+    debug6.log("stega controller stopped");
   };
   return { start, stop };
 }
 
-// src/core/stega/scroll-to-field.ts
-var debug8 = createScopedLogger("stega:scroll");
-var FLASH_DURATION_MS = 1200;
-var flashTimeout = null;
-function scrollToField(request) {
-  const { field, id } = request;
-  if (!field) return false;
-  const candidates = document.querySelectorAll(
-    "[data-prepr-encoded]"
-  );
-  let target = null;
-  for (const candidate of candidates) {
-    if (candidate.getAttribute("data-prepr-field") !== field) continue;
-    if (id && candidate.getAttribute("data-prepr-id") !== id) continue;
-    target = candidate;
-    break;
-  }
-  if (!target) {
-    debug8.log("no element found for field", field);
-    return false;
-  }
-  target.scrollIntoView({ behavior: "smooth", block: "center" });
-  if (flashTimeout) clearTimeout(flashTimeout);
-  document.querySelectorAll(".prepr-overlay-active").forEach((el) => el.classList.remove("prepr-overlay-active"));
-  target.classList.add("prepr-overlay-active");
-  flashTimeout = setTimeout(() => {
-    target.classList.remove("prepr-overlay-active");
-    flashTimeout = null;
-  }, FLASH_DURATION_MS);
-  return true;
-}
-
 // src/core/store.ts
 var DEFAULT_STATE = {
   locale: "en",
@@ -2218,7 +2175,7 @@ function definePreprToolbar() {
 }
 
 // src/core/create-preview.ts
-var debug9 = createScopedLogger("create-preview");
+var debug7 = createScopedLogger("create-preview");
 var controllerStores = /* @__PURE__ */ new WeakMap();
 function defaultNavigation() {
   return {
@@ -2260,7 +2217,7 @@ function createPreprPreview(opts = {}) {
   const search = new URLSearchParams(window.location.search);
   const hideBar = search.get(PARAM_HIDE_BAR) === "true";
   if (hideBar) {
-    debug9.log(`${PARAM_HIDE_BAR}=true \u2014 no visible toolbar`);
+    debug7.log(`${PARAM_HIDE_BAR}=true \u2014 no visible toolbar`);
   }
   const mountUi = (options?.ui ?? true) && !isIframe && !hideBar;
   const locale = resolveLocale(options);
@@ -2296,17 +2253,18 @@ function createPreprPreview(opts = {}) {
     tooltip: mountUi,
     // In the editor, ask the parent to focus the field instead of opening a new
     // tab. Standalone previews keep the window.open behaviour.
-    onEdit: ({ href, id, field, locale: contentLocale }) => {
+    onEdit: ({ href, origin, id, field }) => {
       const safeHref = href ? safeEditUrl(href) : null;
       if (href && !safeHref) {
-        debug9.warn("ignored edit request with unsupported href scheme");
+        debug7.warn("ignored edit request with unsupported href scheme");
         return;
       }
       if (isIframe) {
         sendPreprEvent("field_edit_requested", {
+          href: safeHref ?? void 0,
+          origin,
           id,
-          field,
-          locale: contentLocale
+          field
         });
       } else if (safeHref) {
         window.open(safeHref, "_blank", "noopener,noreferrer");
@@ -2314,7 +2272,8 @@ function createPreprPreview(opts = {}) {
     }
   });
   const autoClean = createStegaAutoClean({
-    enabled: options?.autoClean
+    enabled: options?.autoClean,
+    isHydrated: opts.isHydrated
   });
   autoClean.start();
   const handleChange = createChangeHandler({
@@ -2333,15 +2292,7 @@ function createPreprPreview(opts = {}) {
     handleChange(before, state);
   });
   const bridge = createIframeBridge(store, {
-    allowedEditorOrigins: options?.allowedEditorOrigins,
-    // The editor selecting a field scrolls the matching element into view. The
-    // lookup relies on the attributes the stega scan writes, so it finds
-    // nothing until encoded content has been tagged.
-    onScrollToField: ({ field, id }) => {
-      if (!scrollToField({ field, id })) {
-        debug9.log("no element on this page renders field", field);
-      }
-    }
+    allowedEditorOrigins: options?.allowedEditorOrigins
   });
   sendPreprEvent(
     "getScrollPosition",
@@ -2361,13 +2312,20 @@ function createPreprPreview(opts = {}) {
       bridge.stop();
     }
     el?.remove();
-    debug9.log("preview destroyed");
+    debug7.log("preview destroyed");
   }
   const controller = { destroy };
   controllerStores.set(controller, store);
   return controller;
 }
 
+// src/core/personalization.ts
+var PERSONALIZED_VARY = /\bPrepr-(Segments|ABTesting)/i;
+function isPersonalizedResponse(source) {
+  const headers = "headers" in source ? source.headers : source;
+  return PERSONALIZED_VARY.test(headers.get("vary") ?? "");
+}
+
 // src/core/server.ts
 var PreprError = class extends Error {
   constructor(message, code, context, originalError) {
@@ -2683,6 +2641,10 @@ function processFrameworkRequest(request, opts, framework) {
       });
     }
   }
+  if (requestHeaders.has("Prepr-Segments")) {
+    requestHeaders.delete("Prepr-Customer-Id");
+    requestHeaders.delete("Prepr-Customer-Id-Created");
+  }
   return { requestHeaders, responseCookies };
 }
 
@@ -2765,6 +2727,7 @@ function setTrackingParam(key, value) {
   getPreprHeadersFromHeaders,
   getPreprUUIDFromHeaders,
   getToolbarPropsFromHeaders,
+  isPersonalizedResponse,
   loadTrackingPixel,
   processPreprRequest,
   resolveFeatures,

package/dist/index.d.cts

@@ -1,11 +1,13 @@
-import { P as PreprFeatures, R as ResolvedPreprFeatures, L as Locale, a as PreprSegment, b as PreprVariant, c as PreprToolbarProps, d as PreprPreviewOptions, e as PreprErrorCode, f as PreprHeaders } from './pixel-e1fUWl2Y.cjs';
-export { g as PreprEnvironment, h as PreprEventType, i as PreprFeatureConfig, j as PreprHeaderName, k as PreprPixelConfig, l as PreprToolbarComponentProps, m as PreprToolbarOptions, n as loadTrackingPixel, s as setTrackingParam, t as trackEvent } from './pixel-e1fUWl2Y.cjs';
+import { b as PreprFeatures, R as ResolvedPreprFeatures, L as Locale, c as PreprSegment, d as PreprVariant, e as PreprToolbarProps, f as PreprPreviewOptions } from './types-BYH9XqmN.cjs';
+export { g as PreprEnvironment, a as PreprErrorCode, h as PreprEventType, i as PreprFeatureConfig, j as PreprHeaderName, P as PreprHeaders, k as PreprToolbarComponentProps, l as PreprToolbarOptions } from './types-BYH9XqmN.cjs';
+export { P as PreprError, e as extractAccessToken, g as getActiveSegmentFromHeaders, a as getActiveVariantFromHeaders, b as getPreprEnvironmentSegments, c as getPreprHeadersFromHeaders, d as getPreprUUIDFromHeaders, f as getToolbarPropsFromHeaders, i as isPersonalizedResponse, v as validatePreprToken } from './server-DJuS3YU0.cjs';
+export { P as PreprPixelConfig, l as loadTrackingPixel, s as setTrackingParam, t as trackEvent } from './pixel-DwW7cXJm.cjs';
 
 /**
  * Package version; must match package.json. Lives in its own leaf module so
  * core can import it without cycling through the barrel.
  */
-declare const VERSION = "0.5.0-rc.1";
+declare const VERSION = "0.6.0-alpha.0";
 
 /**
  * Resolve a `PreprFeatures` bag to plain booleans, defaulting every omitted key
@@ -65,6 +67,11 @@ interface CreatePreprPreviewOptions {
     props?: PreprToolbarProps;
     options?: PreprPreviewOptions;
     navigation?: PreprNavigationAdapter;
+    /**
+     * @internal Supplied by framework wrappers so stega stripping waits until
+     * the framework has hydrated the text it would change.
+     */
+    isHydrated?: (node: Text) => boolean;
 }
 interface PreprPreviewController {
     destroy(): void;
@@ -137,72 +144,14 @@ declare class PreprToolbarElement extends HTMLElementBase {
 /** Idempotent, including across bundles that each try to define the element. */
 declare function definePreprToolbar(): void;
 
-/** Which field the editor asked the preview to bring on screen. */
-interface ScrollToFieldMessage {
-    field: string;
-    id?: string;
-}
 interface IframeBridgeOptions {
     /**
      * Replace the `*.prepr.io` wildcard with an exact origin list. Intended for
      * self-hosted editors; when set, the wildcard no longer applies.
      */
     allowedEditorOrigins?: string[];
-    /**
-     * Called when the editor selects a field and wants the preview to scroll to
-     * it. Only fires for messages from the handshaked editor origin. The bridge
-     * stays free of DOM lookups: the preview runtime supplies `scrollToField`.
-     */
-    onScrollToField?: (message: ScrollToFieldMessage) => void;
 }
 
-/** 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);
-}
-/** Prepr Customer ID, or null if the middleware did not run for this request. */
-declare function getPreprUUIDFromHeaders(headers: Headers): string | null;
-/** Active segment ID, or null when no segment is selected. */
-declare function getActiveSegmentFromHeaders(headers: Headers): string | null;
-/** Active A/B variant (`'A'`/`'B'`), or null when no test is running. */
-declare function getActiveVariantFromHeaders(headers: Headers): string | null;
-/**
- * Collect the Prepr headers into a `PreprHeaders`. Lookups are case-insensitive
- * per the Fetch spec, but the returned keys use the declared casing.
- */
-declare function getPreprHeadersFromHeaders(headers: Headers): PreprHeaders;
-/**
- * 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;
-/**
- * Fetches the environment's segments from the Prepr API.
- *
- * `token` must be a Prepr GraphQL URL with scope 'segments'.
- * @throws PreprError if the token is invalid or the request fails.
- */
-declare function getPreprEnvironmentSegments(token: string): Promise<PreprSegment[]>;
-/**
- * Never throws: a failed segments fetch yields an empty list so the toolbar
- * still renders. The list is returned under both `segments` and the deprecated
- * `data` alias.
- *
- * Pass the same `features` object you give the toolbar and the middleware: with
- * segments disabled the `_Segments` request is skipped entirely, saving a
- * round-trip per page.
- */
-declare function getToolbarPropsFromHeaders(headers: Headers, token: string, features?: PreprFeatures): Promise<PreprToolbarProps>;
-
 interface CookieSpec {
     name: string;
     value: string;
@@ -241,4 +190,4 @@ interface PreprMiddlewareOptions {
  */
 declare function processPreprRequest(request: Request, opts?: PreprMiddlewareOptions): PreprMiddlewareResult;
 
-export { type CookieSpec, type CreatePreprPreviewOptions, type IframeBridgeOptions, PreprError, PreprErrorCode, PreprFeatures, PreprHeaders, type PreprMiddlewareOptions, type PreprMiddlewareResult, type PreprNavigationAdapter, type PreprPreviewController, PreprPreviewOptions, PreprSegment, PreprToolbarElement, PreprToolbarProps, PreprVariant, ResolvedPreprFeatures, type ToolbarState, type ToolbarStore, VERSION, createPreprPreview, createToolbarStore, definePreprToolbar, extractAccessToken, getActiveSegmentFromHeaders, getActiveVariantFromHeaders, getPreprEnvironmentSegments, getPreprHeadersFromHeaders, getPreprUUIDFromHeaders, getToolbarPropsFromHeaders, processPreprRequest, resolveFeatures, stegaClean, validatePreprToken };
+export { type CookieSpec, type CreatePreprPreviewOptions, type IframeBridgeOptions, PreprFeatures, type PreprMiddlewareOptions, type PreprMiddlewareResult, type PreprNavigationAdapter, type PreprPreviewController, PreprPreviewOptions, PreprSegment, PreprToolbarElement, PreprToolbarProps, PreprVariant, ResolvedPreprFeatures, type ToolbarState, type ToolbarStore, VERSION, createPreprPreview, createToolbarStore, definePreprToolbar, processPreprRequest, resolveFeatures, stegaClean };

package/dist/index.d.ts

@@ -1,11 +1,13 @@
-import { P as PreprFeatures, R as ResolvedPreprFeatures, L as Locale, a as PreprSegment, b as PreprVariant, c as PreprToolbarProps, d as PreprPreviewOptions, e as PreprErrorCode, f as PreprHeaders } from './pixel-e1fUWl2Y.js';
-export { g as PreprEnvironment, h as PreprEventType, i as PreprFeatureConfig, j as PreprHeaderName, k as PreprPixelConfig, l as PreprToolbarComponentProps, m as PreprToolbarOptions, n as loadTrackingPixel, s as setTrackingParam, t as trackEvent } from './pixel-e1fUWl2Y.js';
+import { b as PreprFeatures, R as ResolvedPreprFeatures, L as Locale, c as PreprSegment, d as PreprVariant, e as PreprToolbarProps, f as PreprPreviewOptions } from './types-BYH9XqmN.js';
+export { g as PreprEnvironment, a as PreprErrorCode, h as PreprEventType, i as PreprFeatureConfig, j as PreprHeaderName, P as PreprHeaders, k as PreprToolbarComponentProps, l as PreprToolbarOptions } from './types-BYH9XqmN.js';
+export { P as PreprError, e as extractAccessToken, g as getActiveSegmentFromHeaders, a as getActiveVariantFromHeaders, b as getPreprEnvironmentSegments, c as getPreprHeadersFromHeaders, d as getPreprUUIDFromHeaders, f as getToolbarPropsFromHeaders, i as isPersonalizedResponse, v as validatePreprToken } from './server-Brr1UgtW.js';
+export { P as PreprPixelConfig, l as loadTrackingPixel, s as setTrackingParam, t as trackEvent } from './pixel-DwW7cXJm.js';
 
 /**
  * Package version; must match package.json. Lives in its own leaf module so
  * core can import it without cycling through the barrel.
  */
-declare const VERSION = "0.5.0-rc.1";
+declare const VERSION = "0.6.0-alpha.0";
 
 /**
  * Resolve a `PreprFeatures` bag to plain booleans, defaulting every omitted key
@@ -65,6 +67,11 @@ interface CreatePreprPreviewOptions {
     props?: PreprToolbarProps;
     options?: PreprPreviewOptions;
     navigation?: PreprNavigationAdapter;
+    /**
+     * @internal Supplied by framework wrappers so stega stripping waits until
+     * the framework has hydrated the text it would change.
+     */
+    isHydrated?: (node: Text) => boolean;
 }
 interface PreprPreviewController {
     destroy(): void;
@@ -137,72 +144,14 @@ declare class PreprToolbarElement extends HTMLElementBase {
 /** Idempotent, including across bundles that each try to define the element. */
 declare function definePreprToolbar(): void;
 
-/** Which field the editor asked the preview to bring on screen. */
-interface ScrollToFieldMessage {
-    field: string;
-    id?: string;
-}
 interface IframeBridgeOptions {
     /**
      * Replace the `*.prepr.io` wildcard with an exact origin list. Intended for
      * self-hosted editors; when set, the wildcard no longer applies.
      */
     allowedEditorOrigins?: string[];
-    /**
-     * Called when the editor selects a field and wants the preview to scroll to
-     * it. Only fires for messages from the handshaked editor origin. The bridge
-     * stays free of DOM lookups: the preview runtime supplies `scrollToField`.
-     */
-    onScrollToField?: (message: ScrollToFieldMessage) => void;
 }
 
-/** 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);
-}
-/** Prepr Customer ID, or null if the middleware did not run for this request. */
-declare function getPreprUUIDFromHeaders(headers: Headers): string | null;
-/** Active segment ID, or null when no segment is selected. */
-declare function getActiveSegmentFromHeaders(headers: Headers): string | null;
-/** Active A/B variant (`'A'`/`'B'`), or null when no test is running. */
-declare function getActiveVariantFromHeaders(headers: Headers): string | null;
-/**
- * Collect the Prepr headers into a `PreprHeaders`. Lookups are case-insensitive
- * per the Fetch spec, but the returned keys use the declared casing.
- */
-declare function getPreprHeadersFromHeaders(headers: Headers): PreprHeaders;
-/**
- * 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;
-/**
- * Fetches the environment's segments from the Prepr API.
- *
- * `token` must be a Prepr GraphQL URL with scope 'segments'.
- * @throws PreprError if the token is invalid or the request fails.
- */
-declare function getPreprEnvironmentSegments(token: string): Promise<PreprSegment[]>;
-/**
- * Never throws: a failed segments fetch yields an empty list so the toolbar
- * still renders. The list is returned under both `segments` and the deprecated
- * `data` alias.
- *
- * Pass the same `features` object you give the toolbar and the middleware: with
- * segments disabled the `_Segments` request is skipped entirely, saving a
- * round-trip per page.
- */
-declare function getToolbarPropsFromHeaders(headers: Headers, token: string, features?: PreprFeatures): Promise<PreprToolbarProps>;
-
 interface CookieSpec {
     name: string;
     value: string;
@@ -241,4 +190,4 @@ interface PreprMiddlewareOptions {
  */
 declare function processPreprRequest(request: Request, opts?: PreprMiddlewareOptions): PreprMiddlewareResult;
 
-export { type CookieSpec, type CreatePreprPreviewOptions, type IframeBridgeOptions, PreprError, PreprErrorCode, PreprFeatures, PreprHeaders, type PreprMiddlewareOptions, type PreprMiddlewareResult, type PreprNavigationAdapter, type PreprPreviewController, PreprPreviewOptions, PreprSegment, PreprToolbarElement, PreprToolbarProps, PreprVariant, ResolvedPreprFeatures, type ToolbarState, type ToolbarStore, VERSION, createPreprPreview, createToolbarStore, definePreprToolbar, extractAccessToken, getActiveSegmentFromHeaders, getActiveVariantFromHeaders, getPreprEnvironmentSegments, getPreprHeadersFromHeaders, getPreprUUIDFromHeaders, getToolbarPropsFromHeaders, processPreprRequest, resolveFeatures, stegaClean, validatePreprToken };
+export { type CookieSpec, type CreatePreprPreviewOptions, type IframeBridgeOptions, PreprFeatures, type PreprMiddlewareOptions, type PreprMiddlewareResult, type PreprNavigationAdapter, type PreprPreviewController, PreprPreviewOptions, PreprSegment, PreprToolbarElement, PreprToolbarProps, PreprVariant, ResolvedPreprFeatures, type ToolbarState, type ToolbarStore, VERSION, createPreprPreview, createToolbarStore, definePreprToolbar, processPreprRequest, resolveFeatures, stegaClean };