@websolutespa/bom-next 3.0.2 → 4.0.0-next.1

package/dist/server/page.js

@@ -1,29 +1,87 @@
-"use server";
 import { buildBreadcrumb } from "../lib/breadcrumb.js";
-import { buildBaseOptions } from "./mixer.js";
+import { buildReadOptions } from "./mixer.js";
 import { getCategorySegments } from "@websolutespa/bom-core";
+import "server-only";
+
 //#region src/server/page.ts
 /**
+
+* Fields `getPage` needs to build the envelope (href, alternates, breadcrumb,
+
+* segments) and that templates rely on (meta, template). They are always
+
+* kept, whatever `select` the caller passes.
+
+*/
+const PAGE_ENVELOPE_FIELDS = [
+	"id",
+	"slug",
+	"title",
+	"category",
+	"markets",
+	"meta",
+	"template"
+];
+function isExcludeSelect(select) {
+	return Object.values(select).some((value) => value === false || typeof value === "object" && value !== null && isExcludeSelect(value));
+}
+/**
+
+* Merges the envelope fields into a Payload select.
+
+* - include mode (`true` values): envelope keys are added.
+
+* - exclude mode (`false` values): envelope keys are removed from the exclusion list.
+
+*/
+function withEnvelopeSelect(select) {
+	if (!select || Object.keys(select).length === 0) return select;
+	const merged = { ...select };
+	if (isExcludeSelect(select)) for (const key of PAGE_ENVELOPE_FIELDS) delete merged[key];
+	else for (const key of PAGE_ENVELOPE_FIELDS) if (merged[key] === void 0) merged[key] = true;
+	return merged;
+}
+/**
+
 * Fetches a single page document by ID using Payload local API and assembles
+
 * the IPage envelope (routes, alternates, breadcrumb, parentRoute).
+
 *
+
 * All data required for the envelope comes from mixerContext — no store calls.
+
 *   - routes/alternates : mixerContext.routes filtered by schema+id
+
 *   - segments          : getCategorySegments() from bom-core (pure)
+
 *   - breadcrumb        : findRouteOfCategory() from bom-core + mixerContext.currentRoutes
+
+*
+
+* Returns undefined when the document is not found; any other error is logged and rethrown.
+
+* The last argument accepts read options (depth, draft, select, populate, joins);
+
+* a boolean is still accepted as the legacy `draftMode` flag (depth 0).
+
 */
-async function getPage(slug, id, market, locale, payload, user, mixerContext, draftMode) {
+async function getPage(slug, id, market, locale, payload, user, mixerContext, readOptions) {
+	const options = typeof readOptions === "object" ? readOptions : {
+		draft: readOptions,
+		depth: 0
+	};
+	const read = buildReadOptions({
+		...options,
+		select: withEnvelopeSelect(options.select),
+		user,
+		locale
+	});
 	try {
-		const base = buildBaseOptions(user, locale, draftMode);
 		const page = await payload.findByID({
+			...read,
 			collection: slug,
 			id,
-			locale: base.locale,
-			fallbackLocale: base.fallbackLocale,
-			draft: base.draft,
-			depth: base.depth,
-			user: base.user,
-			overrideAccess: base.overrideAccess,
 			disableErrors: true,
 			context: mixerContext
 		});
@@ -45,13 +103,14 @@ async function getPage(slug, id, market, locale, payload, user, mixerContext, dr
 			};
 		} else {
 			console.log("PageService.getPage.notfound", slug, id, locale);
-			return;
+			return void 0;
 		}
-	} catch {
-		return;
+	} catch (error) {
+		console.error("PageService.getPage.error", slug, id, locale, error);
+		throw error;
 	}
 }
-//#endregion
-export { getPage };
 
+//#endregion
+export { PAGE_ENVELOPE_FIELDS, getPage, withEnvelopeSelect };
 //# sourceMappingURL=page.js.map

package/dist/server/page.js.map

@@ -1 +1 @@
-{"version":3,"file":"page.js","names":[],"sources":["../../src/server/page.ts"],"sourcesContent":["'use server';\r\n\r\nimport { getCategorySegments, ICategorized, ICategory, IRoute, IRouteLink } from '@websolutespa/bom-core';\r\nimport type { User } from '@websolutespa/payload-plugin-bowl';\r\nimport type { CollectionSlug } from 'payload';\r\nimport { buildBreadcrumb } from '../lib/breadcrumb';\r\nimport type { MixerContext, TypedPage } from '../types';\r\nimport { buildBaseOptions } from './mixer';\r\nimport type { MixerPayload } from './mixer-payload';\r\n\r\n/**\r\n * Fetches a single page document by ID using Payload local API and assembles\r\n * the IPage envelope (routes, alternates, breadcrumb, parentRoute).\r\n *\r\n * All data required for the envelope comes from mixerContext — no store calls.\r\n *   - routes/alternates : mixerContext.routes filtered by schema+id\r\n *   - segments          : getCategorySegments() from bom-core (pure)\r\n *   - breadcrumb        : findRouteOfCategory() from bom-core + mixerContext.currentRoutes\r\n */\r\nexport async function getPage<TSlug extends CollectionSlug>(\r\n  slug: TSlug,\r\n  id: string,\r\n  market: string,\r\n  locale: string,\r\n  payload: MixerPayload,\r\n  user: User,\r\n  mixerContext: MixerContext,\r\n  draftMode?: boolean\r\n): Promise<TypedPage<TSlug> | undefined> {\r\n  try {\r\n    const base = buildBaseOptions(user, locale, draftMode);\r\n    const page = await payload.findByID({\r\n      collection: slug,\r\n      id,\r\n      locale: base.locale,\r\n      fallbackLocale: base.fallbackLocale,\r\n      draft: base.draft,\r\n      depth: base.depth,\r\n      user: base.user,\r\n      overrideAccess: base.overrideAccess,\r\n      disableErrors: true,\r\n      context: mixerContext,\r\n    });\r\n    if (page) {\r\n      // All routes for this schema+document across every market/locale (for alternates)\r\n      const routes = (mixerContext.routes as IRoute[]).filter(\r\n        r => r.schema === slug && String(r.page) === String(id)\r\n      );\r\n      const currentRoute = routes.find(r => r.market === market && r.locale === locale);\r\n      const alternates = routes;\r\n\r\n      // Segments derived from categories already present in mixerContext (pure, no I/O)\r\n      const categories = mixerContext.categories as unknown as ICategory[];\r\n      const segments = getCategorySegments(categories, page as unknown as ICategorized);\r\n\r\n      // Breadcrumb built from currentRoutes (pre-filtered to market+locale by mixer)\r\n      const currentRoutes = mixerContext.currentRoutes as IRoute[];\r\n      const breadcrumb: IRouteLink[] = currentRoute\r\n        ? buildBreadcrumb(segments, currentRoute, currentRoutes)\r\n        : [];\r\n\r\n      const parentRoute: IRouteLink | undefined = breadcrumb.length > 1\r\n        ? breadcrumb[breadcrumb.length - 2]\r\n        : undefined;\r\n\r\n      return {\r\n        ...page,\r\n        href: currentRoute?.id,\r\n        alternates,\r\n        breadcrumb,\r\n        parentRoute,\r\n      } as unknown as TypedPage<TSlug>;\r\n    } else {\r\n      console.log('PageService.getPage.notfound', slug, id, locale);\r\n      return undefined;\r\n    }\r\n  } catch {\r\n    return undefined;\r\n  }\r\n}\r\n\r\n/*\r\nexport function asServerProps(props: any): any {\r\n  return JSON.parse(JSON.stringify(props));\r\n}\r\n*/\r\n"],"mappings":";;;;;;;;;;;;;;AAmBA,eAAsB,QACpB,MACA,IACA,QACA,QACA,SACA,MACA,cACA,WACuC;CACvC,IAAI;EACF,MAAM,OAAO,iBAAiB,MAAM,QAAQ,SAAS;EACrD,MAAM,OAAO,MAAM,QAAQ,SAAS;GAClC,YAAY;GACZ;GACA,QAAQ,KAAK;GACb,gBAAgB,KAAK;GACrB,OAAO,KAAK;GACZ,OAAO,KAAK;GACZ,MAAM,KAAK;GACX,gBAAgB,KAAK;GACrB,eAAe;GACf,SAAS;EACX,CAAC;EACD,IAAI,MAAM;GAER,MAAM,SAAU,aAAa,OAAoB,QAC/C,MAAK,EAAE,WAAW,QAAQ,OAAO,EAAE,IAAI,MAAM,OAAO,EAAE,CACxD;GACA,MAAM,eAAe,OAAO,MAAK,MAAK,EAAE,WAAW,UAAU,EAAE,WAAW,MAAM;GAChF,MAAM,aAAa;GAGnB,MAAM,aAAa,aAAa;GAChC,MAAM,WAAW,oBAAoB,YAAY,IAA+B;GAGhF,MAAM,gBAAgB,aAAa;GACnC,MAAM,aAA2B,eAC7B,gBAAgB,UAAU,cAAc,aAAa,IACrD,CAAC;GAEL,MAAM,cAAsC,WAAW,SAAS,IAC5D,WAAW,WAAW,SAAS,KAC/B,KAAA;GAEJ,OAAO;IACL,GAAG;IACH,MAAM,cAAc;IACpB;IACA;IACA;GACF;EACF,OAAO;GACL,QAAQ,IAAI,gCAAgC,MAAM,IAAI,MAAM;GAC5D;EACF;CACF,QAAQ;EACN;CACF;AACF"}
+{"version":3,"file":"page.js","names":["select: SelectType","select: T","merged: Record<string, unknown>","slug: TSlug","id: string","market: string","locale: string","payload: MixerPayload","user: User","mixerContext: MixerContext","readOptions?: ReadOptions | boolean","options: ReadOptions","breadcrumb: IRouteLink[]","parentRoute: IRouteLink | undefined"],"sources":["../../src/server/page.ts"],"sourcesContent":["import 'server-only';\r\n\r\nimport { getCategorySegments, ICategorized, ICategory, IRoute, IRouteLink } from '@websolutespa/bom-core';\r\nimport type { User } from '@websolutespa/payload-plugin-bowl';\r\nimport type { CollectionSlug, SelectType } from 'payload';\r\nimport { buildBreadcrumb } from '../lib/breadcrumb';\r\nimport type { MixerContext, PageEnvelopeField, PageSelect, ReadOptions, TypedPage } from '../types';\r\nimport { buildReadOptions } from './mixer';\r\nimport type { MixerPayload } from './mixer-payload';\r\n\r\n/**\r\n * Fields `getPage` needs to build the envelope (href, alternates, breadcrumb,\r\n * segments) and that templates rely on (meta, template). They are always\r\n * kept, whatever `select` the caller passes.\r\n */\r\nexport const PAGE_ENVELOPE_FIELDS = ['id', 'slug', 'title', 'category', 'markets', 'meta', 'template'] as const satisfies readonly PageEnvelopeField[];\r\n\r\nfunction isExcludeSelect(select: SelectType): boolean {\r\n  return Object.values(select).some(value =>\r\n    value === false || (typeof value === 'object' && value !== null && isExcludeSelect(value as SelectType))\r\n  );\r\n}\r\n\r\n/**\r\n * Merges the envelope fields into a Payload select.\r\n * - include mode (`true` values): envelope keys are added.\r\n * - exclude mode (`false` values): envelope keys are removed from the exclusion list.\r\n */\r\nexport function withEnvelopeSelect<T extends SelectType | undefined>(select: T): T {\r\n  if (!select || Object.keys(select).length === 0) {\r\n    return select;\r\n  }\r\n  const merged: Record<string, unknown> = { ...select };\r\n  if (isExcludeSelect(select)) {\r\n    for (const key of PAGE_ENVELOPE_FIELDS) {\r\n      delete merged[key];\r\n    }\r\n  } else {\r\n    for (const key of PAGE_ENVELOPE_FIELDS) {\r\n      if (merged[key] === undefined) {\r\n        merged[key] = true;\r\n      }\r\n    }\r\n  }\r\n  return merged as T;\r\n}\r\n\r\n/**\r\n * Fetches a single page document by ID using Payload local API and assembles\r\n * the IPage envelope (routes, alternates, breadcrumb, parentRoute).\r\n *\r\n * All data required for the envelope comes from mixerContext — no store calls.\r\n *   - routes/alternates : mixerContext.routes filtered by schema+id\r\n *   - segments          : getCategorySegments() from bom-core (pure)\r\n *   - breadcrumb        : findRouteOfCategory() from bom-core + mixerContext.currentRoutes\r\n *\r\n * Returns undefined when the document is not found; any other error is logged and rethrown.\r\n * The last argument accepts read options (depth, draft, select, populate, joins);\r\n * a boolean is still accepted as the legacy `draftMode` flag (depth 0).\r\n */\r\nexport async function getPage<TSlug extends CollectionSlug, TSelect extends PageSelect<TSlug> = undefined>(\r\n  slug: TSlug,\r\n  id: string,\r\n  market: string,\r\n  locale: string,\r\n  payload: MixerPayload,\r\n  user: User,\r\n  mixerContext: MixerContext,\r\n  readOptions?: ReadOptions | boolean\r\n): Promise<TypedPage<TSlug, TSelect> | undefined> {\r\n  const options: ReadOptions = typeof readOptions === 'object'\r\n    ? readOptions\r\n    : { draft: readOptions, depth: 0 };\r\n  const read = buildReadOptions({\r\n    ...options,\r\n    select: withEnvelopeSelect(options.select),\r\n    user,\r\n    locale,\r\n  });\r\n  try {\r\n    const page = await payload.findByID({\r\n      ...read,\r\n      collection: slug,\r\n      id,\r\n      disableErrors: true,\r\n      context: mixerContext,\r\n    });\r\n    if (page) {\r\n      // All routes for this schema+document across every market/locale (for alternates)\r\n      const routes = (mixerContext.routes as IRoute[]).filter(\r\n        r => r.schema === slug && String(r.page) === String(id)\r\n      );\r\n      const currentRoute = routes.find(r => r.market === market && r.locale === locale);\r\n      const alternates = routes;\r\n\r\n      // Segments derived from categories already present in mixerContext (pure, no I/O)\r\n      const categories = mixerContext.categories as unknown as ICategory[];\r\n      const segments = getCategorySegments(categories, page as unknown as ICategorized);\r\n\r\n      // Breadcrumb built from currentRoutes (pre-filtered to market+locale by mixer)\r\n      const currentRoutes = mixerContext.currentRoutes as IRoute[];\r\n      const breadcrumb: IRouteLink[] = currentRoute\r\n        ? buildBreadcrumb(segments, currentRoute, currentRoutes)\r\n        : [];\r\n\r\n      const parentRoute: IRouteLink | undefined = breadcrumb.length > 1\r\n        ? breadcrumb[breadcrumb.length - 2]\r\n        : undefined;\r\n\r\n      return {\r\n        ...page,\r\n        href: currentRoute?.id,\r\n        alternates,\r\n        breadcrumb,\r\n        parentRoute,\r\n      } as unknown as TypedPage<TSlug, TSelect>;\r\n    } else {\r\n      console.log('PageService.getPage.notfound', slug, id, locale);\r\n      return undefined;\r\n    }\r\n  } catch (error) {\r\n    console.error('PageService.getPage.error', slug, id, locale, error);\r\n    throw error;\r\n  }\r\n}\r\n\r\n/*\r\nexport function asServerProps(props: any): any {\r\n  return JSON.parse(JSON.stringify(props));\r\n}\r\n*/\r\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,uBAAuB;CAAC;CAAM;CAAQ;CAAS;CAAY;CAAW;CAAQ;AAAW;AAEtG,SAAS,gBAAgBA,QAA6B;AACpD,QAAO,OAAO,OAAO,OAAO,CAAC,KAAK,WAChC,UAAU,SAAU,OAAO,UAAU,YAAY,UAAU,QAAQ,gBAAgB,MAAoB,CACxG;AACF;;;;;;;;;;AAOD,SAAgB,mBAAqDC,QAAc;AACjF,KAAI,CAAC,UAAU,OAAO,KAAK,OAAO,CAAC,WAAW,EAC5C,QAAO;CAET,MAAMC,SAAkC,EAAE,GAAG,OAAQ;AACrD,KAAI,gBAAgB,OAAO,CACzB,MAAK,MAAM,OAAO,sBAChB,OAAO,OAAO;KAGhB,MAAK,MAAM,OAAO,qBAChB,KAAI,OAAO,SAAS,QAClB,OAAO,OAAO;AAIpB,QAAO;AACR;;;;;;;;;;;;;;;;;;;;;;;;;;AAeD,eAAsB,QACpBC,MACAC,IACAC,QACAC,QACAC,SACAC,MACAC,cACAC,aACgD;CAChD,MAAMC,UAAuB,OAAO,gBAAgB,WAChD,cACA;EAAE,OAAO;EAAa,OAAO;CAAG;CACpC,MAAM,OAAO,iBAAiB;EAC5B,GAAG;EACH,QAAQ,mBAAmB,QAAQ,OAAO;EAC1C;EACA;CACD,EAAC;AACF,KAAI;EACF,MAAM,OAAO,MAAM,QAAQ,SAAS;GAClC,GAAG;GACH,YAAY;GACZ;GACA,eAAe;GACf,SAAS;EACV,EAAC;AACF,MAAI,MAAM;GAER,MAAM,SAAU,aAAa,OAAoB,OAC/C,OAAK,EAAE,WAAW,QAAQ,OAAO,EAAE,KAAK,KAAK,OAAO,GAAG,CACxD;GACD,MAAM,eAAe,OAAO,KAAK,OAAK,EAAE,WAAW,UAAU,EAAE,WAAW,OAAO;GACjF,MAAM,aAAa;GAGnB,MAAM,aAAa,aAAa;GAChC,MAAM,WAAW,oBAAoB,YAAY,KAAgC;GAGjF,MAAM,gBAAgB,aAAa;GACnC,MAAMC,aAA2B,eAC7B,gBAAgB,UAAU,cAAc,cAAc,GACtD,CAAE;GAEN,MAAMC,cAAsC,WAAW,SAAS,IAC5D,WAAW,WAAW,SAAS,KAC/B;AAEJ,UAAO;IACL,GAAG;IACH,MAAM,cAAc;IACpB;IACA;IACA;GACD;EACF,OAAM;GACL,QAAQ,IAAI,gCAAgC,MAAM,IAAI,OAAO;AAC7D,UAAO;EACR;CACF,SAAQ,OAAO;EACd,QAAQ,MAAM,6BAA6B,MAAM,IAAI,QAAQ,MAAM;AACnE,QAAM;CACP;AACF"}

package/dist/server/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","names":[],"sources":["../../src/server/utils.ts"],"mappings":";;;;;iBAIgB,UAAA,UAAoB,oBAAoB,SAAM,8BAAA,CAAA;iBAQ9C,qBAAA,UAA+B"}
+{"version":3,"file":"utils.d.ts","names":[],"sources":["../../src/server/utils.ts"],"sourcesContent":[],"mappings":";;;;;iBAIgB,UAAA,UAAoB,oBAAoB,SAAM,8BAAA,CAAA;iBAQ9C,qBAAA,UAA+B"}

package/dist/server/utils.js

@@ -1,9 +1,11 @@
 import { resolveRoute } from "../lib/route.js";
 import { getHost } from "@websolutespa/bom-core";
+
 //#region src/server/utils.ts
 function getNextUrl(request, route) {
 	const nextUrl = request.nextUrl.clone();
-	nextUrl.pathname = resolveRoute(route);
+	const resolvedPathname = resolveRoute(route);
+	nextUrl.pathname = resolvedPathname;
 	return nextUrl;
 }
 function getHrefBeforeRedirect(request) {
@@ -17,7 +19,7 @@ function getHrefBeforeRedirect(request) {
 	}
 	return hrefBeforeRedirect;
 }
+
 //#endregion
 export { getHrefBeforeRedirect, getNextUrl };
-
 //# sourceMappingURL=utils.js.map

package/dist/server/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":[],"sources":["../../src/server/utils.ts"],"sourcesContent":["import { getHost, IRoute } from '@websolutespa/bom-core';\r\nimport { NextRequest } from 'next/server';\r\nimport { resolveRoute } from '../lib/route';\r\n\r\nexport function getNextUrl(request: NextRequest, route: IRoute) {\r\n  const nextUrl = request.nextUrl.clone();\r\n  const resolvedPathname = resolveRoute(route);\r\n  // console.log('getNextUrl.resolvedPathname', resolvedPathname);\r\n  nextUrl.pathname = resolvedPathname;\r\n  return nextUrl;\r\n}\r\n\r\nexport function getHrefBeforeRedirect(request: NextRequest): string | null {\r\n  let hrefBeforeRedirect: string | null = null;\r\n  const urlBeforeRedirect = request.nextUrl.clone();\r\n  const host = getHost(request.headers);\r\n  if (host) {\r\n    urlBeforeRedirect.host = host;\r\n    urlBeforeRedirect.port = host.split(':')[1] || '';\r\n    hrefBeforeRedirect = urlBeforeRedirect.href;\r\n  }\r\n  return hrefBeforeRedirect;\r\n}\r\n"],"mappings":";;;AAIA,SAAgB,WAAW,SAAsB,OAAe;CAC9D,MAAM,UAAU,QAAQ,QAAQ,MAAM;CAGtC,QAAQ,WAFiB,aAAa,KAEJ;CAClC,OAAO;AACT;AAEA,SAAgB,sBAAsB,SAAqC;CACzE,IAAI,qBAAoC;CACxC,MAAM,oBAAoB,QAAQ,QAAQ,MAAM;CAChD,MAAM,OAAO,QAAQ,QAAQ,OAAO;CACpC,IAAI,MAAM;EACR,kBAAkB,OAAO;EACzB,kBAAkB,OAAO,KAAK,MAAM,GAAG,CAAC,CAAC,MAAM;EAC/C,qBAAqB,kBAAkB;CACzC;CACA,OAAO;AACT"}
+{"version":3,"file":"utils.js","names":["request: NextRequest","route: IRoute","hrefBeforeRedirect: string | null"],"sources":["../../src/server/utils.ts"],"sourcesContent":["import { getHost, IRoute } from '@websolutespa/bom-core';\r\nimport { NextRequest } from 'next/server';\r\nimport { resolveRoute } from '../lib/route';\r\n\r\nexport function getNextUrl(request: NextRequest, route: IRoute) {\r\n  const nextUrl = request.nextUrl.clone();\r\n  const resolvedPathname = resolveRoute(route);\r\n  // console.log('getNextUrl.resolvedPathname', resolvedPathname);\r\n  nextUrl.pathname = resolvedPathname;\r\n  return nextUrl;\r\n}\r\n\r\nexport function getHrefBeforeRedirect(request: NextRequest): string | null {\r\n  let hrefBeforeRedirect: string | null = null;\r\n  const urlBeforeRedirect = request.nextUrl.clone();\r\n  const host = getHost(request.headers);\r\n  if (host) {\r\n    urlBeforeRedirect.host = host;\r\n    urlBeforeRedirect.port = host.split(':')[1] || '';\r\n    hrefBeforeRedirect = urlBeforeRedirect.href;\r\n  }\r\n  return hrefBeforeRedirect;\r\n}\r\n"],"mappings":";;;;AAIA,SAAgB,WAAWA,SAAsBC,OAAe;CAC9D,MAAM,UAAU,QAAQ,QAAQ,OAAO;CACvC,MAAM,mBAAmB,aAAa,MAAM;CAE5C,QAAQ,WAAW;AACnB,QAAO;AACR;AAED,SAAgB,sBAAsBD,SAAqC;CACzE,IAAIE,qBAAoC;CACxC,MAAM,oBAAoB,QAAQ,QAAQ,OAAO;CACjD,MAAM,OAAO,QAAQ,QAAQ,QAAQ;AACrC,KAAI,MAAM;EACR,kBAAkB,OAAO;EACzB,kBAAkB,OAAO,KAAK,MAAM,IAAI,CAAC,MAAM;EAC/C,qBAAqB,kBAAkB;CACxC;AACD,QAAO;AACR"}

package/dist/server/utmz.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utmz.d.ts","names":[],"sources":["../../src/server/utmz.ts"],"mappings":";;;iBAEgB,OAAA,UAAiB"}
+{"version":3,"file":"utmz.d.ts","names":[],"sources":["../../src/server/utmz.ts"],"sourcesContent":[],"mappings":";;;iBAEgB,OAAA,UAAiB"}

package/dist/server/utmz.js

@@ -8,7 +8,7 @@ function getUtmz(request) {
 	}
 	return utmz;
 }
+
 //#endregion
 export { getUtmz };
-
 //# sourceMappingURL=utmz.js.map

package/dist/server/utmz.js.map

@@ -1 +1 @@
-{"version":3,"file":"utmz.js","names":[],"sources":["../../src/server/utmz.ts"],"sourcesContent":["import { NextApiRequest } from 'next';\r\n\r\nexport function getUtmz(request: NextApiRequest): string {\r\n  let utmz = 'N/A';\r\n  if (typeof request.cookies.__utmz === 'string') {\r\n    utmz = request.cookies.__utmz;\r\n    const i = utmz.indexOf('utmcsr');\r\n    utmz = utmz.substring(i === -1 ? 0 : i);\r\n  }\r\n  return utmz;\r\n}\r\n"],"mappings":";AAEA,SAAgB,QAAQ,SAAiC;CACvD,IAAI,OAAO;CACX,IAAI,OAAO,QAAQ,QAAQ,WAAW,UAAU;EAC9C,OAAO,QAAQ,QAAQ;EACvB,MAAM,IAAI,KAAK,QAAQ,QAAQ;EAC/B,OAAO,KAAK,UAAU,MAAM,KAAK,IAAI,CAAC;CACxC;CACA,OAAO;AACT"}
+{"version":3,"file":"utmz.js","names":["request: NextApiRequest"],"sources":["../../src/server/utmz.ts"],"sourcesContent":["import { NextApiRequest } from 'next';\r\n\r\nexport function getUtmz(request: NextApiRequest): string {\r\n  let utmz = 'N/A';\r\n  if (typeof request.cookies.__utmz === 'string') {\r\n    utmz = request.cookies.__utmz;\r\n    const i = utmz.indexOf('utmcsr');\r\n    utmz = utmz.substring(i === -1 ? 0 : i);\r\n  }\r\n  return utmz;\r\n}\r\n"],"mappings":";AAEA,SAAgB,QAAQA,SAAiC;CACvD,IAAI,OAAO;AACX,KAAI,OAAO,QAAQ,QAAQ,WAAW,UAAU;EAC9C,OAAO,QAAQ,QAAQ;EACvB,MAAM,IAAI,KAAK,QAAQ,SAAS;EAChC,OAAO,KAAK,UAAU,MAAM,KAAK,IAAI,EAAE;CACxC;AACD,QAAO;AACR"}

package/dist/types.d.ts

@@ -3,7 +3,7 @@ import { ErrorContext, RequestInfo } from "./instrumentation/types.js";
 import { ICategorized, IComponent, ILayout, ILocale, IMarket, IPage, IPrettify, IRoute, PageProps } from "@websolutespa/bom-core";
 import { ComponentType, ReactNode } from "react";
 import { Category, EndUser, User } from "@websolutespa/payload-plugin-bowl";
-import { BasePayload, CollectionSlug, DataFromCollectionSlug, SanitizedConfig, TypedFallbackLocale, TypedLocale } from "payload";
+import { BasePayload, CollectionSlug, DataFromCollectionSlug, JoinQuery, PopulateType, SanitizedConfig, SelectType, TransformCollectionWithSelect, TypedCollectionSelect, TypedFallbackLocale, TypedLocale } from "payload";
 import { DynamicOptions, Loader } from "next/dynamic";
 
 //#region src/types.d.ts
@@ -89,12 +89,83 @@ type IContext = {
   payload: MixerPayload;
   context: MixerContext;
 };
-type PageDocument<TSlug extends CollectionSlug> = DataFromCollectionSlug<TSlug>;
-/** A generated page collection document enriched with Bowl's page envelope. */
-type TypedPage<TSlug extends CollectionSlug> = BowlDecorator<PageDocument<TSlug>> & IPage<ICategorized>;
-type TypedPageContext<TSlug extends CollectionSlug = CollectionSlug> = {
-  layout: ILayout;
-  page: TypedPage<TSlug> | undefined;
+/** `true` / `false` forces draft mode, `'auto'` reads Next's `draftMode()`. */
+type DraftOption = boolean | 'auto';
+/** Select accepted for a page collection, or `undefined` for the full document. */
+type PageSelect<TSlug extends CollectionSlug> = TypedCollectionSelect[TSlug] | undefined;
+/**
+ * A generated page collection document, narrowed by `select` when one is given.
+ * Without a select the full generated document type is returned.
+ */
+type PageDocument<TSlug extends CollectionSlug, TSelect = undefined> = TSelect extends SelectType ? TransformCollectionWithSelect<TSlug, TSelect> : DataFromCollectionSlug<TSlug>;
+/** Fields always read by `createPageContext`, whatever `select` is passed (see PAGE_ENVELOPE_FIELDS). */
+type PageEnvelopeField = 'id' | 'slug' | 'title' | 'category' | 'markets' | 'meta' | 'template';
+type SelectInclude = {
+  [key: string]: SelectInclude | true;
+};
+/** Type counterpart of `withEnvelopeSelect`: the envelope fields are always part of the result. */
+type WithEnvelopeSelect<TSelect> = TSelect extends SelectInclude ? TSelect & { [K in PageEnvelopeField]: true } : Omit<TSelect, PageEnvelopeField>;
+/** Envelope added by `getPage` to every page document. */
+type PageEnvelope = Pick<IPage, 'schema' | 'alternates' | 'breadcrumb' | 'href' | 'parentRoute'>;
+/**
+ * A generated page collection document enriched with Bowl's page envelope.
+ * With a `select`, only the selected fields (plus the envelope fields) are typed.
+ */
+type TypedPage<TSlug extends CollectionSlug, TSelect extends PageSelect<TSlug> = undefined> = [TSelect] extends [SelectType] ? BowlDecorator<PageDocument<TSlug, WithEnvelopeSelect<TSelect>>> & PageEnvelope : BowlDecorator<PageDocument<TSlug>> & IPage<ICategorized>;
+/**
+ * Narrows relationship / upload fields that are known to be populated
+ * (depth >= 1) from `string | T` (or `number | T`) to `T`.
+ *
+ * @example
+ * const media = page.media as Populated<typeof page.media>;
+ */
+type Populated<T> = T extends readonly (infer TItem)[] ? Populated<TItem>[] : Exclude<T, string | number>;
+/** Options for the layout fetch (`createLayoutContext`, or `layout` in `createPageContext`). */
+type LayoutOptions = {
+  /** Population depth for app, menus, labels, markets. Default `DEFAULT_LAYOUT_DEPTH` (1: app logo, menu media). */
+  depth?: number;
+  /** Default: the page draft option, or `'auto'` for `createLayoutContext`. */
+  draft?: DraftOption;
+};
+/** The `layout` option of `createPageContext`: layout options, or `false` to skip the layout. */
+type LayoutOption = LayoutOptions | false;
+/** `ILayout`, or `undefined` when the layout option is `false`. */
+type LayoutFor<TLayout extends LayoutOption> = TLayout extends false ? undefined : ILayout;
+type LayoutContextOptions = LayoutOptions & {
+  config: Promise<SanitizedConfig>;
+  headers?: ReadonlyHeaders;
+};
+type PageContextOptions<TSlug extends CollectionSlug = CollectionSlug, TSelect extends PageSelect<TSlug> = undefined, TLayout extends LayoutOption = LayoutOption> = {
+  config: Promise<SanitizedConfig>;
+  headers?: ReadonlyHeaders;
+  /**
+   * Population depth. Default `DEFAULT_PAGE_DEPTH` (2).
+   * 0 = ids only, 1 = direct relations/uploads (including those inside blocks),
+   * 2 = relations of relations (e.g. card covers).
+   */
+  depth?: number;
+  /** Payload select for the page document. Envelope fields are always merged in. */
+  select?: TSelect;
+  /** Per-collection select applied to populated documents, e.g. `{ media: { url: true } }`. */
+  populate?: PopulateType;
+  joins?: JoinQuery<TSlug> | false;
+  /** `true` / `false`, or `'auto'` to read Next `draftMode()`. Default `'auto'`. */
+  draft?: DraftOption;
+  /** Options for the layout fetch, or `false` to skip loading the layout (`layout` is then `undefined`). */
+  layout?: TLayout;
+};
+/** Read options shared by every local API call made for a page or layout. */
+type ReadOptions = {
+  depth?: number;
+  draft?: boolean;
+  select?: SelectType;
+  populate?: PopulateType;
+  joins?: JoinQuery<any> | false;
+};
+type TypedPageContext<TSlug extends CollectionSlug = CollectionSlug, TSelect extends PageSelect<TSlug> = undefined, TLayout extends LayoutOption = LayoutOptions> = {
+  /** `undefined` when the page context was created with `layout: false`. */
+  layout: LayoutFor<TLayout>;
+  page: TypedPage<TSlug, TSelect> | undefined;
   user: IUser | IEndUser | null;
   label: (key: string, params?: Record<string, any>) => string;
   link: (category: string) => string | undefined;
@@ -132,5 +203,5 @@ type ILazyStaticProps = Record<string, ILazyStaticPropsFunc>;
 //# sourceMappingURL=types.d.ts.map
 
 //#endregion
-export { BaseOptions, ComponentContext, ComponentProps, ErrorContext, IContext, IEndUser, ILazyComponent, ILazyComponentFunc, ILazyComponentProps, ILazyFuncProps, ILazyModules, ILazyProps, ILazyStaticProps, ILazyStaticPropsFunc, ILazyableProps, ILazyedProps, INullableLazyableProps, IPageContext, IUser, LayoutContext, LocalProvider, MarketLocaleParams, MixerContext, NotFoundContext, NotFoundParams, PageContext, PageDocument, PageLayoutContext, PageParams, PartialPageProps, ReadonlyHeaders, RequestInfo, SearchParams, TypedPage, TypedPageContext };
+export { BaseOptions, ComponentContext, ComponentProps, DraftOption, IContext, IEndUser, ILazyComponent, ILazyComponentFunc, ILazyComponentProps, ILazyFuncProps, ILazyModules, ILazyProps, ILazyStaticProps, ILazyStaticPropsFunc, ILazyableProps, ILazyedProps, INullableLazyableProps, IPageContext, IUser, LayoutContext, LayoutContextOptions, LayoutFor, LayoutOption, LayoutOptions, LocalProvider, MarketLocaleParams, MixerContext, NotFoundContext, NotFoundParams, PageContext, PageContextOptions, PageDocument, PageEnvelope, PageEnvelopeField, PageLayoutContext, PageParams, PageSelect, PartialPageProps, Populated, ReadOptions, ReadonlyHeaders, SearchParams, TypedPage, TypedPageContext, WithEnvelopeSelect };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":"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"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@websolutespa/bom-next",
-  "version": "3.0.2",
+  "version": "4.0.0-next.1",
   "description": "Next module of the BOM Repository",
   "keywords": [
     "bom",
@@ -23,36 +23,37 @@
     "types": "tsc --noemit"
   },
   "dependencies": {
+    "server-only": "0.0.1",
     "transliteration": "latest"
   },
   "peerDependencies": {
     "@sentry/nextjs": "10.75.0",
-    "@websolutespa/bom-core": "^3.0.1",
-    "@websolutespa/payload-db-memory": "^3.0.2",
-    "@websolutespa/payload-plugin-bowl": "^3.0.17",
-    "@websolutespa/payload-utils": "^3.0.2",
+    "@websolutespa/bom-core": "^4.0.0-next.0",
+    "@websolutespa/payload-db-memory": "^3.0.3",
+    "@websolutespa/payload-plugin-bowl": "^4.0.0-next.0",
+    "@websolutespa/payload-utils": "^4.0.0-next.0",
     "next": "16.1.6",
     "payload": "3.74.0",
-    "react-dom": "19.2.3",
-    "react": "19.2.3"
+    "react": "19.2.3",
+    "react-dom": "19.2.3"
   },
   "devDependencies": {
     "@sentry/nextjs": "10.75.0",
-    "@types/react-dom": "19.2.3",
     "@types/react": "19.2.10",
-    "@websolutespa/bom-cli": "^3.0.1",
-    "@websolutespa/bom-core": "^3.0.1",
+    "@types/react-dom": "19.2.3",
+    "@websolutespa/bom-cli": "^4.0.0-next.0",
+    "@websolutespa/bom-core": "^4.0.0-next.0",
     "@websolutespa/eslint-config": "^3.0.0",
-    "@websolutespa/payload-db-memory": "^3.0.2",
-    "@websolutespa/payload-plugin-bowl": "^3.0.17",
-    "@websolutespa/payload-utils": "^3.0.2",
-    "@websolutespa/test": "^3.0.2",
+    "@websolutespa/payload-db-memory": "^3.0.3",
+    "@websolutespa/payload-plugin-bowl": "^4.0.0-next.0",
+    "@websolutespa/payload-utils": "^4.0.0-next.0",
+    "@websolutespa/test": "^4.0.0-next.0",
     "@websolutespa/tsconfig": "^3.0.0",
     "eslint": "9.31.0",
     "npm-run-all": "4.1.5",
+    "react": "19.2.3",
     "react-dom": "19.2.3",
     "react-error-boundary": "4.1.2",
-    "react": "19.2.3",
     "typescript": "5.8.3"
   },
   "publishConfig": {

package/src/exports/server.ts

@@ -9,6 +9,7 @@ export * from '../server/handlers/route.handler';
 export * from '../server/handlers/sitemap.handler';
 export * from '../server/handlers/static-params.handler';
 export * from '../server/handlers/vars.handler';
+export * from '../server/helpers';
 export * from '../server/lazy';
 export * from '../server/local-api';
 export * from '../server/metadata';

package/src/lib/const.ts

@@ -1,3 +1,18 @@
 import type { Config, User } from '@websolutespa/payload-plugin-bowl';
 
 export const guest = { collection: 'users', roles: ['guest'] } as (User & Config['user']);
+
+/**
+ * Default population depth for page documents read by `createPageContext`.
+ *
+ * - `0`: relationships and uploads are returned as ids.
+ * - `1`: direct relationships and uploads are populated, including those inside blocks.
+ * - `2`: relationships of relationships are populated too (e.g. the cover of a related card).
+ */
+export const DEFAULT_PAGE_DEPTH = 2;
+
+/**
+ * Default population depth for the layout reads (app global, menus, labels, markets).
+ * `1` populates the app logo and menu media.
+ */
+export const DEFAULT_LAYOUT_DEPTH = 1;

package/src/lib/http.ts

@@ -5,11 +5,22 @@ const API_BASE = process.env.NEXT_PUBLIC_API || '/api';
 
 export type ApiRequestOptions = FetchRequestOptions;
 
+/**
+ * Default options for requests to this app's own API.
+ *
+ * Server-side calls (proxy, handlers) target the request's deployment URL,
+ * which Vercel Deployment Protection answers with 401. When "Protection Bypass
+ * for Automation" is enabled, Vercel exposes VERCEL_AUTOMATION_BYPASS_SECRET;
+ * sending it as `x-vercel-protection-bypass` lets these calls through. The
+ * secret is never sent from the browser.
+ */
 export function getLocalApiRequestOptions(): ApiRequestOptions {
-  return {
-    headers: {
-    },
-  };
+  const headers: Record<string, string> = {};
+  const bypassSecret = !isBrowser ? process.env.VERCEL_AUTOMATION_BYPASS_SECRET : undefined;
+  if (bypassSecret) {
+    headers['x-vercel-protection-bypass'] = bypassSecret;
+  }
+  return { headers };
 }
 
 export function getRemoteApiRequestOptions(token?: string): ApiRequestOptions {

package/src/proxy/proxy.ts

@@ -10,15 +10,22 @@ export type MiddlewareOptions = {
 };
 export type Middleware = (props: MiddlewareOptions) => NextMiddlewareResult | Promise<NextMiddlewareResult>;
 
+/** Optional fixed origin for internal resolver requests, e.g. `http://127.0.0.1:3000`. */
+const INTERNAL_ORIGIN = process.env.BOM_INTERNAL_ORIGIN?.replace(/\/$/, '');
+
 /**
  * Returns the externally visible origin for an internal middleware request.
  *
- * Deployments commonly terminate TLS or change ports before forwarding to
- * Next.js. Honoring valid forwarded headers keeps resolver requests on the
- * public host and prevents an avoidable proxy redirect; direct-origin fallback
- * keeps local development and untrusted/invalid header values deterministic.
+ * BOM_INTERNAL_ORIGIN wins when set, for hosts whose public or deployment URL
+ * is unreachable from the server (protected previews, private networks,
+ * containers behind a gateway). Otherwise valid forwarded headers keep resolver
+ * requests on the public host; direct-origin fallback keeps local development
+ * and untrusted/invalid header values deterministic.
  */
 export function getRequestOrigin(request: NextRequest): string {
+  if (INTERNAL_ORIGIN) {
+    return INTERNAL_ORIGIN;
+  }
   const forwardedHost = request.headers.get('x-forwarded-host')?.split(',')[0]?.trim();
   const forwardedProtocol = request.headers.get('x-forwarded-proto')?.split(',')[0]?.trim();
   const forwardedPort = request.headers.get('x-forwarded-port')?.split(',')[0]?.trim();