@cmssy/core 10.3.0 → 10.4.0

package/dist/{content-client-D0EdiqbQ.d.cts → content-client-CJQ-nafm.d.cts}

@@ -3,15 +3,28 @@ import { CmssyClientConfig, CmssyLayoutGroup, CmssyPageData, CmssyPageMeta, Cmss
 /** HTTP-level failure from the cmssy API, with a machine-readable status. */
 declare class CmssyRequestError extends Error {
     readonly status: number;
-    constructor(message: string, status: number);
+    /**
+     * 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.
+     */
+    readonly retryAfterMs?: number;
+    constructor(message: string, status: number, retryAfterMs?: number);
 }
 interface RetryPolicy {
     /** Additional attempts after the first request (default 3). */
     maxRetries?: number;
     /** Exponential backoff base in ms: base * 2^attempt (default 300). */
     baseDelayMs?: number;
-    /** Upper bound for any single wait, including Retry-After (default 3000). */
+    /** Upper bound for a guessed backoff wait (default 3000). */
     maxDelayMs?: number;
+    /**
+     * Upper bound for a wait the server asked for by `Retry-After` (default
+     * 10000). Beyond it there is nothing to gain from holding a render open, so
+     * the request fails immediately and carries `retryAfterMs` - the caller is in
+     * a better position to decide between stale content and an error page.
+     */
+    maxRetryAfterMs?: number;
     /** HTTP statuses that trigger a retry (default [429, 503]). */
     retryStatuses?: number[];
 }

package/dist/{content-client-D0EdiqbQ.d.ts → content-client-CJQ-nafm.d.ts}

@@ -3,15 +3,28 @@ import { CmssyClientConfig, CmssyLayoutGroup, CmssyPageData, CmssyPageMeta, Cmss
 /** HTTP-level failure from the cmssy API, with a machine-readable status. */
 declare class CmssyRequestError extends Error {
     readonly status: number;
-    constructor(message: string, status: number);
+    /**
+     * 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.
+     */
+    readonly retryAfterMs?: number;
+    constructor(message: string, status: number, retryAfterMs?: number);
 }
 interface RetryPolicy {
     /** Additional attempts after the first request (default 3). */
     maxRetries?: number;
     /** Exponential backoff base in ms: base * 2^attempt (default 300). */
     baseDelayMs?: number;
-    /** Upper bound for any single wait, including Retry-After (default 3000). */
+    /** Upper bound for a guessed backoff wait (default 3000). */
     maxDelayMs?: number;
+    /**
+     * Upper bound for a wait the server asked for by `Retry-After` (default
+     * 10000). Beyond it there is nothing to gain from holding a render open, so
+     * the request fails immediately and carries `retryAfterMs` - the caller is in
+     * a better position to decide between stale content and an error page.
+     */
+    maxRetryAfterMs?: number;
     /** HTTP statuses that trigger a retry (default [429, 503]). */
     retryStatuses?: number[];
 }

package/dist/{csp-DlAEXYjA.d.cts → csp-BityT_ug.d.cts}

@@ -1,5 +1,5 @@
 import { CmssyClientConfig, BlockRect, BlockSchema, BlockMeta } from '@cmssy/types';
-import { G as GraphqlRequestOptions } from './locale-rhYcXU5z.cjs';
+import { G as GraphqlRequestOptions } from './locale-C7sA46qu.cjs';
 
 declare const DEFAULT_CMSSY_EDITOR_ORIGINS: string[];
 declare function isDevelopment(): boolean;

package/dist/{csp-Blh6P15m.d.ts → csp-DJ17P3PN.d.ts}

@@ -1,5 +1,5 @@
 import { CmssyClientConfig, BlockRect, BlockSchema, BlockMeta } from '@cmssy/types';
-import { G as GraphqlRequestOptions } from './locale-XintNd0n.js';
+import { G as GraphqlRequestOptions } from './locale-Ox_qVlNy.js';
 
 declare const DEFAULT_CMSSY_EDITOR_ORIGINS: string[];
 declare function isDevelopment(): boolean;

package/dist/index.cjs

@@ -64,10 +64,17 @@ Set the listed environment variables (e.g. in .env.local) and restart the dev se
 // src/data/http.ts
 var CmssyRequestError = class extends Error {
   status;
-  constructor(message, 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];
@@ -104,14 +111,17 @@ async function fetchWithRetry(doFetch, url, init, retry) {
   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 = Math.min(retryAfterMs(response) ?? backoff, maxDelayMs);
+    const wait = asked !== null ? asked : Math.min(backoff, maxDelayMs);
     await sleep(wait, init.signal);
     response = await doFetch(url, init);
   }
@@ -145,9 +155,12 @@ async function postGraphql(url, query, variables, options) {
     } 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}`,
-      response.status
+      `cmssy: ${options.label} failed (${response.status})${detail}${wait}`,
+      response.status,
+      asked ?? void 0
     );
   }
   let json;

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, P as PROTOCOL_VERSION, e as ParentReadyMessage, f as PatchMessage, g as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SelectMessage, h as applyCmssyCsp, i as createCmssyClient, j as defineCmssyConfig, k as isProtocolCompatible, n as normalizeOrigin, p as parseEditorMessage, l as postToEditor, r as resolveEditorOrigin } from './csp-DlAEXYjA.cjs';
-export { C as CMSSY_LOCALE_HEADER, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref } from './locale-rhYcXU5z.cjs';
-export { C as CmssyRequestError, D as DEFAULT_CMSSY_API_URL, F as FetchLike, a as FetchLikeResponse, b as FetchPageOptions, R as RetryPolicy } from './content-client-D0EdiqbQ.cjs';
+export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, P as PROTOCOL_VERSION, e as ParentReadyMessage, f as PatchMessage, g as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SelectMessage, h as applyCmssyCsp, i as createCmssyClient, j as defineCmssyConfig, k as isProtocolCompatible, n as normalizeOrigin, p as parseEditorMessage, l as postToEditor, r as resolveEditorOrigin } from './csp-BityT_ug.cjs';
+export { C as CMSSY_LOCALE_HEADER, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref } from './locale-C7sA46qu.cjs';
+export { C as CmssyRequestError, D as DEFAULT_CMSSY_API_URL, F as FetchLike, a as FetchLikeResponse, b as FetchPageOptions, R as RetryPolicy } from './content-client-CJQ-nafm.cjs';
 import * as _cmssy_types from '@cmssy/types';
 import { FieldOptions, TypedField, BlockPropsSchema, InferBlockContent, RelationMode, CmssyModelRecord, VerifyCmssyWebhookOptions, CmssyWebhookEvent } from '@cmssy/types';
 export { BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BuildBlockContextExtra, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockPage, CmssyBlockWorkspace, CmssyBranding, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLayoutSettings, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssySiteConfig, CmssyWebhookEvent, CmssyWebhookOrder, FieldCondition, FieldConditionGroup, FieldConditionLogic, FieldControl, FieldDefinition, FieldOptions, FieldType, InferBlockContent, RawBlock, RawLayoutBlock, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup } from '@cmssy/types';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, P as PROTOCOL_VERSION, e as ParentReadyMessage, f as PatchMessage, g as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SelectMessage, h as applyCmssyCsp, i as createCmssyClient, j as defineCmssyConfig, k as isProtocolCompatible, n as normalizeOrigin, p as parseEditorMessage, l as postToEditor, r as resolveEditorOrigin } from './csp-Blh6P15m.js';
-export { C as CMSSY_LOCALE_HEADER, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref } from './locale-XintNd0n.js';
-export { C as CmssyRequestError, D as DEFAULT_CMSSY_API_URL, F as FetchLike, a as FetchLikeResponse, b as FetchPageOptions, R as RetryPolicy } from './content-client-D0EdiqbQ.js';
+export { A as AppToEditorMessage, B as BoundsMessage, C as ClickMessage, a as CmssyClient, b as CmssyConfig, c as CmssyCspOptions, d as CmssyEnvConfig, D as DEFAULT_CMSSY_EDITOR_ORIGINS, E as EditorToAppMessage, P as PROTOCOL_VERSION, e as ParentReadyMessage, f as PatchMessage, g as PostTarget, Q as QueryScopedOptions, R as ReadyMessage, S as SelectMessage, h as applyCmssyCsp, i as createCmssyClient, j as defineCmssyConfig, k as isProtocolCompatible, n as normalizeOrigin, p as parseEditorMessage, l as postToEditor, r as resolveEditorOrigin } from './csp-DJ17P3PN.js';
+export { C as CMSSY_LOCALE_HEADER, G as GraphqlRequestOptions, g as graphqlRequest, l as localizeHref } from './locale-Ox_qVlNy.js';
+export { C as CmssyRequestError, D as DEFAULT_CMSSY_API_URL, F as FetchLike, a as FetchLikeResponse, b as FetchPageOptions, R as RetryPolicy } from './content-client-CJQ-nafm.js';
 import * as _cmssy_types from '@cmssy/types';
 import { FieldOptions, TypedField, BlockPropsSchema, InferBlockContent, RelationMode, CmssyModelRecord, VerifyCmssyWebhookOptions, CmssyWebhookEvent } from '@cmssy/types';
 export { BlockMeta, BlockPropsSchema, BlockRect, BlockSchema, BuildBlockContextExtra, CmssyBlockAuthContext, CmssyBlockContext, CmssyBlockMember, CmssyBlockPage, CmssyBlockWorkspace, CmssyBranding, CmssyClientConfig, CmssyFormDefinition, CmssyFormField, CmssyFormSettings, CmssyFormSubmitResponse, CmssyLayoutGroup, CmssyLayoutSettings, CmssyLocaleContext, CmssyLocalizedValue, CmssyModelDefinition, CmssyModelRecord, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyRecordList, CmssySiteConfig, CmssyWebhookEvent, CmssyWebhookOrder, FieldCondition, FieldConditionGroup, FieldConditionLogic, FieldControl, FieldDefinition, FieldOptions, FieldType, InferBlockContent, RawBlock, RawLayoutBlock, SubmitFormInput, TypedField, VerifyCmssyWebhookOptions, evaluateFieldConditionGroup } from '@cmssy/types';

package/dist/index.js

@@ -62,10 +62,17 @@ Set the listed environment variables (e.g. in .env.local) and restart the dev se
 // src/data/http.ts
 var CmssyRequestError = class extends Error {
   status;
-  constructor(message, 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];
@@ -102,14 +109,17 @@ async function fetchWithRetry(doFetch, url, init, retry) {
   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 = Math.min(retryAfterMs(response) ?? backoff, maxDelayMs);
+    const wait = asked !== null ? asked : Math.min(backoff, maxDelayMs);
     await sleep(wait, init.signal);
     response = await doFetch(url, init);
   }
@@ -143,9 +153,12 @@ async function postGraphql(url, query, variables, options) {
     } 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}`,
-      response.status
+      `cmssy: ${options.label} failed (${response.status})${detail}${wait}`,
+      response.status,
+      asked ?? void 0
     );
   }
   let json;

package/dist/internal/locale.cjs

@@ -3,10 +3,17 @@
 // src/data/http.ts
 var CmssyRequestError = class extends Error {
   status;
-  constructor(message, 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];
@@ -43,14 +50,17 @@ async function fetchWithRetry(doFetch, url, init, retry) {
   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 = Math.min(retryAfterMs(response) ?? backoff, maxDelayMs);
+    const wait = asked !== null ? asked : Math.min(backoff, maxDelayMs);
     await sleep(wait, init.signal);
     response = await doFetch(url, init);
   }
@@ -84,9 +94,12 @@ async function postGraphql(url, query, variables, options) {
     } 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}`,
-      response.status
+      `cmssy: ${options.label} failed (${response.status})${detail}${wait}`,
+      response.status,
+      asked ?? void 0
     );
   }
   let json;

package/dist/internal/locale.d.cts

@@ -1,8 +1,8 @@
-import { G as GraphqlRequestOptions } from '../locale-rhYcXU5z.cjs';
-export { C as CMSSY_LOCALE_HEADER, b as buildLocaleSwitchHref, a as localeForPath, c as localeForPathname, l as localizeHref, d as localizeHtmlLinks, s as splitCmssyLocale } from '../locale-rhYcXU5z.cjs';
+import { G as GraphqlRequestOptions } from '../locale-C7sA46qu.cjs';
+export { C as CMSSY_LOCALE_HEADER, b as buildLocaleSwitchHref, a as localeForPath, c as localeForPathname, l as localizeHref, d as localizeHtmlLinks, s as splitCmssyLocale } from '../locale-C7sA46qu.cjs';
 import { CmssySiteLocales, CmssyClientConfig } from '@cmssy/types';
 export { CmssySiteLocales } from '@cmssy/types';
-import '../content-client-D0EdiqbQ.cjs';
+import '../content-client-CJQ-nafm.cjs';
 
 /**
  * Maps a workspace site config to its locale set. The single place that

package/dist/internal/locale.d.ts

@@ -1,8 +1,8 @@
-import { G as GraphqlRequestOptions } from '../locale-XintNd0n.js';
-export { C as CMSSY_LOCALE_HEADER, b as buildLocaleSwitchHref, a as localeForPath, c as localeForPathname, l as localizeHref, d as localizeHtmlLinks, s as splitCmssyLocale } from '../locale-XintNd0n.js';
+import { G as GraphqlRequestOptions } from '../locale-Ox_qVlNy.js';
+export { C as CMSSY_LOCALE_HEADER, b as buildLocaleSwitchHref, a as localeForPath, c as localeForPathname, l as localizeHref, d as localizeHtmlLinks, s as splitCmssyLocale } from '../locale-Ox_qVlNy.js';
 import { CmssySiteLocales, CmssyClientConfig } from '@cmssy/types';
 export { CmssySiteLocales } from '@cmssy/types';
-import '../content-client-D0EdiqbQ.js';
+import '../content-client-CJQ-nafm.js';
 
 /**
  * Maps a workspace site config to its locale set. The single place that

package/dist/internal/locale.js

@@ -1,10 +1,17 @@
 // src/data/http.ts
 var CmssyRequestError = class extends Error {
   status;
-  constructor(message, 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];
@@ -41,14 +48,17 @@ async function fetchWithRetry(doFetch, url, init, retry) {
   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 = Math.min(retryAfterMs(response) ?? backoff, maxDelayMs);
+    const wait = asked !== null ? asked : Math.min(backoff, maxDelayMs);
     await sleep(wait, init.signal);
     response = await doFetch(url, init);
   }
@@ -82,9 +92,12 @@ async function postGraphql(url, query, variables, options) {
     } 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}`,
-      response.status
+      `cmssy: ${options.label} failed (${response.status})${detail}${wait}`,
+      response.status,
+      asked ?? void 0
     );
   }
   let json;

package/dist/internal.cjs

@@ -3,10 +3,17 @@
 // src/data/http.ts
 var CmssyRequestError = class extends Error {
   status;
-  constructor(message, 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];
@@ -43,14 +50,17 @@ async function fetchWithRetry(doFetch, url, init, retry) {
   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 = Math.min(retryAfterMs(response) ?? backoff, maxDelayMs);
+    const wait = asked !== null ? asked : Math.min(backoff, maxDelayMs);
     await sleep(wait, init.signal);
     response = await doFetch(url, init);
   }
@@ -84,9 +94,12 @@ async function postGraphql(url, query, variables, options) {
     } 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}`,
-      response.status
+      `cmssy: ${options.label} failed (${response.status})${detail}${wait}`,
+      response.status,
+      asked ?? void 0
     );
   }
   let json;

package/dist/internal.d.cts

@@ -1,10 +1,10 @@
-export { f as fetchLayouts, c as fetchPage, d as fetchPageById, e as fetchPageMeta, g as fetchPages, n as normalizeSlug, r as resolveApiUrl, h as resolvePublicUrl } from './content-client-D0EdiqbQ.cjs';
+export { f as fetchLayouts, c as fetchPage, d as fetchPageById, e as fetchPageMeta, g as fetchPages, n as normalizeSlug, r as resolveApiUrl, h as resolvePublicUrl } from './content-client-CJQ-nafm.cjs';
 import { CmssyFormDefinition, BuildBlockContextExtra, CmssyBlockContext, CmssyClientConfig, CmssySiteConfig, RawBlock, FieldDefinition } from '@cmssy/types';
 export { CmssySiteLocales } from '@cmssy/types';
-import { G as GraphqlRequestOptions } from './locale-rhYcXU5z.cjs';
-export { C as CMSSY_LOCALE_HEADER, b as buildLocaleSwitchHref, a as localeForPath, c as localeForPathname, l as localizeHref, d as localizeHtmlLinks, s as splitCmssyLocale } from './locale-rhYcXU5z.cjs';
-import { Q as QueryScopedOptions } from './csp-DlAEXYjA.cjs';
-export { m as cmssyCspHeaders, o as isDevelopment, q as resolveInitialTarget, t as toCspOrigin } from './csp-DlAEXYjA.cjs';
+import { G as GraphqlRequestOptions } from './locale-C7sA46qu.cjs';
+export { C as CMSSY_LOCALE_HEADER, b as buildLocaleSwitchHref, a as localeForPath, c as localeForPathname, l as localizeHref, d as localizeHtmlLinks, s as splitCmssyLocale } from './locale-C7sA46qu.cjs';
+import { Q as QueryScopedOptions } from './csp-BityT_ug.cjs';
+export { m as cmssyCspHeaders, o as isDevelopment, q as resolveInitialTarget, t as toCspOrigin } from './csp-BityT_ug.cjs';
 export { localesFromSiteConfig, localizedPath, resolveSiteLocales, splitLocaleFromPath } from './internal/locale.cjs';
 
 declare const SITE_CONFIG_QUERY = "query PublicSiteConfig($workspaceSlug: String!) {\n  public {\n    siteConfig(workspaceSlug: $workspaceSlug) {\n      id\n      workspaceId\n      siteName\n      defaultLanguage\n      enabledLanguages\n      enabledFeatures\n      notFoundPageId\n      previewUrl\n      branding {\n        brandName\n        logoUrl\n        faviconUrl\n        ogImageUrl\n      }\n    }\n  }\n}";

package/dist/internal.d.ts

@@ -1,10 +1,10 @@
-export { f as fetchLayouts, c as fetchPage, d as fetchPageById, e as fetchPageMeta, g as fetchPages, n as normalizeSlug, r as resolveApiUrl, h as resolvePublicUrl } from './content-client-D0EdiqbQ.js';
+export { f as fetchLayouts, c as fetchPage, d as fetchPageById, e as fetchPageMeta, g as fetchPages, n as normalizeSlug, r as resolveApiUrl, h as resolvePublicUrl } from './content-client-CJQ-nafm.js';
 import { CmssyFormDefinition, BuildBlockContextExtra, CmssyBlockContext, CmssyClientConfig, CmssySiteConfig, RawBlock, FieldDefinition } from '@cmssy/types';
 export { CmssySiteLocales } from '@cmssy/types';
-import { G as GraphqlRequestOptions } from './locale-XintNd0n.js';
-export { C as CMSSY_LOCALE_HEADER, b as buildLocaleSwitchHref, a as localeForPath, c as localeForPathname, l as localizeHref, d as localizeHtmlLinks, s as splitCmssyLocale } from './locale-XintNd0n.js';
-import { Q as QueryScopedOptions } from './csp-Blh6P15m.js';
-export { m as cmssyCspHeaders, o as isDevelopment, q as resolveInitialTarget, t as toCspOrigin } from './csp-Blh6P15m.js';
+import { G as GraphqlRequestOptions } from './locale-Ox_qVlNy.js';
+export { C as CMSSY_LOCALE_HEADER, b as buildLocaleSwitchHref, a as localeForPath, c as localeForPathname, l as localizeHref, d as localizeHtmlLinks, s as splitCmssyLocale } from './locale-Ox_qVlNy.js';
+import { Q as QueryScopedOptions } from './csp-DJ17P3PN.js';
+export { m as cmssyCspHeaders, o as isDevelopment, q as resolveInitialTarget, t as toCspOrigin } from './csp-DJ17P3PN.js';
 export { localesFromSiteConfig, localizedPath, resolveSiteLocales, splitLocaleFromPath } from './internal/locale.js';
 
 declare const SITE_CONFIG_QUERY = "query PublicSiteConfig($workspaceSlug: String!) {\n  public {\n    siteConfig(workspaceSlug: $workspaceSlug) {\n      id\n      workspaceId\n      siteName\n      defaultLanguage\n      enabledLanguages\n      enabledFeatures\n      notFoundPageId\n      previewUrl\n      branding {\n        brandName\n        logoUrl\n        faviconUrl\n        ogImageUrl\n      }\n    }\n  }\n}";

package/dist/internal.js

@@ -1,10 +1,17 @@
 // src/data/http.ts
 var CmssyRequestError = class extends Error {
   status;
-  constructor(message, 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];
@@ -41,14 +48,17 @@ async function fetchWithRetry(doFetch, url, init, retry) {
   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 = Math.min(retryAfterMs(response) ?? backoff, maxDelayMs);
+    const wait = asked !== null ? asked : Math.min(backoff, maxDelayMs);
     await sleep(wait, init.signal);
     response = await doFetch(url, init);
   }
@@ -82,9 +92,12 @@ async function postGraphql(url, query, variables, options) {
     } 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}`,
-      response.status
+      `cmssy: ${options.label} failed (${response.status})${detail}${wait}`,
+      response.status,
+      asked ?? void 0
     );
   }
   let json;

package/dist/{locale-rhYcXU5z.d.cts → locale-C7sA46qu.d.cts}

@@ -1,4 +1,4 @@
-import { F as FetchLike, R as RetryPolicy } from './content-client-D0EdiqbQ.cjs';
+import { F as FetchLike, R as RetryPolicy } from './content-client-CJQ-nafm.cjs';
 import { CmssyClientConfig, CmssyLocaleContext } from '@cmssy/types';
 
 interface GraphqlRequestOptions {

package/dist/{locale-XintNd0n.d.ts → locale-Ox_qVlNy.d.ts}

@@ -1,4 +1,4 @@
-import { F as FetchLike, R as RetryPolicy } from './content-client-D0EdiqbQ.js';
+import { F as FetchLike, R as RetryPolicy } from './content-client-CJQ-nafm.js';
 import { CmssyClientConfig, CmssyLocaleContext } from '@cmssy/types';
 
 interface GraphqlRequestOptions {

package/dist/preflight.d.cts

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

package/dist/preflight.d.ts

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

package/package.json

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