@cmssy/core 19.4.0 → 19.5.0

package/dist/{content-client-DhcHP8ln.d.cts → content-client-BSNwo1SM.d.cts}

@@ -21,6 +21,18 @@ declare const CMSSY_RATE_LIMIT_WINDOW_MS = 60000;
 type ResolvedRetryPolicy = Readonly<Required<RetryPolicy>>;
 declare const CMSSY_RETRY_MODES: Record<CmssyRetryMode, ResolvedRetryPolicy>;
 declare function isTransientRequestError(error: unknown): error is CmssyRequestError;
+declare function createRetryingFetch<F extends FetchLike = FetchLike>(retry: RetryOption, doFetch?: F, label?: string): F;
+interface CmssyGraphqlErrorEntry {
+    message?: string;
+    extensions?: {
+        code?: string;
+    };
+}
+declare class CmssyGraphqlError extends Error {
+    readonly errors: ReadonlyArray<CmssyGraphqlErrorEntry>;
+    readonly code: string | undefined;
+    constructor(message: string, errors: ReadonlyArray<CmssyGraphqlErrorEntry>);
+}
 
 declare const DEFAULT_CMSSY_API_URL = "https://api.cmssy.io/graphql";
 declare function resolveApiUrl(apiUrl: string | undefined): string;
@@ -53,4 +65,4 @@ declare function fetchPages(config: CmssyClientConfig, options?: Pick<FetchPageO
 declare function fetchPageMeta(config: CmssyClientConfig, path: string | string[] | undefined, options?: Pick<FetchPageOptions, "fetch" | "signal" | "retry">): Promise<CmssyPageMeta | null>;
 declare function fetchLayouts(config: CmssyClientConfig, path: string | string[] | undefined, options?: FetchPageOptions): Promise<CmssyLayoutGroup[]>;
 
-export { CMSSY_RATE_LIMIT_WINDOW_MS as C, DEFAULT_CMSSY_API_URL as D, type FetchLike as F, type RetryOption as R, CMSSY_RETRY_MODES as a, CmssyRequestError as b, type CmssyRetryMode as c, type FetchLikeResponse as d, type FetchPageOptions as e, type RetryPolicy as f, fetchLayouts as g, fetchPage as h, isTransientRequestError as i, fetchPageById as j, fetchPageMeta as k, fetchPages as l, resolveApiUrl as r };
+export { CMSSY_RATE_LIMIT_WINDOW_MS as C, DEFAULT_CMSSY_API_URL as D, type FetchLike as F, type RetryOption as R, CMSSY_RETRY_MODES as a, CmssyGraphqlError as b, type CmssyGraphqlErrorEntry as c, CmssyRequestError as d, type CmssyRetryMode as e, type FetchLikeResponse as f, type FetchPageOptions as g, type RetryPolicy as h, createRetryingFetch as i, isTransientRequestError as j, fetchLayouts as k, fetchPage as l, fetchPageById as m, fetchPageMeta as n, fetchPages as o, resolveApiUrl as r };

package/dist/{content-client-DhcHP8ln.d.ts → content-client-BSNwo1SM.d.ts}

@@ -21,6 +21,18 @@ declare const CMSSY_RATE_LIMIT_WINDOW_MS = 60000;
 type ResolvedRetryPolicy = Readonly<Required<RetryPolicy>>;
 declare const CMSSY_RETRY_MODES: Record<CmssyRetryMode, ResolvedRetryPolicy>;
 declare function isTransientRequestError(error: unknown): error is CmssyRequestError;
+declare function createRetryingFetch<F extends FetchLike = FetchLike>(retry: RetryOption, doFetch?: F, label?: string): F;
+interface CmssyGraphqlErrorEntry {
+    message?: string;
+    extensions?: {
+        code?: string;
+    };
+}
+declare class CmssyGraphqlError extends Error {
+    readonly errors: ReadonlyArray<CmssyGraphqlErrorEntry>;
+    readonly code: string | undefined;
+    constructor(message: string, errors: ReadonlyArray<CmssyGraphqlErrorEntry>);
+}
 
 declare const DEFAULT_CMSSY_API_URL = "https://api.cmssy.io/graphql";
 declare function resolveApiUrl(apiUrl: string | undefined): string;
@@ -53,4 +65,4 @@ declare function fetchPages(config: CmssyClientConfig, options?: Pick<FetchPageO
 declare function fetchPageMeta(config: CmssyClientConfig, path: string | string[] | undefined, options?: Pick<FetchPageOptions, "fetch" | "signal" | "retry">): Promise<CmssyPageMeta | null>;
 declare function fetchLayouts(config: CmssyClientConfig, path: string | string[] | undefined, options?: FetchPageOptions): Promise<CmssyLayoutGroup[]>;
 
-export { CMSSY_RATE_LIMIT_WINDOW_MS as C, DEFAULT_CMSSY_API_URL as D, type FetchLike as F, type RetryOption as R, CMSSY_RETRY_MODES as a, CmssyRequestError as b, type CmssyRetryMode as c, type FetchLikeResponse as d, type FetchPageOptions as e, type RetryPolicy as f, fetchLayouts as g, fetchPage as h, isTransientRequestError as i, fetchPageById as j, fetchPageMeta as k, fetchPages as l, resolveApiUrl as r };
+export { CMSSY_RATE_LIMIT_WINDOW_MS as C, DEFAULT_CMSSY_API_URL as D, type FetchLike as F, type RetryOption as R, CMSSY_RETRY_MODES as a, CmssyGraphqlError as b, type CmssyGraphqlErrorEntry as c, CmssyRequestError as d, type CmssyRetryMode as e, type FetchLikeResponse as f, type FetchPageOptions as g, type RetryPolicy as h, createRetryingFetch as i, isTransientRequestError as j, fetchLayouts as k, fetchPage as l, fetchPageById as m, fetchPageMeta as n, fetchPages as o, resolveApiUrl as r };

package/dist/{csp-eQsMxVsg.d.cts → csp-CkxY33mW.d.cts}

@@ -1,5 +1,5 @@
 import { LayoutRegion, BlockPropsSchema, InferBlockContent, CmssyClientConfig, BlockRect, BlockSchema, BlockMeta } from '@cmssy/types';
-import { C as CmssyOperationInput, G as GraphqlRequestOptions } from './locale-DmMO2Cwk.cjs';
+import { C as CmssyOperationInput, G as GraphqlRequestOptions } from './locale-D1ZCb7eA.cjs';
 
 interface CmssyLayout<R extends readonly LayoutRegion[] = readonly LayoutRegion[]> {
     readonly regions: R;

package/dist/{csp-AofUvsVZ.d.ts → csp-vR6v-WmE.d.ts}

@@ -1,5 +1,5 @@
 import { LayoutRegion, BlockPropsSchema, InferBlockContent, CmssyClientConfig, BlockRect, BlockSchema, BlockMeta } from '@cmssy/types';
-import { C as CmssyOperationInput, G as GraphqlRequestOptions } from './locale-BHRDFyNF.js';
+import { C as CmssyOperationInput, G as GraphqlRequestOptions } from './locale-By_6K3p0.js';
 
 interface CmssyLayout<R extends readonly LayoutRegion[] = readonly LayoutRegion[]> {
     readonly regions: R;

package/dist/index.cjs

@@ -225,7 +225,7 @@ function documentText(document2) {
 }
 
 // src/version.ts
-var CMSSY_CORE_VERSION = "19.4.0" ;
+var CMSSY_CORE_VERSION = "19.5.0" ;
 var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
 
 // src/data/http.ts
@@ -348,12 +348,32 @@ async function fetchWithRetry(doFetch, url, init, retry, label) {
     console.warn(
       `[cmssy] ${label} got ${response.status}, retrying in ${wait}ms (attempt ${attempt + 1}/${policy.maxRetries})`
     );
-    await sleep(wait, init.signal);
+    await sleep(wait, init?.signal);
     waitedMs += wait;
     response = await doFetch(url, init);
   }
   return { response, waitedMs };
 }
+function createRetryingFetch(retry, doFetch, label = "request") {
+  const wrapped = async (url, init) => {
+    const impl = doFetch ?? globalThis.fetch;
+    if (typeof impl !== "function") {
+      throw new Error("cmssy: no fetch implementation available - pass one");
+    }
+    return (await fetchWithRetry(impl, url, init, retry, label)).response;
+  };
+  return wrapped;
+}
+var CmssyGraphqlError = class extends Error {
+  errors;
+  code;
+  constructor(message, errors) {
+    super(message);
+    this.name = "CmssyGraphqlError";
+    this.errors = errors;
+    this.code = errors[0]?.extensions?.code;
+  }
+};
 async function postGraphql(url, query, variables, options) {
   const doFetch = options.fetch ?? globalThis.fetch;
   if (typeof doFetch !== "function") {
@@ -405,7 +425,10 @@ async function postGraphql(url, query, variables, options) {
   }
   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}`);
+    throw new CmssyGraphqlError(
+      `cmssy: ${options.label} error - ${message}`,
+      json.errors
+    );
   }
   return json.data;
 }
@@ -1126,6 +1149,14 @@ async function verifyCmssyWebhook(options) {
   return parsed;
 }
 
+Object.defineProperty(exports, "API_TOKEN_HEADER_NAME", {
+  enumerable: true,
+  get: function () { return types.API_TOKEN_HEADER_NAME; }
+});
+Object.defineProperty(exports, "CLIENT_IP_HEADER_NAME", {
+  enumerable: true,
+  get: function () { return types.CLIENT_IP_HEADER_NAME; }
+});
 Object.defineProperty(exports, "MediaType", {
   enumerable: true,
   get: function () { return types.MediaType; }
@@ -1145,6 +1176,7 @@ exports.CMSSY_LOCALE_HEADER = CMSSY_LOCALE_HEADER;
 exports.CMSSY_RATE_LIMIT_WINDOW_MS = CMSSY_RATE_LIMIT_WINDOW_MS;
 exports.CMSSY_RETRY_MODES = CMSSY_RETRY_MODES;
 exports.CMSSY_SECRET_QUERY_PARAM = CMSSY_SECRET_QUERY_PARAM;
+exports.CmssyGraphqlError = CmssyGraphqlError;
 exports.CmssyRequestError = CmssyRequestError;
 exports.CmssyWebhookError = CmssyWebhookError;
 exports.DEFAULT_CMSSY_API_URL = DEFAULT_CMSSY_API_URL;
@@ -1156,6 +1188,7 @@ exports.blocksToMeta = blocksToMeta;
 exports.blocksToSchemas = blocksToSchemas;
 exports.buildBlockManifest = buildBlockManifest;
 exports.createCmssyClient = createCmssyClient;
+exports.createRetryingFetch = createRetryingFetch;
 exports.defineCmssyConfig = defineCmssyConfig;
 exports.defineCmssyLayout = defineCmssyLayout;
 exports.fields = fields;

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, e as CmssyLayout, f as CmssyRegion, g as CmssyRegionOf, h as CmssyRegionSettings, i as CmssyRegionSettingsOf, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, I as InvisibleBlock, j as InvisibleBlocksMessage, P as PROTOCOL_VERSION, k as ParentReadyMessage, l as PatchMessage, m as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SHORTCUT_ACTIONS, n as ScopedVariables, o as SelectMessage, p as ShortcutAction, q as ShortcutMessage, V as VariablesParameter, r as ViewportMessage, s as applyCmssyCsp, t as createCmssyClient, u as defineCmssyConfig, v as defineCmssyLayout, w as isProtocolCompatible, x as normalizeOrigin, y as parseEditorMessage, z as postToEditor, F as resolveEditorOrigin } from './csp-eQsMxVsg.cjs';
-export { a as CMSSY_LOCALE_HEADER, b as CmssyOperation, C as CmssyOperationInput, c as CmssyTypedDocument, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref, r as resolveCmssyLocale, t as typedOperation } from './locale-DmMO2Cwk.cjs';
-export { C as CMSSY_RATE_LIMIT_WINDOW_MS, a as CMSSY_RETRY_MODES, b as CmssyRequestError, c as CmssyRetryMode, D as DEFAULT_CMSSY_API_URL, F as FetchLike, d as FetchLikeResponse, e as FetchPageOptions, R as RetryOption, f as RetryPolicy, i as isTransientRequestError } from './content-client-DhcHP8ln.cjs';
+export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, e as CmssyLayout, f as CmssyRegion, g as CmssyRegionOf, h as CmssyRegionSettings, i as CmssyRegionSettingsOf, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, I as InvisibleBlock, j as InvisibleBlocksMessage, P as PROTOCOL_VERSION, k as ParentReadyMessage, l as PatchMessage, m as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SHORTCUT_ACTIONS, n as ScopedVariables, o as SelectMessage, p as ShortcutAction, q as ShortcutMessage, V as VariablesParameter, r as ViewportMessage, s as applyCmssyCsp, t as createCmssyClient, u as defineCmssyConfig, v as defineCmssyLayout, w as isProtocolCompatible, x as normalizeOrigin, y as parseEditorMessage, z as postToEditor, F as resolveEditorOrigin } from './csp-CkxY33mW.cjs';
+export { a as CMSSY_LOCALE_HEADER, b as CmssyOperation, C as CmssyOperationInput, c as CmssyTypedDocument, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref, r as resolveCmssyLocale, t as typedOperation } from './locale-D1ZCb7eA.cjs';
+export { C as CMSSY_RATE_LIMIT_WINDOW_MS, a as CMSSY_RETRY_MODES, b as CmssyGraphqlError, c as CmssyGraphqlErrorEntry, d as CmssyRequestError, e as CmssyRetryMode, D as DEFAULT_CMSSY_API_URL, F as FetchLike, f as FetchLikeResponse, g as FetchPageOptions, R as RetryOption, h as RetryPolicy, i as createRetryingFetch, j as isTransientRequestError } from './content-client-BSNwo1SM.cjs';
 import * as _cmssy_types from '@cmssy/types';
 import { FieldOptions, TypedField, FieldTypeValueMap, ResolvedMediaValue, PageRef, BlockPropsSchema, InferBlockContent, RelationMode, CmssyModelRecord, ResolvedMedia, MediaType, BlockSchema, LayoutRegion, FieldDefinition, BlockMeta, CmssyFormField, VerifyCmssyWebhookOptions, CmssyWebhookEvent } from '@cmssy/types';
-export { BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BuildBlockContextExtra, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockPage, CmssyBlockWorkspace, CmssyBranding, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssySiteConfig, CmssyWebhookEvent, CmssyWebhookOrder, FieldCondition, FieldConditionGroup, FieldConditionLogic, FieldControl, FieldDefinition, FieldOptions, FieldType, FileFieldValue, InferBlockContent, LayoutRegion, LayoutRegionId, MediaTransform, MediaType, RawBlock, RawLayoutBlock, ResolvedMedia, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup, mediaTypeValues } from '@cmssy/types';
+export { API_TOKEN_HEADER_NAME, BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BuildBlockContextExtra, CLIENT_IP_HEADER_NAME, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockPage, CmssyBlockWorkspace, CmssyBranding, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssySiteConfig, CmssyWebhookEvent, CmssyWebhookOrder, FieldCondition, FieldConditionGroup, FieldConditionLogic, FieldControl, FieldDefinition, FieldOptions, FieldType, FileFieldValue, InferBlockContent, LayoutRegion, LayoutRegionId, MediaTransform, MediaType, RawBlock, RawLayoutBlock, ResolvedMedia, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup, mediaTypeValues } from '@cmssy/types';
 
 /**
  * Whether the content is guaranteed to carry the field. Only `required` says

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, e as CmssyLayout, f as CmssyRegion, g as CmssyRegionOf, h as CmssyRegionSettings, i as CmssyRegionSettingsOf, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, I as InvisibleBlock, j as InvisibleBlocksMessage, P as PROTOCOL_VERSION, k as ParentReadyMessage, l as PatchMessage, m as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SHORTCUT_ACTIONS, n as ScopedVariables, o as SelectMessage, p as ShortcutAction, q as ShortcutMessage, V as VariablesParameter, r as ViewportMessage, s as applyCmssyCsp, t as createCmssyClient, u as defineCmssyConfig, v as defineCmssyLayout, w as isProtocolCompatible, x as normalizeOrigin, y as parseEditorMessage, z as postToEditor, F as resolveEditorOrigin } from './csp-AofUvsVZ.js';
-export { a as CMSSY_LOCALE_HEADER, b as CmssyOperation, C as CmssyOperationInput, c as CmssyTypedDocument, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref, r as resolveCmssyLocale, t as typedOperation } from './locale-BHRDFyNF.js';
-export { C as CMSSY_RATE_LIMIT_WINDOW_MS, a as CMSSY_RETRY_MODES, b as CmssyRequestError, c as CmssyRetryMode, D as DEFAULT_CMSSY_API_URL, F as FetchLike, d as FetchLikeResponse, e as FetchPageOptions, R as RetryOption, f as RetryPolicy, i as isTransientRequestError } from './content-client-DhcHP8ln.js';
+export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, e as CmssyLayout, f as CmssyRegion, g as CmssyRegionOf, h as CmssyRegionSettings, i as CmssyRegionSettingsOf, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, I as InvisibleBlock, j as InvisibleBlocksMessage, P as PROTOCOL_VERSION, k as ParentReadyMessage, l as PatchMessage, m as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SHORTCUT_ACTIONS, n as ScopedVariables, o as SelectMessage, p as ShortcutAction, q as ShortcutMessage, V as VariablesParameter, r as ViewportMessage, s as applyCmssyCsp, t as createCmssyClient, u as defineCmssyConfig, v as defineCmssyLayout, w as isProtocolCompatible, x as normalizeOrigin, y as parseEditorMessage, z as postToEditor, F as resolveEditorOrigin } from './csp-vR6v-WmE.js';
+export { a as CMSSY_LOCALE_HEADER, b as CmssyOperation, C as CmssyOperationInput, c as CmssyTypedDocument, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref, r as resolveCmssyLocale, t as typedOperation } from './locale-By_6K3p0.js';
+export { C as CMSSY_RATE_LIMIT_WINDOW_MS, a as CMSSY_RETRY_MODES, b as CmssyGraphqlError, c as CmssyGraphqlErrorEntry, d as CmssyRequestError, e as CmssyRetryMode, D as DEFAULT_CMSSY_API_URL, F as FetchLike, f as FetchLikeResponse, g as FetchPageOptions, R as RetryOption, h as RetryPolicy, i as createRetryingFetch, j as isTransientRequestError } from './content-client-BSNwo1SM.js';
 import * as _cmssy_types from '@cmssy/types';
 import { FieldOptions, TypedField, FieldTypeValueMap, ResolvedMediaValue, PageRef, BlockPropsSchema, InferBlockContent, RelationMode, CmssyModelRecord, ResolvedMedia, MediaType, BlockSchema, LayoutRegion, FieldDefinition, BlockMeta, CmssyFormField, VerifyCmssyWebhookOptions, CmssyWebhookEvent } from '@cmssy/types';
-export { BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BuildBlockContextExtra, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockPage, CmssyBlockWorkspace, CmssyBranding, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssySiteConfig, CmssyWebhookEvent, CmssyWebhookOrder, FieldCondition, FieldConditionGroup, FieldConditionLogic, FieldControl, FieldDefinition, FieldOptions, FieldType, FileFieldValue, InferBlockContent, LayoutRegion, LayoutRegionId, MediaTransform, MediaType, RawBlock, RawLayoutBlock, ResolvedMedia, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup, mediaTypeValues } from '@cmssy/types';
+export { API_TOKEN_HEADER_NAME, BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BuildBlockContextExtra, CLIENT_IP_HEADER_NAME, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockPage, CmssyBlockWorkspace, CmssyBranding, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssySiteConfig, CmssyWebhookEvent, CmssyWebhookOrder, FieldCondition, FieldConditionGroup, FieldConditionLogic, FieldControl, FieldDefinition, FieldOptions, FieldType, FileFieldValue, InferBlockContent, LayoutRegion, LayoutRegionId, MediaTransform, MediaType, RawBlock, RawLayoutBlock, ResolvedMedia, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup, mediaTypeValues } from '@cmssy/types';
 
 /**
  * Whether the content is guaranteed to carry the field. Only `required` says

package/dist/index.js

@@ -1,5 +1,5 @@
 import { brandingFieldNames, mediaTypeValues, LAYOUT_REGIONS_MAX, LAYOUT_REGION_ID_PATTERN, LAYOUT_REGION_LABEL_MAX, evaluateFieldConditionGroup } from '@cmssy/types';
-export { MediaType, evaluateFieldConditionGroup, mediaTypeValues } from '@cmssy/types';
+export { API_TOKEN_HEADER_NAME, CLIENT_IP_HEADER_NAME, MediaType, evaluateFieldConditionGroup, mediaTypeValues } from '@cmssy/types';
 
 // src/config.ts
 var DEFAULT_CMSSY_EDITOR_ORIGINS = [
@@ -224,7 +224,7 @@ function documentText(document2) {
 }
 
 // src/version.ts
-var CMSSY_CORE_VERSION = "19.4.0" ;
+var CMSSY_CORE_VERSION = "19.5.0" ;
 var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
 
 // src/data/http.ts
@@ -347,12 +347,32 @@ async function fetchWithRetry(doFetch, url, init, retry, label) {
     console.warn(
       `[cmssy] ${label} got ${response.status}, retrying in ${wait}ms (attempt ${attempt + 1}/${policy.maxRetries})`
     );
-    await sleep(wait, init.signal);
+    await sleep(wait, init?.signal);
     waitedMs += wait;
     response = await doFetch(url, init);
   }
   return { response, waitedMs };
 }
+function createRetryingFetch(retry, doFetch, label = "request") {
+  const wrapped = async (url, init) => {
+    const impl = doFetch ?? globalThis.fetch;
+    if (typeof impl !== "function") {
+      throw new Error("cmssy: no fetch implementation available - pass one");
+    }
+    return (await fetchWithRetry(impl, url, init, retry, label)).response;
+  };
+  return wrapped;
+}
+var CmssyGraphqlError = class extends Error {
+  errors;
+  code;
+  constructor(message, errors) {
+    super(message);
+    this.name = "CmssyGraphqlError";
+    this.errors = errors;
+    this.code = errors[0]?.extensions?.code;
+  }
+};
 async function postGraphql(url, query, variables, options) {
   const doFetch = options.fetch ?? globalThis.fetch;
   if (typeof doFetch !== "function") {
@@ -404,7 +424,10 @@ async function postGraphql(url, query, variables, options) {
   }
   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}`);
+    throw new CmssyGraphqlError(
+      `cmssy: ${options.label} error - ${message}`,
+      json.errors
+    );
   }
   return json.data;
 }
@@ -1125,4 +1148,4 @@ async function verifyCmssyWebhook(options) {
   return parsed;
 }
 
-export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_EDIT_TOKEN_HEADER, CMSSY_LOCALE_HEADER, CMSSY_RATE_LIMIT_WINDOW_MS, CMSSY_RETRY_MODES, CMSSY_SECRET_QUERY_PARAM, CmssyRequestError, CmssyWebhookError, DEFAULT_CMSSY_API_URL, DEFAULT_CMSSY_EDITOR_ORIGINS, PROTOCOL_VERSION, SHORTCUT_ACTIONS, applyCmssyCsp, blocksToMeta, blocksToSchemas, buildBlockManifest, createCmssyClient, defineCmssyConfig, defineCmssyLayout, fields, graphqlRequest, isFormFieldRequired, isFormFieldVisible, isProtocolCompatible, isTransientRequestError, isVerifiedEditUrl, layoutRegionsToBridge, localizeHref, mediaAlt, mediaDuration, mediaType, mediaUrl, mediaUrls, mintCmssyEditToken, normalizeOrigin, parseEditorMessage, postToEditor, propsToSchema, registryToManifestBlocks, resolveCmssyLocale, resolveEditorOrigin, typedOperation, verifyCmssyEditToken, verifyCmssyWebhook, visibleFormFields };
+export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_EDIT_TOKEN_HEADER, CMSSY_LOCALE_HEADER, CMSSY_RATE_LIMIT_WINDOW_MS, CMSSY_RETRY_MODES, CMSSY_SECRET_QUERY_PARAM, CmssyGraphqlError, CmssyRequestError, CmssyWebhookError, DEFAULT_CMSSY_API_URL, DEFAULT_CMSSY_EDITOR_ORIGINS, PROTOCOL_VERSION, SHORTCUT_ACTIONS, applyCmssyCsp, blocksToMeta, blocksToSchemas, buildBlockManifest, createCmssyClient, createRetryingFetch, defineCmssyConfig, defineCmssyLayout, fields, graphqlRequest, isFormFieldRequired, isFormFieldVisible, isProtocolCompatible, isTransientRequestError, isVerifiedEditUrl, layoutRegionsToBridge, localizeHref, mediaAlt, mediaDuration, mediaType, mediaUrl, mediaUrls, mintCmssyEditToken, normalizeOrigin, parseEditorMessage, postToEditor, propsToSchema, registryToManifestBlocks, resolveCmssyLocale, resolveEditorOrigin, typedOperation, verifyCmssyEditToken, verifyCmssyWebhook, visibleFormFields };

package/dist/internal/locale.cjs

@@ -154,7 +154,7 @@ function documentText(document) {
 }
 
 // src/version.ts
-var CMSSY_CORE_VERSION = "19.4.0" ;
+var CMSSY_CORE_VERSION = "19.5.0" ;
 var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
 
 // src/data/http.ts
@@ -274,12 +274,22 @@ async function fetchWithRetry(doFetch, url, init, retry, label) {
     console.warn(
       `[cmssy] ${label} got ${response.status}, retrying in ${wait}ms (attempt ${attempt + 1}/${policy.maxRetries})`
     );
-    await sleep(wait, init.signal);
+    await sleep(wait, init?.signal);
     waitedMs += wait;
     response = await doFetch(url, init);
   }
   return { response, waitedMs };
 }
+var CmssyGraphqlError = class extends Error {
+  errors;
+  code;
+  constructor(message, errors) {
+    super(message);
+    this.name = "CmssyGraphqlError";
+    this.errors = errors;
+    this.code = errors[0]?.extensions?.code;
+  }
+};
 async function postGraphql(url, query, variables, options) {
   const doFetch = options.fetch ?? globalThis.fetch;
   if (typeof doFetch !== "function") {
@@ -331,7 +341,10 @@ async function postGraphql(url, query, variables, options) {
   }
   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}`);
+    throw new CmssyGraphqlError(
+      `cmssy: ${options.label} error - ${message}`,
+      json.errors
+    );
   }
   return json.data;
 }

package/dist/internal/locale.d.cts

@@ -1,6 +1,6 @@
-export { a as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from '../locale-DmMO2Cwk.cjs';
+export { a as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from '../locale-D1ZCb7eA.cjs';
 export { CmssySiteLocales } from '@cmssy/types';
-import '../content-client-DhcHP8ln.cjs';
+import '../content-client-BSNwo1SM.cjs';
 
 declare function localizedPath(slug: string, locale: string, defaultLocale: string): string;
 

package/dist/internal/locale.d.ts

@@ -1,6 +1,6 @@
-export { a as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from '../locale-BHRDFyNF.js';
+export { a as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from '../locale-By_6K3p0.js';
 export { CmssySiteLocales } from '@cmssy/types';
-import '../content-client-DhcHP8ln.js';
+import '../content-client-BSNwo1SM.js';
 
 declare function localizedPath(slug: string, locale: string, defaultLocale: string): string;
 

package/dist/internal/locale.js

@@ -152,7 +152,7 @@ function documentText(document) {
 }
 
 // src/version.ts
-var CMSSY_CORE_VERSION = "19.4.0" ;
+var CMSSY_CORE_VERSION = "19.5.0" ;
 var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
 
 // src/data/http.ts
@@ -272,12 +272,22 @@ async function fetchWithRetry(doFetch, url, init, retry, label) {
     console.warn(
       `[cmssy] ${label} got ${response.status}, retrying in ${wait}ms (attempt ${attempt + 1}/${policy.maxRetries})`
     );
-    await sleep(wait, init.signal);
+    await sleep(wait, init?.signal);
     waitedMs += wait;
     response = await doFetch(url, init);
   }
   return { response, waitedMs };
 }
+var CmssyGraphqlError = class extends Error {
+  errors;
+  code;
+  constructor(message, errors) {
+    super(message);
+    this.name = "CmssyGraphqlError";
+    this.errors = errors;
+    this.code = errors[0]?.extensions?.code;
+  }
+};
 async function postGraphql(url, query, variables, options) {
   const doFetch = options.fetch ?? globalThis.fetch;
   if (typeof doFetch !== "function") {
@@ -329,7 +339,10 @@ async function postGraphql(url, query, variables, options) {
   }
   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}`);
+    throw new CmssyGraphqlError(
+      `cmssy: ${options.label} error - ${message}`,
+      json.errors
+    );
   }
   return json.data;
 }

package/dist/internal.cjs

@@ -154,7 +154,7 @@ function documentText(document2) {
 }
 
 // src/version.ts
-var CMSSY_CORE_VERSION = "19.4.0" ;
+var CMSSY_CORE_VERSION = "19.5.0" ;
 var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
 
 // src/data/http.ts
@@ -274,12 +274,22 @@ async function fetchWithRetry(doFetch, url, init, retry, label) {
     console.warn(
       `[cmssy] ${label} got ${response.status}, retrying in ${wait}ms (attempt ${attempt + 1}/${policy.maxRetries})`
     );
-    await sleep(wait, init.signal);
+    await sleep(wait, init?.signal);
     waitedMs += wait;
     response = await doFetch(url, init);
   }
   return { response, waitedMs };
 }
+var CmssyGraphqlError = class extends Error {
+  errors;
+  code;
+  constructor(message, errors) {
+    super(message);
+    this.name = "CmssyGraphqlError";
+    this.errors = errors;
+    this.code = errors[0]?.extensions?.code;
+  }
+};
 async function postGraphql(url, query, variables, options) {
   const doFetch = options.fetch ?? globalThis.fetch;
   if (typeof doFetch !== "function") {
@@ -331,7 +341,10 @@ async function postGraphql(url, query, variables, options) {
   }
   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}`);
+    throw new CmssyGraphqlError(
+      `cmssy: ${options.label} error - ${message}`,
+      json.errors
+    );
   }
   return json.data;
 }

package/dist/internal.d.cts

@@ -1,10 +1,10 @@
-export { g as fetchLayouts, h as fetchPage, j as fetchPageById, k as fetchPageMeta, l as fetchPages, r as resolveApiUrl } from './content-client-DhcHP8ln.cjs';
+export { k as fetchLayouts, l as fetchPage, m as fetchPageById, n as fetchPageMeta, o as fetchPages, r as resolveApiUrl } from './content-client-BSNwo1SM.cjs';
 import { CmssyFormDefinition, CmssyModelDefinition, CmssyRecordList, CmssySiteConfig, CmssyFormSubmitResponse, SubmitFormInput, BuildBlockContextExtra, CmssyBlockContext, CmssyClientConfig, FieldDefinition, RawBlock, CmssyLayoutGroup } from '@cmssy/types';
 export { CmssySiteLocales } from '@cmssy/types';
-import { b as CmssyOperation, G as GraphqlRequestOptions } from './locale-DmMO2Cwk.cjs';
-export { a as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from './locale-DmMO2Cwk.cjs';
-import { Q as QueryScopedOptions } from './csp-eQsMxVsg.cjs';
-export { G as cmssyCspHeaders, H as isDevelopment, J as layoutRegionIds, K as resolveInitialTarget, L as toCspOrigin } from './csp-eQsMxVsg.cjs';
+import { b as CmssyOperation, G as GraphqlRequestOptions } from './locale-D1ZCb7eA.cjs';
+export { a as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from './locale-D1ZCb7eA.cjs';
+import { Q as QueryScopedOptions } from './csp-CkxY33mW.cjs';
+export { G as cmssyCspHeaders, H as isDevelopment, J as layoutRegionIds, K as resolveInitialTarget, L as toCspOrigin } from './csp-CkxY33mW.cjs';
 export { localizedPath } from './internal/locale.cjs';
 
 interface SiteConfigVariables {

package/dist/internal.d.ts

@@ -1,10 +1,10 @@
-export { g as fetchLayouts, h as fetchPage, j as fetchPageById, k as fetchPageMeta, l as fetchPages, r as resolveApiUrl } from './content-client-DhcHP8ln.js';
+export { k as fetchLayouts, l as fetchPage, m as fetchPageById, n as fetchPageMeta, o as fetchPages, r as resolveApiUrl } from './content-client-BSNwo1SM.js';
 import { CmssyFormDefinition, CmssyModelDefinition, CmssyRecordList, CmssySiteConfig, CmssyFormSubmitResponse, SubmitFormInput, BuildBlockContextExtra, CmssyBlockContext, CmssyClientConfig, FieldDefinition, RawBlock, CmssyLayoutGroup } from '@cmssy/types';
 export { CmssySiteLocales } from '@cmssy/types';
-import { b as CmssyOperation, G as GraphqlRequestOptions } from './locale-BHRDFyNF.js';
-export { a as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from './locale-BHRDFyNF.js';
-import { Q as QueryScopedOptions } from './csp-AofUvsVZ.js';
-export { G as cmssyCspHeaders, H as isDevelopment, J as layoutRegionIds, K as resolveInitialTarget, L as toCspOrigin } from './csp-AofUvsVZ.js';
+import { b as CmssyOperation, G as GraphqlRequestOptions } from './locale-By_6K3p0.js';
+export { a as CMSSY_LOCALE_HEADER, d as localeForPath, e as localeForPathname, l as localizeHref, f as resolveSiteLocales, s as splitCmssyLocale, h as splitLocaleFromPath } from './locale-By_6K3p0.js';
+import { Q as QueryScopedOptions } from './csp-vR6v-WmE.js';
+export { G as cmssyCspHeaders, H as isDevelopment, J as layoutRegionIds, K as resolveInitialTarget, L as toCspOrigin } from './csp-vR6v-WmE.js';
 export { localizedPath } from './internal/locale.js';
 
 interface SiteConfigVariables {

package/dist/internal.js

@@ -152,7 +152,7 @@ function documentText(document2) {
 }
 
 // src/version.ts
-var CMSSY_CORE_VERSION = "19.4.0" ;
+var CMSSY_CORE_VERSION = "19.5.0" ;
 var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
 
 // src/data/http.ts
@@ -272,12 +272,22 @@ async function fetchWithRetry(doFetch, url, init, retry, label) {
     console.warn(
       `[cmssy] ${label} got ${response.status}, retrying in ${wait}ms (attempt ${attempt + 1}/${policy.maxRetries})`
     );
-    await sleep(wait, init.signal);
+    await sleep(wait, init?.signal);
     waitedMs += wait;
     response = await doFetch(url, init);
   }
   return { response, waitedMs };
 }
+var CmssyGraphqlError = class extends Error {
+  errors;
+  code;
+  constructor(message, errors) {
+    super(message);
+    this.name = "CmssyGraphqlError";
+    this.errors = errors;
+    this.code = errors[0]?.extensions?.code;
+  }
+};
 async function postGraphql(url, query, variables, options) {
   const doFetch = options.fetch ?? globalThis.fetch;
   if (typeof doFetch !== "function") {
@@ -329,7 +339,10 @@ async function postGraphql(url, query, variables, options) {
   }
   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}`);
+    throw new CmssyGraphqlError(
+      `cmssy: ${options.label} error - ${message}`,
+      json.errors
+    );
   }
   return json.data;
 }

package/dist/{locale-BHRDFyNF.d.ts → locale-By_6K3p0.d.ts}

@@ -1,5 +1,5 @@
 import { CmssyClientConfig, CmssyLocaleContext, CmssySiteLocales } from '@cmssy/types';
-import { F as FetchLike, R as RetryOption } from './content-client-DhcHP8ln.js';
+import { F as FetchLike, R as RetryOption } from './content-client-BSNwo1SM.js';
 
 interface CmssyTypedDocument<Result, Variables> {
     __apiType?: (variables: Variables) => Result;

package/dist/{locale-DmMO2Cwk.d.cts → locale-D1ZCb7eA.d.cts}

@@ -1,5 +1,5 @@
 import { CmssyClientConfig, CmssyLocaleContext, CmssySiteLocales } from '@cmssy/types';
-import { F as FetchLike, R as RetryOption } from './content-client-DhcHP8ln.cjs';
+import { F as FetchLike, R as RetryOption } from './content-client-BSNwo1SM.cjs';
 
 interface CmssyTypedDocument<Result, Variables> {
     __apiType?: (variables: Variables) => Result;

package/dist/preflight.cjs

@@ -152,7 +152,7 @@ function documentText(document) {
 }
 
 // src/version.ts
-var CMSSY_CORE_VERSION = "19.4.0" ;
+var CMSSY_CORE_VERSION = "19.5.0" ;
 var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
 
 // src/content/content-client.ts

package/dist/preflight.d.cts

@@ -1,4 +1,4 @@
-import { F as FetchLike } from './content-client-DhcHP8ln.cjs';
+import { F as FetchLike } from './content-client-BSNwo1SM.cjs';
 import { CmssyClientConfig } from '@cmssy/types';
 
 interface EditDiagnosticsConfig {

package/dist/preflight.d.ts

@@ -1,4 +1,4 @@
-import { F as FetchLike } from './content-client-DhcHP8ln.js';
+import { F as FetchLike } from './content-client-BSNwo1SM.js';
 import { CmssyClientConfig } from '@cmssy/types';
 
 interface EditDiagnosticsConfig {

package/dist/preflight.js

@@ -150,7 +150,7 @@ function documentText(document) {
 }
 
 // src/version.ts
-var CMSSY_CORE_VERSION = "19.4.0" ;
+var CMSSY_CORE_VERSION = "19.5.0" ;
 var CMSSY_USER_AGENT = `@cmssy/core/${CMSSY_CORE_VERSION}`;
 
 // src/content/content-client.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/core",
-  "version": "19.4.0",
+  "version": "19.5.0",
   "description": "Framework-agnostic cmssy gateway: GraphQL client, block/field system, editor protocol. No React, no Next.",
   "keywords": [
     "cmssy",
@@ -87,7 +87,7 @@
     "vitest": "^2.1.0"
   },
   "dependencies": {
-    "@cmssy/types": "0.59.0",
+    "@cmssy/types": "0.60.0",
     "jose": "^6.2.3"
   },
   "scripts": {