@preprio/toolkit 0.3.4 → 0.4.0

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.4";
+var VERSION = "0.4.0";
 
 // 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 = {};

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.4";
+var VERSION = "0.4.0";
 
 // 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 = {};

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

@@ -1,3 +1,6 @@
+// src/version.ts
+var VERSION = "0.4.0";
+
 // 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.4";
+var VERSION = "0.4.0";
 
 // 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 = {};
@@ -2639,6 +2640,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.4";
+declare const VERSION = "0.4.0";
 
 /**
  * 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.4";
+declare const VERSION = "0.4.0";
 
 /**
  * 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.4";
+} from "./chunk-XFRVWN3C.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 = {};

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.0";
+
 // 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-XFRVWN3C.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.4";
+var VERSION = "0.4.0";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -297,7 +297,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 = {};

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.4";
+var VERSION = "0.4.0";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -261,7 +261,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 = {};

package/dist/nuxt/index.cjs

@@ -35,7 +35,7 @@ __export(nuxt_exports, {
 module.exports = __toCommonJS(nuxt_exports);
 
 // src/version.ts
-var VERSION = "0.3.4";
+var VERSION = "0.4.0";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -295,7 +295,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 = {};

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.4";
+var VERSION = "0.4.0";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -259,7 +259,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 = {};

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.0";
+
 // 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.0";
+
 // 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.4";
+var VERSION = "0.4.0";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -291,7 +291,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 = {};

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.4";
+var VERSION = "0.4.0";
 
 // src/core/constants.ts
 var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
@@ -255,7 +255,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 = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@preprio/toolkit",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "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)",