@coframe/sdk 1.1.54 → 1.1.56

package/README.md

@@ -86,10 +86,11 @@ installations:
   production visitor would get.
 - `coframe_should_send_events=true` allows events during preview for testing.
 
-Debug tools are allowed by default. Open the Launcher with `cf_preview=true` and
-use **Keep across navigation** in the Preview Session tool to keep the selected
-variants active for the current tab. Set `enableDebug: false` to prevent URL or
-saved session state from loading the Launcher.
+Debug tools are allowed by default. A preview link (`coframe_variant_id` with
+`cf_preview=true`) keeps the selected variants active for the current tab as you
+navigate; turn off **Keep across navigation** in the Preview Session tool to
+stop. Set `enableDebug: false` to prevent URL or saved session state from
+loading the Launcher (a preview link then applies to its own page only).
 
 For SSR, pass the complete request URL, including its query string, as
 `currentUrl`. This is required for query-sensitive targeting and allows

package/dist/pkg/cf.cjs.js

@@ -2479,6 +2479,16 @@ function readStoredPreviewVariantId() {
         return null;
     }
 }
+function persistPreviewVariantId(variantId) {
+    const normalized = normalizePreviewVariantId(variantId);
+    if (!normalized)
+        return;
+    try {
+        window.sessionStorage.setItem(COFRAME_PREVIEW_SESSION_STORAGE_KEY, normalized);
+    }
+    catch (_a) {
+    }
+}
 function resolvePreviewSource(url = window.location.href) {
     const urlVariantId = readPreviewVariantIdFromUrl(url);
     const storedVariantId = readStoredPreviewVariantId();
@@ -5338,6 +5348,10 @@ async function resolveConfig(Coframe, revealActions) {
     if (previewSource.urlVariantId) {
         previewVariantId = previewSource.urlVariantId;
         isSessionVariant = previewSource.isKeptForSession;
+        if (urlParams.get(COFRAME_PREVIEW_QUERY_PARAM) === 'true' &&
+            config.enableDebug !== false) {
+            persistPreviewVariantId(previewSource.urlVariantId);
+        }
     }
     else if (previewSource.storedVariantId) {
         previewVariantId = previewSource.storedVariantId;

package/dist/pkg/cf.esm.mjs

@@ -2477,6 +2477,16 @@ function readStoredPreviewVariantId() {
         return null;
     }
 }
+function persistPreviewVariantId(variantId) {
+    const normalized = normalizePreviewVariantId(variantId);
+    if (!normalized)
+        return;
+    try {
+        window.sessionStorage.setItem(COFRAME_PREVIEW_SESSION_STORAGE_KEY, normalized);
+    }
+    catch (_a) {
+    }
+}
 function resolvePreviewSource(url = window.location.href) {
     const urlVariantId = readPreviewVariantIdFromUrl(url);
     const storedVariantId = readStoredPreviewVariantId();
@@ -5336,6 +5346,10 @@ async function resolveConfig(Coframe, revealActions) {
     if (previewSource.urlVariantId) {
         previewVariantId = previewSource.urlVariantId;
         isSessionVariant = previewSource.isKeptForSession;
+        if (urlParams.get(COFRAME_PREVIEW_QUERY_PARAM) === 'true' &&
+            config.enableDebug !== false) {
+            persistPreviewVariantId(previewSource.urlVariantId);
+        }
     }
     else if (previewSource.storedVariantId) {
         previewVariantId = previewSource.storedVariantId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coframe/sdk",
-  "version": "1.1.54",
+  "version": "1.1.56",
   "description": "Coframe optimizes your website using generative AI to deliver maximum impact to your audience and allow your site to improve itself as you sleep. Learn more at coframe.com.",
   "main": "dist/pkg/cf.cjs.js",
   "module": "dist/pkg/cf.esm.mjs",