@cmssy/core 16.2.0 → 16.3.0

package/dist/index.cjs

@@ -73,6 +73,10 @@ Set the listed environment variables (e.g. in .env.local) and restart the dev se
   return resolved;
 }
 
+// src/version.ts
+var CMSSY_CORE_VERSION = "16.3.0" ;
+var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
+
 // src/data/http.ts
 var CmssyRequestError = class extends Error {
   status;
@@ -208,7 +212,11 @@ async function postGraphql(url, query, variables, options) {
     url,
     {
       method: "POST",
-      headers: { "content-type": "application/json", ...options.headers },
+      headers: {
+        "content-type": "application/json",
+        "user-agent": CMSSY_USER_AGENT,
+        ...options.headers
+      },
       body: JSON.stringify({ query, variables }),
       signal: options.signal
     },
@@ -465,6 +473,26 @@ async function resolveWorkspaceId(config, options = {}) {
   }
   return siteConfig.workspaceId;
 }
+var MAX_ENTRIES = 64;
+var workspaceIdCache = /* @__PURE__ */ new Map();
+function cacheKey(config) {
+  return `${resolveApiUrl(config.apiUrl)}::${config.org}::${config.workspaceSlug}`;
+}
+function cachedWorkspaceId(config, options = {}) {
+  const key = cacheKey(config);
+  const existing = workspaceIdCache.get(key);
+  if (existing) return existing;
+  const fresh = resolveWorkspaceId(config, options).catch((err) => {
+    workspaceIdCache.delete(key);
+    throw err;
+  });
+  if (workspaceIdCache.size >= MAX_ENTRIES) workspaceIdCache.clear();
+  workspaceIdCache.set(key, fresh);
+  return fresh;
+}
+function primeWorkspaceId(config, workspaceId) {
+  workspaceIdCache.set(cacheKey(config), Promise.resolve(workspaceId));
+}
 
 // src/data/client.ts
 function createCmssyClient(input) {
@@ -472,19 +500,8 @@ function createCmssyClient(input) {
     ...input,
     apiUrl: resolveApiUrl(input.apiUrl)
   };
-  let cachedWorkspaceId;
-  let inFlight;
   function resolveWorkspaceId2(options) {
-    if (cachedWorkspaceId) return Promise.resolve(cachedWorkspaceId);
-    if (!inFlight) {
-      inFlight = resolveWorkspaceId(config, options).then((id) => {
-        cachedWorkspaceId = id;
-        return id;
-      }).finally(() => {
-        inFlight = void 0;
-      });
-    }
-    return inFlight;
+    return cachedWorkspaceId(config, options);
   }
   function query(document2, variables, options) {
     return graphqlRequest(
@@ -515,7 +532,11 @@ function createCmssyClient(input) {
   const client = {
     config,
     resolveWorkspaceId: resolveWorkspaceId2,
-    query: ((document2, variables = {}, options) => query(documentText(document2), variables, options)),
+    query: ((document2, variables = {}, options) => query(
+      documentText(document2),
+      variables,
+      options
+    )),
     queryScoped: ((document2, variables = {}, options = {}) => queryScoped(
       documentText(document2),
       variables,
@@ -712,7 +733,7 @@ function localizeHref(href, locale) {
 // src/data/site-locales.ts
 var TTL_MS = 6e4;
 var FAILURE_TTL_MS = 5e3;
-var MAX_ENTRIES = 64;
+var MAX_ENTRIES2 = 64;
 var cache = /* @__PURE__ */ new Map();
 function localesFromSiteConfig(siteConfig) {
   const defaultLocale = siteConfig?.defaultLanguage || "en";
@@ -736,11 +757,14 @@ async function loadSiteLocales(config, options) {
       { ...options, public: true, retry: options?.retry ?? "build" },
       "site config"
     );
-    value = localesFromSiteConfig(data.public?.siteConfig ?? null);
+    const siteConfig = data.public?.siteConfig ?? null;
+    if (siteConfig?.workspaceId)
+      primeWorkspaceId(config, siteConfig.workspaceId);
+    value = localesFromSiteConfig(siteConfig);
   } catch {
     value = null;
   }
-  if (cache.size >= MAX_ENTRIES) cache.clear();
+  if (cache.size >= MAX_ENTRIES2) cache.clear();
   cache.set(key, {
     value,
     expires: Date.now() + (value ? TTL_MS : FAILURE_TTL_MS)

package/dist/index.js

@@ -72,6 +72,10 @@ Set the listed environment variables (e.g. in .env.local) and restart the dev se
   return resolved;
 }
 
+// src/version.ts
+var CMSSY_CORE_VERSION = "16.3.0" ;
+var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
+
 // src/data/http.ts
 var CmssyRequestError = class extends Error {
   status;
@@ -207,7 +211,11 @@ async function postGraphql(url, query, variables, options) {
     url,
     {
       method: "POST",
-      headers: { "content-type": "application/json", ...options.headers },
+      headers: {
+        "content-type": "application/json",
+        "user-agent": CMSSY_USER_AGENT,
+        ...options.headers
+      },
       body: JSON.stringify({ query, variables }),
       signal: options.signal
     },
@@ -464,6 +472,26 @@ async function resolveWorkspaceId(config, options = {}) {
   }
   return siteConfig.workspaceId;
 }
+var MAX_ENTRIES = 64;
+var workspaceIdCache = /* @__PURE__ */ new Map();
+function cacheKey(config) {
+  return `${resolveApiUrl(config.apiUrl)}::${config.org}::${config.workspaceSlug}`;
+}
+function cachedWorkspaceId(config, options = {}) {
+  const key = cacheKey(config);
+  const existing = workspaceIdCache.get(key);
+  if (existing) return existing;
+  const fresh = resolveWorkspaceId(config, options).catch((err) => {
+    workspaceIdCache.delete(key);
+    throw err;
+  });
+  if (workspaceIdCache.size >= MAX_ENTRIES) workspaceIdCache.clear();
+  workspaceIdCache.set(key, fresh);
+  return fresh;
+}
+function primeWorkspaceId(config, workspaceId) {
+  workspaceIdCache.set(cacheKey(config), Promise.resolve(workspaceId));
+}
 
 // src/data/client.ts
 function createCmssyClient(input) {
@@ -471,19 +499,8 @@ function createCmssyClient(input) {
     ...input,
     apiUrl: resolveApiUrl(input.apiUrl)
   };
-  let cachedWorkspaceId;
-  let inFlight;
   function resolveWorkspaceId2(options) {
-    if (cachedWorkspaceId) return Promise.resolve(cachedWorkspaceId);
-    if (!inFlight) {
-      inFlight = resolveWorkspaceId(config, options).then((id) => {
-        cachedWorkspaceId = id;
-        return id;
-      }).finally(() => {
-        inFlight = void 0;
-      });
-    }
-    return inFlight;
+    return cachedWorkspaceId(config, options);
   }
   function query(document2, variables, options) {
     return graphqlRequest(
@@ -514,7 +531,11 @@ function createCmssyClient(input) {
   const client = {
     config,
     resolveWorkspaceId: resolveWorkspaceId2,
-    query: ((document2, variables = {}, options) => query(documentText(document2), variables, options)),
+    query: ((document2, variables = {}, options) => query(
+      documentText(document2),
+      variables,
+      options
+    )),
     queryScoped: ((document2, variables = {}, options = {}) => queryScoped(
       documentText(document2),
       variables,
@@ -711,7 +732,7 @@ function localizeHref(href, locale) {
 // src/data/site-locales.ts
 var TTL_MS = 6e4;
 var FAILURE_TTL_MS = 5e3;
-var MAX_ENTRIES = 64;
+var MAX_ENTRIES2 = 64;
 var cache = /* @__PURE__ */ new Map();
 function localesFromSiteConfig(siteConfig) {
   const defaultLocale = siteConfig?.defaultLanguage || "en";
@@ -735,11 +756,14 @@ async function loadSiteLocales(config, options) {
       { ...options, public: true, retry: options?.retry ?? "build" },
       "site config"
     );
-    value = localesFromSiteConfig(data.public?.siteConfig ?? null);
+    const siteConfig = data.public?.siteConfig ?? null;
+    if (siteConfig?.workspaceId)
+      primeWorkspaceId(config, siteConfig.workspaceId);
+    value = localesFromSiteConfig(siteConfig);
   } catch {
     value = null;
   }
-  if (cache.size >= MAX_ENTRIES) cache.clear();
+  if (cache.size >= MAX_ENTRIES2) cache.clear();
   cache.set(key, {
     value,
     expires: Date.now() + (value ? TTL_MS : FAILURE_TTL_MS)

package/dist/internal/locale.cjs

@@ -1,5 +1,9 @@
 'use strict';
 
+// src/version.ts
+var CMSSY_CORE_VERSION = "16.3.0" ;
+var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
+
 // src/data/http.ts
 var CmssyRequestError = class extends Error {
   status;
@@ -135,7 +139,11 @@ async function postGraphql(url, query, variables, options) {
     url,
     {
       method: "POST",
-      headers: { "content-type": "application/json", ...options.headers },
+      headers: {
+        "content-type": "application/json",
+        "user-agent": CMSSY_USER_AGENT,
+        ...options.headers
+      },
       body: JSON.stringify({ query, variables }),
       signal: options.signal
     },
@@ -224,6 +232,15 @@ var SITE_CONFIG_QUERY = `query PublicSiteConfig($workspaceSlug: String!) {
   }
 }`;
 
+// src/data/settings-client.ts
+var workspaceIdCache = /* @__PURE__ */ new Map();
+function cacheKey(config) {
+  return `${resolveApiUrl(config.apiUrl)}::${config.org}::${config.workspaceSlug}`;
+}
+function primeWorkspaceId(config, workspaceId) {
+  workspaceIdCache.set(cacheKey(config), Promise.resolve(workspaceId));
+}
+
 // src/data/site-locales.ts
 var TTL_MS = 6e4;
 var FAILURE_TTL_MS = 5e3;
@@ -251,7 +268,10 @@ async function loadSiteLocales(config, options) {
       { ...options, public: true, retry: options?.retry ?? "build" },
       "site config"
     );
-    value = localesFromSiteConfig(data.public?.siteConfig ?? null);
+    const siteConfig = data.public?.siteConfig ?? null;
+    if (siteConfig?.workspaceId)
+      primeWorkspaceId(config, siteConfig.workspaceId);
+    value = localesFromSiteConfig(siteConfig);
   } catch {
     value = null;
   }

package/dist/internal/locale.js

@@ -1,3 +1,7 @@
+// src/version.ts
+var CMSSY_CORE_VERSION = "16.3.0" ;
+var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
+
 // src/data/http.ts
 var CmssyRequestError = class extends Error {
   status;
@@ -133,7 +137,11 @@ async function postGraphql(url, query, variables, options) {
     url,
     {
       method: "POST",
-      headers: { "content-type": "application/json", ...options.headers },
+      headers: {
+        "content-type": "application/json",
+        "user-agent": CMSSY_USER_AGENT,
+        ...options.headers
+      },
       body: JSON.stringify({ query, variables }),
       signal: options.signal
     },
@@ -222,6 +230,15 @@ var SITE_CONFIG_QUERY = `query PublicSiteConfig($workspaceSlug: String!) {
   }
 }`;
 
+// src/data/settings-client.ts
+var workspaceIdCache = /* @__PURE__ */ new Map();
+function cacheKey(config) {
+  return `${resolveApiUrl(config.apiUrl)}::${config.org}::${config.workspaceSlug}`;
+}
+function primeWorkspaceId(config, workspaceId) {
+  workspaceIdCache.set(cacheKey(config), Promise.resolve(workspaceId));
+}
+
 // src/data/site-locales.ts
 var TTL_MS = 6e4;
 var FAILURE_TTL_MS = 5e3;
@@ -249,7 +266,10 @@ async function loadSiteLocales(config, options) {
       { ...options, public: true, retry: options?.retry ?? "build" },
       "site config"
     );
-    value = localesFromSiteConfig(data.public?.siteConfig ?? null);
+    const siteConfig = data.public?.siteConfig ?? null;
+    if (siteConfig?.workspaceId)
+      primeWorkspaceId(config, siteConfig.workspaceId);
+    value = localesFromSiteConfig(siteConfig);
   } catch {
     value = null;
   }

package/dist/internal.cjs

@@ -2,6 +2,10 @@
 
 var types = require('@cmssy/types');
 
+// src/version.ts
+var CMSSY_CORE_VERSION = "16.3.0" ;
+var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
+
 // src/data/http.ts
 var CmssyRequestError = class extends Error {
   status;
@@ -137,7 +141,11 @@ async function postGraphql(url, query, variables, options) {
     url,
     {
       method: "POST",
-      headers: { "content-type": "application/json", ...options.headers },
+      headers: {
+        "content-type": "application/json",
+        "user-agent": CMSSY_USER_AGENT,
+        ...options.headers
+      },
       body: JSON.stringify({ query, variables }),
       signal: options.signal
     },
@@ -514,7 +522,26 @@ async function resolveWorkspaceId(config, options = {}) {
   }
   return siteConfig.workspaceId;
 }
+var MAX_ENTRIES = 64;
 var workspaceIdCache = /* @__PURE__ */ new Map();
+function cacheKey(config) {
+  return `${resolveApiUrl(config.apiUrl)}::${config.org}::${config.workspaceSlug}`;
+}
+function cachedWorkspaceId(config, options = {}) {
+  const key = cacheKey(config);
+  const existing = workspaceIdCache.get(key);
+  if (existing) return existing;
+  const fresh = resolveWorkspaceId(config, options).catch((err) => {
+    workspaceIdCache.delete(key);
+    throw err;
+  });
+  if (workspaceIdCache.size >= MAX_ENTRIES) workspaceIdCache.clear();
+  workspaceIdCache.set(key, fresh);
+  return fresh;
+}
+function primeWorkspaceId(config, workspaceId) {
+  workspaceIdCache.set(cacheKey(config), Promise.resolve(workspaceId));
+}
 function clearWorkspaceIdCache() {
   workspaceIdCache.clear();
 }
@@ -673,19 +700,8 @@ function createCmssyClient(input) {
     ...input,
     apiUrl: resolveApiUrl(input.apiUrl)
   };
-  let cachedWorkspaceId;
-  let inFlight;
   function resolveWorkspaceId2(options) {
-    if (cachedWorkspaceId) return Promise.resolve(cachedWorkspaceId);
-    if (!inFlight) {
-      inFlight = resolveWorkspaceId(config, options).then((id) => {
-        cachedWorkspaceId = id;
-        return id;
-      }).finally(() => {
-        inFlight = void 0;
-      });
-    }
-    return inFlight;
+    return cachedWorkspaceId(config, options);
   }
   function query(document2, variables, options) {
     return graphqlRequest(
@@ -716,7 +732,11 @@ function createCmssyClient(input) {
   const client = {
     config,
     resolveWorkspaceId: resolveWorkspaceId2,
-    query: ((document2, variables = {}, options) => query(documentText(document2), variables, options)),
+    query: ((document2, variables = {}, options) => query(
+      documentText(document2),
+      variables,
+      options
+    )),
     queryScoped: ((document2, variables = {}, options = {}) => queryScoped(
       documentText(document2),
       variables,
@@ -1017,7 +1037,7 @@ async function resolveForms(config, blocks, schemas, locale, defaultLocale, opti
 // src/data/site-locales.ts
 var TTL_MS = 6e4;
 var FAILURE_TTL_MS = 5e3;
-var MAX_ENTRIES = 64;
+var MAX_ENTRIES2 = 64;
 var cache = /* @__PURE__ */ new Map();
 function localesFromSiteConfig(siteConfig) {
   const defaultLocale = siteConfig?.defaultLanguage || "en";
@@ -1041,11 +1061,14 @@ async function loadSiteLocales(config, options) {
       { ...options, public: true, retry: options?.retry ?? "build" },
       "site config"
     );
-    value = localesFromSiteConfig(data.public?.siteConfig ?? null);
+    const siteConfig = data.public?.siteConfig ?? null;
+    if (siteConfig?.workspaceId)
+      primeWorkspaceId(config, siteConfig.workspaceId);
+    value = localesFromSiteConfig(siteConfig);
   } catch {
     value = null;
   }
-  if (cache.size >= MAX_ENTRIES) cache.clear();
+  if (cache.size >= MAX_ENTRIES2) cache.clear();
   cache.set(key, {
     value,
     expires: Date.now() + (value ? TTL_MS : FAILURE_TTL_MS)

package/dist/internal.js

@@ -1,5 +1,9 @@
 import { DEFAULT_LAYOUT_REGIONS } from '@cmssy/types';
 
+// src/version.ts
+var CMSSY_CORE_VERSION = "16.3.0" ;
+var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
+
 // src/data/http.ts
 var CmssyRequestError = class extends Error {
   status;
@@ -135,7 +139,11 @@ async function postGraphql(url, query, variables, options) {
     url,
     {
       method: "POST",
-      headers: { "content-type": "application/json", ...options.headers },
+      headers: {
+        "content-type": "application/json",
+        "user-agent": CMSSY_USER_AGENT,
+        ...options.headers
+      },
       body: JSON.stringify({ query, variables }),
       signal: options.signal
     },
@@ -512,7 +520,26 @@ async function resolveWorkspaceId(config, options = {}) {
   }
   return siteConfig.workspaceId;
 }
+var MAX_ENTRIES = 64;
 var workspaceIdCache = /* @__PURE__ */ new Map();
+function cacheKey(config) {
+  return `${resolveApiUrl(config.apiUrl)}::${config.org}::${config.workspaceSlug}`;
+}
+function cachedWorkspaceId(config, options = {}) {
+  const key = cacheKey(config);
+  const existing = workspaceIdCache.get(key);
+  if (existing) return existing;
+  const fresh = resolveWorkspaceId(config, options).catch((err) => {
+    workspaceIdCache.delete(key);
+    throw err;
+  });
+  if (workspaceIdCache.size >= MAX_ENTRIES) workspaceIdCache.clear();
+  workspaceIdCache.set(key, fresh);
+  return fresh;
+}
+function primeWorkspaceId(config, workspaceId) {
+  workspaceIdCache.set(cacheKey(config), Promise.resolve(workspaceId));
+}
 function clearWorkspaceIdCache() {
   workspaceIdCache.clear();
 }
@@ -671,19 +698,8 @@ function createCmssyClient(input) {
     ...input,
     apiUrl: resolveApiUrl(input.apiUrl)
   };
-  let cachedWorkspaceId;
-  let inFlight;
   function resolveWorkspaceId2(options) {
-    if (cachedWorkspaceId) return Promise.resolve(cachedWorkspaceId);
-    if (!inFlight) {
-      inFlight = resolveWorkspaceId(config, options).then((id) => {
-        cachedWorkspaceId = id;
-        return id;
-      }).finally(() => {
-        inFlight = void 0;
-      });
-    }
-    return inFlight;
+    return cachedWorkspaceId(config, options);
   }
   function query(document2, variables, options) {
     return graphqlRequest(
@@ -714,7 +730,11 @@ function createCmssyClient(input) {
   const client = {
     config,
     resolveWorkspaceId: resolveWorkspaceId2,
-    query: ((document2, variables = {}, options) => query(documentText(document2), variables, options)),
+    query: ((document2, variables = {}, options) => query(
+      documentText(document2),
+      variables,
+      options
+    )),
     queryScoped: ((document2, variables = {}, options = {}) => queryScoped(
       documentText(document2),
       variables,
@@ -1015,7 +1035,7 @@ async function resolveForms(config, blocks, schemas, locale, defaultLocale, opti
 // src/data/site-locales.ts
 var TTL_MS = 6e4;
 var FAILURE_TTL_MS = 5e3;
-var MAX_ENTRIES = 64;
+var MAX_ENTRIES2 = 64;
 var cache = /* @__PURE__ */ new Map();
 function localesFromSiteConfig(siteConfig) {
   const defaultLocale = siteConfig?.defaultLanguage || "en";
@@ -1039,11 +1059,14 @@ async function loadSiteLocales(config, options) {
       { ...options, public: true, retry: options?.retry ?? "build" },
       "site config"
     );
-    value = localesFromSiteConfig(data.public?.siteConfig ?? null);
+    const siteConfig = data.public?.siteConfig ?? null;
+    if (siteConfig?.workspaceId)
+      primeWorkspaceId(config, siteConfig.workspaceId);
+    value = localesFromSiteConfig(siteConfig);
   } catch {
     value = null;
   }
-  if (cache.size >= MAX_ENTRIES) cache.clear();
+  if (cache.size >= MAX_ENTRIES2) cache.clear();
   cache.set(key, {
     value,
     expires: Date.now() + (value ? TTL_MS : FAILURE_TTL_MS)

package/dist/preflight.cjs

@@ -346,13 +346,26 @@ function parseOrigin(value) {
     return null;
   }
 }
+var LOCAL_HOSTNAMES = ["localhost", "127.0.0.1"];
+function previewUrlFix(devOrigin) {
+  let hostname = null;
+  try {
+    hostname = new URL(devOrigin).hostname;
+  } catch {
+    hostname = null;
+  }
+  if (hostname && LOCAL_HOSTNAMES.includes(hostname)) {
+    return `toggle dev mode in the editor and enter ${devOrigin} there - ${SETTINGS_PATH} holds the shared preview URL of the DEPLOYED site, not your machine`;
+  }
+  return `paste ${devOrigin} into the preview URL field in ${SETTINGS_PATH}`;
+}
 function checkPreviewUrl(previewUrl, devOrigin) {
   const trimmed = previewUrl?.trim();
   if (!trimmed) {
     return {
       status: "fail",
       message: "no preview URL is set for this workspace",
-      fix: `paste ${devOrigin} into the preview URL field in ${SETTINGS_PATH}`
+      fix: previewUrlFix(devOrigin)
     };
   }
   const previewOrigin = parseOrigin(trimmed);
@@ -360,7 +373,7 @@ function checkPreviewUrl(previewUrl, devOrigin) {
     return {
       status: "fail",
       message: `the workspace preview URL "${trimmed}" is not a valid URL`,
-      fix: `paste ${devOrigin} into the preview URL field in ${SETTINGS_PATH}`
+      fix: previewUrlFix(devOrigin)
     };
   }
   const localOrigin = parseOrigin(devOrigin);
@@ -373,7 +386,7 @@ function checkPreviewUrl(previewUrl, devOrigin) {
   return {
     status: "fail",
     message: `the workspace preview URL is ${previewOrigin} but your dev server runs at ${devOrigin}`,
-    fix: `paste ${devOrigin} into the preview URL field in ${SETTINGS_PATH}`
+    fix: previewUrlFix(devOrigin)
   };
 }
 function frameAncestorSources(cspHeaderValue) {

package/dist/preflight.js

@@ -344,13 +344,26 @@ function parseOrigin(value) {
     return null;
   }
 }
+var LOCAL_HOSTNAMES = ["localhost", "127.0.0.1"];
+function previewUrlFix(devOrigin) {
+  let hostname = null;
+  try {
+    hostname = new URL(devOrigin).hostname;
+  } catch {
+    hostname = null;
+  }
+  if (hostname && LOCAL_HOSTNAMES.includes(hostname)) {
+    return `toggle dev mode in the editor and enter ${devOrigin} there - ${SETTINGS_PATH} holds the shared preview URL of the DEPLOYED site, not your machine`;
+  }
+  return `paste ${devOrigin} into the preview URL field in ${SETTINGS_PATH}`;
+}
 function checkPreviewUrl(previewUrl, devOrigin) {
   const trimmed = previewUrl?.trim();
   if (!trimmed) {
     return {
       status: "fail",
       message: "no preview URL is set for this workspace",
-      fix: `paste ${devOrigin} into the preview URL field in ${SETTINGS_PATH}`
+      fix: previewUrlFix(devOrigin)
     };
   }
   const previewOrigin = parseOrigin(trimmed);
@@ -358,7 +371,7 @@ function checkPreviewUrl(previewUrl, devOrigin) {
     return {
       status: "fail",
       message: `the workspace preview URL "${trimmed}" is not a valid URL`,
-      fix: `paste ${devOrigin} into the preview URL field in ${SETTINGS_PATH}`
+      fix: previewUrlFix(devOrigin)
     };
   }
   const localOrigin = parseOrigin(devOrigin);
@@ -371,7 +384,7 @@ function checkPreviewUrl(previewUrl, devOrigin) {
   return {
     status: "fail",
     message: `the workspace preview URL is ${previewOrigin} but your dev server runs at ${devOrigin}`,
-    fix: `paste ${devOrigin} into the preview URL field in ${SETTINGS_PATH}`
+    fix: previewUrlFix(devOrigin)
   };
 }
 function frameAncestorSources(cspHeaderValue) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/core",
-  "version": "16.2.0",
+  "version": "16.3.0",
   "description": "Framework-agnostic cmssy gateway: GraphQL client, block/field system, editor protocol. No React, no Next.",
   "keywords": [
     "cmssy",