@websolutespa/bom-next 4.0.0-next.4 → 4.0.0-next.5

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @websolutespa/bom-next
 
+## 4.0.0-next.5
+
+### Patch Changes
+
+- feat: renamed API handlers for image, mock, preview, revalidate, vars, and session endpoints
+- Updated dependencies
+  - @websolutespa/payload-plugin-bowl@4.0.0-next.4
+
 ## 4.0.0-next.4
 
 ### Patch Changes

package/README.md

@@ -1,89 +1,89 @@
-# @websolutespa/bom-next
-
-[![npm version](https://badge.fury.io/js/%40websolutespa%2Fbom-next.svg)](https://badge.fury.io/js/%40websolutespa%2Fbom-next)
-
-[![status alpha](https://img.shields.io/badge/status-alpha-red.svg)](https://shields.io/)
-
-Next module of the [BOM Repository](https://github.com/websolutespa/bom) by [websolute](https://www.websolute.com/).
-
----
-
-##### *this library is for internal usage and not production ready*
-
-## Page context
-
-```ts
-import { createPageContext, getMetadata } from '@websolutespa/bom-next/server';
-
-export const generateMetadata = getMetadata('post_detail', config);
-
-const { page, layout, label, link } = await createPageContext(market, locale, 'post_detail', id, {
-  config,
-  depth: 2, // default DEFAULT_PAGE_DEPTH
-  select: { title: true, abstract: true, media: true, components: true },
-  populate: { media: { url: true, alt: true, width: true, height: true, type: true } },
-});
-
-const { layout } = await createLayoutContext(market, locale, { config }); // depth: DEFAULT_LAYOUT_DEPTH (1)
-```
-
-| option | default | |
-|---|---|---|
-| `depth` | `2` | `0` ids only, `1` direct relations/uploads (including those inside blocks), `2` relations of relations |
-| `select` | – | Payload select; envelope fields (`id`, `slug`, `title`, `category`, `markets`, `meta`, `template`) are always read |
-| `populate` | – | per-collection select for populated documents |
-| `draft` | `'auto'` | `true` / `false`, or `'auto'` to read Next `draftMode()` |
-| `layout` | `{ depth: 1 }` | layout options, or `false` to skip the layout |
-
-Page and layout reads are memoized per request, so `getMetadata` and the page component share them when called with the same options.
-To bind `config` once: `export const { createPageContext, createLayoutContext, getMetadata } = createContextHelpers({ config, defaults: { depth: 2 } });`
-
-## Metadata
-
-`getPageMetadata` (and `getMetadata`, its `config`-first form) returns a `generateMetadata` function that renders on the server: plain-text title and description, canonical (keeping `?pagination[page]=N` after the first page), `alternates.languages` with one `locale-COUNTRY` entry per market country plus `x-default`, robots, keywords, Open Graph and Twitter.
-
-```ts
-import { getPageMetadata, JsonLd, buildPageStructuredData } from '@websolutespa/bom-next/server';
-
-export const generateMetadata = getPageMetadata('post_detail', {
-  config,
-  metadata: {
-    brand: { name: 'Example', logo: '/logo.png', twitterName: '@example' },
-    extend: (metadata, { page }) => ({ ...metadata, title: `${metadata.title} | Example` }),
-  },
-});
-
-// JSON-LD in the page component
-<JsonLd data={buildPageStructuredData(page, layout, { brand: { name: 'Example' } })} />
-```
-
-`buildPageMetadata(page, layout, options)` is the same builder for custom routes. URLs are resolved against `NEXT_PUBLIC_URL` unless `baseUrl` is passed. Robots come from `meta.robots`, or `meta.robot` (the `@payloadcms/plugin-seo` field).
-
-The client `MetaDataProvider` only computes values for `useMetaData`; the `next/head` based `Meta`, `OpenGraph` and `StructuredData` components of the mixer packages render nothing in the App Router.
-
-`layout.homeHref` is the root page href for the current market and locale; prefer it to `layout.topLevelHrefs.<slug>`, which is keyed by collection slug or template.
-
-## Routing proxy
-
-`createRouteProxy` resolves each request through `/api/-route` and caches the result per instance: found routes for `BOM_ROUTE_CACHE_TTL` seconds (default `30`, `0` disables), misses and redirects for at most 10 seconds. Draft requests and server errors are never cached. CMS redirects send the browser to the target returned by the resolver.
-
-`routeAutoDetection` redirects `/` straight from the `detectedRoute` cookie when present; otherwise it detects the market (GeoIP, 2 s timeout, cached per IP for one hour) and the locale.
-
-The server context (`getContext`) reads routes from the Bowl route store and caches the rest per market, locale and user for `MEMORY_CACHE_DURATION` seconds (default 300). Any route store change, local or from another instance through Redis, clears it. Draft contexts are never cached.
-
-## Environment
-
-Per-request diagnostics (proxy, local API calls, context cache) are logged in development only (`NODE_ENV` unset or `development`).
-
-| Variable | Default | |
-|---|---|---|
-| `BOM_ROUTE_CACHE_TTL` | `30` | proxy route cache lifetime in seconds, `0` disables it |
-| `MEMORY_CACHE_DURATION` | `300` | server context cache lifetime in seconds |
-| `UI_REGISTRY_SOURCE_DIR` | `packages/ui/src` | registry source directory |
-| `UI_REGISTRY_COMPONENTS_JSON` | nearest `components.json` | shadcn config whose aliases (e.g. `@/ui/lib/utils`) are mapped to registry imports |
-| `UI_REGISTRY_SOURCE_ALIAS` | – | extra import prefix pointing at the registry source, e.g. `@/ui/` |
-| `UI_REGISTRY_SKIP_UNRESOLVED` | – | `1` hides registry items that import app code; otherwise they are listed with `meta.unresolvedImports` |
-
-## User
-
-`UserProvider` reads `/api/auth/me` once per page load, shared by every mount and client navigation. Pass `initialUser` (a user or `null`) when the server already knows it to skip the request; `setUser` and `invalidateUser()` keep the cached value current after login or logout.
+# @websolutespa/bom-next
+
+[![npm version](https://badge.fury.io/js/%40websolutespa%2Fbom-next.svg)](https://badge.fury.io/js/%40websolutespa%2Fbom-next)
+
+[![status alpha](https://img.shields.io/badge/status-alpha-red.svg)](https://shields.io/)
+
+Next module of the [BOM Repository](https://github.com/websolutespa/bom) by [websolute](https://www.websolute.com/).
+
+---
+
+##### *this library is for internal usage and not production ready*
+
+## Page context
+
+```ts
+import { createPageContext, getMetadata } from '@websolutespa/bom-next/server';
+
+export const generateMetadata = getMetadata('post_detail', config);
+
+const { page, layout, label, link } = await createPageContext(market, locale, 'post_detail', id, {
+  config,
+  depth: 2, // default DEFAULT_PAGE_DEPTH
+  select: { title: true, abstract: true, media: true, components: true },
+  populate: { media: { url: true, alt: true, width: true, height: true, type: true } },
+});
+
+const { layout } = await createLayoutContext(market, locale, { config }); // depth: DEFAULT_LAYOUT_DEPTH (1)
+```
+
+| option | default | |
+|---|---|---|
+| `depth` | `2` | `0` ids only, `1` direct relations/uploads (including those inside blocks), `2` relations of relations |
+| `select` | – | Payload select; envelope fields (`id`, `slug`, `title`, `category`, `markets`, `meta`, `template`) are always read |
+| `populate` | – | per-collection select for populated documents |
+| `draft` | `'auto'` | `true` / `false`, or `'auto'` to read Next `draftMode()` |
+| `layout` | `{ depth: 1 }` | layout options, or `false` to skip the layout |
+
+Page and layout reads are memoized per request, so `getMetadata` and the page component share them when called with the same options.
+To bind `config` once: `export const { createPageContext, createLayoutContext, getMetadata } = createContextHelpers({ config, defaults: { depth: 2 } });`
+
+## Metadata
+
+`getPageMetadata` (and `getMetadata`, its `config`-first form) returns a `generateMetadata` function that renders on the server: plain-text title and description, canonical (keeping `?pagination[page]=N` after the first page), `alternates.languages` with one `locale-COUNTRY` entry per market country plus `x-default`, robots, keywords, Open Graph and Twitter.
+
+```ts
+import { getPageMetadata, JsonLd, buildPageStructuredData } from '@websolutespa/bom-next/server';
+
+export const generateMetadata = getPageMetadata('post_detail', {
+  config,
+  metadata: {
+    brand: { name: 'Example', logo: '/logo.png', twitterName: '@example' },
+    extend: (metadata, { page }) => ({ ...metadata, title: `${metadata.title} | Example` }),
+  },
+});
+
+// JSON-LD in the page component
+<JsonLd data={buildPageStructuredData(page, layout, { brand: { name: 'Example' } })} />
+```
+
+`buildPageMetadata(page, layout, options)` is the same builder for custom routes. URLs are resolved against `NEXT_PUBLIC_URL` unless `baseUrl` is passed. Robots come from `meta.robots`, or `meta.robot` (the `@payloadcms/plugin-seo` field).
+
+The client `MetaDataProvider` only computes values for `useMetaData`; the `next/head` based `Meta`, `OpenGraph` and `StructuredData` components of the mixer packages render nothing in the App Router.
+
+`layout.homeHref` is the root page href for the current market and locale; prefer it to `layout.topLevelHrefs.<slug>`, which is keyed by collection slug or template.
+
+## Routing proxy
+
+`createRouteProxy` resolves each request through `/api/-route` and caches the result per instance: found routes for `BOM_ROUTE_CACHE_TTL` seconds (default `30`, `0` disables), misses and redirects for at most 10 seconds. Draft requests and server errors are never cached. CMS redirects send the browser to the target returned by the resolver.
+
+`routeAutoDetection` redirects `/` straight from the `detectedRoute` cookie when present; otherwise it detects the market (GeoIP, 2 s timeout, cached per IP for one hour) and the locale.
+
+The server context (`getContext`) reads routes from the Bowl route store and caches the rest per market, locale and user for `MEMORY_CACHE_DURATION` seconds (default 300). Any route store change, local or from another instance through Redis, clears it. Draft contexts are never cached.
+
+## Environment
+
+Per-request diagnostics (proxy, local API calls, context cache) are logged in development only (`NODE_ENV` unset or `development`).
+
+| Variable | Default | |
+|---|---|---|
+| `BOM_ROUTE_CACHE_TTL` | `30` | proxy route cache lifetime in seconds, `0` disables it |
+| `MEMORY_CACHE_DURATION` | `300` | server context cache lifetime in seconds |
+| `UI_REGISTRY_SOURCE_DIR` | `packages/ui/src` | registry source directory |
+| `UI_REGISTRY_COMPONENTS_JSON` | nearest `components.json` | shadcn config whose aliases (e.g. `@/ui/lib/utils`) are mapped to registry imports |
+| `UI_REGISTRY_SOURCE_ALIAS` | – | extra import prefix pointing at the registry source, e.g. `@/ui/` |
+| `UI_REGISTRY_SKIP_UNRESOLVED` | – | `1` hides registry items that import app code; otherwise they are listed with `meta.unresolvedImports` |
+
+## User
+
+`UserProvider` reads `/api/auth/me` once per page load, shared by every mount and client navigation. Pass `initialUser` (a user or `null`) when the server already knows it to skip the request; `setUser` and `invalidateUser()` keep the cached value current after login or logout.

package/dist/client/client.d.ts

@@ -1,7 +1,7 @@
-import * as react1 from "react";
+import * as react0 from "react";
 
 //#region src/client/client.d.ts
-declare function Client(): react1.JSX.Element;
+declare function Client(): react0.JSX.Element;
 //# sourceMappingURL=client.d.ts.map
 
 //#endregion

package/dist/client/extra.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extra.d.ts","names":[],"sources":["../../src/client/extra.tsx"],"sourcesContent":[],"mappings":";;;KAIY,aAAA,GAAgB;cAEf,cAAY,MAAA,CAAA,QAAA;iBAET,aAAA;;;;EAJJ,KAAA,CAAA,EAQF,MARE,CAAA,MAAa,EAAA,GAAA,CAAG;EAEf,QAAA,CAAA,EAOA,KAAA,CAAM,SAP4D;CAAA,CAAA,EAQ9E,MAAA,CAAA,GAAA,CAAA,OAR8E"}
+{"version":3,"file":"extra.d.ts","names":[],"sources":["../../src/client/extra.tsx"],"sourcesContent":[],"mappings":";;;KAIY,aAAA,GAAgB;cAEf,cAAY,MAAA,CAAA,QAAA;iBAET,aAAA;;;;EAJJ,KAAA,CAAA,EAQF,MARE,CAAA,MAAa,EAAA,GAAA,CAAA;EAEZ,QAAA,CAAA,EAOA,KAAA,CAAM,SAP4D;CAAA,CAAA,EAQ9E,MAAA,CAAA,GAAA,CAAA,OAR8E"}

package/dist/client/label.d.ts

@@ -1,13 +1,13 @@
-import * as react2 from "react";
+import * as react21 from "react";
 
 //#region src/client/label.d.ts
 type ILabelContext = (key: string, params?: Record<string, any>) => string;
-declare const LabelContext: react2.Context<ILabelContext | undefined>;
+declare const LabelContext: react21.Context<ILabelContext | undefined>;
 declare function LabelProvider({
   children
 }: {
   children?: React.ReactNode;
-}): react2.JSX.Element;
+}): react21.JSX.Element;
 //# sourceMappingURL=label.d.ts.map
 
 //#endregion

package/dist/client/label.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"label.d.ts","names":[],"sources":["../../src/client/label.tsx"],"sourcesContent":[],"mappings":";;;KAMY,aAAA,0BAAuC;cAEtC,cAAY,MAAA,CAAA,QAAA;iBAET,aAAA;;AAFhB;EAFY,QAAA,CAAA,EAI6C,KAAA,CAAM,SAJtC;AAEzB,CAAA,CAAA,EAE0E,MAAA,CAAA,GAAA,CAAA,OAFK"}
+{"version":3,"file":"label.d.ts","names":[],"sources":["../../src/client/label.tsx"],"sourcesContent":[],"mappings":";;;KAMY,aAAA,0BAAuC;cAEtC,cAAY,OAAA,CAAA,QAAA;iBAET,aAAA;;AAFhB;EAFY,QAAA,CAAA,EAI6C,KAAA,CAAM,SAJtC;AAEzB,CAAA,CAAA,EAE0E,OAAA,CAAA,GAAA,CAAA,OAFK"}

package/dist/client/layout.d.ts

@@ -1,16 +1,16 @@
 import { ILayout } from "@websolutespa/bom-core";
-import * as react4 from "react";
+import * as react2 from "react";
 
 //#region src/client/layout.d.ts
 type ILayoutContext = ILayout;
-declare const LayoutContext: react4.Context<ILayoutContext | undefined>;
+declare const LayoutContext: react2.Context<ILayoutContext | undefined>;
 declare function LayoutProvider({
   layout,
   children
 }: {
   layout: ILayout;
   children?: React.ReactNode;
-}): react4.JSX.Element;
+}): react2.JSX.Element;
 //# sourceMappingURL=layout.d.ts.map
 
 //#endregion

package/dist/client/metadata.d.ts

@@ -2,7 +2,7 @@ import { OpenGraphType } from "../lib/open-graph.js";
 import { StructuredDataType } from "../lib/structured-data.js";
 import { TwitterCardType } from "../lib/twitter-card.js";
 import { IMetaData } from "../lib/meta-data.js";
-import * as react6 from "react";
+import * as react4 from "react";
 import { ReactNode } from "react";
 
 //#region src/client/metadata.d.ts
@@ -29,7 +29,7 @@ type IMetaDataOptions = {
   twitterCard?: TwitterCardType;
 };
 type IMetaDataContext = IMetaData;
-declare const MetaDataContext: react6.Context<IMetaData | undefined>;
+declare const MetaDataContext: react4.Context<IMetaData | undefined>;
 /**
  * Computes page metadata for client components (`useMetaData`). It renders
  * nothing into `<head>`: in the App Router, export `generateMetadata` built
@@ -46,7 +46,7 @@ declare function MetaDataProvider({
   metaData: IMetaDataOptions;
   search?: string;
   children?: ReactNode;
-}): react6.JSX.Element;
+}): react4.JSX.Element;
 //# sourceMappingURL=metadata.d.ts.map
 //#endregion
 export { IMetaDataContext, IMetaDataOptions, MetaDataContext, MetaDataProvider };

package/dist/client/page.d.ts

@@ -1,10 +1,10 @@
 import * as _websolutespa_bom_core0 from "@websolutespa/bom-core";
 import { ILocalized, IPage } from "@websolutespa/bom-core";
-import * as react8 from "react";
+import * as react6 from "react";
 
 //#region src/client/page.d.ts
 type IPageContext = ILocalized<IPage>;
-declare const PageContext: react8.Context<{
+declare const PageContext: react6.Context<{
   [x: string]: unknown;
   id: _websolutespa_bom_core0.IEquatable;
   schema: string;
@@ -398,7 +398,7 @@ declare function PageProvider({
 }: {
   page: ILocalized<IPage>;
   children?: React.ReactNode;
-}): react8.JSX.Element;
+}): react6.JSX.Element;
 //# sourceMappingURL=page.d.ts.map
 //#endregion
 export { IPageContext, PageContext, PageProvider };

package/dist/client/useApi.d.ts

@@ -1,13 +1,13 @@
 import { ApiRequestOptions } from "../lib/http.js";
-import * as react15 from "react";
+import * as react8 from "react";
 
 //#region src/client/useApi.d.ts
-declare function useApiFetch<T = unknown>(pathname: string, options?: ApiRequestOptions): [T | undefined, boolean, any, react15.Dispatch<any>];
-declare function useApiGet<T = unknown>(pathname: string, options?: ApiRequestOptions): [T | undefined, boolean, any, react15.Dispatch<any>];
-declare function useApiPost<T = unknown>(pathname: string, payload: unknown, options?: ApiRequestOptions): [T | undefined, boolean, any, react15.Dispatch<any>];
-declare function useApiPut<T = unknown>(pathname: string, payload: unknown, options?: ApiRequestOptions): [T | undefined, boolean, any, react15.Dispatch<any>];
-declare function useApiPatch<T = unknown>(pathname: string, payload: unknown, options?: ApiRequestOptions): [T | undefined, boolean, any, react15.Dispatch<any>];
-declare function useApiDelete<T = unknown>(pathname: string, options?: ApiRequestOptions): [T | undefined, boolean, any, react15.Dispatch<any>];
+declare function useApiFetch<T = unknown>(pathname: string, options?: ApiRequestOptions): [T | undefined, boolean, any, react8.Dispatch<any>];
+declare function useApiGet<T = unknown>(pathname: string, options?: ApiRequestOptions): [T | undefined, boolean, any, react8.Dispatch<any>];
+declare function useApiPost<T = unknown>(pathname: string, payload: unknown, options?: ApiRequestOptions): [T | undefined, boolean, any, react8.Dispatch<any>];
+declare function useApiPut<T = unknown>(pathname: string, payload: unknown, options?: ApiRequestOptions): [T | undefined, boolean, any, react8.Dispatch<any>];
+declare function useApiPatch<T = unknown>(pathname: string, payload: unknown, options?: ApiRequestOptions): [T | undefined, boolean, any, react8.Dispatch<any>];
+declare function useApiDelete<T = unknown>(pathname: string, options?: ApiRequestOptions): [T | undefined, boolean, any, react8.Dispatch<any>];
 type Api = {
   get: <T = unknown>(pathname: string, options?: ApiRequestOptions) => Promise<T>;
   post: <T = unknown>(pathname: string, payload?: unknown, options?: ApiRequestOptions) => Promise<T>;

package/dist/client/useApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useApi.d.ts","names":[],"sources":["../../src/client/useApi.ts"],"sourcesContent":[],"mappings":";;;;iBAIgB,qDAAoD,qBAAsB,6BAAA,OAAA,CAAA;iBAM1E,mDAAkD,qBAAsB,6BAAA,OAAA,CAAA;iBAIxE,sEAAqE,qBAAsB,6BAAA,OAAA,CAAA;AAV3F,iBAcA,SAdW,CAAA,IAAA,OAAA,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,EAAA,OAAA,EAAA,OAAA,CAAA,EAcyD,iBAdzD,CAAA,EAAA,CAc+E,CAd/E,GAAA,SAAA,EAAA,OAAA,EAAA,GAAA,EAc+E,OAAA,CAAA,QAd/E,CAAA,GAAA,CAAA,CAAA;AAAA,iBAkBX,WAlBW,CAAA,IAAA,OAAA,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,EAAA,OAAA,EAAA,OAAA,CAAA,EAkB2D,iBAlB3D,CAAA,EAAA,CAkBiF,CAlBjF,GAAA,SAAA,EAAA,OAAA,EAAA,GAAA,EAkBiF,OAAA,CAAA,QAlBjF,CAAA,GAAA,CAAA,CAAA;AAAyC,iBAsBpD,YAtBoD,CAAA,IAAA,OAAA,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAsBC,iBAtBD,CAAA,EAAA,CAsBuB,CAtBvB,GAAA,SAAA,EAAA,OAAA,EAAA,GAAA,EAsBuB,OAAA,CAAA,QAtBvB,CAAA,GAAA,CAAA,CAAA;KA0B/D,GAAA,GA1BqF;EAAA,GAAA,EAAA,CAAA,IAAA,OAAA,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EA2BzC,iBA3ByC,EAAA,GA2BnB,OA3BmB,CA2BX,CA3BW,CAAA;EAAA,IAAA,EAAA,CAAA,IAAA,OAAA,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,OAAA,EAAA,OAAA,CAAA,EA4BrB,iBA5BqB,EAAA,GA4BC,OA5BD,CA4BS,CA5BT,CAAA;EAM1E,GAAA,EAAA,CAAA,IAAA,OAAS,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,OAAA,EAAA,OAAA,CAAA,EAuB2C,iBAvB3C,EAAA,GAuBiE,OAvBjE,CAuByE,CAvBzE,CAAA;EAAA,KAAA,EAAA,CAAA,IAAA,OAAA,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,OAAA,EAAA,OAAA,CAAA,EAwB6C,iBAxB7C,EAAA,GAwBmE,OAxBnE,CAwB2E,CAxB3E,CAAA;EAAA,MAAyC,EAAA,CAAA,IAAA,OAAA,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAyBd,iBAzBc,EAAA,GAyBQ,OAzBR,CAyBgB,CAzBhB,CAAA;CAAsB;AAAA,iBA4BxE,MAAA,CAAA,CA5BwE,EA4B9D,GA5B8D"}
+{"version":3,"file":"useApi.d.ts","names":[],"sources":["../../src/client/useApi.ts"],"sourcesContent":[],"mappings":";;;;iBAIgB,qDAAoD,qBAAsB,6BAAA,MAAA,CAAA;iBAM1E,mDAAkD,qBAAsB,6BAAA,MAAA,CAAA;iBAIxE,sEAAqE,qBAAsB,6BAAA,MAAA,CAAA;AAV3F,iBAcA,SAdW,CAAA,IAAA,OAAA,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,EAAA,OAAA,EAAA,OAAA,CAAA,EAcyD,iBAdzD,CAAA,EAAA,CAc+E,CAd/E,GAAA,SAAA,EAAA,OAAA,EAAA,GAAA,EAc+E,MAAA,CAAA,QAd/E,CAAA,GAAA,CAAA,CAAA;AAAA,iBAkBX,WAlBW,CAAA,IAAA,OAAA,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,EAAA,OAAA,EAAA,OAAA,CAAA,EAkB2D,iBAlB3D,CAAA,EAAA,CAkBiF,CAlBjF,GAAA,SAAA,EAAA,OAAA,EAAA,GAAA,EAkBiF,MAAA,CAAA,QAlBjF,CAAA,GAAA,CAAA,CAAA;AAAyC,iBAsBpD,YAtBoD,CAAA,IAAA,OAAA,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAsBC,iBAtBD,CAAA,EAAA,CAsBuB,CAtBvB,GAAA,SAAA,EAAA,OAAA,EAAA,GAAA,EAsBuB,MAAA,CAAA,QAtBvB,CAAA,GAAA,CAAA,CAAA;KA0B/D,GAAA,GA1BqF;EAAA,GAAA,EAAA,CAAA,IAAA,OAAA,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EA2BzC,iBA3ByC,EAAA,GA2BnB,OA3BmB,CA2BX,CA3BW,CAAA;EAAA,IAAA,EAAA,CAAA,IAAA,OAAA,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,OAAA,EAAA,OAAA,CAAA,EA4BrB,iBA5BqB,EAAA,GA4BC,OA5BD,CA4BS,CA5BT,CAAA;EAM1E,GAAA,EAAA,CAAA,IAAA,OAAS,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,OAAA,EAAA,OAAA,CAAA,EAuB2C,iBAvB3C,EAAA,GAuBiE,OAvBjE,CAuByE,CAvBzE,CAAA;EAAA,KAAA,EAAA,CAAA,IAAA,OAAA,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,OAAA,EAAA,OAAA,CAAA,EAwB6C,iBAxB7C,EAAA,GAwBmE,OAxBnE,CAwB2E,CAxB3E,CAAA;EAAA,MAAyC,EAAA,CAAA,IAAA,OAAA,CAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAyBd,iBAzBc,EAAA,GAyBQ,OAzBR,CAyBgB,CAzBhB,CAAA;CAAsB;AAAA,iBA4BxE,MAAA,CAAA,CA5BwE,EA4B9D,GA5B8D"}

package/dist/client/useCollectionApi.d.ts

@@ -1,6 +1,6 @@
 import { ApiRequestOptions } from "../lib/http.js";
 import { QueryParams } from "@websolutespa/bom-core";
-import * as react10 from "react";
+import * as react14 from "react";
 
 //#region src/client/useCollectionApi.d.ts
 type CollectionApi = {
@@ -11,11 +11,11 @@ type CollectionApi = {
   delete: <T = unknown>(pathname: string, options?: ApiRequestOptions) => Promise<T>;
 };
 declare function useCollectionApi(): CollectionApi;
-declare function useCollectionApiGet<T = unknown>(pathname: string, params?: QueryParams, options?: ApiRequestOptions): [T | undefined, boolean, any, react10.Dispatch<any>];
-declare function useCollectionApiPost<T = unknown>(pathname: string, payload: unknown, options?: ApiRequestOptions): [T | undefined, boolean, any, react10.Dispatch<any>];
-declare function useCollectionApiPut<T = unknown>(pathname: string, payload: unknown, options?: ApiRequestOptions): [T | undefined, boolean, any, react10.Dispatch<any>];
-declare function useCollectionApiPatch<T = unknown>(pathname: string, payload: unknown, options?: ApiRequestOptions): [T | undefined, boolean, any, react10.Dispatch<any>];
-declare function useCollectionApiDelete<T = unknown>(pathname: string, options?: ApiRequestOptions): [T | undefined, boolean, any, react10.Dispatch<any>];
+declare function useCollectionApiGet<T = unknown>(pathname: string, params?: QueryParams, options?: ApiRequestOptions): [T | undefined, boolean, any, react14.Dispatch<any>];
+declare function useCollectionApiPost<T = unknown>(pathname: string, payload: unknown, options?: ApiRequestOptions): [T | undefined, boolean, any, react14.Dispatch<any>];
+declare function useCollectionApiPut<T = unknown>(pathname: string, payload: unknown, options?: ApiRequestOptions): [T | undefined, boolean, any, react14.Dispatch<any>];
+declare function useCollectionApiPatch<T = unknown>(pathname: string, payload: unknown, options?: ApiRequestOptions): [T | undefined, boolean, any, react14.Dispatch<any>];
+declare function useCollectionApiDelete<T = unknown>(pathname: string, options?: ApiRequestOptions): [T | undefined, boolean, any, react14.Dispatch<any>];
 //#endregion
 export { useCollectionApi, useCollectionApiDelete, useCollectionApiGet, useCollectionApiPatch, useCollectionApiPost, useCollectionApiPut };
 //# sourceMappingURL=useCollectionApi.d.ts.map

package/dist/client/user.d.ts

@@ -1,5 +1,5 @@
 import { IEndUser, IUser } from "../types.js";
-import * as react21 from "react";
+import * as react19 from "react";
 import { ReactNode } from "react";
 
 //#region src/client/user.d.ts
@@ -8,7 +8,7 @@ type UserContextType = {
   user?: UserValue;
   setUser: (user?: UserValue) => void;
 };
-declare const UserContext: react21.Context<UserContextType>;
+declare const UserContext: react19.Context<UserContextType>;
 /** Forces the next UserProvider mount to read `/auth/me` again. */
 declare function invalidateUser(): void;
 /**
@@ -21,7 +21,7 @@ declare function UserProvider({
 }: {
   initialUser?: UserValue;
   children: ReactNode;
-}): react21.JSX.Element;
+}): react19.JSX.Element;
 //#endregion
 export { UserContext, UserContextType, UserProvider, invalidateUser };
 //# sourceMappingURL=user.d.ts.map

package/dist/exports/server.d.ts

@@ -5,6 +5,7 @@ import { collectionDeleteHandler, collectionGetHandler, collectionPatchHandler,
 import { indexGetHandler } from "../server/handlers/index.handler.js";
 import { previewHandler } from "../server/handlers/preview.handler.js";
 import { getRegistry, getRegistryItem } from "../server/handlers/registry.handler.js";
+import { CdnPurgeHandler, cloudflarePurgeHandler, getRevalidateHandler, resolveCdnPurgeHandler } from "../server/handlers/revalidate.handler.js";
 import { getCompiledRedirects, getRouteHandler } from "../server/handlers/route.handler.js";
 import { ISiteMap, getSiteMapIndex, getSiteMapXML, getSiteMapXSL } from "../server/handlers/sitemap.handler.js";
 import { getStaticParams, getStaticParamsFromPayload, getStaticParams_ } from "../server/handlers/static-params.handler.js";
@@ -19,4 +20,4 @@ import { buildBaseOptions, buildReadOptions, clearMixerContextCache, filterRoute
 import { PAGE_ENVELOPE_FIELDS, getPage, withEnvelopeSelect } from "../server/page.js";
 import { getHrefBeforeRedirect, getNextUrl } from "../server/utils.js";
 import { getUtmz } from "../server/utmz.js";
-export { GetPageMetadataOptions, ISiteMap, JsonLd, PAGE_ENVELOPE_FIELDS, PageMetadataBrand, PageMetadataContext, PageMetadataOptions, PageMetadataProps, PageMetadataSearchParams, PageStructuredDataOptions, buildBaseOptions, buildPageMetadata, buildPageStructuredData, buildReadOptions, clearMixerContextCache, collectionDeleteHandler, collectionGetHandler, collectionPatchHandler, collectionPostHandler, createContextHelpers, createLayoutContext, createNotFoundContext, createPageContext, decorateLazyComponents, filterRoutes, getAuthHeaders, getAuthMeHandler, getCacheKey, getCaptionsVTT, getCompiledRedirects, getContext, getHrefBeforeRedirect, getLocalApi, getMetadata, getMixerContext, getNextUrl, getOptions, getPage, getPageAlternates, getPageContext, getPageMetadata, getPageXDefault, getPaginationQuery, getPayload, getPayloadInstance, getRegistry, getRegistryItem, getRouteHandler, getRoutes, getSearchParams, getSiteMapIndex, getSiteMapXML, getSiteMapXSL, getStaticParams, getStaticParamsFromPayload, getStaticParams_, getUtmz, getVarsHandler, indexGetHandler, inheritParentMetadata, previewHandler, resolveDraft, resolveMetadataUrl, setContext, setPageContext, stableStringify, toPlainText, withEnvelopeSelect, withLazyProps };
+export { CdnPurgeHandler, GetPageMetadataOptions, ISiteMap, JsonLd, PAGE_ENVELOPE_FIELDS, PageMetadataBrand, PageMetadataContext, PageMetadataOptions, PageMetadataProps, PageMetadataSearchParams, PageStructuredDataOptions, buildBaseOptions, buildPageMetadata, buildPageStructuredData, buildReadOptions, clearMixerContextCache, cloudflarePurgeHandler, collectionDeleteHandler, collectionGetHandler, collectionPatchHandler, collectionPostHandler, createContextHelpers, createLayoutContext, createNotFoundContext, createPageContext, decorateLazyComponents, filterRoutes, getAuthHeaders, getAuthMeHandler, getCacheKey, getCaptionsVTT, getCompiledRedirects, getContext, getHrefBeforeRedirect, getLocalApi, getMetadata, getMixerContext, getNextUrl, getOptions, getPage, getPageAlternates, getPageContext, getPageMetadata, getPageXDefault, getPaginationQuery, getPayload, getPayloadInstance, getRegistry, getRegistryItem, getRevalidateHandler, getRouteHandler, getRoutes, getSearchParams, getSiteMapIndex, getSiteMapXML, getSiteMapXSL, getStaticParams, getStaticParamsFromPayload, getStaticParams_, getUtmz, getVarsHandler, indexGetHandler, inheritParentMetadata, previewHandler, resolveCdnPurgeHandler, resolveDraft, resolveMetadataUrl, setContext, setPageContext, stableStringify, toPlainText, withEnvelopeSelect, withLazyProps };

package/dist/exports/server.js

@@ -10,6 +10,7 @@ import { collectionDeleteHandler, collectionGetHandler, collectionPatchHandler,
 import { indexGetHandler } from "../server/handlers/index.handler.js";
 import { previewHandler } from "../server/handlers/preview.handler.js";
 import { getRegistry, getRegistryItem } from "../server/handlers/registry.handler.js";
+import { cloudflarePurgeHandler, getRevalidateHandler, resolveCdnPurgeHandler } from "../server/handlers/revalidate.handler.js";
 import { getCompiledRedirects, getRouteHandler } from "../server/handlers/route.handler.js";
 import { getSiteMapIndex, getSiteMapXML, getSiteMapXSL } from "../server/handlers/sitemap.handler.js";
 import { getStaticParams, getStaticParamsFromPayload, getStaticParams_ } from "../server/handlers/static-params.handler.js";
@@ -20,4 +21,4 @@ import { JsonLd, buildPageStructuredData } from "../server/json-ld.js";
 import { decorateLazyComponents, withLazyProps } from "../server/lazy.js";
 import { getUtmz } from "../server/utmz.js";
 
-export { JsonLd, PAGE_ENVELOPE_FIELDS, buildBaseOptions, buildPageMetadata, buildPageStructuredData, buildReadOptions, clearMixerContextCache, collectionDeleteHandler, collectionGetHandler, collectionPatchHandler, collectionPostHandler, createContextHelpers, createLayoutContext, createNotFoundContext, createPageContext, decorateLazyComponents, filterRoutes, getAuthHeaders, getAuthMeHandler, getCacheKey, getCaptionsVTT, getCompiledRedirects, getContext, getHrefBeforeRedirect, getLocalApi, getMetadata, getMixerContext, getNextUrl, getOptions, getPage, getPageAlternates, getPageContext, getPageMetadata, getPageXDefault, getPaginationQuery, getPayload, getPayloadInstance, getRegistry, getRegistryItem, getRouteHandler, getRoutes, getSearchParams, getSiteMapIndex, getSiteMapXML, getSiteMapXSL, getStaticParams, getStaticParamsFromPayload, getStaticParams_, getUtmz, getVarsHandler, indexGetHandler, inheritParentMetadata, previewHandler, resolveDraft, resolveMetadataUrl, setContext, setPageContext, stableStringify, toPlainText, withEnvelopeSelect, withLazyProps };
+export { JsonLd, PAGE_ENVELOPE_FIELDS, buildBaseOptions, buildPageMetadata, buildPageStructuredData, buildReadOptions, clearMixerContextCache, cloudflarePurgeHandler, collectionDeleteHandler, collectionGetHandler, collectionPatchHandler, collectionPostHandler, createContextHelpers, createLayoutContext, createNotFoundContext, createPageContext, decorateLazyComponents, filterRoutes, getAuthHeaders, getAuthMeHandler, getCacheKey, getCaptionsVTT, getCompiledRedirects, getContext, getHrefBeforeRedirect, getLocalApi, getMetadata, getMixerContext, getNextUrl, getOptions, getPage, getPageAlternates, getPageContext, getPageMetadata, getPageXDefault, getPaginationQuery, getPayload, getPayloadInstance, getRegistry, getRegistryItem, getRevalidateHandler, getRouteHandler, getRoutes, getSearchParams, getSiteMapIndex, getSiteMapXML, getSiteMapXSL, getStaticParams, getStaticParamsFromPayload, getStaticParams_, getUtmz, getVarsHandler, indexGetHandler, inheritParentMetadata, previewHandler, resolveCdnPurgeHandler, resolveDraft, resolveMetadataUrl, setContext, setPageContext, stableStringify, toPlainText, withEnvelopeSelect, withLazyProps };

package/dist/lib/debug.js

@@ -2,8 +2,11 @@ import { isDevelopment } from "@websolutespa/bom-core";
 
 //#region src/lib/debug.ts
 /**
+
 * Per-request diagnostics (proxy, local API calls, context cache). They run
+
 * on every page view and prefetch, so they are logged in development only.
+
 */
 function debug(...args) {
 	if (isDevelopment) console.log(...args);

package/dist/lib/debug.js.map

@@ -1 +1 @@
-{"version":3,"file":"debug.js","names":[],"sources":["../../src/lib/debug.ts"],"sourcesContent":["import { isDevelopment } from '@websolutespa/bom-core';\n\n/**\n * Per-request diagnostics (proxy, local API calls, context cache). They run\n * on every page view and prefetch, so they are logged in development only.\n */\nexport function debug(...args: unknown[]): void {\n  if (isDevelopment) {\n    console.log(...args);\n  }\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,MAAM,GAAG,MAAuB;AAC9C,KAAI,eACF,QAAQ,IAAI,GAAG,KAAK;AAEvB"}
+{"version":3,"file":"debug.js","names":[],"sources":["../../src/lib/debug.ts"],"sourcesContent":["import { isDevelopment } from '@websolutespa/bom-core';\r\n\r\n/**\r\n * Per-request diagnostics (proxy, local API calls, context cache). They run\r\n * on every page view and prefetch, so they are logged in development only.\r\n */\r\nexport function debug(...args: unknown[]): void {\r\n  if (isDevelopment) {\r\n    console.log(...args);\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;AAMA,SAAgB,MAAM,GAAG,MAAuB;AAC9C,KAAI,eACF,QAAQ,IAAI,GAAG,KAAK;AAEvB"}

package/dist/lib/ttl-cache.js

@@ -1,9 +1,14 @@
 //#region src/lib/ttl-cache.ts
 /**
+
 * Small per-instance TTL cache with LRU eviction and in-flight de-duplication.
+
 *
+
 * Values are stored as promises so concurrent requests for the same key share
+
 * one upstream call. Rejected promises are evicted immediately.
+
 */
 var TtlCache = class {
 	entries = /* @__PURE__ */ new Map();

package/dist/lib/ttl-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"ttl-cache.js","names":["maxSize: number","key: string","ttl: (value: T) => number","factory: () => Promise<T>","pending: TtlCacheEntry<T>","entry: TtlCacheEntry<T>"],"sources":["../../src/lib/ttl-cache.ts"],"sourcesContent":["type TtlCacheEntry<T> = {\n  value: Promise<T>;\n  expires: number;\n};\n\n/**\n * Small per-instance TTL cache with LRU eviction and in-flight de-duplication.\n *\n * Values are stored as promises so concurrent requests for the same key share\n * one upstream call. Rejected promises are evicted immediately.\n */\nexport class TtlCache<T> {\n  private readonly entries = new Map<string, TtlCacheEntry<T>>();\n\n  constructor(private readonly maxSize: number) { }\n\n  get size() {\n    return this.entries.size;\n  }\n\n  async getOrSet(key: string, ttl: (value: T) => number, factory: () => Promise<T>): Promise<T> {\n    const now = Date.now();\n    const entry = this.entries.get(key);\n    if (entry && entry.expires > now) {\n      // Re-insert to mark the entry as most recently used.\n      this.entries.delete(key);\n      this.entries.set(key, entry);\n      return entry.value;\n    }\n    if (entry) {\n      this.entries.delete(key);\n    }\n    const value = factory();\n    // Until the value settles, keep it long enough to de-duplicate concurrent calls.\n    const pending: TtlCacheEntry<T> = { value, expires: Number.POSITIVE_INFINITY };\n    this.set(key, pending);\n    try {\n      const resolved = await value;\n      const duration = ttl(resolved);\n      if (duration > 0 && this.entries.get(key) === pending) {\n        pending.expires = Date.now() + duration;\n      } else if (this.entries.get(key) === pending) {\n        this.entries.delete(key);\n      }\n      return resolved;\n    } catch (error) {\n      if (this.entries.get(key) === pending) {\n        this.entries.delete(key);\n      }\n      throw error;\n    }\n  }\n\n  delete(key: string) {\n    this.entries.delete(key);\n  }\n\n  clear() {\n    this.entries.clear();\n  }\n\n  private set(key: string, entry: TtlCacheEntry<T>) {\n    if (this.entries.size >= this.maxSize) {\n      // Maps iterate in insertion order, so the first key is the least recently used.\n      const oldest = this.entries.keys().next().value;\n      if (oldest !== undefined) {\n        this.entries.delete(oldest);\n      }\n    }\n    this.entries.set(key, entry);\n  }\n}\n"],"mappings":";;;;;;;AAWA,IAAa,WAAb,MAAyB;CACvB,AAAiB,0BAAU,IAAI;CAE/B,YAA6BA,SAAiB;EAAjB;CAAoB;CAEjD,IAAI,OAAO;AACT,SAAO,KAAK,QAAQ;CACrB;CAED,MAAM,SAASC,KAAaC,KAA2BC,SAAuC;EAC5F,MAAM,MAAM,KAAK,KAAK;EACtB,MAAM,QAAQ,KAAK,QAAQ,IAAI,IAAI;AACnC,MAAI,SAAS,MAAM,UAAU,KAAK;GAEhC,KAAK,QAAQ,OAAO,IAAI;GACxB,KAAK,QAAQ,IAAI,KAAK,MAAM;AAC5B,UAAO,MAAM;EACd;AACD,MAAI,OACF,KAAK,QAAQ,OAAO,IAAI;EAE1B,MAAM,QAAQ,SAAS;EAEvB,MAAMC,UAA4B;GAAE;GAAO,SAAS,OAAO;EAAmB;EAC9E,KAAK,IAAI,KAAK,QAAQ;AACtB,MAAI;GACF,MAAM,WAAW,MAAM;GACvB,MAAM,WAAW,IAAI,SAAS;AAC9B,OAAI,WAAW,KAAK,KAAK,QAAQ,IAAI,IAAI,KAAK,SAC5C,QAAQ,UAAU,KAAK,KAAK,GAAG;YACtB,KAAK,QAAQ,IAAI,IAAI,KAAK,SACnC,KAAK,QAAQ,OAAO,IAAI;AAE1B,UAAO;EACR,SAAQ,OAAO;AACd,OAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAC5B,KAAK,QAAQ,OAAO,IAAI;AAE1B,SAAM;EACP;CACF;CAED,OAAOH,KAAa;EAClB,KAAK,QAAQ,OAAO,IAAI;CACzB;CAED,QAAQ;EACN,KAAK,QAAQ,OAAO;CACrB;CAED,AAAQ,IAAIA,KAAaI,OAAyB;AAChD,MAAI,KAAK,QAAQ,QAAQ,KAAK,SAAS;GAErC,MAAM,SAAS,KAAK,QAAQ,MAAM,CAAC,MAAM,CAAC;AAC1C,OAAI,WAAW,QACb,KAAK,QAAQ,OAAO,OAAO;EAE9B;EACD,KAAK,QAAQ,IAAI,KAAK,MAAM;CAC7B;AACF"}
+{"version":3,"file":"ttl-cache.js","names":["maxSize: number","key: string","ttl: (value: T) => number","factory: () => Promise<T>","pending: TtlCacheEntry<T>","entry: TtlCacheEntry<T>"],"sources":["../../src/lib/ttl-cache.ts"],"sourcesContent":["type TtlCacheEntry<T> = {\r\n  value: Promise<T>;\r\n  expires: number;\r\n};\r\n\r\n/**\r\n * Small per-instance TTL cache with LRU eviction and in-flight de-duplication.\r\n *\r\n * Values are stored as promises so concurrent requests for the same key share\r\n * one upstream call. Rejected promises are evicted immediately.\r\n */\r\nexport class TtlCache<T> {\r\n  private readonly entries = new Map<string, TtlCacheEntry<T>>();\r\n\r\n  constructor(private readonly maxSize: number) { }\r\n\r\n  get size() {\r\n    return this.entries.size;\r\n  }\r\n\r\n  async getOrSet(key: string, ttl: (value: T) => number, factory: () => Promise<T>): Promise<T> {\r\n    const now = Date.now();\r\n    const entry = this.entries.get(key);\r\n    if (entry && entry.expires > now) {\r\n      // Re-insert to mark the entry as most recently used.\r\n      this.entries.delete(key);\r\n      this.entries.set(key, entry);\r\n      return entry.value;\r\n    }\r\n    if (entry) {\r\n      this.entries.delete(key);\r\n    }\r\n    const value = factory();\r\n    // Until the value settles, keep it long enough to de-duplicate concurrent calls.\r\n    const pending: TtlCacheEntry<T> = { value, expires: Number.POSITIVE_INFINITY };\r\n    this.set(key, pending);\r\n    try {\r\n      const resolved = await value;\r\n      const duration = ttl(resolved);\r\n      if (duration > 0 && this.entries.get(key) === pending) {\r\n        pending.expires = Date.now() + duration;\r\n      } else if (this.entries.get(key) === pending) {\r\n        this.entries.delete(key);\r\n      }\r\n      return resolved;\r\n    } catch (error) {\r\n      if (this.entries.get(key) === pending) {\r\n        this.entries.delete(key);\r\n      }\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  delete(key: string) {\r\n    this.entries.delete(key);\r\n  }\r\n\r\n  clear() {\r\n    this.entries.clear();\r\n  }\r\n\r\n  private set(key: string, entry: TtlCacheEntry<T>) {\r\n    if (this.entries.size >= this.maxSize) {\r\n      // Maps iterate in insertion order, so the first key is the least recently used.\r\n      const oldest = this.entries.keys().next().value;\r\n      if (oldest !== undefined) {\r\n        this.entries.delete(oldest);\r\n      }\r\n    }\r\n    this.entries.set(key, entry);\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;;AAWA,IAAa,WAAb,MAAyB;CACvB,AAAiB,0BAAU,IAAI;CAE/B,YAA6BA,SAAiB;EAAjB;CAAoB;CAEjD,IAAI,OAAO;AACT,SAAO,KAAK,QAAQ;CACrB;CAED,MAAM,SAASC,KAAaC,KAA2BC,SAAuC;EAC5F,MAAM,MAAM,KAAK,KAAK;EACtB,MAAM,QAAQ,KAAK,QAAQ,IAAI,IAAI;AACnC,MAAI,SAAS,MAAM,UAAU,KAAK;GAEhC,KAAK,QAAQ,OAAO,IAAI;GACxB,KAAK,QAAQ,IAAI,KAAK,MAAM;AAC5B,UAAO,MAAM;EACd;AACD,MAAI,OACF,KAAK,QAAQ,OAAO,IAAI;EAE1B,MAAM,QAAQ,SAAS;EAEvB,MAAMC,UAA4B;GAAE;GAAO,SAAS,OAAO;EAAmB;EAC9E,KAAK,IAAI,KAAK,QAAQ;AACtB,MAAI;GACF,MAAM,WAAW,MAAM;GACvB,MAAM,WAAW,IAAI,SAAS;AAC9B,OAAI,WAAW,KAAK,KAAK,QAAQ,IAAI,IAAI,KAAK,SAC5C,QAAQ,UAAU,KAAK,KAAK,GAAG;YACtB,KAAK,QAAQ,IAAI,IAAI,KAAK,SACnC,KAAK,QAAQ,OAAO,IAAI;AAE1B,UAAO;EACR,SAAQ,OAAO;AACd,OAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAC5B,KAAK,QAAQ,OAAO,IAAI;AAE1B,SAAM;EACP;CACF;CAED,OAAOH,KAAa;EAClB,KAAK,QAAQ,OAAO,IAAI;CACzB;CAED,QAAQ;EACN,KAAK,QAAQ,OAAO;CACrB;CAED,AAAQ,IAAIA,KAAaI,OAAyB;AAChD,MAAI,KAAK,QAAQ,QAAQ,KAAK,SAAS;GAErC,MAAM,SAAS,KAAK,QAAQ,MAAM,CAAC,MAAM,CAAC;AAC1C,OAAI,WAAW,QACb,KAAK,QAAQ,OAAO,OAAO;EAE9B;EACD,KAAK,QAAQ,IAAI,KAAK,MAAM;CAC7B;AACF"}

package/dist/server/handlers/revalidate.handler.d.ts

@@ -0,0 +1,49 @@
+import { IRoute } from "@websolutespa/bom-core";
+import { NextRequest } from "next/server";
+import { SanitizedConfig } from "payload";
+
+//#region src/server/handlers/revalidate.handler.d.ts
+
+/**
+ * Strategy for purging the CDN cache after routes have been revalidated.
+ * Implement this for your CDN provider (Cloudflare, Vercel, Fastly, ...).
+ *
+ * Receives every route object in a single call so providers that support
+ * batching can group cache invalidations.
+ *
+ * @param routes the list of route objects that were revalidated
+ */
+type CdnPurgeHandler = (routes: IRoute[]) => Promise<void>;
+/**
+ * Cloudflare CDN purge by Cache-Tag (route.page).
+ * Requires `CLOUDFLARE_ZONE_ID` and `CLOUDFLARE_API_TOKEN` env vars.
+ * No-op when the env vars are not configured.
+ *
+ * Purges distinct page tags in batches of up to 25 tags per request,
+ * invalidating all cached responses with those tags across alternate URLs/resources.
+ */
+declare const cloudflarePurgeHandler: CdnPurgeHandler;
+/**
+ * Resolves the CDN purge strategy from `CDN_STRATEGY` (e.g. `cloudflare`).
+ * Returns `undefined` when the strategy is unknown or not set, disabling the purge.
+ */
+declare function resolveCdnPurgeHandler(strategy?: string | undefined): CdnPurgeHandler | undefined;
+/**
+ * Creates the `/-revalidate` POST handler that revalidates (on-demand ISR) the
+ * Next.js app router pages of the routes matching the request body:
+ *
+ * - `{ "href": "/ww/en/products/xxxx" }` matches a single route by pathname
+ * - `{ "schema": "product", "page": "xxxx" }` matches every market/locale route of a document
+ *
+ * The request must carry `Authorization: Bearer ${MIXER_SECRET}`.
+ *
+ * Routes are read from the Bowl route store, which is invalidated by collection
+ * hooks, so a document that was just saved is already reflected.
+ * An optional CDN purge runs after the pages are revalidated; a purge failure is
+ * logged but never blocks the revalidation response.
+ */
+declare function getRevalidateHandler(config: Promise<SanitizedConfig>, cdnPurge?: CdnPurgeHandler | undefined): (request: NextRequest) => Promise<Response>;
+//# sourceMappingURL=revalidate.handler.d.ts.map
+//#endregion
+export { CdnPurgeHandler, cloudflarePurgeHandler, getRevalidateHandler, resolveCdnPurgeHandler };
+//# sourceMappingURL=revalidate.handler.d.ts.map

package/dist/server/handlers/revalidate.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revalidate.handler.d.ts","names":[],"sources":["../../../src/server/handlers/revalidate.handler.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAkBA;;;;AAA2D;AAU3D;AA6BA;AAgCgB,KAvEJ,eAAA,GAuEwB,CAAA,MAAA,EAvEG,MAuEH,EAAA,EAAA,GAvEgB,OAuEhB,CAAA,IAAA,CAAA;;;;;;;;AACS;cA9DhC,wBAAwB;;;;;iBA6BrB,sBAAA,iCAA6D;;;;;;;;;;;;;;;iBAgC7D,oBAAA,SAA6B,QAAQ,6BAA4B,wCAC/C,gBAAW,QAAA"}