@cmssy/core 10.6.1 → 10.7.0

package/dist/testing.cjs

@@ -1,5 +1,146 @@
 '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/testing/edit-smoke.ts
 var EDITOR_MARKER = /data-cmssy-editor/;
 var SERVER_LAYOUT_BLOCKS = /<header|<footer/;
@@ -7,6 +148,33 @@ async function html(url) {
   const response = await fetch(url, { redirect: "manual" });
   return { status: response.status, body: await response.text() };
 }
+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 = [];
@@ -19,6 +187,12 @@ 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 (configured === true && !hasServerLayoutBlocks) {
+    failures.push(
+      `public ${path}: the workspace defines layout blocks and the page renders none - is a layout slot mounted? (10.0 removed CmssyLayoutSlot; see docs/wiring.md \xA75)`
+    );
+  }
   const unverified = await html(url(`${path}?cmssyEdit=1`));
   if (EDITOR_MARKER.test(unverified.body)) {
     failures.push(

package/dist/testing.d.cts

@@ -18,6 +18,21 @@ interface EditSmokeOptions {
      * 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;
+    };
 }
 interface EditSmokeResult {
     ok: boolean;
@@ -27,12 +42,15 @@ interface EditSmokeResult {
  * 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 three independent things:
+ * 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.
+ *      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:
  *

package/dist/testing.d.ts

@@ -18,6 +18,21 @@ interface EditSmokeOptions {
      * 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;
+    };
 }
 interface EditSmokeResult {
     ok: boolean;
@@ -27,12 +42,15 @@ interface EditSmokeResult {
  * 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 three independent things:
+ * 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.
+ *      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:
  *

package/dist/testing.js

@@ -1,3 +1,144 @@
+// 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/testing/edit-smoke.ts
 var EDITOR_MARKER = /data-cmssy-editor/;
 var SERVER_LAYOUT_BLOCKS = /<header|<footer/;
@@ -5,6 +146,33 @@ async function html(url) {
   const response = await fetch(url, { redirect: "manual" });
   return { status: response.status, body: await response.text() };
 }
+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 = [];
@@ -17,6 +185,12 @@ 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 (configured === true && !hasServerLayoutBlocks) {
+    failures.push(
+      `public ${path}: the workspace defines layout blocks and the page renders none - is a layout slot mounted? (10.0 removed CmssyLayoutSlot; see docs/wiring.md \xA75)`
+    );
+  }
   const unverified = await html(url(`${path}?cmssyEdit=1`));
   if (EDITOR_MARKER.test(unverified.body)) {
     failures.push(

package/package.json

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