fontdue-js 3.4.1 → 3.5.1

package/dist/components/Cart/orderTracking.js

@@ -5,27 +5,46 @@ function readCookie(name) {
   const match = document.cookie.match(new RegExp('(?:^|;\\s*)' + name + '=([^;]*)'));
   return match ? decodeURIComponent(match[1]) : undefined;
 }
-
 /**
- * Stores the buyer's analytics context (cookie consent, Meta browser IDs,
- * checkout page URL) on the current order. The server emits the purchase
- * event from a Stripe webhook — outside the browser — so this is how that
- * event respects the consent banner and carries attribution.
+ * The buyer's analytics context as the order mutations take it: cookie
+ * consent, the anonymous ID, Meta's browser IDs (`_fbp`/`_fbc`) and the page.
+ * Sent with add-to-cart (`createOrderItems`) and cart/checkout open
+ * (`updateOrderTracking`) alike, so the server captures the same identifiers
+ * on every event it emits for the order — "Product Added", "Checkout Started"
+ * (which the server emits when the buyer submits their contact details, not
+ * from these calls) and the purchase, which fires from a Stripe webhook with
+ * no browser at all.
  *
- * Fire-and-forget: tracking must never break checkout.
+ * Returns undefined outside a browser or if anything throws: tracking must
+ * never break the cart.
+ */
+export function orderTrackingInput() {
+  try {
+    if (typeof window === 'undefined') return undefined;
+    return {
+      analyticsConsent: hasConsent('analytics'),
+      anonymousId: getClientAnonymousId(),
+      fbp: readCookie('_fbp'),
+      fbc: readCookie('_fbc'),
+      url: window.location.href
+    };
+  } catch {
+    return undefined;
+  }
+}
+
+/**
+ * Stores the buyer's analytics context on the current order as the cart or
+ * checkout opens. Fire-and-forget: tracking must never break checkout.
  */
 export function sendOrderTracking(environment) {
+  const input = orderTrackingInput();
+  if (!input) return;
   try {
     commitMutation(environment, {
       mutation: (_orderTrackingUpdateOrderTrackingMutation.hash && _orderTrackingUpdateOrderTrackingMutation.hash !== "d59a127a7f140424f507ae549731bac7" && console.error("The definition of 'orderTrackingUpdateOrderTrackingMutation' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _orderTrackingUpdateOrderTrackingMutation),
       variables: {
-        input: {
-          analyticsConsent: hasConsent('analytics'),
-          anonymousId: getClientAnonymousId(),
-          fbp: readCookie('_fbp'),
-          fbc: readCookie('_fbc'),
-          url: window.location.href
-        }
+        input
       },
       onCompleted: () => undefined,
       onError: () => undefined

package/dist/components/CharacterViewer/index.js

@@ -20,7 +20,7 @@ import StyleSelect from './StyleSelect.js';
 import Checkbox from '../Checkbox/index.js';
 import useFeaturesData from '../TypeTester/useFeaturesData.js';
 import CharacterViewerStyleRefetchQueryNode from '../../__generated__/CharacterViewerStyleRefetchQuery.graphql.js';
-import { EnsureFontdueContext } from '../FontdueContextProvider/index.js';
+import { EnsureFontdueContext, LazyQueryBoundary } from '../FontdueContextProvider/index.js';
 import ConfigContext from '../ConfigContext.js';
 import { unicodeNamesUrl } from '../../data/unicodeNamesUrl.js';
 import { compareGlyphs, flattenCharacterList } from './glyphMatch.js';
@@ -498,17 +498,17 @@ export default function CharacterViewer(props) {
       collectionId,
       ...rest
     } = props;
-    inner = /*#__PURE__*/React.createElement(CharacterViewerIdQueryRenderer, _extends({
+    inner = /*#__PURE__*/React.createElement(LazyQueryBoundary, null, /*#__PURE__*/React.createElement(CharacterViewerIdQueryRenderer, _extends({
       collectionId: collectionId
-    }, rest));
+    }, rest)));
   } else if ('collectionSlug' in props && props.collectionSlug) {
     const {
       collectionSlug,
       ...rest
     } = props;
-    inner = /*#__PURE__*/React.createElement(CharacterViewerSlugQueryRenderer, _extends({
+    inner = /*#__PURE__*/React.createElement(LazyQueryBoundary, null, /*#__PURE__*/React.createElement(CharacterViewerSlugQueryRenderer, _extends({
       collectionSlug: collectionSlug
-    }, rest));
+    }, rest)));
   } else {
     throw new Error('CharacterViewer expected one of preloadedQuery, collectionId, or collectionSlug');
   }

package/dist/components/CustomerLoginForm/index.js

@@ -2,7 +2,7 @@
 
 import _CustomerLoginFormQuery from "../../__generated__/CustomerLoginFormQuery.graphql.js";
 import _CustomerLoginFormLoginMutation from "../../__generated__/CustomerLoginFormLoginMutation.graphql.js";
-import React, { useState } from 'react';
+import React, { Suspense, useState } from 'react';
 import { commitMutation, graphql, useLazyLoadQuery, useRelayEnvironment } from 'react-relay';
 import TextField from '../TextField/index.js';
 const loginMutation = (_CustomerLoginFormLoginMutation.hash && _CustomerLoginFormLoginMutation.hash !== "975b639fac1e0d88e0f0c9c55acd8b9c" && console.error("The definition of 'CustomerLoginFormLoginMutation' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _CustomerLoginFormLoginMutation);
@@ -51,7 +51,13 @@ const CustomerLoginForm = _ref => {
     className: "login-form"
   }, error && /*#__PURE__*/React.createElement("div", {
     className: "login-form__errors"
-  }, error), submitted ? /*#__PURE__*/React.createElement(SubmittedMessage, null) : /*#__PURE__*/React.createElement("form", {
+  }, error), submitted ?
+  /*#__PURE__*/
+  // The label fetch suspends; resolve it here rather than at whatever
+  // boundary the host app has above the form.
+  React.createElement(Suspense, {
+    fallback: null
+  }, /*#__PURE__*/React.createElement(SubmittedMessage, null)) : /*#__PURE__*/React.createElement("form", {
     className: "login-form__form",
     onSubmit: handleSubmit
   }, /*#__PURE__*/React.createElement("div", {

package/dist/components/FeatureTester/FeatureTesters.js

@@ -7,7 +7,7 @@ import _FeatureTesters_collection from "../../__generated__/FeatureTesters_colle
 import React from 'react';
 import { graphql, useFragment, useLazyLoadQuery, usePreloadedQuery } from 'react-relay';
 import FeatureTesterCard from './FeatureTesterCard.js';
-import { EnsureFontdueContext } from '../FontdueContextProvider/index.js';
+import { EnsureFontdueContext, LazyQueryBoundary } from '../FontdueContextProvider/index.js';
 import FeatureTestersIdQueryNode from '../../__generated__/FeatureTestersIdQuery.graphql.js';
 import FeatureTestersSlugQueryNode from '../../__generated__/FeatureTestersSlugQuery.graphql.js';
 import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
@@ -148,9 +148,9 @@ export default function FeatureTesters(_ref7) {
     config: config
   }, 'preloadedQuery' in props && props.preloadedQuery ? /*#__PURE__*/React.createElement(FeatureTestersPreloadedRenderer, _extends({
     preloadedQuery: props.preloadedQuery
-  }, options)) : 'collectionId' in props && props.collectionId ? /*#__PURE__*/React.createElement(ById, _extends({
+  }, options)) : 'collectionId' in props && props.collectionId ? /*#__PURE__*/React.createElement(LazyQueryBoundary, null, /*#__PURE__*/React.createElement(ById, _extends({
     collectionId: props.collectionId
-  }, options)) : /*#__PURE__*/React.createElement(BySlug, _extends({
+  }, options))) : /*#__PURE__*/React.createElement(LazyQueryBoundary, null, /*#__PURE__*/React.createElement(BySlug, _extends({
     collectionSlug: props.collectionSlug
-  }, options)));
+  }, options))));
 }

package/dist/components/FeatureTester/index.js

@@ -5,7 +5,7 @@ import _FeatureTesterStandaloneQuery from "../../__generated__/FeatureTesterStan
 import React from 'react';
 import { graphql, useLazyLoadQuery, usePreloadedQuery } from 'react-relay';
 import FeatureTesterCard from './FeatureTesterCard.js';
-import { EnsureFontdueContext } from '../FontdueContextProvider/index.js';
+import { EnsureFontdueContext, LazyQueryBoundary } from '../FontdueContextProvider/index.js';
 import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
 import useSerializablePreloadedQuery from '../../relay/useSerializablePreloadedQuery.js';
 import FeatureTesterStandaloneQueryNode from '../../__generated__/FeatureTesterStandaloneQuery.graphql.js';
@@ -62,5 +62,5 @@ function FeatureTesterLazyRenderer(_ref3) {
 export default function FeatureTester(props) {
   return /*#__PURE__*/React.createElement(EnsureFontdueContext, {
     config: props.config
-  }, 'preloadedQuery' in props && props.preloadedQuery ? /*#__PURE__*/React.createElement(FeatureTesterPreloadedRenderer, props) : /*#__PURE__*/React.createElement(FeatureTesterLazyRenderer, props));
+  }, 'preloadedQuery' in props && props.preloadedQuery ? /*#__PURE__*/React.createElement(FeatureTesterPreloadedRenderer, props) : /*#__PURE__*/React.createElement(LazyQueryBoundary, null, /*#__PURE__*/React.createElement(FeatureTesterLazyRenderer, props)));
 }

package/dist/components/FontdueContextProvider/index.d.ts

@@ -7,6 +7,9 @@ export declare function EnsureFontdueContext({ children, config, }: {
     children: React.ReactNode;
     config?: Config;
 }): React.JSX.Element;
+export declare function LazyQueryBoundary({ children }: {
+    children: React.ReactNode;
+}): React.JSX.Element;
 export interface FontdueContextProvider_props {
     children?: React.ReactNode;
     url?: string;

package/dist/components/FontdueContextProvider/index.js

@@ -53,6 +53,14 @@ function ConfigOverride(_ref) {
 // typeTester: { selectable: true } }} />` works without any provider. Inside an
 // existing context, it deep-merges onto the inherited config — the component's
 // keys win, everything else is inherited from the outer `<FontdueProvider>`.
+//
+// Deliberately no Suspense boundary here either: one around every component
+// would put a dehydrated boundary in the server HTML of each preloaded
+// component, and React hydrates those lazily — measured on a Next 16 / React
+// 19.2 page, the preloaded BuyButton, TypeTesters and CharacterViewer were
+// still unhydrated a minute after load (a click still works, since React
+// hydrates the target on interaction, but nothing else does). Only the lazy
+// renderers need a boundary; see LazyQueryBoundary.
 export function EnsureFontdueContext(_ref2) {
   let {
     children,
@@ -68,6 +76,27 @@ export function EnsureFontdueContext(_ref2) {
     config: config
   }, children);
 }
+
+// The Suspense boundary for a component's *lazy* renderer — the branch taken
+// when it's given an id or slug rather than a preloaded query, so it fetches
+// its own data with useLazyLoadQuery (see the lazy-vs-preloaded guide). That
+// suspension has to resolve here, next to the component, not at whatever
+// boundary the host app has above it: the provider used to supply one around
+// the whole app, which blanked everything beneath it while any one component
+// loaded — and put every Next page inside a Suspense boundary, so
+// `notFound()`, `redirect()` and thrown errors were caught in it and the
+// response streamed as 200 (see FontdueContextProvider below). Preloaded
+// renderers resolve synchronously and get no boundary, so their server HTML
+// hydrates with the page as before. A null fallback keeps server HTML and the
+// first client render identical.
+export function LazyQueryBoundary(_ref3) {
+  let {
+    children
+  } = _ref3;
+  return /*#__PURE__*/React.createElement(Suspense, {
+    fallback: null
+  }, children);
+}
 const IS_SERVER = typeof window === typeof undefined;
 
 // === Multi-island state-sharing contract ===
@@ -112,7 +141,15 @@ function useSharedStore(providedStore, config) {
 // `*Preloaded` self-wrapping components use this so they can stand alone
 // without claiming the page-level aux UI slot. Pages that need aux UI
 // (theme/test-mode/consent/tracking) wrap with `FontdueProvider` instead.
-export default function FontdueContextProvider(_ref3) {
+//
+// Deliberately NO Suspense (or error) boundary around `children`. Mounted in a
+// Next root layout, a boundary here sits above every page: React SSR then
+// catches a page's `notFound()`, `redirect()` or thrown error inside it, emits
+// the fallback, and streams the shell as 200 — soft 404s site-wide, redirects
+// with no Location header, error.tsx never rendering (FD-1183 / FD-1074).
+// Components that can suspend carry their own boundary via
+// `EnsureFontdueContext`; the provider's aux UI has one in FontdueProvider.
+export default function FontdueContextProvider(_ref4) {
   let {
     children,
     url,
@@ -120,7 +157,7 @@ export default function FontdueContextProvider(_ref3) {
     config,
     components,
     store
-  } = _ref3;
+  } = _ref4;
   const environment = useCurrentEnvironment({
     url,
     stripeIntegration
@@ -136,8 +173,6 @@ export default function FontdueContextProvider(_ref3) {
     environment: environment
   }, /*#__PURE__*/React.createElement(Provider, {
     store: sharedStore
-  }, /*#__PURE__*/React.createElement(Suspense, {
-    fallback: null
   }, /*#__PURE__*/React.createElement(RawConfigContext.Provider, {
     value: config
   }, /*#__PURE__*/React.createElement(ConfigContext.Provider, {
@@ -146,5 +181,5 @@ export default function FontdueContextProvider(_ref3) {
     value: url ?? fontdueBaseUrl() ?? ''
   }, /*#__PURE__*/React.createElement(ComponentsContext.Provider, {
     value: components ?? {}
-  }, /*#__PURE__*/React.createElement(TypeTesterFamiliesProvider, null, children)))))))));
+  }, /*#__PURE__*/React.createElement(TypeTesterFamiliesProvider, null, children))))))));
 }

package/dist/components/NewsletterSignup/index.js

@@ -14,7 +14,7 @@ import Check from '../Icons/Check.js';
 import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
 import useSerializablePreloadedQuery from '../../relay/useSerializablePreloadedQuery.js';
 import NewsletterSignupQueryNode from '../../__generated__/NewsletterSignupQuery.graphql.js';
-import { EnsureFontdueContext } from '../FontdueContextProvider/index.js';
+import { EnsureFontdueContext, LazyQueryBoundary } from '../FontdueContextProvider/index.js';
 import { useRecaptchaTimeout, isRecaptchaScriptLoaded, RECAPTCHA_UNAVAILABLE_MESSAGE } from '../../hooks/useRecaptchaTimeout.js';
 const updateCustomerMutation = (_NewsletterSignupUpdateCustomerMutation.hash && _NewsletterSignupUpdateCustomerMutation.hash !== "769087891b6f263122bbb630b3f2ca6c" && console.error("The definition of 'NewsletterSignupUpdateCustomerMutation' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _NewsletterSignupUpdateCustomerMutation);
 export async function loadNewsletterSignupQuery(options) {
@@ -238,5 +238,5 @@ export default function NewsletterSignup(_ref4) {
     config: config
   }, props.preloadedQuery ? /*#__PURE__*/React.createElement(NewsletterSignupPreloadedQueryRenderer, _extends({}, props, {
     preloadedQuery: props.preloadedQuery
-  })) : /*#__PURE__*/React.createElement(NewsletterSignupLazyQueryRenderer, props));
+  })) : /*#__PURE__*/React.createElement(LazyQueryBoundary, null, /*#__PURE__*/React.createElement(NewsletterSignupLazyQueryRenderer, props)));
 }

package/dist/components/Precart/index.js

@@ -12,6 +12,7 @@ import License from './License.js';
 import { Price } from '../Price/index.js';
 import { pluralize } from '../../utils.js';
 import ComponentsContext from '../ComponentsContext.js';
+import { orderTrackingInput } from '../Cart/orderTracking.js';
 function skuName(sku) {
   if (sku.product && 'name' in sku.product) return sku.product.name;
   return null;
@@ -153,7 +154,8 @@ function Precart(_ref3) {
     const variables = {
       input: {
         skuIds: selectedItemsArray(),
-        licenseSelections: licenseSelectionsArray()
+        licenseSelections: licenseSelectionsArray(),
+        tracking: orderTrackingInput()
       }
     };
     const mutation = (_PrecartAddToCartMutation.hash && _PrecartAddToCartMutation.hash !== "c5ead46ecc07099bee68d4f4f1ecb5bf" && console.error("The definition of 'PrecartAddToCartMutation' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _PrecartAddToCartMutation);

package/dist/components/StoreModalProductSummary/index.js

@@ -11,6 +11,7 @@ import { pluralize } from '../../utils.js';
 import { useLicenseAndOrderVariables } from '../../hooks/useLicenseAndOrderVariables.js';
 import { useRefetchOnLicenseChanges } from '../../hooks/useRefetchOnLicenseChanges.js';
 import ConfigContext from '../ConfigContext.js';
+import { orderTrackingInput } from '../Cart/orderTracking.js';
 const addToCartMutation = (_StoreModalProductSummaryAddToCartMutation.hash && _StoreModalProductSummaryAddToCartMutation.hash !== "91ea762e3842af2919da3a4c710a48cc" && console.error("The definition of 'StoreModalProductSummaryAddToCartMutation' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _StoreModalProductSummaryAddToCartMutation);
 const clearCartMutation = (_StoreModalProductSummaryClearCartMutation.hash && _StoreModalProductSummaryClearCartMutation.hash !== "b5c37f74432030a297c1bcf2be63b6f7" && console.error("The definition of 'StoreModalProductSummaryClearCartMutation' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _StoreModalProductSummaryClearCartMutation);
 const countStyles = viewer => {
@@ -105,7 +106,8 @@ const StoreModalProductSummary = _ref => {
           });
         }, []),
         orderVariableSelections,
-        licenseeIsBillingIdentity
+        licenseeIsBillingIdentity,
+        tracking: orderTrackingInput()
       }
     };
     commitAddToCart({

package/dist/components/TestFontsForm/index.js

@@ -15,7 +15,7 @@ import TestFontsFormQueryNode from '../../__generated__/TestFontsForm_Query.grap
 import Checkbox from '../Checkbox/index.js';
 import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
 import useSerializablePreloadedQuery from '../../relay/useSerializablePreloadedQuery.js';
-import { EnsureFontdueContext } from '../FontdueContextProvider/index.js';
+import { EnsureFontdueContext, LazyQueryBoundary } from '../FontdueContextProvider/index.js';
 import { useRecaptchaTimeout, isRecaptchaScriptLoaded, RECAPTCHA_UNAVAILABLE_MESSAGE } from '../../hooks/useRecaptchaTimeout.js';
 const updateCustomerMutation = (_TestFontsFormUpdateCustomerMutation.hash && _TestFontsFormUpdateCustomerMutation.hash !== "ba56958399f0893bd667ff02c33a6975" && console.error("The definition of 'TestFontsFormUpdateCustomerMutation' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _TestFontsFormUpdateCustomerMutation);
 const TestFontsDownloading = _ref => {
@@ -258,5 +258,5 @@ export default function TestFontsForm(_ref5) {
     config: config
   }, props.preloadedQuery ? /*#__PURE__*/React.createElement(TestFontsFormPreloadedQueryRenderer, _extends({}, props, {
     preloadedQuery: props.preloadedQuery
-  })) : /*#__PURE__*/React.createElement(TestFontsFormLazyQueryRenderer, props));
+  })) : /*#__PURE__*/React.createElement(LazyQueryBoundary, null, /*#__PURE__*/React.createElement(TestFontsFormLazyQueryRenderer, props)));
 }

package/dist/components/TypeTester/TypeTesterStandalone.js

@@ -12,7 +12,7 @@ import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
 import useSerializablePreloadedQuery from '../../relay/useSerializablePreloadedQuery.js';
 import TypeTesterStandaloneQueryNode from '../../__generated__/TypeTesterStandaloneQuery.graphql.js';
 import ConfigContext from '../ConfigContext.js';
-import { EnsureFontdueContext } from '../FontdueContextProvider/index.js';
+import { EnsureFontdueContext, LazyQueryBoundary } from '../FontdueContextProvider/index.js';
 import { useLicenseAndOrderVariables } from '../../hooks/useLicenseAndOrderVariables.js';
 const changedStylesQuery = (_TypeTesterStandaloneChangedStylesQuery.hash && _TypeTesterStandaloneChangedStylesQuery.hash !== "98374227c6b2c3eceab5b48138e1a662" && console.error("The definition of 'TypeTesterStandaloneChangedStylesQuery' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _TypeTesterStandaloneChangedStylesQuery);
 function TypeTesterStandaloneComponent(_ref) {
@@ -144,5 +144,5 @@ function TypeTesterStandaloneLazyQueryRenderer(_ref4) {
 export default function TypeTesterStandalone(props) {
   return /*#__PURE__*/React.createElement(EnsureFontdueContext, {
     config: props.config
-  }, 'preloadedQuery' in props && props.preloadedQuery ? /*#__PURE__*/React.createElement(TypeTesterStandalonePreloadedQueryRenderer, props) : /*#__PURE__*/React.createElement(TypeTesterStandaloneLazyQueryRenderer, props));
+  }, 'preloadedQuery' in props && props.preloadedQuery ? /*#__PURE__*/React.createElement(TypeTesterStandalonePreloadedQueryRenderer, props) : /*#__PURE__*/React.createElement(LazyQueryBoundary, null, /*#__PURE__*/React.createElement(TypeTesterStandaloneLazyQueryRenderer, props)));
 }

package/dist/components/TypeTesters/index.js

@@ -23,7 +23,7 @@ import { normalizeFeaturesProp } from '../TypeTester/types.js';
 import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
 import useSerializablePreloadedQuery from '../../relay/useSerializablePreloadedQuery.js';
 import { useLicenseAndOrderVariables } from '../../hooks/useLicenseAndOrderVariables.js';
-import { EnsureFontdueContext } from '../FontdueContextProvider/index.js';
+import { EnsureFontdueContext, LazyQueryBoundary } from '../FontdueContextProvider/index.js';
 const findPriceBarCollection = (collection, familyId) => {
   if (collection.id === familyId) return collection;
   if (!collection.families) return null;
@@ -306,13 +306,13 @@ export default function TypeTesters(_ref8) {
       preloadedQuery: preloadedQuery
     }, rest));
   } else if (collectionId) {
-    inner = /*#__PURE__*/React.createElement(TypeTestersIDQueryRenderer, _extends({
+    inner = /*#__PURE__*/React.createElement(LazyQueryBoundary, null, /*#__PURE__*/React.createElement(TypeTestersIDQueryRenderer, _extends({
       collectionId: collectionId
-    }, rest));
+    }, rest)));
   } else if (collectionSlug) {
-    inner = /*#__PURE__*/React.createElement(TypeTestersSlugQueryRenderer, _extends({
+    inner = /*#__PURE__*/React.createElement(LazyQueryBoundary, null, /*#__PURE__*/React.createElement(TypeTestersSlugQueryRenderer, _extends({
       collectionSlug: collectionSlug
-    }, rest));
+    }, rest)));
   }
   if (!inner) return null;
   return /*#__PURE__*/React.createElement(EnsureFontdueContext, {

package/dist/relay/environment.d.ts

@@ -1,5 +1,20 @@
 import { Environment, RequestParameters, QueryResponseCache, Variables, GraphQLResponse } from 'relay-runtime';
-export declare const version: string;
+import { version } from '../version.js';
+export { version };
+/**
+ * A GraphQL request that came back with a non-2xx status, or a 2xx whose body
+ * isn't a GraphQL response at all. Thrown rather than returned so a failed
+ * request can never masquerade as data: on the server that payload would be
+ * serialized into the prerendered page, and every visitor would hydrate into
+ * Relay's "No data returned for operation …" until the page was regenerated.
+ */
+export declare class FontdueResponseError extends Error {
+    /** The HTTP status the Fontdue endpoint answered with. */
+    status: number;
+    /** The GraphQL operation name, e.g. `FontdueProviderQuery`. */
+    operation: string;
+    constructor(message: string, status: number, operation: string);
+}
 export declare function fontdueBaseUrl(): string | undefined;
 export declare function createNetworkFetch(options?: CreateRelayEnvironmentOptions): (request: RequestParameters, variables: Variables) => Promise<GraphQLResponse>;
 export declare const networkFetch: (request: RequestParameters, variables: Variables) => Promise<GraphQLResponse>;
@@ -16,4 +31,3 @@ interface CreateRelayEnvironmentOptions {
 }
 export declare function createEnvironment(options: CreateRelayEnvironmentOptions): Environment;
 export declare function useCurrentEnvironment(options: CreateRelayEnvironmentOptions): Environment;
-export {};

package/dist/relay/environment.js

@@ -3,12 +3,11 @@ import { handlePossibleCorsError } from '../corsError.js';
 import { resolveFontdueServerConfig } from './serverConfig.js';
 import { PREVIEW_HEADER, hasPreviewMarkerCookie } from '../preview/constants.js';
 import { NODE_ACCESS_HEADER } from '../nodeAccess.js';
+import { CLIENT_VERSION_HEADER, version } from '../version.js';
 
-// `__FONTDUE_JS_VERSION__` is replaced by an inline babel plugin
-// (defineVersionPlugin in .babelrc.cjs) with the literal package.json#version.
-// Exported so UI (the admin toolbar) can surface it without re-reading the
-// build-time global in a 'use client' module.
-export const version = "3.4.1";
+// Re-exported so UI (the admin toolbar) can surface the package version
+// without re-reading the build-time global in a 'use client' module.
+export { version };
 const IS_SERVER = typeof window === typeof undefined;
 
 // Opt server fetches into Next's data cache only in production; dev stays
@@ -48,6 +47,54 @@ const NEXT_PUBLIC_STRIPE = typeof process !== 'undefined' && process.env ? proce
 const FONTDUE_URL = readEnv('FONTDUE_URL') ?? readEnv('NEXT_PUBLIC_FONTDUE_URL') ?? NEXT_PUBLIC_URL;
 const STRIPE_INTEGRATION = readEnv('FONTDUE_STRIPE_INTEGRATION') ?? readEnv('NEXT_PUBLIC_FONTDUE_STRIPE_INTEGRATION') ?? NEXT_PUBLIC_STRIPE;
 const CACHE_TTL = 10 * 1000; // 10 seconds, to resolve preloaded results
+const RETRY_DELAY_MS = 1000;
+
+/**
+ * A GraphQL request that came back with a non-2xx status, or a 2xx whose body
+ * isn't a GraphQL response at all. Thrown rather than returned so a failed
+ * request can never masquerade as data: on the server that payload would be
+ * serialized into the prerendered page, and every visitor would hydrate into
+ * Relay's "No data returned for operation …" until the page was regenerated.
+ */
+export class FontdueResponseError extends Error {
+  /** The HTTP status the Fontdue endpoint answered with. */
+
+  /** The GraphQL operation name, e.g. `FontdueProviderQuery`. */
+
+  constructor(message, status, operation) {
+    super(message);
+    this.name = 'FontdueResponseError';
+    this.status = status;
+    this.operation = operation;
+  }
+}
+
+// Transient origin failures worth a second try: a gateway or overload error
+// from Cloudflare or Render (5xx), rate limiting, a request timeout.
+function isRetryableStatus(status) {
+  return status >= 500 || status === 429 || status === 408;
+}
+
+// The GraphQL error message a failed response carries, if any — Fontdue
+// answers an unknown site with `{"errors":[{"message":"Site not found"}]}`.
+async function errorMessageOf(resp) {
+  try {
+    var _body$errors, _body$errors$;
+    const body = await resp.json();
+    const message = body === null || body === void 0 ? void 0 : (_body$errors = body.errors) === null || _body$errors === void 0 ? void 0 : (_body$errors$ = _body$errors[0]) === null || _body$errors$ === void 0 ? void 0 : _body$errors$.message;
+    return typeof message === 'string' ? message : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+// A body with `data` (present or null) or an `errors` list. Anything else — an
+// empty object from a proxy, a JSON-shaped error page — is not a payload Relay
+// can act on and must fail the request instead.
+function isGraphQLResponse(json) {
+  if (typeof json !== 'object' || json === null) return false;
+  return 'data' in json || Array.isArray(json.errors);
+}
 
 // The configured Fontdue base URL resolved for the current runtime, or
 // undefined when it can't be determined (e.g. multi-tenant, where fetches go to
@@ -78,7 +125,7 @@ export function createNetworkFetch(options) {
       Accept: 'application/json',
       'Content-Type': 'application/json',
       'fontdue-stripe-integration': (options === null || options === void 0 ? void 0 : options.stripeIntegration) ?? STRIPE_INTEGRATION ?? 'dynamic',
-      'fontdue-client-version': version
+      [CLIENT_VERSION_HEADER]: version
     };
 
     // Whether this request is an admin *preview*. On the server that's a
@@ -130,14 +177,34 @@ export function createNetworkFetch(options) {
     for (let attempt = 0; attempt <= 2; attempt++) {
       try {
         const resp = await fetch(url + `?queryName=${request.name}`, init);
+
+        // A non-2xx response is a failed request, never data. Returning its
+        // body used to let a 5xx that happened to parse as JSON (Cloudflare
+        // answers an `Accept: application/json` client with one) reach Relay
+        // as a payload — and, on the server, get serialized into a prerendered
+        // page that then crashed every visitor on hydration.
+        if (!resp.ok) {
+          if (attempt < 2 && isRetryableStatus(resp.status)) {
+            await new Promise(resolve => setTimeout(resolve, RETRY_DELAY_MS));
+            continue;
+          }
+          const detail = await errorMessageOf(resp);
+          throw new FontdueResponseError(`fontdue-js: ${request.name} failed with HTTP ${resp.status}` + (detail ? `: ${detail}` : ''), resp.status, request.name);
+        }
         const json = await resp.json();
+        if (!isGraphQLResponse(json)) {
+          throw new FontdueResponseError(`fontdue-js: ${request.name} returned HTTP ${resp.status} with a body that is not a GraphQL response`, resp.status, request.name);
+        }
 
         // GraphQL returns exceptions (for example, a missing required variable) in the "errors"
         // property of the response. If any exceptions occurred when processing the request,
         // throw an error to indicate to the developer what went wrong.
-        if (Array.isArray(json.errors)) {
-          var _json$errors, _error$extensions;
-          const error = (_json$errors = json.errors) === null || _json$errors === void 0 ? void 0 : _json$errors[0];
+        const {
+          errors
+        } = json;
+        if (Array.isArray(errors) && errors[0]) {
+          var _error$extensions;
+          const error = errors[0];
           console.error('GraphQL Error:', {
             message: error.message,
             code: (_error$extensions = error.extensions) === null || _error$extensions === void 0 ? void 0 : _error$extensions.code,
@@ -146,9 +213,10 @@ export function createNetworkFetch(options) {
         }
         return json;
       } catch (error) {
+        if (error instanceof FontdueResponseError) throw error;
         // Retry on network errors (TypeError) before falling through to CORS detection
         if (attempt < 2 && error instanceof TypeError) {
-          await new Promise(resolve => setTimeout(resolve, 1000));
+          await new Promise(resolve => setTimeout(resolve, RETRY_DELAY_MS));
           continue;
         }
         if (handlePossibleCorsError(error, url)) {

package/dist/relay/loadSerializableQuery.js

@@ -46,6 +46,18 @@ export default async function loadSerializableQuery(query, variables, options) {
   if (!('params' in query)) throw new Error('Params not found in query, is it a fragment instead of a query?');
   const fetcher = createNetworkFetch(options);
   const response = await fetcher(query.params, variables);
+
+  // The result is handed to the browser and, on a prerendered page, frozen
+  // into the static output — so a response with no data must fail here, where
+  // the render fails with it (Next keeps serving the last good page; a build
+  // aborts), rather than be serialized and crash every visitor on hydration.
+  // Partial data alongside errors is still a payload Relay can render.
+  const singular = Array.isArray(response) ? response[0] : response;
+  if ((singular === null || singular === void 0 ? void 0 : singular.data) == null) {
+    var _singular$errors, _singular$errors$;
+    const detail = singular === null || singular === void 0 ? void 0 : (_singular$errors = singular.errors) === null || _singular$errors === void 0 ? void 0 : (_singular$errors$ = _singular$errors[0]) === null || _singular$errors$ === void 0 ? void 0 : _singular$errors$.message;
+    throw new Error(`fontdue-js: ${query.params.name} returned no data` + (detail ? `: ${detail}` : ''));
+  }
   return {
     params: query.params,
     variables,

package/dist/relay/useSerializablePreloadedQuery.js

@@ -18,14 +18,18 @@ export default function useSerializablePreloadedQuery(preloadQuery) {
   let query = arguments.length > 2 ? arguments[2] : undefined;
   const environment = useRelayEnvironment();
   useMemo(() => {
+    // A preload with no data is not a result to hand Relay: on a page that was
+    // prerendered while the origin was down (older fontdue-js serialized
+    // those) priming the cache with it would make hydration throw "No data
+    // returned for operation …" for every visitor. Leave the cache cold so the
+    // component fetches live instead.
+    const response = preloadQuery.response;
+    const singular = Array.isArray(response) ? response[0] : response;
+    if ((singular === null || singular === void 0 ? void 0 : singular.data) == null) return;
     writePreloadedQueryToCache(preloadQuery);
     if (query != null) {
-      const response = preloadQuery.response;
-      const singular = Array.isArray(response) ? response[0] : response;
-      if ((singular === null || singular === void 0 ? void 0 : singular.data) != null) {
-        const operation = createOperationDescriptor(getRequest(query), preloadQuery.variables);
-        environment.commitPayload(operation, singular.data);
-      }
+      const operation = createOperationDescriptor(getRequest(query), preloadQuery.variables);
+      environment.commitPayload(operation, singular.data);
     }
   }, [preloadQuery, environment, query]);
   return {

package/dist/server/index.js

@@ -47,6 +47,7 @@
 
 import { resolveFontdueServerConfig, setFontdueServerConfig, resolveNodeAccessRecovery } from '../relay/serverConfig.js';
 import { PREVIEW_HEADER } from '../preview/constants.js';
+import { CLIENT_VERSION_HEADER, version } from '../version.js';
 function readEnv(name) {
   if (typeof process !== 'undefined' && process.env) {
     const v = process.env[name];
@@ -146,7 +147,11 @@ export function createFontdueFetch() {
     const headers = {
       'content-type': 'application/json',
       ...(config === null || config === void 0 ? void 0 : config.headers),
-      ...options.headers
+      ...options.headers,
+      // Which fontdue-js this site runs – the server records it per tenant so
+      // sites that need to upgrade for a feature can be found and warned.
+      // Set last so a caller's headers can't misreport it.
+      [CLIENT_VERSION_HEADER]: version
     };
 
     // Declare preview intent explicitly: a forwarded admin token means this is a

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const CLIENT_VERSION_HEADER = "fontdue-client-version";
+export declare const version: string;

package/dist/version.js

@@ -0,0 +1,11 @@
+// `__FONTDUE_JS_VERSION__` is replaced by an inline babel plugin
+// (defineVersionPlugin in .babelrc.cjs) with the literal package.json#version;
+// the CDN bundle gets the same literal from vite.config.ts `define`.
+//
+// Every GraphQL request sends it as the `fontdue-client-version` header
+// (relay/environment.ts, server/index.ts, and the script-tag bootstrap in
+// assets/fontdue/index.tsx). The server records the version per tenant
+// (Fontage.ClientVersions) to spot sites that need to upgrade before a
+// feature that depends on a newer client can work for them.
+export const CLIENT_VERSION_HEADER = 'fontdue-client-version';
+export const version = "3.5.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fontdue-js",
-  "version": "3.4.1",
+  "version": "3.5.1",
   "type": "module",
   "scripts": {
     "build": "npm run relay && run-p build-js build-css build-ts",