@brandlab-digital/site-core 2.0.0 → 3.0.0

package/dist/site.d.ts

@@ -0,0 +1,60 @@
+import { type BrandlabSocialImage } from './metadata.js';
+/**
+ * `production` and `preview` are real Vercel deployments. Everything else —
+ * `next dev`, a local `next start`, CI and tests — is `development`.
+ */
+export type BrandlabDeploymentEnvironment = 'production' | 'preview' | 'development';
+export interface BrandlabDeployment {
+    /** The single gate for production-only behaviour: analytics, contact delivery and Preview restrictions. */
+    readonly environment: BrandlabDeploymentEnvironment;
+    /**
+     * An optimised build (`NODE_ENV=production`), on Vercel or locally. Security
+     * headers and crawler access follow the build so a local `next start` serves
+     * exactly the production headers.
+     */
+    readonly productionBuild: boolean;
+}
+export type BrandlabEnvironment = Readonly<Record<string, string | undefined>>;
+/**
+ * Resolves the deployment once for every consumer (next.config headers,
+ * robots, analytics and contact delivery). Server code passes `process.env`;
+ * browser code passes `{ NEXT_PUBLIC_VERCEL_ENV: process.env.NEXT_PUBLIC_VERCEL_ENV }`,
+ * which `defineBrandlabNextConfig` inlines at build time.
+ *
+ * `VERCEL_ENV` wins over `NEXT_PUBLIC_VERCEL_ENV`. An unrecognised declared
+ * environment fails closed to `preview`: never analytics, never indexable.
+ */
+export declare function resolveBrandlabDeployment(environment: BrandlabEnvironment): BrandlabDeployment;
+export interface BrandlabSiteDefinition {
+    /** Public site name: Open Graph `siteName` and the brand guard for templated titles. */
+    name: string;
+    /** Canonical HTTPS origin written as a source constant, never read from the environment. */
+    canonicalUrl: string;
+    /** Open Graph locale, for example `en_AU`. */
+    locale: string;
+    /** Page title template with exactly one `%s`, for example `%s | Example Services`. */
+    titleTemplate: string;
+    defaultSocialImage: BrandlabSocialImage;
+    /**
+     * Hosts that permanently redirect every path to the canonical origin, such as
+     * the `www` host, the Vercel project host or a retired domain.
+     */
+    aliasHosts: readonly string[];
+}
+export interface BrandlabSite {
+    readonly name: string;
+    /** Canonical origin without a trailing slash, for example `https://example.com.au`. */
+    readonly canonicalUrl: string;
+    readonly canonicalHost: string;
+    readonly locale: string;
+    readonly titleTemplate: string;
+    readonly defaultSocialImage: Readonly<BrandlabSocialImage>;
+    readonly aliasHosts: readonly string[];
+}
+export declare function isBrandlabHostname(value: unknown): value is string;
+/**
+ * Declares the site-wide SEO identity once (`src/config/site.ts`). The result
+ * feeds metadata, robots, sitemaps, redirects and next.config.
+ */
+export declare function defineBrandlabSite(definition: BrandlabSiteDefinition): BrandlabSite;
+//# sourceMappingURL=site.d.ts.map

package/dist/site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,eAAe,CAAA;AAEtB;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,YAAY,GAAG,SAAS,GAAG,aAAa,CAAA;AAEpF,MAAM,WAAW,kBAAkB;IACjC,2GAA2G;IAC3G,QAAQ,CAAC,WAAW,EAAE,6BAA6B,CAAA;IACnD;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAClC;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;AAE9E;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,mBAAmB,GAAG,kBAAkB,CAe9F;AAED,MAAM,WAAW,sBAAsB;IACrC,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAA;IACZ,4FAA4F;IAC5F,YAAY,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,sFAAsF;IACtF,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB,EAAE,mBAAmB,CAAA;IACvC;;;OAGG;IACH,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uFAAuF;IACvF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAA;IAC1D,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC;AAyBD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAElE;AA0BD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,sBAAsB,GAAG,YAAY,CA4CnF"}

package/dist/site.js

@@ -0,0 +1,116 @@
+import { assertBrandlabSocialImage, } from './metadata.js';
+/**
+ * Resolves the deployment once for every consumer (next.config headers,
+ * robots, analytics and contact delivery). Server code passes `process.env`;
+ * browser code passes `{ NEXT_PUBLIC_VERCEL_ENV: process.env.NEXT_PUBLIC_VERCEL_ENV }`,
+ * which `defineBrandlabNextConfig` inlines at build time.
+ *
+ * `VERCEL_ENV` wins over `NEXT_PUBLIC_VERCEL_ENV`. An unrecognised declared
+ * environment fails closed to `preview`: never analytics, never indexable.
+ */
+export function resolveBrandlabDeployment(environment) {
+    if (!environment || typeof environment !== 'object') {
+        throw new TypeError('resolveBrandlabDeployment requires an environment record.');
+    }
+    const declared = (environment.VERCEL_ENV ?? environment.NEXT_PUBLIC_VERCEL_ENV)?.trim();
+    const deploymentEnvironment = !declared || declared === 'development'
+        ? 'development'
+        : declared === 'production'
+            ? 'production'
+            : 'preview';
+    return Object.freeze({
+        environment: deploymentEnvironment,
+        productionBuild: environment.NODE_ENV === 'production',
+    });
+}
+const SITE_KEYS = new Set([
+    'name',
+    'canonicalUrl',
+    'locale',
+    'titleTemplate',
+    'defaultSocialImage',
+    'aliasHosts',
+]);
+const HOSTNAME_PATTERN = /^(?=.{1,253}$)(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z][a-z0-9-]{0,61}[a-z0-9]$/;
+function assertSiteText(value, field, maximum) {
+    if (typeof value !== 'string' ||
+        !value.trim() ||
+        value.trim() !== value ||
+        value.length > maximum ||
+        /[\u0000-\u001f\u007f]/.test(value)) {
+        throw new Error(`${field} must be bounded, trimmed, single-line text.`);
+    }
+}
+export function isBrandlabHostname(value) {
+    return typeof value === 'string' && HOSTNAME_PATTERN.test(value);
+}
+function canonicalOrigin(value) {
+    assertSiteText(value, 'canonicalUrl', 2_048);
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error(`canonicalUrl must be an absolute HTTPS origin: "${value}".`);
+    }
+    if (url.protocol !== 'https:' ||
+        url.username ||
+        url.password ||
+        url.port ||
+        url.search ||
+        url.hash ||
+        (url.pathname !== '/' && url.pathname !== '') ||
+        value.replace(/\/$/, '') !== url.origin ||
+        !isBrandlabHostname(url.hostname)) {
+        throw new Error(`canonicalUrl must be an absolute HTTPS origin: "${value}".`);
+    }
+    return url;
+}
+/**
+ * Declares the site-wide SEO identity once (`src/config/site.ts`). The result
+ * feeds metadata, robots, sitemaps, redirects and next.config.
+ */
+export function defineBrandlabSite(definition) {
+    if (!definition || typeof definition !== 'object' || Array.isArray(definition)) {
+        throw new TypeError('defineBrandlabSite requires a site definition.');
+    }
+    const unsupported = Object.keys(definition).filter((key) => !SITE_KEYS.has(key));
+    if (unsupported.length > 0) {
+        throw new Error(`Site definition contains unsupported keys: ${unsupported.join(', ')}.`);
+    }
+    assertSiteText(definition.name, 'name', 160);
+    const origin = canonicalOrigin(definition.canonicalUrl);
+    assertSiteText(definition.locale, 'locale', 20);
+    if (!/^[a-z]{2}(?:_[A-Z]{2})?$/.test(definition.locale)) {
+        throw new Error('locale must use a language or language_REGION identifier.');
+    }
+    assertSiteText(definition.titleTemplate, 'titleTemplate', 240);
+    if ((definition.titleTemplate.match(/%s/g) ?? []).length !== 1) {
+        throw new Error('titleTemplate must contain exactly one %s placeholder.');
+    }
+    assertBrandlabSocialImage(definition.defaultSocialImage, 'defaultSocialImage');
+    if (!Array.isArray(definition.aliasHosts)) {
+        throw new Error('aliasHosts must list every host that redirects to the canonical origin.');
+    }
+    definition.aliasHosts.forEach((host, index) => {
+        if (!isBrandlabHostname(host)) {
+            throw new Error(`aliasHosts[${index}] must be a lowercase hostname without a scheme, port or path.`);
+        }
+        if (host === origin.hostname) {
+            throw new Error(`aliasHosts[${index}] cannot be the canonical host.`);
+        }
+    });
+    const duplicate = definition.aliasHosts.find((host, index) => definition.aliasHosts.indexOf(host) !== index);
+    if (duplicate)
+        throw new Error(`aliasHosts contains duplicate host "${duplicate}".`);
+    return Object.freeze({
+        name: definition.name,
+        canonicalUrl: origin.origin,
+        canonicalHost: origin.hostname,
+        locale: definition.locale,
+        titleTemplate: definition.titleTemplate,
+        defaultSocialImage: Object.freeze({ ...definition.defaultSocialImage }),
+        aliasHosts: Object.freeze([...definition.aliasHosts]),
+    });
+}
+//# sourceMappingURL=site.js.map

package/dist/site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  assertBrandlabSocialImage,\n  type BrandlabSocialImage,\n} from './metadata.js'\n\n/**\n * `production` and `preview` are real Vercel deployments. Everything else —\n * `next dev`, a local `next start`, CI and tests — is `development`.\n */\nexport type BrandlabDeploymentEnvironment = 'production' | 'preview' | 'development'\n\nexport interface BrandlabDeployment {\n  /** The single gate for production-only behaviour: analytics, contact delivery and Preview restrictions. */\n  readonly environment: BrandlabDeploymentEnvironment\n  /**\n   * An optimised build (`NODE_ENV=production`), on Vercel or locally. Security\n   * headers and crawler access follow the build so a local `next start` serves\n   * exactly the production headers.\n   */\n  readonly productionBuild: boolean\n}\n\nexport type BrandlabEnvironment = Readonly<Record<string, string | undefined>>\n\n/**\n * Resolves the deployment once for every consumer (next.config headers,\n * robots, analytics and contact delivery). Server code passes `process.env`;\n * browser code passes `{ NEXT_PUBLIC_VERCEL_ENV: process.env.NEXT_PUBLIC_VERCEL_ENV }`,\n * which `defineBrandlabNextConfig` inlines at build time.\n *\n * `VERCEL_ENV` wins over `NEXT_PUBLIC_VERCEL_ENV`. An unrecognised declared\n * environment fails closed to `preview`: never analytics, never indexable.\n */\nexport function resolveBrandlabDeployment(environment: BrandlabEnvironment): BrandlabDeployment {\n  if (!environment || typeof environment !== 'object') {\n    throw new TypeError('resolveBrandlabDeployment requires an environment record.')\n  }\n  const declared = (environment.VERCEL_ENV ?? environment.NEXT_PUBLIC_VERCEL_ENV)?.trim()\n  const deploymentEnvironment: BrandlabDeploymentEnvironment =\n    !declared || declared === 'development'\n      ? 'development'\n      : declared === 'production'\n        ? 'production'\n        : 'preview'\n  return Object.freeze({\n    environment: deploymentEnvironment,\n    productionBuild: environment.NODE_ENV === 'production',\n  })\n}\n\nexport interface BrandlabSiteDefinition {\n  /** Public site name: Open Graph `siteName` and the brand guard for templated titles. */\n  name: string\n  /** Canonical HTTPS origin written as a source constant, never read from the environment. */\n  canonicalUrl: string\n  /** Open Graph locale, for example `en_AU`. */\n  locale: string\n  /** Page title template with exactly one `%s`, for example `%s | Example Services`. */\n  titleTemplate: string\n  defaultSocialImage: BrandlabSocialImage\n  /**\n   * Hosts that permanently redirect every path to the canonical origin, such as\n   * the `www` host, the Vercel project host or a retired domain.\n   */\n  aliasHosts: readonly string[]\n}\n\nexport interface BrandlabSite {\n  readonly name: string\n  /** Canonical origin without a trailing slash, for example `https://example.com.au`. */\n  readonly canonicalUrl: string\n  readonly canonicalHost: string\n  readonly locale: string\n  readonly titleTemplate: string\n  readonly defaultSocialImage: Readonly<BrandlabSocialImage>\n  readonly aliasHosts: readonly string[]\n}\n\nconst SITE_KEYS = new Set([\n  'name',\n  'canonicalUrl',\n  'locale',\n  'titleTemplate',\n  'defaultSocialImage',\n  'aliasHosts',\n])\nconst HOSTNAME_PATTERN =\n  /^(?=.{1,253}$)(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z][a-z0-9-]{0,61}[a-z0-9]$/\n\nfunction assertSiteText(value: unknown, field: string, maximum: number): asserts value is string {\n  if (\n    typeof value !== 'string' ||\n    !value.trim() ||\n    value.trim() !== value ||\n    value.length > maximum ||\n    /[\\u0000-\\u001f\\u007f]/.test(value)\n  ) {\n    throw new Error(`${field} must be bounded, trimmed, single-line text.`)\n  }\n}\n\nexport function isBrandlabHostname(value: unknown): value is string {\n  return typeof value === 'string' && HOSTNAME_PATTERN.test(value)\n}\n\nfunction canonicalOrigin(value: unknown) {\n  assertSiteText(value, 'canonicalUrl', 2_048)\n  let url: URL\n  try {\n    url = new URL(value)\n  } catch {\n    throw new Error(`canonicalUrl must be an absolute HTTPS origin: \"${value}\".`)\n  }\n  if (\n    url.protocol !== 'https:' ||\n    url.username ||\n    url.password ||\n    url.port ||\n    url.search ||\n    url.hash ||\n    (url.pathname !== '/' && url.pathname !== '') ||\n    value.replace(/\\/$/, '') !== url.origin ||\n    !isBrandlabHostname(url.hostname)\n  ) {\n    throw new Error(`canonicalUrl must be an absolute HTTPS origin: \"${value}\".`)\n  }\n  return url\n}\n\n/**\n * Declares the site-wide SEO identity once (`src/config/site.ts`). The result\n * feeds metadata, robots, sitemaps, redirects and next.config.\n */\nexport function defineBrandlabSite(definition: BrandlabSiteDefinition): BrandlabSite {\n  if (!definition || typeof definition !== 'object' || Array.isArray(definition)) {\n    throw new TypeError('defineBrandlabSite requires a site definition.')\n  }\n  const unsupported = Object.keys(definition).filter((key) => !SITE_KEYS.has(key))\n  if (unsupported.length > 0) {\n    throw new Error(`Site definition contains unsupported keys: ${unsupported.join(', ')}.`)\n  }\n  assertSiteText(definition.name, 'name', 160)\n  const origin = canonicalOrigin(definition.canonicalUrl)\n  assertSiteText(definition.locale, 'locale', 20)\n  if (!/^[a-z]{2}(?:_[A-Z]{2})?$/.test(definition.locale)) {\n    throw new Error('locale must use a language or language_REGION identifier.')\n  }\n  assertSiteText(definition.titleTemplate, 'titleTemplate', 240)\n  if ((definition.titleTemplate.match(/%s/g) ?? []).length !== 1) {\n    throw new Error('titleTemplate must contain exactly one %s placeholder.')\n  }\n  assertBrandlabSocialImage(definition.defaultSocialImage, 'defaultSocialImage')\n  if (!Array.isArray(definition.aliasHosts)) {\n    throw new Error('aliasHosts must list every host that redirects to the canonical origin.')\n  }\n  definition.aliasHosts.forEach((host, index) => {\n    if (!isBrandlabHostname(host)) {\n      throw new Error(`aliasHosts[${index}] must be a lowercase hostname without a scheme, port or path.`)\n    }\n    if (host === origin.hostname) {\n      throw new Error(`aliasHosts[${index}] cannot be the canonical host.`)\n    }\n  })\n  const duplicate = definition.aliasHosts.find(\n    (host, index) => definition.aliasHosts.indexOf(host) !== index,\n  )\n  if (duplicate) throw new Error(`aliasHosts contains duplicate host \"${duplicate}\".`)\n\n  return Object.freeze({\n    name: definition.name,\n    canonicalUrl: origin.origin,\n    canonicalHost: origin.hostname,\n    locale: definition.locale,\n    titleTemplate: definition.titleTemplate,\n    defaultSocialImage: Object.freeze({ ...definition.defaultSocialImage }),\n    aliasHosts: Object.freeze([...definition.aliasHosts]),\n  })\n}\n"]}

package/dist/sitemaps.d.ts

@@ -1,3 +1,4 @@
+import type { BrandlabRouteCatalog } from './routes.js';
 export interface SitemapEntry {
     url: string;
     lastModified?: string | Date;
@@ -7,6 +8,10 @@ export interface SitemapChunk {
     entries: readonly SitemapEntry[];
 }
 export declare function escapeXml(value: string): string;
+/**
+ * Exactly the headers Next 16's metadata `sitemap.ts` route sends, so a route
+ * served by the shared sitemap helper is indistinguishable from it.
+ */
 export declare function getSitemapXmlHeaders(): {
     'content-type': string;
     'cache-control': string;
@@ -24,11 +29,6 @@ export declare function filterSitemapIndexPaths(groups: readonly {
     entryCount: number;
     includeWhenEmpty?: boolean;
 }[]): string[];
-export declare function shouldIndexSite(options: {
-    nodeEnv?: string;
-    vercelEnv?: string;
-    allowIndexing?: string;
-}): boolean;
 /**
  * Builds canonical sitemap entries from the route catalog. It deliberately
  * omits priority and changeFrequency because search engines do not use those
@@ -37,5 +37,4 @@ export declare function shouldIndexSite(options: {
 export declare function buildSitemapEntries(routes: BrandlabRouteCatalog, options: {
     siteUrl: string;
 }): SitemapEntry[];
-import type { BrandlabRouteCatalog } from './routes.js';
 //# 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,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;CACjC;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/C;AAqBD,wBAAgB,oBAAoB;;;EAKnC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CA2BzE;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,EAAE;IAAE,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,GACjD,MAAM,CAmBR;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,GACA,YAAY,EAAE,CAqBhB;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,YAKpF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,WAKA;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3B,YAAY,EAAE,CAmChB;AAED,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"sitemaps.d.ts","sourceRoot":"","sources":["../src/sitemaps.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAGvD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;CACjC;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/C;AA+BD;;;GAGG;AACH,wBAAgB,oBAAoB;;;EAKnC;AAKD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAezE;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,EAAE;IAAE,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,GACjD,MAAM,CAQR;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,GACA,YAAY,EAAE,CAqBhB;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,YAKpF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3B,YAAY,EAAE,CAmChB"}

package/dist/sitemaps.js

@@ -1,3 +1,5 @@
+import { getAbsoluteUrl } from './metadata.js';
+import { normalizeBrandlabRoutePath, resolveBrandlabRouteIndexing } from './routes.js';
 export function escapeXml(value) {
     return value
         .replace(/&/g, '&')
@@ -6,13 +8,23 @@ export function escapeXml(value) {
         .replace(/"/g, '"')
         .replace(/'/g, ''');
 }
+/**
+ * A `lastmod` exactly as Next's metadata `sitemap.ts` writes it: a string is
+ * kept verbatim (a `YYYY-MM-DD` date stays date-only) and only a `Date` becomes
+ * an ISO timestamp.
+ */
 function formatLastModified(value) {
     if (!value)
         return null;
-    const parsed = value instanceof Date ? value : new Date(value);
-    if (Number.isNaN(parsed.getTime()))
-        throw new Error('Sitemap lastModified must be a valid date.');
-    return parsed.toISOString();
+    if (value instanceof Date) {
+        if (Number.isNaN(value.getTime()))
+            throw new Error('Sitemap lastModified must be a valid date.');
+        return value.toISOString();
+    }
+    if (typeof value !== 'string' || value.trim() !== value || Number.isNaN(Date.parse(value))) {
+        throw new Error(`Sitemap lastModified must be a valid date: "${String(value)}".`);
+    }
+    return escapeXml(value);
 }
 function assertSitemapUrl(value, field) {
     let url;
@@ -26,55 +38,42 @@ function assertSitemapUrl(value, field) {
         throw new Error(`${field} must be an absolute HTTPS URL without credentials or a hash.`);
     }
 }
+/**
+ * Exactly the headers Next 16's metadata `sitemap.ts` route sends, so a route
+ * served by the shared sitemap helper is indistinguishable from it.
+ */
 export function getSitemapXmlHeaders() {
     return {
-        'content-type': 'application/xml; charset=utf-8',
-        'cache-control': 'public, max-age=3600, s-maxage=3600',
+        'content-type': 'application/xml',
+        'cache-control': 'public, max-age=0, must-revalidate',
     };
 }
+const XML_DECLARATION = '<?xml version="1.0" encoding="UTF-8"?>\n';
+const SITEMAP_NAMESPACE = 'http://www.sitemaps.org/schemas/sitemap/0.9';
 export function serializeSitemap(entries) {
     entries.forEach((entry, index) => assertSitemapUrl(entry.url, `entries[${index}].url`));
     const duplicate = entries.find((entry, index) => entries.slice(0, index).some((candidate) => candidate.url === entry.url));
     if (duplicate)
         throw new Error(`Sitemap contains duplicate URL "${duplicate.url}".`);
-    const urls = entries
-        .map((entry) => {
+    // Byte-for-byte the layout of Next's metadata sitemap (resolveSitemap).
+    let xml = `${XML_DECLARATION}<urlset xmlns="${SITEMAP_NAMESPACE}">\n`;
+    for (const entry of entries) {
         const lastModified = formatLastModified(entry.lastModified);
-        return [
-            '  <url>',
-            `    <loc>${escapeXml(entry.url)}</loc>`,
-            lastModified ? `    <lastmod>${lastModified}</lastmod>` : null,
-            '  </url>',
-        ]
-            .filter(Boolean)
-            .join('\n');
-    })
-        .join('\n');
-    return [
-        '<?xml version="1.0" encoding="UTF-8"?>',
-        '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',
-        urls,
-        '</urlset>',
-    ].join('\n');
+        xml += `<url>\n<loc>${escapeXml(entry.url)}</loc>\n`;
+        if (lastModified)
+            xml += `<lastmod>${lastModified}</lastmod>\n`;
+        xml += '</url>\n';
+    }
+    return `${xml}</urlset>\n`;
 }
 export function serializeSitemapIndex(paths, options) {
-    const entries = paths
-        .map((path, index) => {
+    let xml = `${XML_DECLARATION}<sitemapindex xmlns="${SITEMAP_NAMESPACE}">\n`;
+    paths.forEach((path, index) => {
         const url = options.absoluteUrl(path);
         assertSitemapUrl(url, `paths[${index}]`);
-        return [
-            '  <sitemap>',
-            `    <loc>${escapeXml(url)}</loc>`,
-            '  </sitemap>',
-        ].join('\n');
-    })
-        .join('\n');
-    return [
-        '<?xml version="1.0" encoding="UTF-8"?>',
-        '<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',
-        entries,
-        '</sitemapindex>',
-    ].join('\n');
+        xml += `<sitemap>\n<loc>${escapeXml(url)}</loc>\n</sitemap>\n`;
+    });
+    return `${xml}</sitemapindex>\n`;
 }
 export function createSitemapChunks(entries, options) {
     const maxUrlsPerSitemap = options.maxUrlsPerSitemap ?? 500;
@@ -99,13 +98,6 @@ export function filterSitemapIndexPaths(groups) {
         .filter((group) => group.includeWhenEmpty || group.entryCount > 0)
         .map((group) => group.path);
 }
-export function shouldIndexSite(options) {
-    // A Vercel environment declaration is authoritative: preview and
-    // development deployments cannot be made indexable by a drifting override.
-    if (options.vercelEnv)
-        return options.vercelEnv === 'production';
-    return options.nodeEnv === 'production' || options.allowIndexing === '1';
-}
 /**
  * Builds canonical sitemap entries from the route catalog. It deliberately
  * omits priority and changeFrequency because search engines do not use those
@@ -139,6 +131,4 @@ export function buildSitemapEntries(routes, options) {
         throw new Error(`Sitemap contains duplicate canonical URL "${duplicate.url}".`);
     return entries;
 }
-import { getAbsoluteUrl } from './metadata.js';
-import { normalizeBrandlabRoutePath, resolveBrandlabRouteIndexing } from './routes.js';
 //# sourceMappingURL=sitemaps.js.map

package/dist/sitemaps.js.map

@@ -1 +1 @@
-{"version":3,"file":"sitemaps.js","sourceRoot":"","sources":["../src/sitemaps.ts"],"names":[],"mappings":"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","sourcesContent":["export interface SitemapEntry {\n  url: string\n  lastModified?: string | Date\n}\n\nexport interface SitemapChunk {\n  path: string\n  entries: readonly SitemapEntry[]\n}\n\nexport function escapeXml(value: string): string {\n  return value\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&apos;')\n}\n\nfunction formatLastModified(value: SitemapEntry['lastModified']) {\n  if (!value) return null\n  const parsed = value instanceof Date ? value : new Date(value)\n  if (Number.isNaN(parsed.getTime())) throw new Error('Sitemap lastModified must be a valid date.')\n  return parsed.toISOString()\n}\n\nfunction assertSitemapUrl(value: string, field: string) {\n  let url: URL\n  try {\n    url = new URL(value)\n  } catch {\n    throw new Error(`${field} must be an absolute HTTPS URL.`)\n  }\n  if (url.protocol !== 'https:' || url.username || url.password || url.hash) {\n    throw new Error(`${field} must be an absolute HTTPS URL without credentials or a hash.`)\n  }\n}\n\nexport function getSitemapXmlHeaders() {\n  return {\n    'content-type': 'application/xml; charset=utf-8',\n    'cache-control': 'public, max-age=3600, s-maxage=3600',\n  }\n}\n\nexport function serializeSitemap(entries: readonly SitemapEntry[]): string {\n  entries.forEach((entry, index) => assertSitemapUrl(entry.url, `entries[${index}].url`))\n  const duplicate = entries.find((entry, index) =>\n    entries.slice(0, index).some((candidate) => candidate.url === entry.url),\n  )\n  if (duplicate) throw new Error(`Sitemap contains duplicate URL \"${duplicate.url}\".`)\n  const urls = entries\n    .map((entry) => {\n      const lastModified = formatLastModified(entry.lastModified)\n\n      return [\n        '  <url>',\n        `    <loc>${escapeXml(entry.url)}</loc>`,\n        lastModified ? `    <lastmod>${lastModified}</lastmod>` : null,\n        '  </url>',\n      ]\n        .filter(Boolean)\n        .join('\\n')\n    })\n    .join('\\n')\n\n  return [\n    '<?xml version=\"1.0\" encoding=\"UTF-8\"?>',\n    '<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">',\n    urls,\n    '</urlset>',\n  ].join('\\n')\n}\n\nexport function serializeSitemapIndex(\n  paths: readonly string[],\n  options: { absoluteUrl: (path: string) => string },\n): string {\n  const entries = paths\n    .map((path, index) => {\n      const url = options.absoluteUrl(path)\n      assertSitemapUrl(url, `paths[${index}]`)\n      return [\n        '  <sitemap>',\n        `    <loc>${escapeXml(url)}</loc>`,\n        '  </sitemap>',\n      ].join('\\n')\n    })\n    .join('\\n')\n\n  return [\n    '<?xml version=\"1.0\" encoding=\"UTF-8\"?>',\n    '<sitemapindex xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">',\n    entries,\n    '</sitemapindex>',\n  ].join('\\n')\n}\n\nexport function createSitemapChunks(\n  entries: readonly SitemapEntry[],\n  options: {\n    pathPrefix: string\n    maxUrlsPerSitemap?: number\n  },\n): SitemapChunk[] {\n  const maxUrlsPerSitemap = options.maxUrlsPerSitemap ?? 500\n\n  if (!Number.isInteger(maxUrlsPerSitemap) || maxUrlsPerSitemap < 1 || maxUrlsPerSitemap > 50_000) {\n    throw new Error('maxUrlsPerSitemap must be an integer between 1 and 50000.')\n  }\n\n  const pathPrefix = options.pathPrefix.startsWith('/')\n    ? options.pathPrefix\n    : `/${options.pathPrefix}`\n  const normalizedPrefix = pathPrefix.replace(/\\.xml$/, '')\n  const chunks: SitemapChunk[] = []\n\n  for (let index = 0; index < entries.length; index += maxUrlsPerSitemap) {\n    chunks.push({\n      path: `${normalizedPrefix}-${chunks.length + 1}.xml`,\n      entries: entries.slice(index, index + maxUrlsPerSitemap),\n    })\n  }\n\n  return chunks\n}\n\nexport function filterSitemapIndexPaths(\n  groups: readonly { path: string; entryCount: number; includeWhenEmpty?: boolean }[],\n) {\n  return groups\n    .filter((group) => group.includeWhenEmpty || group.entryCount > 0)\n    .map((group) => group.path)\n}\n\nexport function shouldIndexSite(options: {\n  nodeEnv?: string\n  vercelEnv?: string\n  allowIndexing?: string\n}) {\n  // A Vercel environment declaration is authoritative: preview and\n  // development deployments cannot be made indexable by a drifting override.\n  if (options.vercelEnv) return options.vercelEnv === 'production'\n  return options.nodeEnv === 'production' || options.allowIndexing === '1'\n}\n\n/**\n * Builds canonical sitemap entries from the route catalog. It deliberately\n * omits priority and changeFrequency because search engines do not use those\n * values as reliable crawl signals.\n */\nexport function buildSitemapEntries(\n  routes: BrandlabRouteCatalog,\n  options: { siteUrl: string },\n): SitemapEntry[] {\n  const siteUrl = new URL(options.siteUrl)\n  if (\n    siteUrl.protocol !== 'https:' ||\n    siteUrl.username ||\n    siteUrl.password ||\n    siteUrl.pathname !== '/' ||\n    siteUrl.search ||\n    siteUrl.hash\n  ) {\n    throw new Error('siteUrl must be an absolute HTTPS origin.')\n  }\n\n  const entries = routes\n    .filter((route) => resolveBrandlabRouteIndexing(route) === 'index')\n    .map((route) => {\n      const path = normalizeBrandlabRoutePath(route.canonicalPath ?? route.path)\n      const lastModified = route.lastSignificantChange\n\n      if (lastModified && Number.isNaN(Date.parse(lastModified))) {\n        throw new Error(`Route \"${route.id}\" has an invalid lastSignificantChange date.`)\n      }\n\n      return {\n        url: getAbsoluteUrl(siteUrl.origin, path),\n        ...(lastModified ? { lastModified } : {}),\n      }\n    })\n\n  const duplicate = entries.find((entry, index) =>\n    entries.slice(0, index).some((candidate) => candidate.url === entry.url),\n  )\n  if (duplicate) throw new Error(`Sitemap contains duplicate canonical URL \"${duplicate.url}\".`)\n\n  return entries\n}\nimport { getAbsoluteUrl } from './metadata.js'\nimport type { BrandlabRouteCatalog } from './routes.js'\nimport { normalizeBrandlabRoutePath, resolveBrandlabRouteIndexing } from './routes.js'\n"]}
+{"version":3,"file":"sitemaps.js","sourceRoot":"","sources":["../src/sitemaps.ts"],"names":[],"mappings":"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","sourcesContent":["import { getAbsoluteUrl } from './metadata.js'\nimport type { BrandlabRouteCatalog } from './routes.js'\nimport { normalizeBrandlabRoutePath, resolveBrandlabRouteIndexing } from './routes.js'\n\nexport interface SitemapEntry {\n  url: string\n  lastModified?: string | Date\n}\n\nexport interface SitemapChunk {\n  path: string\n  entries: readonly SitemapEntry[]\n}\n\nexport function escapeXml(value: string): string {\n  return value\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&apos;')\n}\n\n/**\n * A `lastmod` exactly as Next's metadata `sitemap.ts` writes it: a string is\n * kept verbatim (a `YYYY-MM-DD` date stays date-only) and only a `Date` becomes\n * an ISO timestamp.\n */\nfunction formatLastModified(value: SitemapEntry['lastModified']) {\n  if (!value) return null\n  if (value instanceof Date) {\n    if (Number.isNaN(value.getTime())) throw new Error('Sitemap lastModified must be a valid date.')\n    return value.toISOString()\n  }\n  if (typeof value !== 'string' || value.trim() !== value || Number.isNaN(Date.parse(value))) {\n    throw new Error(`Sitemap lastModified must be a valid date: \"${String(value)}\".`)\n  }\n  return escapeXml(value)\n}\n\nfunction assertSitemapUrl(value: string, field: string) {\n  let url: URL\n  try {\n    url = new URL(value)\n  } catch {\n    throw new Error(`${field} must be an absolute HTTPS URL.`)\n  }\n  if (url.protocol !== 'https:' || url.username || url.password || url.hash) {\n    throw new Error(`${field} must be an absolute HTTPS URL without credentials or a hash.`)\n  }\n}\n\n/**\n * Exactly the headers Next 16's metadata `sitemap.ts` route sends, so a route\n * served by the shared sitemap helper is indistinguishable from it.\n */\nexport function getSitemapXmlHeaders() {\n  return {\n    'content-type': 'application/xml',\n    'cache-control': 'public, max-age=0, must-revalidate',\n  }\n}\n\nconst XML_DECLARATION = '<?xml version=\"1.0\" encoding=\"UTF-8\"?>\\n'\nconst SITEMAP_NAMESPACE = 'http://www.sitemaps.org/schemas/sitemap/0.9'\n\nexport function serializeSitemap(entries: readonly SitemapEntry[]): string {\n  entries.forEach((entry, index) => assertSitemapUrl(entry.url, `entries[${index}].url`))\n  const duplicate = entries.find((entry, index) =>\n    entries.slice(0, index).some((candidate) => candidate.url === entry.url),\n  )\n  if (duplicate) throw new Error(`Sitemap contains duplicate URL \"${duplicate.url}\".`)\n  // Byte-for-byte the layout of Next's metadata sitemap (resolveSitemap).\n  let xml = `${XML_DECLARATION}<urlset xmlns=\"${SITEMAP_NAMESPACE}\">\\n`\n  for (const entry of entries) {\n    const lastModified = formatLastModified(entry.lastModified)\n    xml += `<url>\\n<loc>${escapeXml(entry.url)}</loc>\\n`\n    if (lastModified) xml += `<lastmod>${lastModified}</lastmod>\\n`\n    xml += '</url>\\n'\n  }\n  return `${xml}</urlset>\\n`\n}\n\nexport function serializeSitemapIndex(\n  paths: readonly string[],\n  options: { absoluteUrl: (path: string) => string },\n): string {\n  let xml = `${XML_DECLARATION}<sitemapindex xmlns=\"${SITEMAP_NAMESPACE}\">\\n`\n  paths.forEach((path, index) => {\n    const url = options.absoluteUrl(path)\n    assertSitemapUrl(url, `paths[${index}]`)\n    xml += `<sitemap>\\n<loc>${escapeXml(url)}</loc>\\n</sitemap>\\n`\n  })\n  return `${xml}</sitemapindex>\\n`\n}\n\nexport function createSitemapChunks(\n  entries: readonly SitemapEntry[],\n  options: {\n    pathPrefix: string\n    maxUrlsPerSitemap?: number\n  },\n): SitemapChunk[] {\n  const maxUrlsPerSitemap = options.maxUrlsPerSitemap ?? 500\n\n  if (!Number.isInteger(maxUrlsPerSitemap) || maxUrlsPerSitemap < 1 || maxUrlsPerSitemap > 50_000) {\n    throw new Error('maxUrlsPerSitemap must be an integer between 1 and 50000.')\n  }\n\n  const pathPrefix = options.pathPrefix.startsWith('/')\n    ? options.pathPrefix\n    : `/${options.pathPrefix}`\n  const normalizedPrefix = pathPrefix.replace(/\\.xml$/, '')\n  const chunks: SitemapChunk[] = []\n\n  for (let index = 0; index < entries.length; index += maxUrlsPerSitemap) {\n    chunks.push({\n      path: `${normalizedPrefix}-${chunks.length + 1}.xml`,\n      entries: entries.slice(index, index + maxUrlsPerSitemap),\n    })\n  }\n\n  return chunks\n}\n\nexport function filterSitemapIndexPaths(\n  groups: readonly { path: string; entryCount: number; includeWhenEmpty?: boolean }[],\n) {\n  return groups\n    .filter((group) => group.includeWhenEmpty || group.entryCount > 0)\n    .map((group) => group.path)\n}\n\n/**\n * Builds canonical sitemap entries from the route catalog. It deliberately\n * omits priority and changeFrequency because search engines do not use those\n * values as reliable crawl signals.\n */\nexport function buildSitemapEntries(\n  routes: BrandlabRouteCatalog,\n  options: { siteUrl: string },\n): SitemapEntry[] {\n  const siteUrl = new URL(options.siteUrl)\n  if (\n    siteUrl.protocol !== 'https:' ||\n    siteUrl.username ||\n    siteUrl.password ||\n    siteUrl.pathname !== '/' ||\n    siteUrl.search ||\n    siteUrl.hash\n  ) {\n    throw new Error('siteUrl must be an absolute HTTPS origin.')\n  }\n\n  const entries = routes\n    .filter((route) => resolveBrandlabRouteIndexing(route) === 'index')\n    .map((route) => {\n      const path = normalizeBrandlabRoutePath(route.canonicalPath ?? route.path)\n      const lastModified = route.lastSignificantChange\n\n      if (lastModified && Number.isNaN(Date.parse(lastModified))) {\n        throw new Error(`Route \"${route.id}\" has an invalid lastSignificantChange date.`)\n      }\n\n      return {\n        url: getAbsoluteUrl(siteUrl.origin, path),\n        ...(lastModified ? { lastModified } : {}),\n      }\n    })\n\n  const duplicate = entries.find((entry, index) =>\n    entries.slice(0, index).some((candidate) => candidate.url === entry.url),\n  )\n  if (duplicate) throw new Error(`Sitemap contains duplicate canonical URL \"${duplicate.url}\".`)\n\n  return entries\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brandlab-digital/site-core",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/RomieDandan/brandlab.git",
@@ -26,6 +26,11 @@
       "types": "./dist/project.d.ts",
       "import": "./dist/project.js"
     },
+    "./site": {
+      "types": "./dist/site.d.ts",
+      "import": "./dist/site.js",
+      "require": "./dist/site.js"
+    },
     "./business": {
       "types": "./dist/business.d.ts",
       "import": "./dist/business.js"
@@ -34,6 +39,11 @@
       "types": "./dist/routes.d.ts",
       "import": "./dist/routes.js"
     },
+    "./redirects": {
+      "types": "./dist/redirects.d.ts",
+      "import": "./dist/redirects.js",
+      "require": "./dist/redirects.js"
+    },
     "./seo-page": {
       "types": "./dist/seo-page.d.ts",
       "import": "./dist/seo-page.js"