@preprio/toolkit 0.3.5 → 0.4.1

package/README.md

@@ -1,9 +1,14 @@
 # @preprio/toolkit
 
-> **Beta — pre-1.0.** The package is published to `latest` and is safe to use, but the
-> public API can still change between minor versions (`0.2.x` → `0.3.0`). Every change
-> is documented in [Breaking changes](https://github.com/preprio/prepr-toolkit/blob/main/RELEASING.md#breaking-changes). Pin an exact
-> version in production, or use a tilde range (`~0.2.0`) so you only pick up patches.
+> **Stable, pre-1.0.** The core is stable and published to `latest`. The package follows
+> semver: minor and patch releases never break the public API, and any breaking change
+> ships as a major bump with a migration entry in
+> [Breaking changes](https://github.com/preprio/prepr-toolkit/blob/main/RELEASING.md#breaking-changes).
+>
+> **Framework support.** The Next.js and Astro integrations are tested end to end. The
+> Nuxt, SvelteKit, and vanilla wrappers share the same core but have seen less real-world
+> use. If you hit a problem with any of them, please
+> [open an issue](https://github.com/preprio/prepr-toolkit/issues).
 
 A framework-agnostic TypeScript library that provides preview functionality, visual editing, and A/B testing for [Prepr CMS](https://prepr.io). Ships thin wrappers for Next.js, Nuxt, Astro, and SvelteKit on top of a vanilla core that runs anywhere.
 

package/dist/astro/index.cjs

@@ -30,7 +30,7 @@ __export(astro_exports, {
 module.exports = __toCommonJS(astro_exports);
 
 // src/version.ts
-var VERSION = "0.3.5";
+var VERSION = "0.4.1";
 
 // src/core/features.ts
 function isEnabled(config) {
@@ -83,7 +83,8 @@ var PREPR_HEADER_KEYS = [
   "Prepr-Visitor-IP",
   "Prepr-Hubspot-Id",
   "Prepr-Customer-Id-Created",
-  "Prepr-User-Agent"
+  "Prepr-User-Agent",
+  "Prepr-Package"
 ];
 function getPreprHeadersFromHeaders(headers) {
   const preprHeaders = {};
@@ -119,6 +120,10 @@ async function getPreprEnvironmentSegments(token) {
   try {
     const response = await fetch(token, {
       headers: {
+        "Prepr-Package": `@preprio/toolkit@${VERSION}`,
+        // Duplicates the version in Prepr-Package. It keeps the User-Agent
+        // format used by `@preprio/prepr-nextjs`, for Prepr API consumers that
+        // still identify the toolbar by that string.
         "User-Agent": `Prepr-Preview-Bar/${VERSION}`,
         "Content-Type": "application/json"
       },
@@ -234,7 +239,7 @@ function parseCookies(request) {
   }
   return cookies;
 }
-function processPreprRequest(request, opts) {
+function processFrameworkRequest(request, opts, framework) {
   const requestHeaders = new Headers(request.headers);
   const responseCookies = [];
   const inboundPreprHeaders = [];
@@ -269,10 +274,10 @@ function processPreprRequest(request, opts) {
   if (userAgent) {
     requestHeaders.set("Prepr-User-Agent", sanitizeHeaderValue(userAgent));
   }
-  requestHeaders.set(
-    "Prepr-Package",
-    `@preprio/toolkit@${opts?.version ?? VERSION}`
-  );
+  const packageParts = [`@preprio/toolkit@${opts?.version ?? VERSION}`];
+  if (framework) packageParts.push(`framework=${framework}`);
+  packageParts.push(`preview=${opts?.preview ? "true" : "false"}`);
+  requestHeaders.set("Prepr-Package", packageParts.join("; "));
   const ip = request.headers.get("Cf-Connecting-Ip") ?? request.headers.get("x-real-ip");
   if (ip) {
     requestHeaders.set("Prepr-Visitor-IP", sanitizeHeaderValue(ip));
@@ -357,9 +362,10 @@ function processPreprRequest(request, opts) {
 
 // src/astro/index.ts
 async function onPreprRequest(context, next, options) {
-  const { requestHeaders, responseCookies } = processPreprRequest(
+  const { requestHeaders, responseCookies } = processFrameworkRequest(
     context.request,
-    options
+    options,
+    "astro"
   );
   requestHeaders.forEach((value, key) => {
     context.request.headers.set(key, value);

package/dist/astro/index.d.cts

@@ -60,6 +60,7 @@ interface PreprHeaders {
     readonly 'Prepr-Hubspot-Id'?: string;
     readonly 'Prepr-Customer-Id-Created'?: 'true';
     readonly 'Prepr-User-Agent'?: string;
+    readonly 'Prepr-Package'?: string;
 }
 
 interface PreprMiddlewareOptions {

package/dist/astro/index.d.ts

@@ -60,6 +60,7 @@ interface PreprHeaders {
     readonly 'Prepr-Hubspot-Id'?: string;
     readonly 'Prepr-Customer-Id-Created'?: 'true';
     readonly 'Prepr-User-Agent'?: string;
+    readonly 'Prepr-Package'?: string;
 }
 
 interface PreprMiddlewareOptions {

package/dist/astro/index.js

@@ -1,5 +1,5 @@
 // src/version.ts
-var VERSION = "0.3.5";
+var VERSION = "0.4.1";
 
 // src/core/features.ts
 function isEnabled(config) {
@@ -52,7 +52,8 @@ var PREPR_HEADER_KEYS = [
   "Prepr-Visitor-IP",
   "Prepr-Hubspot-Id",
   "Prepr-Customer-Id-Created",
-  "Prepr-User-Agent"
+  "Prepr-User-Agent",
+  "Prepr-Package"
 ];
 function getPreprHeadersFromHeaders(headers) {
   const preprHeaders = {};
@@ -88,6 +89,10 @@ async function getPreprEnvironmentSegments(token) {
   try {
     const response = await fetch(token, {
       headers: {
+        "Prepr-Package": `@preprio/toolkit@${VERSION}`,
+        // Duplicates the version in Prepr-Package. It keeps the User-Agent
+        // format used by `@preprio/prepr-nextjs`, for Prepr API consumers that
+        // still identify the toolbar by that string.
         "User-Agent": `Prepr-Preview-Bar/${VERSION}`,
         "Content-Type": "application/json"
       },
@@ -203,7 +208,7 @@ function parseCookies(request) {
   }
   return cookies;
 }
-function processPreprRequest(request, opts) {
+function processFrameworkRequest(request, opts, framework) {
   const requestHeaders = new Headers(request.headers);
   const responseCookies = [];
   const inboundPreprHeaders = [];
@@ -238,10 +243,10 @@ function processPreprRequest(request, opts) {
   if (userAgent) {
     requestHeaders.set("Prepr-User-Agent", sanitizeHeaderValue(userAgent));
   }
-  requestHeaders.set(
-    "Prepr-Package",
-    `@preprio/toolkit@${opts?.version ?? VERSION}`
-  );
+  const packageParts = [`@preprio/toolkit@${opts?.version ?? VERSION}`];
+  if (framework) packageParts.push(`framework=${framework}`);
+  packageParts.push(`preview=${opts?.preview ? "true" : "false"}`);
+  requestHeaders.set("Prepr-Package", packageParts.join("; "));
   const ip = request.headers.get("Cf-Connecting-Ip") ?? request.headers.get("x-real-ip");
   if (ip) {
     requestHeaders.set("Prepr-Visitor-IP", sanitizeHeaderValue(ip));
@@ -326,9 +331,10 @@ function processPreprRequest(request, opts) {
 
 // src/astro/index.ts
 async function onPreprRequest(context, next, options) {
-  const { requestHeaders, responseCookies } = processPreprRequest(
+  const { requestHeaders, responseCookies } = processFrameworkRequest(
     context.request,
-    options
+    options,
+    "astro"
   );
   requestHeaders.forEach((value, key) => {
     context.request.headers.set(key, value);

package/dist/{chunk-HXQ6JUZM.js → chunk-FP5XYD6J.js}

@@ -1,3 +1,6 @@
+// src/version.ts
+var VERSION = "0.4.1";
+
 // src/core/features.ts
 function isEnabled(config) {
   if (typeof config === "boolean") return config;
@@ -2281,6 +2284,7 @@ function loadTrackingPixel(trackingId, config) {
   } else {
     queueFn("init", trackingId);
   }
+  queueFn("param", "pp", VERSION);
   queueFn("event", "pageload");
 }
 function trackEvent(name, data) {
@@ -2303,6 +2307,7 @@ function setTrackingParam(key, value) {
 }
 
 export {
+  VERSION,
   resolveFeatures,
   COOKIE_PREVIEW_MODE,
   COOKIE_SEGMENT,

package/dist/index.cjs

@@ -44,7 +44,7 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 
 // src/version.ts
-var VERSION = "0.3.5";
+var VERSION = "0.4.1";
 
 // src/core/features.ts
 function isEnabled(config) {
@@ -2319,7 +2319,8 @@ var PREPR_HEADER_KEYS = [
   "Prepr-Visitor-IP",
   "Prepr-Hubspot-Id",
   "Prepr-Customer-Id-Created",
-  "Prepr-User-Agent"
+  "Prepr-User-Agent",
+  "Prepr-Package"
 ];
 function getPreprHeadersFromHeaders(headers) {
   const preprHeaders = {};
@@ -2385,6 +2386,10 @@ async function getPreprEnvironmentSegments(token) {
   try {
     const response = await fetch(token, {
       headers: {
+        "Prepr-Package": `@preprio/toolkit@${VERSION}`,
+        // Duplicates the version in Prepr-Package. It keeps the User-Agent
+        // format used by `@preprio/prepr-nextjs`, for Prepr API consumers that
+        // still identify the toolbar by that string.
         "User-Agent": `Prepr-Preview-Bar/${VERSION}`,
         "Content-Type": "application/json"
       },
@@ -2476,6 +2481,9 @@ function parseCookies(request) {
   return cookies;
 }
 function processPreprRequest(request, opts) {
+  return processFrameworkRequest(request, opts);
+}
+function processFrameworkRequest(request, opts, framework) {
   const requestHeaders = new Headers(request.headers);
   const responseCookies = [];
   const inboundPreprHeaders = [];
@@ -2510,10 +2518,10 @@ function processPreprRequest(request, opts) {
   if (userAgent) {
     requestHeaders.set("Prepr-User-Agent", sanitizeHeaderValue(userAgent));
   }
-  requestHeaders.set(
-    "Prepr-Package",
-    `@preprio/toolkit@${opts?.version ?? VERSION}`
-  );
+  const packageParts = [`@preprio/toolkit@${opts?.version ?? VERSION}`];
+  if (framework) packageParts.push(`framework=${framework}`);
+  packageParts.push(`preview=${opts?.preview ? "true" : "false"}`);
+  requestHeaders.set("Prepr-Package", packageParts.join("; "));
   const ip = request.headers.get("Cf-Connecting-Ip") ?? request.headers.get("x-real-ip");
   if (ip) {
     requestHeaders.set("Prepr-Visitor-IP", sanitizeHeaderValue(ip));
@@ -2639,6 +2647,7 @@ function loadTrackingPixel(trackingId, config) {
   } else {
     queueFn("init", trackingId);
   }
+  queueFn("param", "pp", VERSION);
   queueFn("event", "pageload");
 }
 function trackEvent(name, data) {

package/dist/index.d.cts

@@ -1,11 +1,11 @@
-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-B6FtY-11.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-B6FtY-11.cjs';
+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-Wsfvw9G2.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-Wsfvw9G2.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.3.5";
+declare const VERSION = "0.4.1";
 
 /**
  * Resolve a `PreprFeatures` bag to plain booleans, defaulting every omitted key

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-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-B6FtY-11.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-B6FtY-11.js';
+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-Wsfvw9G2.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-Wsfvw9G2.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.3.5";
+declare const VERSION = "0.4.1";
 
 /**
  * Resolve a `PreprFeatures` bag to plain booleans, defaulting every omitted key

package/dist/index.js

@@ -9,6 +9,7 @@ import {
   PARAM_SEGMENT,
   PARAM_VARIANT,
   PreprToolbarElement,
+  VERSION,
   createPreprPreview,
   createToolbarStore,
   definePreprToolbar,
@@ -17,10 +18,7 @@ import {
   setTrackingParam,
   stegaClean,
   trackEvent
-} from "./chunk-HXQ6JUZM.js";
-
-// src/version.ts
-var VERSION = "0.3.5";
+} from "./chunk-FP5XYD6J.js";
 
 // src/core/server.ts
 var PreprError = class extends Error {
@@ -55,7 +53,8 @@ var PREPR_HEADER_KEYS = [
   "Prepr-Visitor-IP",
   "Prepr-Hubspot-Id",
   "Prepr-Customer-Id-Created",
-  "Prepr-User-Agent"
+  "Prepr-User-Agent",
+  "Prepr-Package"
 ];
 function getPreprHeadersFromHeaders(headers) {
   const preprHeaders = {};
@@ -121,6 +120,10 @@ async function getPreprEnvironmentSegments(token) {
   try {
     const response = await fetch(token, {
       headers: {
+        "Prepr-Package": `@preprio/toolkit@${VERSION}`,
+        // Duplicates the version in Prepr-Package. It keeps the User-Agent
+        // format used by `@preprio/prepr-nextjs`, for Prepr API consumers that
+        // still identify the toolbar by that string.
         "User-Agent": `Prepr-Preview-Bar/${VERSION}`,
         "Content-Type": "application/json"
       },
@@ -212,6 +215,9 @@ function parseCookies(request) {
   return cookies;
 }
 function processPreprRequest(request, opts) {
+  return processFrameworkRequest(request, opts);
+}
+function processFrameworkRequest(request, opts, framework) {
   const requestHeaders = new Headers(request.headers);
   const responseCookies = [];
   const inboundPreprHeaders = [];
@@ -246,10 +252,10 @@ function processPreprRequest(request, opts) {
   if (userAgent) {
     requestHeaders.set("Prepr-User-Agent", sanitizeHeaderValue(userAgent));
   }
-  requestHeaders.set(
-    "Prepr-Package",
-    `@preprio/toolkit@${opts?.version ?? VERSION}`
-  );
+  const packageParts = [`@preprio/toolkit@${opts?.version ?? VERSION}`];
+  if (framework) packageParts.push(`framework=${framework}`);
+  packageParts.push(`preview=${opts?.preview ? "true" : "false"}`);
+  requestHeaders.set("Prepr-Package", packageParts.join("; "));
   const ip = request.headers.get("Cf-Connecting-Ip") ?? request.headers.get("x-real-ip");
   if (ip) {
     requestHeaders.set("Prepr-Visitor-IP", sanitizeHeaderValue(ip));

package/dist/nextjs/components.cjs

@@ -2265,6 +2265,9 @@ function createPreprPreview(opts = {}) {
 // src/react/components.ts
 var import_react = require("react");
 
+// src/version.ts
+var VERSION = "0.4.1";
+
 // src/core/pixel.ts
 var PIXEL_SCRIPT_URL = "https://cdn.tracking.prepr.io/js/prepr.min.js";
 var CACHE_BUST_INTERVAL_MS = 24 * 60 * 60 * 1e3;
@@ -2300,6 +2303,7 @@ function loadTrackingPixel(trackingId, config) {
   } else {
     queueFn("init", trackingId);
   }
+  queueFn("param", "pp", VERSION);
   queueFn("event", "pageload");
 }
 

package/dist/nextjs/components.d.cts

@@ -1,4 +1,4 @@
-import { k as PreprPixelConfig, l as PreprToolbarComponentProps } from '../pixel-B6FtY-11.cjs';
+import { k as PreprPixelConfig, l as PreprToolbarComponentProps } from '../pixel-Wsfvw9G2.cjs';
 
 interface PreprTrackingPixelProps {
     /** Prepr tracking/access token. */

package/dist/nextjs/components.d.ts

@@ -1,4 +1,4 @@
-import { k as PreprPixelConfig, l as PreprToolbarComponentProps } from '../pixel-B6FtY-11.js';
+import { k as PreprPixelConfig, l as PreprToolbarComponentProps } from '../pixel-Wsfvw9G2.js';
 
 interface PreprTrackingPixelProps {
     /** Prepr tracking/access token. */

package/dist/nextjs/components.js

@@ -2,7 +2,7 @@
 import {
   createPreprPreview,
   loadTrackingPixel
-} from "../chunk-HXQ6JUZM.js";
+} from "../chunk-FP5XYD6J.js";
 
 // src/nextjs/components.ts
 import { usePathname, useRouter } from "next/navigation";

package/dist/nextjs/index.cjs

@@ -38,7 +38,7 @@ module.exports = __toCommonJS(nextjs_exports);
 var import_server = require("next/server");
 
 // src/version.ts
-var VERSION = "0.3.5";
+var VERSION = "0.4.1";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -100,7 +100,7 @@ function parseCookies(request) {
   }
   return cookies;
 }
-function processPreprRequest(request, opts) {
+function processFrameworkRequest(request, opts, framework) {
   const requestHeaders = new Headers(request.headers);
   const responseCookies = [];
   const inboundPreprHeaders = [];
@@ -135,10 +135,10 @@ function processPreprRequest(request, opts) {
   if (userAgent) {
     requestHeaders.set("Prepr-User-Agent", sanitizeHeaderValue(userAgent));
   }
-  requestHeaders.set(
-    "Prepr-Package",
-    `@preprio/toolkit@${opts?.version ?? VERSION}`
-  );
+  const packageParts = [`@preprio/toolkit@${opts?.version ?? VERSION}`];
+  if (framework) packageParts.push(`framework=${framework}`);
+  packageParts.push(`preview=${opts?.preview ? "true" : "false"}`);
+  requestHeaders.set("Prepr-Package", packageParts.join("; "));
   const ip = request.headers.get("Cf-Connecting-Ip") ?? request.headers.get("x-real-ip");
   if (ip) {
     requestHeaders.set("Prepr-Visitor-IP", sanitizeHeaderValue(ip));
@@ -231,9 +231,10 @@ function createPreprMiddleware(request, responseOrOptions, maybeOptions) {
   } else {
     options = responseOrOptions;
   }
-  const { requestHeaders, responseCookies } = processPreprRequest(
+  const { requestHeaders, responseCookies } = processFrameworkRequest(
     request,
-    options
+    options,
+    "nextjs"
   );
   const response = chainedResponse ?? import_server.NextResponse.next({ request: { headers: requestHeaders } });
   if (chainedResponse) {
@@ -297,7 +298,8 @@ var PREPR_HEADER_KEYS = [
   "Prepr-Visitor-IP",
   "Prepr-Hubspot-Id",
   "Prepr-Customer-Id-Created",
-  "Prepr-User-Agent"
+  "Prepr-User-Agent",
+  "Prepr-Package"
 ];
 function getPreprHeadersFromHeaders(headers2) {
   const preprHeaders = {};
@@ -363,6 +365,10 @@ async function getPreprEnvironmentSegments(token) {
   try {
     const response = await fetch(token, {
       headers: {
+        "Prepr-Package": `@preprio/toolkit@${VERSION}`,
+        // Duplicates the version in Prepr-Package. It keeps the User-Agent
+        // format used by `@preprio/prepr-nextjs`, for Prepr API consumers that
+        // still identify the toolbar by that string.
         "User-Agent": `Prepr-Preview-Bar/${VERSION}`,
         "Content-Type": "application/json"
       },

package/dist/nextjs/index.d.cts

@@ -120,6 +120,7 @@ interface PreprHeaders {
     readonly 'Prepr-Hubspot-Id'?: string;
     readonly 'Prepr-Customer-Id-Created'?: 'true';
     readonly 'Prepr-User-Agent'?: string;
+    readonly 'Prepr-Package'?: string;
 }
 type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
 

package/dist/nextjs/index.d.ts

@@ -120,6 +120,7 @@ interface PreprHeaders {
     readonly 'Prepr-Hubspot-Id'?: string;
     readonly 'Prepr-Customer-Id-Created'?: 'true';
     readonly 'Prepr-User-Agent'?: string;
+    readonly 'Prepr-Package'?: string;
 }
 type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
 

package/dist/nextjs/index.js

@@ -2,7 +2,7 @@
 import { NextResponse } from "next/server";
 
 // src/version.ts
-var VERSION = "0.3.5";
+var VERSION = "0.4.1";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -64,7 +64,7 @@ function parseCookies(request) {
   }
   return cookies;
 }
-function processPreprRequest(request, opts) {
+function processFrameworkRequest(request, opts, framework) {
   const requestHeaders = new Headers(request.headers);
   const responseCookies = [];
   const inboundPreprHeaders = [];
@@ -99,10 +99,10 @@ function processPreprRequest(request, opts) {
   if (userAgent) {
     requestHeaders.set("Prepr-User-Agent", sanitizeHeaderValue(userAgent));
   }
-  requestHeaders.set(
-    "Prepr-Package",
-    `@preprio/toolkit@${opts?.version ?? VERSION}`
-  );
+  const packageParts = [`@preprio/toolkit@${opts?.version ?? VERSION}`];
+  if (framework) packageParts.push(`framework=${framework}`);
+  packageParts.push(`preview=${opts?.preview ? "true" : "false"}`);
+  requestHeaders.set("Prepr-Package", packageParts.join("; "));
   const ip = request.headers.get("Cf-Connecting-Ip") ?? request.headers.get("x-real-ip");
   if (ip) {
     requestHeaders.set("Prepr-Visitor-IP", sanitizeHeaderValue(ip));
@@ -195,9 +195,10 @@ function createPreprMiddleware(request, responseOrOptions, maybeOptions) {
   } else {
     options = responseOrOptions;
   }
-  const { requestHeaders, responseCookies } = processPreprRequest(
+  const { requestHeaders, responseCookies } = processFrameworkRequest(
     request,
-    options
+    options,
+    "nextjs"
   );
   const response = chainedResponse ?? NextResponse.next({ request: { headers: requestHeaders } });
   if (chainedResponse) {
@@ -261,7 +262,8 @@ var PREPR_HEADER_KEYS = [
   "Prepr-Visitor-IP",
   "Prepr-Hubspot-Id",
   "Prepr-Customer-Id-Created",
-  "Prepr-User-Agent"
+  "Prepr-User-Agent",
+  "Prepr-Package"
 ];
 function getPreprHeadersFromHeaders(headers2) {
   const preprHeaders = {};
@@ -327,6 +329,10 @@ async function getPreprEnvironmentSegments(token) {
   try {
     const response = await fetch(token, {
       headers: {
+        "Prepr-Package": `@preprio/toolkit@${VERSION}`,
+        // Duplicates the version in Prepr-Package. It keeps the User-Agent
+        // format used by `@preprio/prepr-nextjs`, for Prepr API consumers that
+        // still identify the toolbar by that string.
         "User-Agent": `Prepr-Preview-Bar/${VERSION}`,
         "Content-Type": "application/json"
       },

package/dist/nuxt/index.cjs

@@ -35,7 +35,7 @@ __export(nuxt_exports, {
 module.exports = __toCommonJS(nuxt_exports);
 
 // src/version.ts
-var VERSION = "0.3.5";
+var VERSION = "0.4.1";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -111,7 +111,7 @@ function parseCookies(request) {
   }
   return cookies;
 }
-function processPreprRequest(request, opts) {
+function processFrameworkRequest(request, opts, framework) {
   const requestHeaders = new Headers(request.headers);
   const responseCookies = [];
   const inboundPreprHeaders = [];
@@ -146,10 +146,10 @@ function processPreprRequest(request, opts) {
   if (userAgent) {
     requestHeaders.set("Prepr-User-Agent", sanitizeHeaderValue(userAgent));
   }
-  requestHeaders.set(
-    "Prepr-Package",
-    `@preprio/toolkit@${opts?.version ?? VERSION}`
-  );
+  const packageParts = [`@preprio/toolkit@${opts?.version ?? VERSION}`];
+  if (framework) packageParts.push(`framework=${framework}`);
+  packageParts.push(`preview=${opts?.preview ? "true" : "false"}`);
+  requestHeaders.set("Prepr-Package", packageParts.join("; "));
   const ip = request.headers.get("Cf-Connecting-Ip") ?? request.headers.get("x-real-ip");
   if (ip) {
     requestHeaders.set("Prepr-Visitor-IP", sanitizeHeaderValue(ip));
@@ -245,9 +245,10 @@ function handlePreprRequest(event, options) {
       request.headers.set(key, value.join(", "));
     }
   }
-  const { requestHeaders, responseCookies } = processPreprRequest(
+  const { requestHeaders, responseCookies } = processFrameworkRequest(
     request,
-    options
+    options,
+    "nuxt"
   );
   requestHeaders.forEach((value, key) => {
     req.headers[key.toLowerCase()] = value;
@@ -295,7 +296,8 @@ var PREPR_HEADER_KEYS = [
   "Prepr-Visitor-IP",
   "Prepr-Hubspot-Id",
   "Prepr-Customer-Id-Created",
-  "Prepr-User-Agent"
+  "Prepr-User-Agent",
+  "Prepr-Package"
 ];
 function getPreprHeadersFromHeaders(headers) {
   const preprHeaders = {};
@@ -361,6 +363,10 @@ async function getPreprEnvironmentSegments(token) {
   try {
     const response = await fetch(token, {
       headers: {
+        "Prepr-Package": `@preprio/toolkit@${VERSION}`,
+        // Duplicates the version in Prepr-Package. It keeps the User-Agent
+        // format used by `@preprio/prepr-nextjs`, for Prepr API consumers that
+        // still identify the toolbar by that string.
         "User-Agent": `Prepr-Preview-Bar/${VERSION}`,
         "Content-Type": "application/json"
       },

package/dist/nuxt/index.d.cts

@@ -60,6 +60,7 @@ interface PreprHeaders {
     readonly 'Prepr-Hubspot-Id'?: string;
     readonly 'Prepr-Customer-Id-Created'?: 'true';
     readonly 'Prepr-User-Agent'?: string;
+    readonly 'Prepr-Package'?: string;
 }
 type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
 

package/dist/nuxt/index.d.ts

@@ -60,6 +60,7 @@ interface PreprHeaders {
     readonly 'Prepr-Hubspot-Id'?: string;
     readonly 'Prepr-Customer-Id-Created'?: 'true';
     readonly 'Prepr-User-Agent'?: string;
+    readonly 'Prepr-Package'?: string;
 }
 type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
 

package/dist/nuxt/index.js

@@ -1,5 +1,5 @@
 // src/version.ts
-var VERSION = "0.3.5";
+var VERSION = "0.4.1";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -75,7 +75,7 @@ function parseCookies(request) {
   }
   return cookies;
 }
-function processPreprRequest(request, opts) {
+function processFrameworkRequest(request, opts, framework) {
   const requestHeaders = new Headers(request.headers);
   const responseCookies = [];
   const inboundPreprHeaders = [];
@@ -110,10 +110,10 @@ function processPreprRequest(request, opts) {
   if (userAgent) {
     requestHeaders.set("Prepr-User-Agent", sanitizeHeaderValue(userAgent));
   }
-  requestHeaders.set(
-    "Prepr-Package",
-    `@preprio/toolkit@${opts?.version ?? VERSION}`
-  );
+  const packageParts = [`@preprio/toolkit@${opts?.version ?? VERSION}`];
+  if (framework) packageParts.push(`framework=${framework}`);
+  packageParts.push(`preview=${opts?.preview ? "true" : "false"}`);
+  requestHeaders.set("Prepr-Package", packageParts.join("; "));
   const ip = request.headers.get("Cf-Connecting-Ip") ?? request.headers.get("x-real-ip");
   if (ip) {
     requestHeaders.set("Prepr-Visitor-IP", sanitizeHeaderValue(ip));
@@ -209,9 +209,10 @@ function handlePreprRequest(event, options) {
       request.headers.set(key, value.join(", "));
     }
   }
-  const { requestHeaders, responseCookies } = processPreprRequest(
+  const { requestHeaders, responseCookies } = processFrameworkRequest(
     request,
-    options
+    options,
+    "nuxt"
   );
   requestHeaders.forEach((value, key) => {
     req.headers[key.toLowerCase()] = value;
@@ -259,7 +260,8 @@ var PREPR_HEADER_KEYS = [
   "Prepr-Visitor-IP",
   "Prepr-Hubspot-Id",
   "Prepr-Customer-Id-Created",
-  "Prepr-User-Agent"
+  "Prepr-User-Agent",
+  "Prepr-Package"
 ];
 function getPreprHeadersFromHeaders(headers) {
   const preprHeaders = {};
@@ -325,6 +327,10 @@ async function getPreprEnvironmentSegments(token) {
   try {
     const response = await fetch(token, {
       headers: {
+        "Prepr-Package": `@preprio/toolkit@${VERSION}`,
+        // Duplicates the version in Prepr-Package. It keeps the User-Agent
+        // format used by `@preprio/prepr-nextjs`, for Prepr API consumers that
+        // still identify the toolbar by that string.
         "User-Agent": `Prepr-Preview-Bar/${VERSION}`,
         "Content-Type": "application/json"
       },

package/dist/{pixel-B6FtY-11.d.cts → pixel-Wsfvw9G2.d.cts}

@@ -127,6 +127,7 @@ interface PreprHeaders {
     readonly 'Prepr-Hubspot-Id'?: string;
     readonly 'Prepr-Customer-Id-Created'?: 'true';
     readonly 'Prepr-User-Agent'?: string;
+    readonly 'Prepr-Package'?: string;
 }
 type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
 

package/dist/{pixel-B6FtY-11.d.ts → pixel-Wsfvw9G2.d.ts}

@@ -127,6 +127,7 @@ interface PreprHeaders {
     readonly 'Prepr-Hubspot-Id'?: string;
     readonly 'Prepr-Customer-Id-Created'?: 'true';
     readonly 'Prepr-User-Agent'?: string;
+    readonly 'Prepr-Package'?: string;
 }
 type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
 

package/dist/react/components.cjs

@@ -2261,6 +2261,9 @@ function createPreprPreview(opts = {}) {
   return controller;
 }
 
+// src/version.ts
+var VERSION = "0.4.1";
+
 // src/core/pixel.ts
 var PIXEL_SCRIPT_URL = "https://cdn.tracking.prepr.io/js/prepr.min.js";
 var CACHE_BUST_INTERVAL_MS = 24 * 60 * 60 * 1e3;
@@ -2296,6 +2299,7 @@ function loadTrackingPixel(trackingId, config) {
   } else {
     queueFn("init", trackingId);
   }
+  queueFn("param", "pp", VERSION);
   queueFn("event", "pageload");
 }
 

package/dist/react/components.js

@@ -2237,6 +2237,9 @@ function createPreprPreview(opts = {}) {
   return controller;
 }
 
+// src/version.ts
+var VERSION = "0.4.1";
+
 // src/core/pixel.ts
 var PIXEL_SCRIPT_URL = "https://cdn.tracking.prepr.io/js/prepr.min.js";
 var CACHE_BUST_INTERVAL_MS = 24 * 60 * 60 * 1e3;
@@ -2272,6 +2275,7 @@ function loadTrackingPixel(trackingId, config) {
   } else {
     queueFn("init", trackingId);
   }
+  queueFn("param", "pp", VERSION);
   queueFn("event", "pageload");
 }
 

package/dist/sveltekit/index.cjs

@@ -35,7 +35,7 @@ __export(sveltekit_exports, {
 module.exports = __toCommonJS(sveltekit_exports);
 
 // src/version.ts
-var VERSION = "0.3.5";
+var VERSION = "0.4.1";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -111,7 +111,7 @@ function parseCookies(request) {
   }
   return cookies;
 }
-function processPreprRequest(request, opts) {
+function processFrameworkRequest(request, opts, framework) {
   const requestHeaders = new Headers(request.headers);
   const responseCookies = [];
   const inboundPreprHeaders = [];
@@ -146,10 +146,10 @@ function processPreprRequest(request, opts) {
   if (userAgent) {
     requestHeaders.set("Prepr-User-Agent", sanitizeHeaderValue(userAgent));
   }
-  requestHeaders.set(
-    "Prepr-Package",
-    `@preprio/toolkit@${opts?.version ?? VERSION}`
-  );
+  const packageParts = [`@preprio/toolkit@${opts?.version ?? VERSION}`];
+  if (framework) packageParts.push(`framework=${framework}`);
+  packageParts.push(`preview=${opts?.preview ? "true" : "false"}`);
+  requestHeaders.set("Prepr-Package", packageParts.join("; "));
   const ip = request.headers.get("Cf-Connecting-Ip") ?? request.headers.get("x-real-ip");
   if (ip) {
     requestHeaders.set("Prepr-Visitor-IP", sanitizeHeaderValue(ip));
@@ -236,9 +236,10 @@ function processPreprRequest(request, opts) {
 var PREPR_LOCALS_KEY = "prepr";
 function preprHandle(options) {
   return async ({ event, resolve }) => {
-    const { requestHeaders, responseCookies } = processPreprRequest(
+    const { requestHeaders, responseCookies } = processFrameworkRequest(
       event.request,
-      options
+      options,
+      "sveltekit"
     );
     requestHeaders.forEach((value, key) => {
       event.request.headers.set(key, value);
@@ -291,7 +292,8 @@ var PREPR_HEADER_KEYS = [
   "Prepr-Visitor-IP",
   "Prepr-Hubspot-Id",
   "Prepr-Customer-Id-Created",
-  "Prepr-User-Agent"
+  "Prepr-User-Agent",
+  "Prepr-Package"
 ];
 function getPreprHeadersFromHeaders(headers) {
   const preprHeaders = {};
@@ -357,6 +359,10 @@ async function getPreprEnvironmentSegments(token) {
   try {
     const response = await fetch(token, {
       headers: {
+        "Prepr-Package": `@preprio/toolkit@${VERSION}`,
+        // Duplicates the version in Prepr-Package. It keeps the User-Agent
+        // format used by `@preprio/prepr-nextjs`, for Prepr API consumers that
+        // still identify the toolbar by that string.
         "User-Agent": `Prepr-Preview-Bar/${VERSION}`,
         "Content-Type": "application/json"
       },

package/dist/sveltekit/index.d.cts

@@ -60,6 +60,7 @@ interface PreprHeaders {
     readonly 'Prepr-Hubspot-Id'?: string;
     readonly 'Prepr-Customer-Id-Created'?: 'true';
     readonly 'Prepr-User-Agent'?: string;
+    readonly 'Prepr-Package'?: string;
 }
 type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
 

package/dist/sveltekit/index.d.ts

@@ -60,6 +60,7 @@ interface PreprHeaders {
     readonly 'Prepr-Hubspot-Id'?: string;
     readonly 'Prepr-Customer-Id-Created'?: 'true';
     readonly 'Prepr-User-Agent'?: string;
+    readonly 'Prepr-Package'?: string;
 }
 type PreprErrorCode = 'INVALID_TOKEN' | 'MISSING_TOKEN' | 'HTTP_ERROR' | 'FETCH_ERROR' | 'INVALID_RESPONSE' | 'CONTEXT_ERROR';
 

package/dist/sveltekit/index.js

@@ -1,5 +1,5 @@
 // src/version.ts
-var VERSION = "0.3.5";
+var VERSION = "0.4.1";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -75,7 +75,7 @@ function parseCookies(request) {
   }
   return cookies;
 }
-function processPreprRequest(request, opts) {
+function processFrameworkRequest(request, opts, framework) {
   const requestHeaders = new Headers(request.headers);
   const responseCookies = [];
   const inboundPreprHeaders = [];
@@ -110,10 +110,10 @@ function processPreprRequest(request, opts) {
   if (userAgent) {
     requestHeaders.set("Prepr-User-Agent", sanitizeHeaderValue(userAgent));
   }
-  requestHeaders.set(
-    "Prepr-Package",
-    `@preprio/toolkit@${opts?.version ?? VERSION}`
-  );
+  const packageParts = [`@preprio/toolkit@${opts?.version ?? VERSION}`];
+  if (framework) packageParts.push(`framework=${framework}`);
+  packageParts.push(`preview=${opts?.preview ? "true" : "false"}`);
+  requestHeaders.set("Prepr-Package", packageParts.join("; "));
   const ip = request.headers.get("Cf-Connecting-Ip") ?? request.headers.get("x-real-ip");
   if (ip) {
     requestHeaders.set("Prepr-Visitor-IP", sanitizeHeaderValue(ip));
@@ -200,9 +200,10 @@ function processPreprRequest(request, opts) {
 var PREPR_LOCALS_KEY = "prepr";
 function preprHandle(options) {
   return async ({ event, resolve }) => {
-    const { requestHeaders, responseCookies } = processPreprRequest(
+    const { requestHeaders, responseCookies } = processFrameworkRequest(
       event.request,
-      options
+      options,
+      "sveltekit"
     );
     requestHeaders.forEach((value, key) => {
       event.request.headers.set(key, value);
@@ -255,7 +256,8 @@ var PREPR_HEADER_KEYS = [
   "Prepr-Visitor-IP",
   "Prepr-Hubspot-Id",
   "Prepr-Customer-Id-Created",
-  "Prepr-User-Agent"
+  "Prepr-User-Agent",
+  "Prepr-Package"
 ];
 function getPreprHeadersFromHeaders(headers) {
   const preprHeaders = {};
@@ -321,6 +323,10 @@ async function getPreprEnvironmentSegments(token) {
   try {
     const response = await fetch(token, {
       headers: {
+        "Prepr-Package": `@preprio/toolkit@${VERSION}`,
+        // Duplicates the version in Prepr-Package. It keeps the User-Agent
+        // format used by `@preprio/prepr-nextjs`, for Prepr API consumers that
+        // still identify the toolbar by that string.
         "User-Agent": `Prepr-Preview-Bar/${VERSION}`,
         "Content-Type": "application/json"
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@preprio/toolkit",
-  "version": "0.3.5",
+  "version": "0.4.1",
   "description": "Prepr personalization, A/B testing and preview toolkit for React, Next.js, Nuxt, Astro, SvelteKit and Express",
   "license": "Apache-2.0",
   "author": "Prepr B.V. (https://prepr.io)",