@cmssy/core 11.6.0 → 11.8.0

package/dist/testing.cjs

@@ -1,146 +1,5 @@
 'use strict';
 
-// src/data/http.ts
-var CmssyRequestError = class extends Error {
-  status;
-  /**
-   * How long the server asked us to wait, in ms, when it said so. Present on a
-   * 429 that carried `Retry-After`; a caller can serve stale content for that
-   * long instead of guessing.
-   */
-  retryAfterMs;
-  constructor(message, status, retryAfterMs2) {
-    super(message);
-    this.name = "CmssyRequestError";
-    this.status = status;
-    if (retryAfterMs2 !== void 0) this.retryAfterMs = retryAfterMs2;
-  }
-};
-var DEFAULT_RETRY_STATUSES = [429, 503];
-function retryAfterMs(response) {
-  const raw = response.headers?.get("retry-after");
-  if (!raw) return null;
-  const seconds = Number(raw);
-  if (Number.isFinite(seconds)) return Math.max(0, seconds * 1e3);
-  const date = Date.parse(raw);
-  if (Number.isFinite(date)) return Math.max(0, date - Date.now());
-  return null;
-}
-function sleep(ms, signal) {
-  return new Promise((resolve, reject) => {
-    if (signal?.aborted) {
-      reject(new Error("cmssy: request aborted"));
-      return;
-    }
-    const timer = setTimeout(() => {
-      signal?.removeEventListener("abort", onAbort);
-      resolve();
-    }, ms);
-    function onAbort() {
-      clearTimeout(timer);
-      reject(new Error("cmssy: request aborted"));
-    }
-    signal?.addEventListener("abort", onAbort, { once: true });
-  });
-}
-async function fetchWithRetry(doFetch, url, init, retry) {
-  if (retry === false || retry === void 0) {
-    return doFetch(url, init);
-  }
-  const maxRetries = retry.maxRetries ?? 3;
-  const baseDelayMs = retry.baseDelayMs ?? 300;
-  const maxDelayMs = retry.maxDelayMs ?? 3e3;
-  const maxRetryAfterMs = retry.maxRetryAfterMs ?? 1e4;
-  const retryStatuses = retry.retryStatuses ?? DEFAULT_RETRY_STATUSES;
-  let response = await doFetch(url, init);
-  for (let attempt = 0; attempt < maxRetries; attempt++) {
-    if (response.ok || !retryStatuses.includes(response.status)) {
-      return response;
-    }
-    const asked = retryAfterMs(response);
-    if (asked !== null && asked > maxRetryAfterMs) return response;
-    const backoff = baseDelayMs * 2 ** attempt;
-    const wait = asked !== null ? asked : Math.min(backoff, maxDelayMs);
-    await sleep(wait, init.signal);
-    response = await doFetch(url, init);
-  }
-  return response;
-}
-async function postGraphql(url, query, variables, options) {
-  const doFetch = options.fetch ?? globalThis.fetch;
-  if (typeof doFetch !== "function") {
-    throw new Error(
-      "cmssy: no fetch implementation available - pass options.fetch"
-    );
-  }
-  const response = await fetchWithRetry(
-    doFetch,
-    url,
-    {
-      method: "POST",
-      headers: { "content-type": "application/json", ...options.headers },
-      body: JSON.stringify({ query, variables }),
-      signal: options.signal
-    },
-    options.retry
-  );
-  if (!response.ok) {
-    let detail = "";
-    try {
-      const body = await response.json();
-      if (body.errors && body.errors.length > 0) {
-        detail = ` - ${body.errors.map((error) => error.message ?? "GraphQL error").join("; ")}`;
-      }
-    } catch {
-      detail = "";
-    }
-    const asked = retryAfterMs(response);
-    const wait = asked !== null ? ` - retry after ${Math.ceil(asked / 1e3)}s` : "";
-    throw new CmssyRequestError(
-      `cmssy: ${options.label} failed (${response.status})${detail}${wait}`,
-      response.status,
-      asked ?? void 0
-    );
-  }
-  let json;
-  try {
-    json = await response.json();
-  } catch {
-    throw new Error(`cmssy: invalid JSON response from the ${options.label}`);
-  }
-  if (json.errors && json.errors.length > 0) {
-    const message = json.errors.map((error) => error.message ?? "GraphQL error").join("; ");
-    throw new Error(`cmssy: ${options.label} error - ${message}`);
-  }
-  return json.data;
-}
-
-// src/content/content-client.ts
-var DEFAULT_CMSSY_API_URL = "https://api.cmssy.io/graphql";
-function resolveApiUrl(apiUrl) {
-  const explicit = apiUrl?.trim();
-  if (explicit) return explicit;
-  const env = globalThis.process?.env;
-  const fromEnv = env?.CMSSY_API_URL?.trim() ?? "";
-  return fromEnv.length > 0 ? fromEnv : DEFAULT_CMSSY_API_URL;
-}
-function resolvePublicUrl(config) {
-  const base = resolveApiUrl(config.apiUrl).replace(/\/graphql\/?$/, "");
-  return `${base}/public/${config.org}/${config.workspaceSlug}/graphql`;
-}
-
-// src/data/graphql-request.ts
-async function graphqlRequest(config, query, variables, options = {}, label = "request") {
-  const url = options.public ? resolvePublicUrl(config) : resolveApiUrl(config.apiUrl);
-  return postGraphql(url, query, variables, {
-    fetch: options.fetch,
-    signal: options.signal,
-    headers: options.headers,
-    retry: options.retry,
-    label
-  });
-}
-
 // src/preflight.ts
 var ALLOWED_FRAME_HOSTS = ["cmssy.io", "www.cmssy.io"];
 function frameAncestorSources(cspHeaderValue) {
@@ -209,36 +68,10 @@ function localeOf(path) {
 function langOf(body) {
   return /<html[^>]*\slang=["']([^"']+)["']/i.exec(body)?.[1];
 }
-var LAYOUT_BLOCKS_QUERY = `query CmssySmokeLayouts($workspaceSlug: String!, $pageSlug: String!) {
-  public {
-    page {
-      layouts(workspaceSlug: $workspaceSlug, pageSlug: $pageSlug) {
-        position
-        blocks { id isActive }
-      }
-    }
-  }
-}`;
-async function workspaceHasLayoutBlocks(workspace, pageSlug) {
-  try {
-    const data = await graphqlRequest(
-      workspace,
-      LAYOUT_BLOCKS_QUERY,
-      { workspaceSlug: workspace.workspaceSlug, pageSlug },
-      { public: true, retry: {} },
-      "edit smoke: layout blocks"
-    );
-    const groups = data.public?.page?.layouts ?? [];
-    return groups.some(
-      (group) => (group.blocks ?? []).some((block) => block.isActive !== false)
-    );
-  } catch {
-    return null;
-  }
-}
 async function checkCmssyEditMode(options) {
   const { baseUrl, secret, path = "/" } = options;
   const failures = [];
+  const skipped = [];
   const url = (suffix) => `${baseUrl.replace(/\/+$/, "")}${suffix}`;
   const publicPage = await html(url(path));
   if (publicPage.status !== 200) {
@@ -248,7 +81,17 @@ async function checkCmssyEditMode(options) {
     failures.push(`public ${path}: the editor is mounted on a public page`);
   }
   const hasServerLayoutBlocks = SERVER_LAYOUT_BLOCKS.test(publicPage.body);
-  const configured = options.workspace ? await workspaceHasLayoutBlocks(options.workspace, path) : null;
+  if (!hasServerLayoutBlocks) {
+    skipped.push(
+      `layout bridge: the public ${path} server-rendered no <header> or <footer>, so nothing proved they move onto the edit bridge in edit mode`
+    );
+  }
+  const expectLayoutBlocks = options.expectLayoutBlocks === true;
+  if (!expectLayoutBlocks) {
+    skipped.push(
+      "layout slot: expectLayoutBlocks is not set, so neither the mounted slot nor the content it resolved for the editor was asserted"
+    );
+  }
   const unverified = await html(url(`${path}?cmssyEdit=1`));
   if (EDITOR_MARKER.test(unverified.body)) {
     failures.push(
@@ -271,12 +114,12 @@ async function checkCmssyEditMode(options) {
       `edit ${path}: the header and footer are still server-rendered - the editor will let you select them but show no fields (is CMSSY_EDIT_HEADER set on the rewrite?)`
     );
   }
-  if (configured === true && !EDITABLE_LAYOUT_SLOT.test(verified.body)) {
+  if (expectLayoutBlocks && !EDITABLE_LAYOUT_SLOT.test(verified.body)) {
     failures.push(
-      `edit ${path}: the workspace defines layout blocks and no editable layout slot is mounted - the header and footer cannot be edited (10.0 removed CmssyLayoutSlot; see docs/wiring.md \xA75)`
+      `edit ${path}: expectLayoutBlocks is set and no editable layout slot is mounted - the header and footer cannot be edited (mount CmssyLayoutSlot from @cmssy/next/server, or resolveCmssyLayoutSlot on the other adapters; see docs/wiring.md \xA75)`
     );
   }
-  if (configured === true && EDITABLE_LAYOUT_SLOT.test(verified.body)) {
+  if (expectLayoutBlocks && EDITABLE_LAYOUT_SLOT.test(verified.body)) {
     const counts = resolvedContentCounts(verified.body);
     if (counts.length === 0) {
       failures.push(
@@ -290,6 +133,11 @@ async function checkCmssyEditMode(options) {
   }
   const query = `cmssyEdit=1&cmssySecret=${encodeURIComponent(secret)}`;
   const { localizedPath } = options;
+  if (!localizedPath) {
+    skipped.push(
+      "language: no localizedPath, so nothing checked that a prefixed URL previews in its own language"
+    );
+  }
   if (localizedPath) {
     const locale = options.localizedLocale ?? localeOf(localizedPath);
     const localized = await html(url(`${localizedPath}?${query}`));
@@ -314,8 +162,12 @@ async function checkCmssyEditMode(options) {
   }
   if (options.editRoute !== false) {
     await checkDirectEditRoute(url, path, query, void 0, failures);
+  } else {
+    skipped.push(
+      "edit route: this adapter serves the editor from the page (editRoute: false), so there is no /cmssy-edit route to reach directly and its frame-ancestors were not checked - nothing to fix unless you expected one"
+    );
   }
-  return { ok: failures.length === 0, failures };
+  return { ok: failures.length === 0, failures, skipped };
 }
 async function checkDirectEditRoute(url, routedPath, query, locale, failures) {
   const withoutPrefix = withoutEditPrefix(routedPath);

package/dist/testing.d.cts

@@ -1,65 +1,17 @@
 interface EditSmokeOptions {
-    /** A running build of the consumer app, e.g. http://localhost:3000. */
     baseUrl: string;
-    /** The site's CMSSY_DRAFT_SECRET. Without it nothing can be verified. */
     secret: string;
-    /** A published page to exercise. Defaults to "/". */
     path?: string;
-    /**
-     * The same page under a language prefix, e.g. "/no". The caller states it
-     * because only the caller knows how its site spells a language; asking a
-     * workspace would tie this check to content that can change or be deleted.
-     *
-     * Given it, the check also proves the preview renders in THAT language rather
-     * than the default one - by reading `<html lang>`, which is a contract,
-     * unlike a word from the page's copy that an editor can change at any time.
-     */
     localizedPath?: string;
-    /**
-     * The language `localizedPath` must render, e.g. "no". Defaults to the first
-     * path segment, which IS the language on a prefixed site.
-     */
     localizedLocale?: string;
-    /**
-     * The workspace the app is pointed at. Given it, the check asks the delivery
-     * API whether the workspace HAS header/footer blocks - and if it does, an app
-     * that renders none is a failure rather than a site that simply has none.
-     *
-     * That distinction is the whole point. `cmssy init` once scaffolded the
-     * editable-layout wrapper with nothing mounting it, so the app rendered no
-     * header at all - and this check, unable to tell "none configured" from "none
-     * rendered", stayed green.
-     */
-    workspace?: {
-        org: string;
-        workspaceSlug: string;
-        apiUrl?: string;
-    };
+    expectLayoutBlocks?: boolean;
     editRoute?: boolean;
 }
 interface EditSmokeResult {
     ok: boolean;
     failures: string[];
+    skipped: string[];
 }
-/**
- * Proves a consumer app's EDIT path still works - the path a build cannot check,
- * because the site compiles and serves fine while being uneditable.
- *
- * It asserts four independent things:
- *   1. the public page renders WITHOUT the editor, header and footer server-rendered;
- *   2. a bare `?cmssyEdit=1` does NOT enter edit mode (an unverified pair must
- *      not open the door - CMS-948);
- *   3. a verified `cmssyEdit=1` + `cmssySecret` renders the editor AND moves the
- *      header and footer onto the edit bridge;
- *   4. given `workspace`, that an app whose workspace HAS layout blocks renders
- *      them at all - the one thing "no header anywhere" and "no header
- *      configured" otherwise look alike.
- *
- * Run it against a started production build:
- *
- *   const result = await checkCmssyEditMode({ baseUrl, secret });
- *   expect(result.failures).toEqual([]);
- */
 declare function checkCmssyEditMode(options: EditSmokeOptions): Promise<EditSmokeResult>;
 
 export { type EditSmokeOptions, type EditSmokeResult, checkCmssyEditMode };

package/dist/testing.d.ts

@@ -1,65 +1,17 @@
 interface EditSmokeOptions {
-    /** A running build of the consumer app, e.g. http://localhost:3000. */
     baseUrl: string;
-    /** The site's CMSSY_DRAFT_SECRET. Without it nothing can be verified. */
     secret: string;
-    /** A published page to exercise. Defaults to "/". */
     path?: string;
-    /**
-     * The same page under a language prefix, e.g. "/no". The caller states it
-     * because only the caller knows how its site spells a language; asking a
-     * workspace would tie this check to content that can change or be deleted.
-     *
-     * Given it, the check also proves the preview renders in THAT language rather
-     * than the default one - by reading `<html lang>`, which is a contract,
-     * unlike a word from the page's copy that an editor can change at any time.
-     */
     localizedPath?: string;
-    /**
-     * The language `localizedPath` must render, e.g. "no". Defaults to the first
-     * path segment, which IS the language on a prefixed site.
-     */
     localizedLocale?: string;
-    /**
-     * The workspace the app is pointed at. Given it, the check asks the delivery
-     * API whether the workspace HAS header/footer blocks - and if it does, an app
-     * that renders none is a failure rather than a site that simply has none.
-     *
-     * That distinction is the whole point. `cmssy init` once scaffolded the
-     * editable-layout wrapper with nothing mounting it, so the app rendered no
-     * header at all - and this check, unable to tell "none configured" from "none
-     * rendered", stayed green.
-     */
-    workspace?: {
-        org: string;
-        workspaceSlug: string;
-        apiUrl?: string;
-    };
+    expectLayoutBlocks?: boolean;
     editRoute?: boolean;
 }
 interface EditSmokeResult {
     ok: boolean;
     failures: string[];
+    skipped: string[];
 }
-/**
- * Proves a consumer app's EDIT path still works - the path a build cannot check,
- * because the site compiles and serves fine while being uneditable.
- *
- * It asserts four independent things:
- *   1. the public page renders WITHOUT the editor, header and footer server-rendered;
- *   2. a bare `?cmssyEdit=1` does NOT enter edit mode (an unverified pair must
- *      not open the door - CMS-948);
- *   3. a verified `cmssyEdit=1` + `cmssySecret` renders the editor AND moves the
- *      header and footer onto the edit bridge;
- *   4. given `workspace`, that an app whose workspace HAS layout blocks renders
- *      them at all - the one thing "no header anywhere" and "no header
- *      configured" otherwise look alike.
- *
- * Run it against a started production build:
- *
- *   const result = await checkCmssyEditMode({ baseUrl, secret });
- *   expect(result.failures).toEqual([]);
- */
 declare function checkCmssyEditMode(options: EditSmokeOptions): Promise<EditSmokeResult>;
 
 export { type EditSmokeOptions, type EditSmokeResult, checkCmssyEditMode };

package/dist/testing.js

@@ -1,144 +1,3 @@
-// src/data/http.ts
-var CmssyRequestError = class extends Error {
-  status;
-  /**
-   * How long the server asked us to wait, in ms, when it said so. Present on a
-   * 429 that carried `Retry-After`; a caller can serve stale content for that
-   * long instead of guessing.
-   */
-  retryAfterMs;
-  constructor(message, status, retryAfterMs2) {
-    super(message);
-    this.name = "CmssyRequestError";
-    this.status = status;
-    if (retryAfterMs2 !== void 0) this.retryAfterMs = retryAfterMs2;
-  }
-};
-var DEFAULT_RETRY_STATUSES = [429, 503];
-function retryAfterMs(response) {
-  const raw = response.headers?.get("retry-after");
-  if (!raw) return null;
-  const seconds = Number(raw);
-  if (Number.isFinite(seconds)) return Math.max(0, seconds * 1e3);
-  const date = Date.parse(raw);
-  if (Number.isFinite(date)) return Math.max(0, date - Date.now());
-  return null;
-}
-function sleep(ms, signal) {
-  return new Promise((resolve, reject) => {
-    if (signal?.aborted) {
-      reject(new Error("cmssy: request aborted"));
-      return;
-    }
-    const timer = setTimeout(() => {
-      signal?.removeEventListener("abort", onAbort);
-      resolve();
-    }, ms);
-    function onAbort() {
-      clearTimeout(timer);
-      reject(new Error("cmssy: request aborted"));
-    }
-    signal?.addEventListener("abort", onAbort, { once: true });
-  });
-}
-async function fetchWithRetry(doFetch, url, init, retry) {
-  if (retry === false || retry === void 0) {
-    return doFetch(url, init);
-  }
-  const maxRetries = retry.maxRetries ?? 3;
-  const baseDelayMs = retry.baseDelayMs ?? 300;
-  const maxDelayMs = retry.maxDelayMs ?? 3e3;
-  const maxRetryAfterMs = retry.maxRetryAfterMs ?? 1e4;
-  const retryStatuses = retry.retryStatuses ?? DEFAULT_RETRY_STATUSES;
-  let response = await doFetch(url, init);
-  for (let attempt = 0; attempt < maxRetries; attempt++) {
-    if (response.ok || !retryStatuses.includes(response.status)) {
-      return response;
-    }
-    const asked = retryAfterMs(response);
-    if (asked !== null && asked > maxRetryAfterMs) return response;
-    const backoff = baseDelayMs * 2 ** attempt;
-    const wait = asked !== null ? asked : Math.min(backoff, maxDelayMs);
-    await sleep(wait, init.signal);
-    response = await doFetch(url, init);
-  }
-  return response;
-}
-async function postGraphql(url, query, variables, options) {
-  const doFetch = options.fetch ?? globalThis.fetch;
-  if (typeof doFetch !== "function") {
-    throw new Error(
-      "cmssy: no fetch implementation available - pass options.fetch"
-    );
-  }
-  const response = await fetchWithRetry(
-    doFetch,
-    url,
-    {
-      method: "POST",
-      headers: { "content-type": "application/json", ...options.headers },
-      body: JSON.stringify({ query, variables }),
-      signal: options.signal
-    },
-    options.retry
-  );
-  if (!response.ok) {
-    let detail = "";
-    try {
-      const body = await response.json();
-      if (body.errors && body.errors.length > 0) {
-        detail = ` - ${body.errors.map((error) => error.message ?? "GraphQL error").join("; ")}`;
-      }
-    } catch {
-      detail = "";
-    }
-    const asked = retryAfterMs(response);
-    const wait = asked !== null ? ` - retry after ${Math.ceil(asked / 1e3)}s` : "";
-    throw new CmssyRequestError(
-      `cmssy: ${options.label} failed (${response.status})${detail}${wait}`,
-      response.status,
-      asked ?? void 0
-    );
-  }
-  let json;
-  try {
-    json = await response.json();
-  } catch {
-    throw new Error(`cmssy: invalid JSON response from the ${options.label}`);
-  }
-  if (json.errors && json.errors.length > 0) {
-    const message = json.errors.map((error) => error.message ?? "GraphQL error").join("; ");
-    throw new Error(`cmssy: ${options.label} error - ${message}`);
-  }
-  return json.data;
-}
-
-// src/content/content-client.ts
-var DEFAULT_CMSSY_API_URL = "https://api.cmssy.io/graphql";
-function resolveApiUrl(apiUrl) {
-  const explicit = apiUrl?.trim();
-  if (explicit) return explicit;
-  const env = globalThis.process?.env;
-  const fromEnv = env?.CMSSY_API_URL?.trim() ?? "";
-  return fromEnv.length > 0 ? fromEnv : DEFAULT_CMSSY_API_URL;
-}
-function resolvePublicUrl(config) {
-  const base = resolveApiUrl(config.apiUrl).replace(/\/graphql\/?$/, "");
-  return `${base}/public/${config.org}/${config.workspaceSlug}/graphql`;
-}
-
-// src/data/graphql-request.ts
-async function graphqlRequest(config, query, variables, options = {}, label = "request") {
-  const url = options.public ? resolvePublicUrl(config) : resolveApiUrl(config.apiUrl);
-  return postGraphql(url, query, variables, {
-    fetch: options.fetch,
-    signal: options.signal,
-    headers: options.headers,
-    retry: options.retry,
-    label
-  });
-}
-
 // src/preflight.ts
 var ALLOWED_FRAME_HOSTS = ["cmssy.io", "www.cmssy.io"];
 function frameAncestorSources(cspHeaderValue) {
@@ -207,36 +66,10 @@ function localeOf(path) {
 function langOf(body) {
   return /<html[^>]*\slang=["']([^"']+)["']/i.exec(body)?.[1];
 }
-var LAYOUT_BLOCKS_QUERY = `query CmssySmokeLayouts($workspaceSlug: String!, $pageSlug: String!) {
-  public {
-    page {
-      layouts(workspaceSlug: $workspaceSlug, pageSlug: $pageSlug) {
-        position
-        blocks { id isActive }
-      }
-    }
-  }
-}`;
-async function workspaceHasLayoutBlocks(workspace, pageSlug) {
-  try {
-    const data = await graphqlRequest(
-      workspace,
-      LAYOUT_BLOCKS_QUERY,
-      { workspaceSlug: workspace.workspaceSlug, pageSlug },
-      { public: true, retry: {} },
-      "edit smoke: layout blocks"
-    );
-    const groups = data.public?.page?.layouts ?? [];
-    return groups.some(
-      (group) => (group.blocks ?? []).some((block) => block.isActive !== false)
-    );
-  } catch {
-    return null;
-  }
-}
 async function checkCmssyEditMode(options) {
   const { baseUrl, secret, path = "/" } = options;
   const failures = [];
+  const skipped = [];
   const url = (suffix) => `${baseUrl.replace(/\/+$/, "")}${suffix}`;
   const publicPage = await html(url(path));
   if (publicPage.status !== 200) {
@@ -246,7 +79,17 @@ async function checkCmssyEditMode(options) {
     failures.push(`public ${path}: the editor is mounted on a public page`);
   }
   const hasServerLayoutBlocks = SERVER_LAYOUT_BLOCKS.test(publicPage.body);
-  const configured = options.workspace ? await workspaceHasLayoutBlocks(options.workspace, path) : null;
+  if (!hasServerLayoutBlocks) {
+    skipped.push(
+      `layout bridge: the public ${path} server-rendered no <header> or <footer>, so nothing proved they move onto the edit bridge in edit mode`
+    );
+  }
+  const expectLayoutBlocks = options.expectLayoutBlocks === true;
+  if (!expectLayoutBlocks) {
+    skipped.push(
+      "layout slot: expectLayoutBlocks is not set, so neither the mounted slot nor the content it resolved for the editor was asserted"
+    );
+  }
   const unverified = await html(url(`${path}?cmssyEdit=1`));
   if (EDITOR_MARKER.test(unverified.body)) {
     failures.push(
@@ -269,12 +112,12 @@ async function checkCmssyEditMode(options) {
       `edit ${path}: the header and footer are still server-rendered - the editor will let you select them but show no fields (is CMSSY_EDIT_HEADER set on the rewrite?)`
     );
   }
-  if (configured === true && !EDITABLE_LAYOUT_SLOT.test(verified.body)) {
+  if (expectLayoutBlocks && !EDITABLE_LAYOUT_SLOT.test(verified.body)) {
     failures.push(
-      `edit ${path}: the workspace defines layout blocks and no editable layout slot is mounted - the header and footer cannot be edited (10.0 removed CmssyLayoutSlot; see docs/wiring.md \xA75)`
+      `edit ${path}: expectLayoutBlocks is set and no editable layout slot is mounted - the header and footer cannot be edited (mount CmssyLayoutSlot from @cmssy/next/server, or resolveCmssyLayoutSlot on the other adapters; see docs/wiring.md \xA75)`
     );
   }
-  if (configured === true && EDITABLE_LAYOUT_SLOT.test(verified.body)) {
+  if (expectLayoutBlocks && EDITABLE_LAYOUT_SLOT.test(verified.body)) {
     const counts = resolvedContentCounts(verified.body);
     if (counts.length === 0) {
       failures.push(
@@ -288,6 +131,11 @@ async function checkCmssyEditMode(options) {
   }
   const query = `cmssyEdit=1&cmssySecret=${encodeURIComponent(secret)}`;
   const { localizedPath } = options;
+  if (!localizedPath) {
+    skipped.push(
+      "language: no localizedPath, so nothing checked that a prefixed URL previews in its own language"
+    );
+  }
   if (localizedPath) {
     const locale = options.localizedLocale ?? localeOf(localizedPath);
     const localized = await html(url(`${localizedPath}?${query}`));
@@ -312,8 +160,12 @@ async function checkCmssyEditMode(options) {
   }
   if (options.editRoute !== false) {
     await checkDirectEditRoute(url, path, query, void 0, failures);
+  } else {
+    skipped.push(
+      "edit route: this adapter serves the editor from the page (editRoute: false), so there is no /cmssy-edit route to reach directly and its frame-ancestors were not checked - nothing to fix unless you expected one"
+    );
   }
-  return { ok: failures.length === 0, failures };
+  return { ok: failures.length === 0, failures, skipped };
 }
 async function checkDirectEditRoute(url, routedPath, query, locale, failures) {
   const withoutPrefix = withoutEditPrefix(routedPath);