@cmssy/core 11.1.1 → 11.3.0

package/dist/internal.cjs

@@ -1111,6 +1111,51 @@ function cmssyCspHeaders(options) {
   };
 }
 
+// src/data/delivery-operations.ts
+var CMSSY_DELIVERY_OPERATIONS = [
+  {
+    purpose: "Languages, branding and the 404 page - the workspace's settings.",
+    document: SITE_CONFIG_QUERY
+  },
+  {
+    purpose: "One page with its blocks. `previewSecret` returns the draft.",
+    document: PUBLIC_PAGE_QUERY
+  },
+  {
+    purpose: "One page by id - what the workspace's 404 page setting stores.",
+    document: PUBLIC_PAGE_BY_ID_QUERY
+  },
+  {
+    purpose: "The published page list - sitemaps, and static params.",
+    document: PUBLIC_PAGES_QUERY
+  },
+  {
+    purpose: "SEO fields for one page, without fetching its blocks.",
+    document: PUBLIC_PAGE_META_QUERY
+  },
+  {
+    purpose: "Header, footer and the other layout positions for a page.",
+    document: PUBLIC_PAGE_LAYOUTS_QUERY
+  },
+  {
+    purpose: "Records of one model - the typed half of `cmssy types`.",
+    document: MODEL_RECORDS_QUERY
+  },
+  {
+    purpose: "Records by id - how a relation field resolves to records.",
+    document: RECORDS_BY_IDS_QUERY
+  },
+  {
+    purpose: "A form definition, for rendering and validating it.",
+    document: FORM_QUERY
+  },
+  {
+    purpose: "Submitting that form - rendering one without this is half a feature.",
+    document: SUBMIT_FORM_MUTATION
+  }
+];
+
+exports.CMSSY_DELIVERY_OPERATIONS = CMSSY_DELIVERY_OPERATIONS;
 exports.CMSSY_LOCALE_HEADER = CMSSY_LOCALE_HEADER;
 exports.FORM_QUERY = FORM_QUERY;
 exports.MODEL_DEFINITIONS_QUERY = MODEL_DEFINITIONS_QUERY;

package/dist/internal.d.cts

@@ -62,4 +62,30 @@ declare function resolveRelationContent(config: CmssyClientConfig, entries: Rela
 
 declare function cmssySecretsMatch(a: string, b: string): Promise<boolean>;
 
-export { type BlockSchemaMap, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, RECORDS_BY_IDS_QUERY, type RelationContentEntry, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, asBucket, buildBlockContext, cachedWorkspaceId, clearWorkspaceIdCache, cmssySecretsMatch, collectFormIds, fetchSiteConfig, getBlockContentForLanguage, normalizeRelationContent, resolveForms, resolveRelationContent, resolveWorkspaceId };
+interface CmssyDeliveryOperation {
+    /** One line, for the generated file - why an app would want this one. */
+    purpose: string;
+    document: string;
+}
+/**
+ * The delivery operations the SDK itself performs, for `cmssy types` to vendor
+ * into an app.
+ *
+ * These reference the runtime constants rather than restating them: a second
+ * copy here would be free to drift from the client that actually sends them,
+ * which is the problem this list exists to remove. Keep it that way - a literal
+ * moved into this file also drops out of `sdl-operations.test.ts`, which
+ * validates exported document *strings* in their home modules.
+ *
+ * Deliberately absent, and why:
+ *
+ * - `PUBLIC_PAGE_DEV_QUERY` - a second document named `PublicPage`. Two
+ *   documents cannot share an operation name in graphql-codegen's client
+ *   preset, so including it would emit a file every consumer's codegen
+ *   rejects. It is also a dev-preview path an app never calls itself.
+ * - `MODEL_DEFINITIONS_QUERY` - `cmssy types` already turns definitions into
+ *   TypeScript; fetching them at runtime is not something an app does.
+ */
+declare const CMSSY_DELIVERY_OPERATIONS: readonly CmssyDeliveryOperation[];
+
+export { type BlockSchemaMap, CMSSY_DELIVERY_OPERATIONS, type CmssyDeliveryOperation, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, RECORDS_BY_IDS_QUERY, type RelationContentEntry, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, asBucket, buildBlockContext, cachedWorkspaceId, clearWorkspaceIdCache, cmssySecretsMatch, collectFormIds, fetchSiteConfig, getBlockContentForLanguage, normalizeRelationContent, resolveForms, resolveRelationContent, resolveWorkspaceId };

package/dist/internal.d.ts

@@ -62,4 +62,30 @@ declare function resolveRelationContent(config: CmssyClientConfig, entries: Rela
 
 declare function cmssySecretsMatch(a: string, b: string): Promise<boolean>;
 
-export { type BlockSchemaMap, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, RECORDS_BY_IDS_QUERY, type RelationContentEntry, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, asBucket, buildBlockContext, cachedWorkspaceId, clearWorkspaceIdCache, cmssySecretsMatch, collectFormIds, fetchSiteConfig, getBlockContentForLanguage, normalizeRelationContent, resolveForms, resolveRelationContent, resolveWorkspaceId };
+interface CmssyDeliveryOperation {
+    /** One line, for the generated file - why an app would want this one. */
+    purpose: string;
+    document: string;
+}
+/**
+ * The delivery operations the SDK itself performs, for `cmssy types` to vendor
+ * into an app.
+ *
+ * These reference the runtime constants rather than restating them: a second
+ * copy here would be free to drift from the client that actually sends them,
+ * which is the problem this list exists to remove. Keep it that way - a literal
+ * moved into this file also drops out of `sdl-operations.test.ts`, which
+ * validates exported document *strings* in their home modules.
+ *
+ * Deliberately absent, and why:
+ *
+ * - `PUBLIC_PAGE_DEV_QUERY` - a second document named `PublicPage`. Two
+ *   documents cannot share an operation name in graphql-codegen's client
+ *   preset, so including it would emit a file every consumer's codegen
+ *   rejects. It is also a dev-preview path an app never calls itself.
+ * - `MODEL_DEFINITIONS_QUERY` - `cmssy types` already turns definitions into
+ *   TypeScript; fetching them at runtime is not something an app does.
+ */
+declare const CMSSY_DELIVERY_OPERATIONS: readonly CmssyDeliveryOperation[];
+
+export { type BlockSchemaMap, CMSSY_DELIVERY_OPERATIONS, type CmssyDeliveryOperation, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, RECORDS_BY_IDS_QUERY, type RelationContentEntry, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, asBucket, buildBlockContext, cachedWorkspaceId, clearWorkspaceIdCache, cmssySecretsMatch, collectFormIds, fetchSiteConfig, getBlockContentForLanguage, normalizeRelationContent, resolveForms, resolveRelationContent, resolveWorkspaceId };

package/dist/internal.js

@@ -1109,4 +1109,48 @@ function cmssyCspHeaders(options) {
   };
 }
 
-export { CMSSY_LOCALE_HEADER, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, RECORDS_BY_IDS_QUERY, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, asBucket, buildBlockContext, buildLocaleSwitchHref, cachedWorkspaceId, clearWorkspaceIdCache, cmssyCspHeaders, cmssySecretsMatch, collectFormIds, fetchLayouts, fetchPage, fetchPageById, fetchPageMeta, fetchPages, fetchSiteConfig, getBlockContentForLanguage, isDevelopment, localeForPath, localeForPathname, localesFromSiteConfig, localizeHref, localizeHtmlLinks, localizedPath, normalizeRelationContent, normalizeSlug, resolveApiUrl, resolveForms, resolveInitialTarget, resolvePublicUrl, resolveRelationContent, resolveSiteLocales, resolveWorkspaceId, splitCmssyLocale, splitLocaleFromPath, toCspOrigin };
+// src/data/delivery-operations.ts
+var CMSSY_DELIVERY_OPERATIONS = [
+  {
+    purpose: "Languages, branding and the 404 page - the workspace's settings.",
+    document: SITE_CONFIG_QUERY
+  },
+  {
+    purpose: "One page with its blocks. `previewSecret` returns the draft.",
+    document: PUBLIC_PAGE_QUERY
+  },
+  {
+    purpose: "One page by id - what the workspace's 404 page setting stores.",
+    document: PUBLIC_PAGE_BY_ID_QUERY
+  },
+  {
+    purpose: "The published page list - sitemaps, and static params.",
+    document: PUBLIC_PAGES_QUERY
+  },
+  {
+    purpose: "SEO fields for one page, without fetching its blocks.",
+    document: PUBLIC_PAGE_META_QUERY
+  },
+  {
+    purpose: "Header, footer and the other layout positions for a page.",
+    document: PUBLIC_PAGE_LAYOUTS_QUERY
+  },
+  {
+    purpose: "Records of one model - the typed half of `cmssy types`.",
+    document: MODEL_RECORDS_QUERY
+  },
+  {
+    purpose: "Records by id - how a relation field resolves to records.",
+    document: RECORDS_BY_IDS_QUERY
+  },
+  {
+    purpose: "A form definition, for rendering and validating it.",
+    document: FORM_QUERY
+  },
+  {
+    purpose: "Submitting that form - rendering one without this is half a feature.",
+    document: SUBMIT_FORM_MUTATION
+  }
+];
+
+export { CMSSY_DELIVERY_OPERATIONS, CMSSY_LOCALE_HEADER, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, RECORDS_BY_IDS_QUERY, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, asBucket, buildBlockContext, buildLocaleSwitchHref, cachedWorkspaceId, clearWorkspaceIdCache, cmssyCspHeaders, cmssySecretsMatch, collectFormIds, fetchLayouts, fetchPage, fetchPageById, fetchPageMeta, fetchPages, fetchSiteConfig, getBlockContentForLanguage, isDevelopment, localeForPath, localeForPathname, localesFromSiteConfig, localizeHref, localizeHtmlLinks, localizedPath, normalizeRelationContent, normalizeSlug, resolveApiUrl, resolveForms, resolveInitialTarget, resolvePublicUrl, resolveRelationContent, resolveSiteLocales, resolveWorkspaceId, splitCmssyLocale, splitLocaleFromPath, toCspOrigin };

package/dist/testing.cjs

@@ -145,6 +145,10 @@ async function graphqlRequest(config, query, variables, options = {}, label = "r
 var EDITOR_MARKER = /data-cmssy-editor/;
 var SERVER_LAYOUT_BLOCKS = /<header|<footer/;
 var EDITABLE_LAYOUT_SLOT = /data-cmssy-layout-slot/;
+var EDITOR_CONTENT_COUNT = /data-cmssy-editor-content="(\d+)"/g;
+function resolvedContentCounts(body) {
+  return [...body.matchAll(EDITOR_CONTENT_COUNT)].map((m) => Number(m[1]));
+}
 async function html(url) {
   const response = await fetch(url, { redirect: "manual" });
   return { status: response.status, body: await response.text() };
@@ -216,6 +220,18 @@ async function checkCmssyEditMode(options) {
       `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)`
     );
   }
+  if (configured === true && EDITABLE_LAYOUT_SLOT.test(verified.body)) {
+    const counts = resolvedContentCounts(verified.body);
+    if (counts.length === 0) {
+      failures.push(
+        `edit ${path}: the layout slot reports no editor-content marker - @cmssy/react is older than 11.2.0, or the slot is not CmssyLazyLayout`
+      );
+    } else if (counts.every((count) => count === 0)) {
+      failures.push(
+        `edit ${path}: every layout slot resolved 0 blocks for the editor. The slot is mounted but was not rendered in edit mode - the canvas gets nothing and the fetch ran without the preview secret, so you are editing the published page. Check that the verified request reaches the edit route with its edit signal intact.`
+      );
+    }
+  }
   const { localizedPath } = options;
   if (localizedPath) {
     const locale = options.localizedLocale ?? localizedPath.split("/").filter(Boolean)[0];

package/dist/testing.js

@@ -143,6 +143,10 @@ async function graphqlRequest(config, query, variables, options = {}, label = "r
 var EDITOR_MARKER = /data-cmssy-editor/;
 var SERVER_LAYOUT_BLOCKS = /<header|<footer/;
 var EDITABLE_LAYOUT_SLOT = /data-cmssy-layout-slot/;
+var EDITOR_CONTENT_COUNT = /data-cmssy-editor-content="(\d+)"/g;
+function resolvedContentCounts(body) {
+  return [...body.matchAll(EDITOR_CONTENT_COUNT)].map((m) => Number(m[1]));
+}
 async function html(url) {
   const response = await fetch(url, { redirect: "manual" });
   return { status: response.status, body: await response.text() };
@@ -214,6 +218,18 @@ async function checkCmssyEditMode(options) {
       `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)`
     );
   }
+  if (configured === true && EDITABLE_LAYOUT_SLOT.test(verified.body)) {
+    const counts = resolvedContentCounts(verified.body);
+    if (counts.length === 0) {
+      failures.push(
+        `edit ${path}: the layout slot reports no editor-content marker - @cmssy/react is older than 11.2.0, or the slot is not CmssyLazyLayout`
+      );
+    } else if (counts.every((count) => count === 0)) {
+      failures.push(
+        `edit ${path}: every layout slot resolved 0 blocks for the editor. The slot is mounted but was not rendered in edit mode - the canvas gets nothing and the fetch ran without the preview secret, so you are editing the published page. Check that the verified request reaches the edit route with its edit signal intact.`
+      );
+    }
+  }
   const { localizedPath } = options;
   if (localizedPath) {
     const locale = options.localizedLocale ?? localizedPath.split("/").filter(Boolean)[0];

package/package.json

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