@brandlab-digital/site-next 2.1.0 → 3.1.0

package/dist/metadata.js

@@ -1,37 +1,35 @@
-import { buildBrandlabMetadata, buildSeoMetadata, } from '@brandlab-digital/site-core/metadata';
+import { buildBrandlabMetadata, } from '@brandlab-digital/site-core/metadata';
 import { getRouteById, resolveBrandlabRouteIndexing, } from '@brandlab-digital/site-core/routes';
 import { defineSeoPage } from '@brandlab-digital/site-core/seo-page';
 export function toNextMetadata(metadata) {
     const { canonicalPath: _canonicalPath, canonicalUrl: _canonicalUrl, resolvedTitle: _resolvedTitle, ...next } = metadata;
     return next;
 }
-export function buildNextMetadata(input) {
-    return toNextMetadata(buildSeoMetadata(input));
-}
-export function buildBrandlabNextMetadata(input) {
-    return toNextMetadata(buildBrandlabMetadata(input));
-}
-export function createNextMetadataBuilder(defaults) {
-    return (page) => buildNextMetadata({ ...defaults, ...page });
-}
-export function createBrandlabNextMetadataBuilder(defaults) {
-    return (page) => buildBrandlabNextMetadata({ ...defaults, ...page });
-}
-/** Builds page metadata from the same route identity used by breadcrumbs and sitemaps. */
-export function createRouteMetadataBuilder(defaults, routes) {
+/**
+ * The project's one page-metadata binding (`src/lib/seo/metadata.ts`):
+ * `export const pageMetadata = createRouteMetadataBuilder(site, routes)`.
+ * Canonical path and robots come from the route catalogue; the title mode is
+ * explicit per page. Keywords keep their form: a comma-separated string renders
+ * exactly as given, a list renders joined with commas, as Next renders them.
+ */
+export function createRouteMetadataBuilder(site, routes) {
     return (input) => {
         const page = defineSeoPage(input);
         const route = getRouteById(routes, page.routeId);
         if (!route)
             throw new Error(`Unknown metadata route ID "${page.routeId}".`);
-        return buildBrandlabNextMetadata({
-            ...defaults,
+        return toNextMetadata(buildBrandlabMetadata({
+            brandName: site.name,
+            siteUrl: site.canonicalUrl,
+            locale: site.locale,
+            titleTemplate: site.titleTemplate,
+            defaultSocialImage: site.defaultSocialImage,
             title: page.title,
             description: page.description,
             pathname: route.canonicalPath ?? route.path,
             indexing: resolveBrandlabRouteIndexing(route),
             ...(page.titleMode ? { titleMode: page.titleMode } : {}),
-            ...(page.keywords ? { keywords: [...page.keywords] } : {}),
+            ...(page.keywords !== undefined ? { keywords: page.keywords } : {}),
             ...(page.socialImage ? { socialImage: page.socialImage } : {}),
             ...(page.article
                 ? {
@@ -44,7 +42,7 @@ export function createRouteMetadataBuilder(defaults, routes) {
                     },
                 }
                 : {}),
-        });
+        }));
     };
 }
 //# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GAIjB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EACL,YAAY,EACZ,4BAA4B,GAE7B,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAwB,MAAM,sCAAsC,CAAA;AAwB1F,MAAM,UAAU,cAAc,CAAC,QAA6B;IAC1D,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAC1G,QAAQ,CAAA;IACV,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAA4B;IAC5D,OAAO,cAAc,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAiC;IAEjC,OAAO,cAAc,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAA;AACrD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAAkC;IAC1E,OAAO,CAAC,IAA+B,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;AACzF,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,QAAwC;IACxF,OAAO,CAAC,IAAqC,EAAE,EAAE,CAC/C,yBAAyB,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;AACvD,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,0BAA0B,CACxC,QAAwC,EACxC,MAA4B;IAE5B,OAAO,CAAC,KAAsB,EAA0B,EAAE;QACxD,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAChD,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,OAAO,IAAI,CAAC,CAAA;QAE3E,OAAO,yBAAyB,CAAC;YAC/B,GAAG,QAAQ;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,IAAI;YAC3C,QAAQ,EAAE,4BAA4B,CAAC,KAAK,CAAC;YAC7C,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,IAAI,CAAC,OAAO;gBACd,CAAC,CAAC;oBACE,OAAO,EAAE;wBACP,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa;wBACzC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY;4BAC3B,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;4BAC7C,CAAC,CAAC,EAAE,CAAC;wBACP,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;qBACnC;iBACF;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC","sourcesContent":["import {\n  buildBrandlabMetadata,\n  buildSeoMetadata,\n  type BrandlabSeoMetadata,\n  type BuildBrandlabMetadataInput,\n  type BuildSeoMetadataInput,\n} from '@brandlab-digital/site-core/metadata'\nimport {\n  getRouteById,\n  resolveBrandlabRouteIndexing,\n  type BrandlabRouteCatalog,\n} from '@brandlab-digital/site-core/routes'\nimport { defineSeoPage, type BrandlabSeoPage } from '@brandlab-digital/site-core/seo-page'\n\nexport type NextCompatibleMetadata = Omit<\n  BrandlabSeoMetadata,\n  'canonicalPath' | 'canonicalUrl' | 'resolvedTitle'\n>\n\nexport type BrandlabMetadataDefaults = Pick<\n  BuildSeoMetadataInput,\n  'brandName' | 'siteUrl' | 'locale' | 'titleTemplate' | 'defaultSocialImage'\n>\n\nexport type BrandlabPageMetadataInput = Omit<BuildSeoMetadataInput, keyof BrandlabMetadataDefaults>\n\nexport type BrandlabStrictMetadataDefaults = Pick<\n  BuildBrandlabMetadataInput,\n  'brandName' | 'siteUrl' | 'locale' | 'titleTemplate' | 'defaultSocialImage'\n>\n\nexport type BrandlabStrictPageMetadataInput = Omit<\n  BuildBrandlabMetadataInput,\n  keyof BrandlabStrictMetadataDefaults\n>\n\nexport function toNextMetadata(metadata: BrandlabSeoMetadata): NextCompatibleMetadata {\n  const { canonicalPath: _canonicalPath, canonicalUrl: _canonicalUrl, resolvedTitle: _resolvedTitle, ...next } =\n    metadata\n  return next\n}\n\nexport function buildNextMetadata(input: BuildSeoMetadataInput): NextCompatibleMetadata {\n  return toNextMetadata(buildSeoMetadata(input))\n}\n\nexport function buildBrandlabNextMetadata(\n  input: BuildBrandlabMetadataInput,\n): NextCompatibleMetadata {\n  return toNextMetadata(buildBrandlabMetadata(input))\n}\n\nexport function createNextMetadataBuilder(defaults: BrandlabMetadataDefaults) {\n  return (page: BrandlabPageMetadataInput) => buildNextMetadata({ ...defaults, ...page })\n}\n\nexport function createBrandlabNextMetadataBuilder(defaults: BrandlabStrictMetadataDefaults) {\n  return (page: BrandlabStrictPageMetadataInput) =>\n    buildBrandlabNextMetadata({ ...defaults, ...page })\n}\n\n/** Builds page metadata from the same route identity used by breadcrumbs and sitemaps. */\nexport function createRouteMetadataBuilder(\n  defaults: BrandlabStrictMetadataDefaults,\n  routes: BrandlabRouteCatalog,\n) {\n  return (input: BrandlabSeoPage): NextCompatibleMetadata => {\n    const page = defineSeoPage(input)\n    const route = getRouteById(routes, page.routeId)\n    if (!route) throw new Error(`Unknown metadata route ID \"${page.routeId}\".`)\n\n    return buildBrandlabNextMetadata({\n      ...defaults,\n      title: page.title,\n      description: page.description,\n      pathname: route.canonicalPath ?? route.path,\n      indexing: resolveBrandlabRouteIndexing(route),\n      ...(page.titleMode ? { titleMode: page.titleMode } : {}),\n      ...(page.keywords ? { keywords: [...page.keywords] } : {}),\n      ...(page.socialImage ? { socialImage: page.socialImage } : {}),\n      ...(page.article\n        ? {\n            article: {\n              publishedTime: page.article.publishedTime,\n              ...(page.article.modifiedTime\n                ? { modifiedTime: page.article.modifiedTime }\n                : {}),\n              authors: [...page.article.authors],\n            },\n          }\n        : {}),\n    })\n  }\n}\n"]}
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAEtB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EACL,YAAY,EACZ,4BAA4B,GAE7B,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAwB,MAAM,sCAAsC,CAAA;AAQ1F,MAAM,UAAU,cAAc,CAAC,QAA6B;IAC1D,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAC1G,QAAQ,CAAA;IACV,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAAkB,EAClB,MAA4B;IAE5B,OAAO,CAAC,KAAsB,EAA0B,EAAE;QACxD,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAChD,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,OAAO,IAAI,CAAC,CAAA;QAE3E,OAAO,cAAc,CAAC,qBAAqB,CAAC;YAC1C,SAAS,EAAE,IAAI,CAAC,IAAI;YACpB,OAAO,EAAE,IAAI,CAAC,YAAY;YAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;YAC3C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,IAAI;YAC3C,QAAQ,EAAE,4BAA4B,CAAC,KAAK,CAAC;YAC7C,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,IAAI,CAAC,OAAO;gBACd,CAAC,CAAC;oBACE,OAAO,EAAE;wBACP,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa;wBACzC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY;4BAC3B,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;4BAC7C,CAAC,CAAC,EAAE,CAAC;wBACP,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;qBACnC;iBACF;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC,CAAA;IACL,CAAC,CAAA;AACH,CAAC","sourcesContent":["import {\n  buildBrandlabMetadata,\n  type BrandlabSeoMetadata,\n} from '@brandlab-digital/site-core/metadata'\nimport {\n  getRouteById,\n  resolveBrandlabRouteIndexing,\n  type BrandlabRouteCatalog,\n} from '@brandlab-digital/site-core/routes'\nimport { defineSeoPage, type BrandlabSeoPage } from '@brandlab-digital/site-core/seo-page'\nimport type { BrandlabSite } from '@brandlab-digital/site-core/site'\n\nexport type NextCompatibleMetadata = Omit<\n  BrandlabSeoMetadata,\n  'canonicalPath' | 'canonicalUrl' | 'resolvedTitle'\n>\n\nexport function toNextMetadata(metadata: BrandlabSeoMetadata): NextCompatibleMetadata {\n  const { canonicalPath: _canonicalPath, canonicalUrl: _canonicalUrl, resolvedTitle: _resolvedTitle, ...next } =\n    metadata\n  return next\n}\n\n/**\n * The project's one page-metadata binding (`src/lib/seo/metadata.ts`):\n * `export const pageMetadata = createRouteMetadataBuilder(site, routes)`.\n * Canonical path and robots come from the route catalogue; the title mode is\n * explicit per page. Keywords keep their form: a comma-separated string renders\n * exactly as given, a list renders joined with commas, as Next renders them.\n */\nexport function createRouteMetadataBuilder(\n  site: BrandlabSite,\n  routes: BrandlabRouteCatalog,\n) {\n  return (input: BrandlabSeoPage): NextCompatibleMetadata => {\n    const page = defineSeoPage(input)\n    const route = getRouteById(routes, page.routeId)\n    if (!route) throw new Error(`Unknown metadata route ID \"${page.routeId}\".`)\n\n    return toNextMetadata(buildBrandlabMetadata({\n      brandName: site.name,\n      siteUrl: site.canonicalUrl,\n      locale: site.locale,\n      titleTemplate: site.titleTemplate,\n      defaultSocialImage: site.defaultSocialImage,\n      title: page.title,\n      description: page.description,\n      pathname: route.canonicalPath ?? route.path,\n      indexing: resolveBrandlabRouteIndexing(route),\n      ...(page.titleMode ? { titleMode: page.titleMode } : {}),\n      ...(page.keywords !== undefined ? { keywords: page.keywords } : {}),\n      ...(page.socialImage ? { socialImage: page.socialImage } : {}),\n      ...(page.article\n        ? {\n            article: {\n              publishedTime: page.article.publishedTime,\n              ...(page.article.modifiedTime\n                ? { modifiedTime: page.article.modifiedTime }\n                : {}),\n              authors: [...page.article.authors],\n            },\n          }\n        : {}),\n    }))\n  }\n}\n"]}

package/dist/next-config.d.ts

@@ -0,0 +1,113 @@
+import { type BrandlabRedirectTable } from '@brandlab-digital/site-core/redirects';
+import { type BrandlabDeploymentEnvironment, type BrandlabEnvironment, type BrandlabSite } from '@brandlab-digital/site-core/site';
+import { type BrandlabContentSecurityPolicyExtensions, type BrandlabHeader, type BrandlabHeaderRule, type BrandlabHstsExpansion } from './headers.js';
+/** Next redirect records: 308 stays `permanent: true`, 301 stays `statusCode: 301`. */
+export type BrandlabNextRedirect = {
+    source: string;
+    destination: string;
+    has?: {
+        type: 'host';
+        value: string;
+    }[];
+} & ({
+    permanent: true;
+    statusCode?: never;
+} | {
+    statusCode: 301;
+    permanent?: never;
+});
+export interface BrandlabNextRemotePattern {
+    protocol?: 'http' | 'https';
+    hostname: string;
+    port?: string;
+    pathname?: string;
+    search?: string;
+}
+/** The site's own image settings; the output format is always WebP. */
+export interface BrandlabNextImagesOptions {
+    deviceSizes?: readonly number[];
+    imageSizes?: readonly number[];
+    qualities?: readonly number[];
+    minimumCacheTTL?: number;
+    remotePatterns?: readonly BrandlabNextRemotePattern[];
+}
+export interface BrandlabNextImagesConfig {
+    formats: 'image/webp'[];
+    deviceSizes?: number[];
+    imageSizes?: number[];
+    qualities?: number[];
+    minimumCacheTTL?: number;
+    remotePatterns?: BrandlabNextRemotePattern[];
+}
+export interface BrandlabNextConfig {
+    poweredByHeader: false;
+    /** Trailing slashes are handled by single-hop redirect rules instead. */
+    skipTrailingSlashRedirect: true;
+    env: {
+        NEXT_PUBLIC_VERCEL_ENV: BrandlabDeploymentEnvironment;
+    };
+    outputFileTracingIncludes: Record<string, string[]>;
+    images: BrandlabNextImagesConfig;
+    pageExtensions?: string[];
+    headers: () => Promise<BrandlabHeaderRule[]>;
+    redirects: () => Promise<BrandlabNextRedirect[]>;
+}
+export interface BrandlabNextConfigOptions {
+    site: BrandlabSite;
+    /** The src/data/redirects.ts table (defineRedirects). */
+    redirects: BrandlabRedirectTable;
+    images: BrandlabNextImagesOptions;
+    /** Reviewed CSP origins for declared integrations such as Meta Pixel or map embeds. */
+    csp?: BrandlabContentSecurityPolicyExtensions;
+    hsts?: BrandlabHstsExpansion;
+    /** Reviewed exception to the default Permissions-Policy that is already live. */
+    permissionsPolicy?: string;
+    /** Reviewed response headers that are already live; protected headers cannot be replaced. */
+    extraHeaders?: readonly BrandlabHeader[];
+    /**
+     * Public folders of static files that never change in place, written as Next
+     * sources such as `['/images/:path*', '/fonts/:path*']`. Production builds serve
+     * their files (names with an extension) with `public, max-age=31536000, immutable`;
+     * Previews keep `private, no-store`. Each folder must exist under `public/`, and
+     * no route under `src/app` or `app` may answer below it.
+     */
+    staticAssetCache?: readonly string[];
+    /** Defaults to process.env; tests supply a fixed environment. */
+    environment?: BrandlabEnvironment;
+    /** The project root for the staticAssetCache checks; defaults to process.cwd(). */
+    projectRoot?: string;
+}
+/** Sharp's Linux binaries must travel with the contact route's image sanitiser. */
+export declare const BRANDLAB_CONTACT_OUTPUT_FILE_TRACING: Readonly<{
+    '/api/contact': readonly string[];
+}>;
+/**
+ * Converts the redirect table to Next redirects: each entry keeps its 301 or
+ * 308 status (Next forwards the query string), gains a single-hop
+ * trailing-slash variant, then one trailing-slash rule and one permanent
+ * canonical-host rule per alias host follow. There is no x-forwarded-proto
+ * rule: Vercel's edge already enforces HTTPS.
+ */
+export declare function buildBrandlabRedirects(options: {
+    site: BrandlabSite;
+    redirects: BrandlabRedirectTable;
+}): BrandlabNextRedirect[];
+/**
+ * The whole next.config.ts after its first line
+ * `import '@brandlab-digital/site-next/image-runtime'`:
+ * `export default defineBrandlabNextConfig({ site, redirects, images })`.
+ *
+ * Sets poweredByHeader: false, WebP image output, Sharp output tracing for
+ * /api/contact, NEXT_PUBLIC_VERCEL_ENV for browser gates, the deployment's
+ * header rules (with immutable caching for the declared static public folders on
+ * production builds) and the redirect table. Validation runs when the config
+ * loads, so an invalid table, header exception or static folder fails the build.
+ */
+export declare function defineBrandlabNextConfig(options: BrandlabNextConfigOptions & {
+    mdx?: undefined;
+}): BrandlabNextConfig;
+export declare function defineBrandlabNextConfig<Wrapped>(options: BrandlabNextConfigOptions & {
+    /** The @next/mdx wrapper: createMDX({ options: { remarkPlugins: ['remark-gfm'] } }). */
+    mdx: (config: BrandlabNextConfig) => Wrapped;
+}): Wrapped;
+//# sourceMappingURL=next-config.d.ts.map

package/dist/next-config.d.ts.map

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

package/dist/next-config.js

@@ -0,0 +1,213 @@
+import { readdirSync, statSync } from 'node:fs';
+import { join, posix } from 'node:path';
+import { defineRedirects } from '@brandlab-digital/site-core/redirects';
+import { resolveBrandlabDeployment, } from '@brandlab-digital/site-core/site';
+import { buildBrandlabHeaderRules, parseBrandlabStaticAssetCache, } from './headers.js';
+/** Sharp's Linux binaries must travel with the contact route's image sanitiser. */
+export const BRANDLAB_CONTACT_OUTPUT_FILE_TRACING = Object.freeze({
+    '/api/contact': Object.freeze([
+        'node_modules/sharp/**/*',
+        'node_modules/@img/sharp-linux-x64/**/*',
+        'node_modules/@img/sharp-libvips-linux-x64/**/*',
+    ]),
+});
+const MDX_PAGE_EXTENSIONS = ['tsx', 'ts', 'jsx', 'js', 'mdx', 'md'];
+const OPTION_KEYS = new Set([
+    'site',
+    'redirects',
+    'images',
+    'csp',
+    'hsts',
+    'permissionsPolicy',
+    'extraHeaders',
+    'staticAssetCache',
+    'mdx',
+    'environment',
+    'projectRoot',
+]);
+const IMAGE_KEYS = new Set(['deviceSizes', 'imageSizes', 'qualities', 'minimumCacheTTL', 'remotePatterns']);
+function assertKnownKeys(value, allowed, field, hint = '') {
+    const unsupported = Object.keys(value).filter((key) => !allowed.has(key));
+    if (unsupported.length > 0) {
+        throw new Error(`${field} contains unsupported keys: ${unsupported.join(', ')}.${hint}`);
+    }
+}
+function positiveIntegers(values, field) {
+    if (values === undefined)
+        return undefined;
+    if (!Array.isArray(values) ||
+        values.length === 0 ||
+        values.some((value) => !Number.isSafeInteger(value) || value < 1)) {
+        throw new Error(`images.${field} must list positive integers.`);
+    }
+    return [...values];
+}
+function buildImagesConfig(images) {
+    if (!images || typeof images !== 'object' || Array.isArray(images)) {
+        throw new Error('images must declare the site image settings ({} for Next defaults).');
+    }
+    assertKnownKeys(images, IMAGE_KEYS, 'images', ' The output format is always image/webp.');
+    const deviceSizes = positiveIntegers(images.deviceSizes, 'deviceSizes');
+    const imageSizes = positiveIntegers(images.imageSizes, 'imageSizes');
+    const qualities = positiveIntegers(images.qualities, 'qualities');
+    if (qualities?.some((quality) => quality > 100)) {
+        throw new Error('images.qualities must be between 1 and 100.');
+    }
+    if (images.minimumCacheTTL !== undefined &&
+        (!Number.isSafeInteger(images.minimumCacheTTL) || images.minimumCacheTTL < 0)) {
+        throw new Error('images.minimumCacheTTL must be a non-negative integer of seconds.');
+    }
+    if (images.remotePatterns !== undefined && !Array.isArray(images.remotePatterns)) {
+        throw new Error('images.remotePatterns must be an array.');
+    }
+    return {
+        formats: ['image/webp'],
+        ...(deviceSizes ? { deviceSizes } : {}),
+        ...(imageSizes ? { imageSizes } : {}),
+        ...(qualities ? { qualities } : {}),
+        ...(images.minimumCacheTTL !== undefined ? { minimumCacheTTL: images.minimumCacheTTL } : {}),
+        ...(images.remotePatterns
+            ? { remotePatterns: images.remotePatterns.map((pattern) => ({ ...pattern })) }
+            : {}),
+    };
+}
+const PAGE_OR_ROUTE_FILE = /^(?:page|route)\.[A-Za-z0-9]+$/;
+const METADATA_ROUTE_FILE = /^(?:opengraph-image|twitter-image|icon|apple-icon|sitemap|robots|manifest)(?:[\w.-]*)\.[A-Za-z0-9]+$/;
+function isDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The first route file under an app directory that can answer a path strictly
+ * below `/<folder>/`. `depth` counts the folder segments matched so far: route
+ * groups, intercepts and parallel slots add none, a dynamic segment matches any
+ * one, and a catch-all reaches every path below the folder.
+ */
+function routeBelowFolder(directory, folder, depth, relative) {
+    for (const entry of readdirSync(directory, { withFileTypes: true })) {
+        const name = entry.name;
+        if (name.startsWith('_') || name.startsWith('.') || name === 'node_modules')
+            continue;
+        const path = join(directory, name);
+        const nextRelative = posix.join(relative, name);
+        if (entry.isFile()) {
+            // Page and route files serve their own directory; metadata files serve a path below it.
+            const below = depth > folder.length && PAGE_OR_ROUTE_FILE.test(name);
+            const metadata = depth >= folder.length && METADATA_ROUTE_FILE.test(name);
+            if (below || metadata)
+                return nextRelative;
+            continue;
+        }
+        if (!entry.isDirectory())
+            continue;
+        let next = null;
+        if (name.startsWith('(') || name.startsWith('@'))
+            next = depth;
+        else if (/^\[\[?\.\.\./.test(name))
+            next = folder.length + 1;
+        else if (depth >= folder.length || name.startsWith('[') || name === folder[depth])
+            next = depth + 1;
+        if (next === null)
+            continue;
+        const found = routeBelowFolder(path, folder, next, nextRelative);
+        if (found)
+            return found;
+    }
+    return null;
+}
+/** Each declared folder exists under public/ and no app route answers below it. */
+function assertStaticAssetFolders(folders, root) {
+    for (const { source, folder } of folders) {
+        const publicFolder = posix.join('public', ...folder);
+        if (!isDirectory(join(root, publicFolder))) {
+            throw new Error(`staticAssetCache "${source}": ${publicFolder} is not a folder of static files in ${root}.`);
+        }
+        for (const appDirectory of ['src/app', 'app']) {
+            if (!isDirectory(join(root, appDirectory)))
+                continue;
+            const route = routeBelowFolder(join(root, appDirectory), folder, 0, appDirectory);
+            if (route) {
+                throw new Error(`staticAssetCache "${source}": ${route} answers below /${folder.join('/')}, so immutable caching could reach a page or route.`);
+            }
+        }
+    }
+}
+/**
+ * Converts the redirect table to Next redirects: each entry keeps its 301 or
+ * 308 status (Next forwards the query string), gains a single-hop
+ * trailing-slash variant, then one trailing-slash rule and one permanent
+ * canonical-host rule per alias host follow. There is no x-forwarded-proto
+ * rule: Vercel's edge already enforces HTTPS.
+ */
+export function buildBrandlabRedirects(options) {
+    const table = defineRedirects(options.redirects);
+    const entries = table.flatMap((redirect) => {
+        const status = redirect.status === 301
+            ? { statusCode: 301 }
+            : { permanent: true };
+        const has = redirect.host ? { has: [{ type: 'host', value: redirect.host }] } : {};
+        const record = (source) => ({
+            source,
+            destination: redirect.destination,
+            ...status,
+            ...has,
+        });
+        return redirect.source === '/'
+            ? [record(redirect.source)]
+            : [record(redirect.source), record(`${redirect.source}/`)];
+    });
+    return [
+        ...entries,
+        { source: '/:path+/', destination: '/:path+', permanent: true },
+        ...options.site.aliasHosts.map((host) => ({
+            source: '/:path*',
+            has: [{ type: 'host', value: host }],
+            destination: `${options.site.canonicalUrl}/:path*`,
+            permanent: true,
+        })),
+    ];
+}
+export function defineBrandlabNextConfig(options) {
+    if (!options || typeof options !== 'object') {
+        throw new TypeError('defineBrandlabNextConfig requires the site, redirects and images.');
+    }
+    assertKnownKeys(options, OPTION_KEYS, 'next.config options');
+    if (!options.site?.canonicalUrl || !Array.isArray(options.site.aliasHosts)) {
+        throw new Error('site must come from defineBrandlabSite.');
+    }
+    if (options.mdx !== undefined && typeof options.mdx !== 'function') {
+        throw new TypeError('mdx must be the @next/mdx config wrapper.');
+    }
+    const deployment = resolveBrandlabDeployment(options.environment ?? process.env);
+    if (options.staticAssetCache !== undefined) {
+        assertStaticAssetFolders(parseBrandlabStaticAssetCache(options.staticAssetCache), options.projectRoot ?? process.cwd());
+    }
+    const headerRules = buildBrandlabHeaderRules({
+        deployment,
+        ...(options.csp ? { contentSecurityPolicyExtensions: options.csp } : {}),
+        ...(options.hsts ? { hsts: options.hsts } : {}),
+        ...(options.permissionsPolicy ? { permissionsPolicy: options.permissionsPolicy } : {}),
+        ...(options.extraHeaders ? { extraHeaders: options.extraHeaders } : {}),
+        ...(options.staticAssetCache ? { staticAssetCache: options.staticAssetCache } : {}),
+    });
+    const redirects = buildBrandlabRedirects({ site: options.site, redirects: options.redirects });
+    const config = {
+        poweredByHeader: false,
+        skipTrailingSlashRedirect: true,
+        env: { NEXT_PUBLIC_VERCEL_ENV: deployment.environment },
+        outputFileTracingIncludes: Object.fromEntries(Object.entries(BRANDLAB_CONTACT_OUTPUT_FILE_TRACING).map(([route, globs]) => [route, [...globs]])),
+        images: buildImagesConfig(options.images),
+        ...(options.mdx ? { pageExtensions: [...MDX_PAGE_EXTENSIONS] } : {}),
+        headers: async () => headerRules.map((rule) => ({ source: rule.source, headers: rule.headers.map((header) => ({ ...header })) })),
+        redirects: async () => redirects.map((redirect) => ({
+            ...redirect,
+            ...(redirect.has ? { has: redirect.has.map((condition) => ({ ...condition })) } : {}),
+        })),
+    };
+    return options.mdx ? options.mdx(config) : config;
+}
+//# sourceMappingURL=next-config.js.map

package/dist/next-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-config.js","sourceRoot":"","sources":["../src/next-config.ts"],"names":[],"mappings":"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","sourcesContent":["import { readdirSync, statSync } from 'node:fs'\nimport { join, posix } from 'node:path'\nimport { defineRedirects, type BrandlabRedirectTable } from '@brandlab-digital/site-core/redirects'\nimport {\n  resolveBrandlabDeployment,\n  type BrandlabDeploymentEnvironment,\n  type BrandlabEnvironment,\n  type BrandlabSite,\n} from '@brandlab-digital/site-core/site'\nimport {\n  buildBrandlabHeaderRules,\n  parseBrandlabStaticAssetCache,\n  type BrandlabContentSecurityPolicyExtensions,\n  type BrandlabHeader,\n  type BrandlabHeaderRule,\n  type BrandlabHstsExpansion,\n  type BrandlabStaticAssetFolder,\n} from './headers.js'\n\n/** Next redirect records: 308 stays `permanent: true`, 301 stays `statusCode: 301`. */\nexport type BrandlabNextRedirect = {\n  source: string\n  destination: string\n  has?: { type: 'host'; value: string }[]\n} & ({ permanent: true; statusCode?: never } | { statusCode: 301; permanent?: never })\n\nexport interface BrandlabNextRemotePattern {\n  protocol?: 'http' | 'https'\n  hostname: string\n  port?: string\n  pathname?: string\n  search?: string\n}\n\n/** The site's own image settings; the output format is always WebP. */\nexport interface BrandlabNextImagesOptions {\n  deviceSizes?: readonly number[]\n  imageSizes?: readonly number[]\n  qualities?: readonly number[]\n  minimumCacheTTL?: number\n  remotePatterns?: readonly BrandlabNextRemotePattern[]\n}\n\nexport interface BrandlabNextImagesConfig {\n  formats: 'image/webp'[]\n  deviceSizes?: number[]\n  imageSizes?: number[]\n  qualities?: number[]\n  minimumCacheTTL?: number\n  remotePatterns?: BrandlabNextRemotePattern[]\n}\n\nexport interface BrandlabNextConfig {\n  poweredByHeader: false\n  /** Trailing slashes are handled by single-hop redirect rules instead. */\n  skipTrailingSlashRedirect: true\n  env: { NEXT_PUBLIC_VERCEL_ENV: BrandlabDeploymentEnvironment }\n  outputFileTracingIncludes: Record<string, string[]>\n  images: BrandlabNextImagesConfig\n  pageExtensions?: string[]\n  headers: () => Promise<BrandlabHeaderRule[]>\n  redirects: () => Promise<BrandlabNextRedirect[]>\n}\n\nexport interface BrandlabNextConfigOptions {\n  site: BrandlabSite\n  /** The src/data/redirects.ts table (defineRedirects). */\n  redirects: BrandlabRedirectTable\n  images: BrandlabNextImagesOptions\n  /** Reviewed CSP origins for declared integrations such as Meta Pixel or map embeds. */\n  csp?: BrandlabContentSecurityPolicyExtensions\n  hsts?: BrandlabHstsExpansion\n  /** Reviewed exception to the default Permissions-Policy that is already live. */\n  permissionsPolicy?: string\n  /** Reviewed response headers that are already live; protected headers cannot be replaced. */\n  extraHeaders?: readonly BrandlabHeader[]\n  /**\n   * Public folders of static files that never change in place, written as Next\n   * sources such as `['/images/:path*', '/fonts/:path*']`. Production builds serve\n   * their files (names with an extension) with `public, max-age=31536000, immutable`;\n   * Previews keep `private, no-store`. Each folder must exist under `public/`, and\n   * no route under `src/app` or `app` may answer below it.\n   */\n  staticAssetCache?: readonly string[]\n  /** Defaults to process.env; tests supply a fixed environment. */\n  environment?: BrandlabEnvironment\n  /** The project root for the staticAssetCache checks; defaults to process.cwd(). */\n  projectRoot?: string\n}\n\n/** Sharp's Linux binaries must travel with the contact route's image sanitiser. */\nexport const BRANDLAB_CONTACT_OUTPUT_FILE_TRACING = Object.freeze({\n  '/api/contact': Object.freeze([\n    'node_modules/sharp/**/*',\n    'node_modules/@img/sharp-linux-x64/**/*',\n    'node_modules/@img/sharp-libvips-linux-x64/**/*',\n  ]),\n})\n\nconst MDX_PAGE_EXTENSIONS = ['tsx', 'ts', 'jsx', 'js', 'mdx', 'md']\nconst OPTION_KEYS = new Set([\n  'site',\n  'redirects',\n  'images',\n  'csp',\n  'hsts',\n  'permissionsPolicy',\n  'extraHeaders',\n  'staticAssetCache',\n  'mdx',\n  'environment',\n  'projectRoot',\n])\nconst IMAGE_KEYS = new Set(['deviceSizes', 'imageSizes', 'qualities', 'minimumCacheTTL', 'remotePatterns'])\n\nfunction assertKnownKeys(value: object, allowed: ReadonlySet<string>, field: string, hint = '') {\n  const unsupported = Object.keys(value).filter((key) => !allowed.has(key))\n  if (unsupported.length > 0) {\n    throw new Error(`${field} contains unsupported keys: ${unsupported.join(', ')}.${hint}`)\n  }\n}\n\nfunction positiveIntegers(values: readonly number[] | undefined, field: string) {\n  if (values === undefined) return undefined\n  if (\n    !Array.isArray(values) ||\n    values.length === 0 ||\n    values.some((value) => !Number.isSafeInteger(value) || value < 1)\n  ) {\n    throw new Error(`images.${field} must list positive integers.`)\n  }\n  return [...values]\n}\n\nfunction buildImagesConfig(images: BrandlabNextImagesOptions): BrandlabNextImagesConfig {\n  if (!images || typeof images !== 'object' || Array.isArray(images)) {\n    throw new Error('images must declare the site image settings ({} for Next defaults).')\n  }\n  assertKnownKeys(images, IMAGE_KEYS, 'images', ' The output format is always image/webp.')\n  const deviceSizes = positiveIntegers(images.deviceSizes, 'deviceSizes')\n  const imageSizes = positiveIntegers(images.imageSizes, 'imageSizes')\n  const qualities = positiveIntegers(images.qualities, 'qualities')\n  if (qualities?.some((quality) => quality > 100)) {\n    throw new Error('images.qualities must be between 1 and 100.')\n  }\n  if (\n    images.minimumCacheTTL !== undefined &&\n    (!Number.isSafeInteger(images.minimumCacheTTL) || images.minimumCacheTTL < 0)\n  ) {\n    throw new Error('images.minimumCacheTTL must be a non-negative integer of seconds.')\n  }\n  if (images.remotePatterns !== undefined && !Array.isArray(images.remotePatterns)) {\n    throw new Error('images.remotePatterns must be an array.')\n  }\n  return {\n    formats: ['image/webp'],\n    ...(deviceSizes ? { deviceSizes } : {}),\n    ...(imageSizes ? { imageSizes } : {}),\n    ...(qualities ? { qualities } : {}),\n    ...(images.minimumCacheTTL !== undefined ? { minimumCacheTTL: images.minimumCacheTTL } : {}),\n    ...(images.remotePatterns\n      ? { remotePatterns: images.remotePatterns.map((pattern) => ({ ...pattern })) }\n      : {}),\n  }\n}\n\nconst PAGE_OR_ROUTE_FILE = /^(?:page|route)\\.[A-Za-z0-9]+$/\nconst METADATA_ROUTE_FILE = /^(?:opengraph-image|twitter-image|icon|apple-icon|sitemap|robots|manifest)(?:[\\w.-]*)\\.[A-Za-z0-9]+$/\n\nfunction isDirectory(path: string) {\n  try {\n    return statSync(path).isDirectory()\n  } catch {\n    return false\n  }\n}\n\n/**\n * The first route file under an app directory that can answer a path strictly\n * below `/<folder>/`. `depth` counts the folder segments matched so far: route\n * groups, intercepts and parallel slots add none, a dynamic segment matches any\n * one, and a catch-all reaches every path below the folder.\n */\nfunction routeBelowFolder(\n  directory: string,\n  folder: readonly string[],\n  depth: number,\n  relative: string,\n): string | null {\n  for (const entry of readdirSync(directory, { withFileTypes: true })) {\n    const name = entry.name\n    if (name.startsWith('_') || name.startsWith('.') || name === 'node_modules') continue\n    const path = join(directory, name)\n    const nextRelative = posix.join(relative, name)\n    if (entry.isFile()) {\n      // Page and route files serve their own directory; metadata files serve a path below it.\n      const below = depth > folder.length && PAGE_OR_ROUTE_FILE.test(name)\n      const metadata = depth >= folder.length && METADATA_ROUTE_FILE.test(name)\n      if (below || metadata) return nextRelative\n      continue\n    }\n    if (!entry.isDirectory()) continue\n    let next: number | null = null\n    if (name.startsWith('(') || name.startsWith('@')) next = depth\n    else if (/^\\[\\[?\\.\\.\\./.test(name)) next = folder.length + 1\n    else if (depth >= folder.length || name.startsWith('[') || name === folder[depth]) next = depth + 1\n    if (next === null) continue\n    const found = routeBelowFolder(path, folder, next, nextRelative)\n    if (found) return found\n  }\n  return null\n}\n\n/** Each declared folder exists under public/ and no app route answers below it. */\nfunction assertStaticAssetFolders(folders: readonly BrandlabStaticAssetFolder[], root: string) {\n  for (const { source, folder } of folders) {\n    const publicFolder = posix.join('public', ...folder)\n    if (!isDirectory(join(root, publicFolder))) {\n      throw new Error(`staticAssetCache \"${source}\": ${publicFolder} is not a folder of static files in ${root}.`)\n    }\n    for (const appDirectory of ['src/app', 'app']) {\n      if (!isDirectory(join(root, appDirectory))) continue\n      const route = routeBelowFolder(join(root, appDirectory), folder, 0, appDirectory)\n      if (route) {\n        throw new Error(\n          `staticAssetCache \"${source}\": ${route} answers below /${folder.join('/')}, so immutable caching could reach a page or route.`,\n        )\n      }\n    }\n  }\n}\n\n/**\n * Converts the redirect table to Next redirects: each entry keeps its 301 or\n * 308 status (Next forwards the query string), gains a single-hop\n * trailing-slash variant, then one trailing-slash rule and one permanent\n * canonical-host rule per alias host follow. There is no x-forwarded-proto\n * rule: Vercel's edge already enforces HTTPS.\n */\nexport function buildBrandlabRedirects(options: {\n  site: BrandlabSite\n  redirects: BrandlabRedirectTable\n}): BrandlabNextRedirect[] {\n  const table = defineRedirects(options.redirects)\n  const entries = table.flatMap((redirect): BrandlabNextRedirect[] => {\n    const status = redirect.status === 301\n      ? { statusCode: 301 as const }\n      : { permanent: true as const }\n    const has = redirect.host ? { has: [{ type: 'host' as const, value: redirect.host }] } : {}\n    const record = (source: string): BrandlabNextRedirect => ({\n      source,\n      destination: redirect.destination,\n      ...status,\n      ...has,\n    })\n    return redirect.source === '/'\n      ? [record(redirect.source)]\n      : [record(redirect.source), record(`${redirect.source}/`)]\n  })\n  return [\n    ...entries,\n    { source: '/:path+/', destination: '/:path+', permanent: true },\n    ...options.site.aliasHosts.map((host): BrandlabNextRedirect => ({\n      source: '/:path*',\n      has: [{ type: 'host', value: host }],\n      destination: `${options.site.canonicalUrl}/:path*`,\n      permanent: true,\n    })),\n  ]\n}\n\n/**\n * The whole next.config.ts after its first line\n * `import '@brandlab-digital/site-next/image-runtime'`:\n * `export default defineBrandlabNextConfig({ site, redirects, images })`.\n *\n * Sets poweredByHeader: false, WebP image output, Sharp output tracing for\n * /api/contact, NEXT_PUBLIC_VERCEL_ENV for browser gates, the deployment's\n * header rules (with immutable caching for the declared static public folders on\n * production builds) and the redirect table. Validation runs when the config\n * loads, so an invalid table, header exception or static folder fails the build.\n */\nexport function defineBrandlabNextConfig(\n  options: BrandlabNextConfigOptions & { mdx?: undefined },\n): BrandlabNextConfig\nexport function defineBrandlabNextConfig<Wrapped>(\n  options: BrandlabNextConfigOptions & {\n    /** The @next/mdx wrapper: createMDX({ options: { remarkPlugins: ['remark-gfm'] } }). */\n    mdx: (config: BrandlabNextConfig) => Wrapped\n  },\n): Wrapped\nexport function defineBrandlabNextConfig(\n  options: BrandlabNextConfigOptions & { mdx?: (config: BrandlabNextConfig) => unknown },\n): unknown {\n  if (!options || typeof options !== 'object') {\n    throw new TypeError('defineBrandlabNextConfig requires the site, redirects and images.')\n  }\n  assertKnownKeys(options, OPTION_KEYS, 'next.config options')\n  if (!options.site?.canonicalUrl || !Array.isArray(options.site.aliasHosts)) {\n    throw new Error('site must come from defineBrandlabSite.')\n  }\n  if (options.mdx !== undefined && typeof options.mdx !== 'function') {\n    throw new TypeError('mdx must be the @next/mdx config wrapper.')\n  }\n  const deployment = resolveBrandlabDeployment(options.environment ?? process.env)\n  if (options.staticAssetCache !== undefined) {\n    assertStaticAssetFolders(\n      parseBrandlabStaticAssetCache(options.staticAssetCache),\n      options.projectRoot ?? process.cwd(),\n    )\n  }\n  const headerRules = buildBrandlabHeaderRules({\n    deployment,\n    ...(options.csp ? { contentSecurityPolicyExtensions: options.csp } : {}),\n    ...(options.hsts ? { hsts: options.hsts } : {}),\n    ...(options.permissionsPolicy ? { permissionsPolicy: options.permissionsPolicy } : {}),\n    ...(options.extraHeaders ? { extraHeaders: options.extraHeaders } : {}),\n    ...(options.staticAssetCache ? { staticAssetCache: options.staticAssetCache } : {}),\n  })\n  const redirects = buildBrandlabRedirects({ site: options.site, redirects: options.redirects })\n\n  const config: BrandlabNextConfig = {\n    poweredByHeader: false,\n    skipTrailingSlashRedirect: true,\n    env: { NEXT_PUBLIC_VERCEL_ENV: deployment.environment },\n    outputFileTracingIncludes: Object.fromEntries(\n      Object.entries(BRANDLAB_CONTACT_OUTPUT_FILE_TRACING).map(([route, globs]) => [route, [...globs]]),\n    ),\n    images: buildImagesConfig(options.images),\n    ...(options.mdx ? { pageExtensions: [...MDX_PAGE_EXTENSIONS] } : {}),\n    headers: async () =>\n      headerRules.map((rule) => ({ source: rule.source, headers: rule.headers.map((header) => ({ ...header })) })),\n    redirects: async () =>\n      redirects.map((redirect) => ({\n        ...redirect,\n        ...(redirect.has ? { has: redirect.has.map((condition) => ({ ...condition })) } : {}),\n      })),\n  }\n  return options.mdx ? options.mdx(config) : config\n}\n"]}

package/dist/robots.d.ts

@@ -1,3 +1,4 @@
+import { type BrandlabDeployment, type BrandlabEnvironment, type BrandlabSite } from '@brandlab-digital/site-core/site';
 export interface BrandlabRobotsMetadata {
     rules: Array<{
         userAgent: string;
@@ -6,10 +7,17 @@ export interface BrandlabRobotsMetadata {
     }>;
     sitemap?: string;
 }
-export declare function buildRobotsMetadata(options: {
-    siteUrl: string;
-    nodeEnv?: string;
-    vercelEnv?: string;
-    allowIndexing?: string;
-}): BrandlabRobotsMetadata;
+/**
+ * Crawlers may index any production build except a Vercel Preview: the real
+ * production deployment and a local `next start`. `next dev` and every
+ * Preview are closed. There is no environment override.
+ */
+export declare function isBrandlabIndexableDeployment(deployment: BrandlabDeployment): boolean;
+/**
+ * `src/app/robots.ts`: `export default createBrandlabRobots(site)`.
+ * The deployment is resolved when Next renders robots.txt.
+ */
+export declare function createBrandlabRobots(site: BrandlabSite, options?: {
+    environment?: BrandlabEnvironment;
+}): () => BrandlabRobotsMetadata;
 //# sourceMappingURL=robots.d.ts.map

package/dist/robots.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../src/robots.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,GAAG,sBAAsB,CAoBzB"}
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../src/robots.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,kCAAkC,CAAA;AAEzC,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,kBAAkB,WAG3E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,mBAAmB,CAAA;CAAO,SAGzB,sBAAsB,CAajD"}

package/dist/robots.js

@@ -1,22 +1,31 @@
-import { getAbsoluteUrl } from '@brandlab-digital/site-core/metadata';
-import { shouldIndexSite } from '@brandlab-digital/site-core/sitemaps';
-export function buildRobotsMetadata(options) {
-    const shouldIndex = shouldIndexSite({
-        nodeEnv: options.nodeEnv,
-        vercelEnv: options.vercelEnv,
-        allowIndexing: options.allowIndexing,
-    });
-    if (!shouldIndex) {
+import { resolveBrandlabDeployment, } from '@brandlab-digital/site-core/site';
+/**
+ * Crawlers may index any production build except a Vercel Preview: the real
+ * production deployment and a local `next start`. `next dev` and every
+ * Preview are closed. There is no environment override.
+ */
+export function isBrandlabIndexableDeployment(deployment) {
+    return deployment.environment === 'production' ||
+        (deployment.environment === 'development' && deployment.productionBuild);
+}
+/**
+ * `src/app/robots.ts`: `export default createBrandlabRobots(site)`.
+ * The deployment is resolved when Next renders robots.txt.
+ */
+export function createBrandlabRobots(site, options = {}) {
+    const sitemap = `${site.canonicalUrl}/sitemap.xml`;
+    return function robots() {
+        const deployment = resolveBrandlabDeployment(options.environment ?? process.env);
+        if (!isBrandlabIndexableDeployment(deployment)) {
+            return { rules: [{ userAgent: '*', disallow: '/' }] };
+        }
+        // No `host` directive: it is a non-standard robots.txt extension ignored
+        // by Google and Bing; canonical-host consolidation is owned by permanent
+        // redirects and canonical URLs.
         return {
-            rules: [{ userAgent: '*', disallow: '/' }],
+            rules: [{ userAgent: '*', allow: '/' }],
+            sitemap,
         };
-    }
-    // No `host` directive: it is a non-standard robots.txt extension ignored
-    // by Google and Bing; canonical-host consolidation is owned by permanent
-    // edge redirects + canonical URLs (Brandlab Project Standard §5).
-    return {
-        rules: [{ userAgent: '*', allow: '/' }],
-        sitemap: getAbsoluteUrl(options.siteUrl, '/sitemap.xml'),
     };
 }
 //# sourceMappingURL=robots.js.map

package/dist/robots.js.map

@@ -1 +1 @@
-{"version":3,"file":"robots.js","sourceRoot":"","sources":["../src/robots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAA;AAOtE,MAAM,UAAU,mBAAmB,CAAC,OAKnC;IACC,MAAM,WAAW,GAAG,eAAe,CAAC;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAA;IAEF,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;SAC3C,CAAA;IACH,CAAC;IAED,yEAAyE;IACzE,yEAAyE;IACzE,kEAAkE;IAClE,OAAO;QACL,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACvC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC;KACzD,CAAA;AACH,CAAC","sourcesContent":["import { getAbsoluteUrl } from '@brandlab-digital/site-core/metadata'\nimport { shouldIndexSite } from '@brandlab-digital/site-core/sitemaps'\n\nexport interface BrandlabRobotsMetadata {\n  rules: Array<{ userAgent: string; allow?: string; disallow?: string }>\n  sitemap?: string\n}\n\nexport function buildRobotsMetadata(options: {\n  siteUrl: string\n  nodeEnv?: string\n  vercelEnv?: string\n  allowIndexing?: string\n}): BrandlabRobotsMetadata {\n  const shouldIndex = shouldIndexSite({\n    nodeEnv: options.nodeEnv,\n    vercelEnv: options.vercelEnv,\n    allowIndexing: options.allowIndexing,\n  })\n\n  if (!shouldIndex) {\n    return {\n      rules: [{ userAgent: '*', disallow: '/' }],\n    }\n  }\n\n  // No `host` directive: it is a non-standard robots.txt extension ignored\n  // by Google and Bing; canonical-host consolidation is owned by permanent\n  // edge redirects + canonical URLs (Brandlab Project Standard §5).\n  return {\n    rules: [{ userAgent: '*', allow: '/' }],\n    sitemap: getAbsoluteUrl(options.siteUrl, '/sitemap.xml'),\n  }\n}\n"]}
+{"version":3,"file":"robots.js","sourceRoot":"","sources":["../src/robots.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,GAI1B,MAAM,kCAAkC,CAAA;AAOzC;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,UAA8B;IAC1E,OAAO,UAAU,CAAC,WAAW,KAAK,YAAY;QAC5C,CAAC,UAAU,CAAC,WAAW,KAAK,aAAa,IAAI,UAAU,CAAC,eAAe,CAAC,CAAA;AAC5E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAkB,EAClB,UAAiD,EAAE;IAEnD,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,YAAY,cAAc,CAAA;IAClD,OAAO,SAAS,MAAM;QACpB,MAAM,UAAU,GAAG,yBAAyB,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,CAAA;QAChF,IAAI,CAAC,6BAA6B,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/C,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,CAAA;QACvD,CAAC;QACD,yEAAyE;QACzE,yEAAyE;QACzE,gCAAgC;QAChC,OAAO;YACL,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;YACvC,OAAO;SACR,CAAA;IACH,CAAC,CAAA;AACH,CAAC","sourcesContent":["import {\n  resolveBrandlabDeployment,\n  type BrandlabDeployment,\n  type BrandlabEnvironment,\n  type BrandlabSite,\n} from '@brandlab-digital/site-core/site'\n\nexport interface BrandlabRobotsMetadata {\n  rules: Array<{ userAgent: string; allow?: string; disallow?: string }>\n  sitemap?: string\n}\n\n/**\n * Crawlers may index any production build except a Vercel Preview: the real\n * production deployment and a local `next start`. `next dev` and every\n * Preview are closed. There is no environment override.\n */\nexport function isBrandlabIndexableDeployment(deployment: BrandlabDeployment) {\n  return deployment.environment === 'production' ||\n    (deployment.environment === 'development' && deployment.productionBuild)\n}\n\n/**\n * `src/app/robots.ts`: `export default createBrandlabRobots(site)`.\n * The deployment is resolved when Next renders robots.txt.\n */\nexport function createBrandlabRobots(\n  site: BrandlabSite,\n  options: { environment?: BrandlabEnvironment } = {},\n) {\n  const sitemap = `${site.canonicalUrl}/sitemap.xml`\n  return function robots(): BrandlabRobotsMetadata {\n    const deployment = resolveBrandlabDeployment(options.environment ?? process.env)\n    if (!isBrandlabIndexableDeployment(deployment)) {\n      return { rules: [{ userAgent: '*', disallow: '/' }] }\n    }\n    // No `host` directive: it is a non-standard robots.txt extension ignored\n    // by Google and Bing; canonical-host consolidation is owned by permanent\n    // redirects and canonical URLs.\n    return {\n      rules: [{ userAgent: '*', allow: '/' }],\n      sitemap,\n    }\n  }\n}\n"]}

package/dist/sitemaps.d.ts

@@ -1,6 +1,40 @@
+import type { BrandlabRouteCatalog } from '@brandlab-digital/site-core/routes';
+import type { BrandlabSite } from '@brandlab-digital/site-core/site';
 import { type SitemapEntry } from '@brandlab-digital/site-core/sitemaps';
 export declare function sitemapXmlResponse(entries: readonly SitemapEntry[]): Response;
 export declare function sitemapIndexXmlResponse(paths: readonly string[], options: {
     absoluteUrl: (path: string) => string;
 }): Response;
+export type BrandlabSitemapMode = 'single' | 'split';
+export interface BrandlabSitemapRouteOptions {
+    /** `split` only when brandlab.config declares `sitemap.mode: 'split'`. */
+    mode: BrandlabSitemapMode;
+    /** Split mode: URLs per child sitemap (default 1000). */
+    maxUrlsPerSitemap?: number;
+}
+export interface BrandlabSitemapChunkRouteContext {
+    params: Promise<{
+        chunk: string;
+    }>;
+}
+export interface BrandlabSitemapRoute {
+    readonly mode: BrandlabSitemapMode;
+    /** `src/app/sitemap.xml/route.ts`: the URL set, or the sitemap index in split mode. */
+    GET(): Response;
+    /** Child sitemap paths listed by the index; empty in single mode. */
+    chunkPaths(): string[];
+    /** `src/app/sitemaps/[chunk]/route.ts` (split mode, with `dynamicParams = false`). */
+    chunk: {
+        generateStaticParams(): {
+            chunk: string;
+        }[];
+        GET(request: Request, context: BrandlabSitemapChunkRouteContext): Promise<Response>;
+    };
+}
+/**
+ * The route-catalogue sitemap. `lastmod` comes only from each route's
+ * `lastSignificantChange`, never from build time. Entries are resolved once,
+ * so an invalid catalogue fails the build.
+ */
+export declare function createBrandlabSitemapRoute(routes: BrandlabRouteCatalog, site: BrandlabSite, options?: BrandlabSitemapRouteOptions): BrandlabSitemapRoute;
 //# sourceMappingURL=sitemaps.d.ts.map

package/dist/sitemaps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sitemaps.d.ts","sourceRoot":"","sources":["../src/sitemaps.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,sCAAsC,CAAA;AAE7C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,QAAQ,CAI7E;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,EAAE;IAAE,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,GACjD,QAAQ,CAIV"}
+{"version":3,"file":"sitemaps.d.ts","sourceRoot":"","sources":["../src/sitemaps.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAqB,MAAM,oCAAoC,CAAA;AACjG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAOL,KAAK,YAAY,EAClB,MAAM,sCAAsC,CAAA;AAE7C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,QAAQ,CAI7E;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,EAAE;IAAE,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,GACjD,QAAQ,CAIV;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEpD,MAAM,WAAW,2BAA2B;IAC1C,0EAA0E;IAC1E,IAAI,EAAE,mBAAmB,CAAA;IACzB,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,gCAAgC;IAC/C,MAAM,EAAE,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAA;IAClC,uFAAuF;IACvF,GAAG,IAAI,QAAQ,CAAA;IACf,qEAAqE;IACrE,UAAU,IAAI,MAAM,EAAE,CAAA;IACtB,sFAAsF;IACtF,KAAK,EAAE;QACL,oBAAoB,IAAI;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;QAC3C,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;KACpF,CAAA;CACF;AAiCD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE,2BAAgD,GACxD,oBAAoB,CAsCtB"}