@hagicode/hagilight 0.20.1-dev.196.1.d67f4e4 → 0.20.1-dev.199.1.c17b214

package/Footer.astro

@@ -8,8 +8,12 @@ interface Props extends ComponentProps<typeof CoreFooter> {}
 if (typeof manifest.version !== 'string' || manifest.version.trim().length === 0) {
   throw new Error('@hagicode/hagilight requires a nonempty string version in its package.json.');
 }
+
+// Set per request by the hagilight integration on a regional build. Absent otherwise, so global output is unchanged.
+const consentFromBuild = (Astro.locals as { hagilightConsent?: { regional: boolean; replayEntry: boolean } }).hagilightConsent;
+const { regional = consentFromBuild?.regional, replayEntry = consentFromBuild?.replayEntry, ...props } = Astro.props;
 ---
 
-<CoreFooter {...Astro.props}>
+<CoreFooter {...props} regional={regional} replayEntry={replayEntry}>
   <span slot="attribution">Powered By hagilight@{manifest.version}</span>
 </CoreFooter>

package/dist/consent-middleware.d.ts

@@ -0,0 +1,2 @@
+import type { MiddlewareHandler } from 'astro';
+export declare const onRequest: MiddlewareHandler;

package/dist/consent-middleware.js

@@ -0,0 +1,5 @@
+import consentFooter from 'virtual:hagilight/consent-footer';
+export const onRequest = (context, next) => {
+    context.locals.hagilightConsent = consentFooter;
+    return next();
+};

package/dist/integration.d.ts

@@ -102,5 +102,10 @@ export type HagilightFaviconOptions = FaviconOptions;
  * precedence, and an enabled Starlight Hagilight integration owns RSS feeds.
  */
 export declare function hagilight({ enabled, rss, contentImages, llms, metadata, analytics }?: HagilightOptions): AstroIntegration;
+/** The footer's regional state, read per request by `Footer.astro` through `Astro.locals`. */
+export interface ConsentFooterState {
+    regional: boolean;
+    replayEntry: boolean;
+}
 /** Inject the bundled HagiCode favicon unless the site head already declares an icon. */
 export declare function hagilightFavicon(options?: HagilightFaviconOptions): AstroIntegration;

package/dist/integration.js

@@ -7,7 +7,7 @@ import { checkContentImageRegistration, registerContentImages } from '@hagicode/
 import { resolveFaviconHeadEntry } from '@hagicode/hagilight-core/favicon';
 import { DEFAULT_POSTHOG_API_KEY, POSTHOG_API_KEY_PATTERN, posthogInitScript } from '@hagicode/hagilight-core/posthog';
 import { consentHeadScript } from '@hagicode/hagilight-core/consent-mount';
-import { validatePolicyVersion, validatePrivacyUrl } from '@hagicode/hagilight-core/consent-markup';
+import { resolveRegionalOptions, validatePolicyVersion, validatePrivacyUrl, } from '@hagicode/hagilight-core/consent-markup';
 import { resolveRssLocales } from '@hagicode/hagilight-core/rss';
 import { resolvePlainAstroRssOwner } from '@hagicode/hagilight-core/rss-ownership';
 import { resolveSiteMetadataOption } from '@hagicode/hagilight-core/site-metadata';
@@ -18,6 +18,8 @@ const VIRTUAL_RSS_CONFIG = 'virtual:hagilight/rss-config';
 const VIRTUAL_RSS_CONFIG_RESOLVED = `\0${VIRTUAL_RSS_CONFIG}`;
 const VIRTUAL_BUILD_INFO = 'virtual:hagilight/build-info';
 const VIRTUAL_BUILD_INFO_RESOLVED = `\0${VIRTUAL_BUILD_INFO}`;
+const VIRTUAL_CONSENT_FOOTER = 'virtual:hagilight/consent-footer';
+const VIRTUAL_CONSENT_FOOTER_RESOLVED = `\0${VIRTUAL_CONSENT_FOOTER}`;
 const PAGE_SOURCE_EXTENSIONS = new Set(['.astro', '.html', '.js', '.jsx', '.md', '.mdx', '.ts', '.tsx']);
 const packageRoot = new URL('../', import.meta.url);
 const routeEntrypoint = (name) => fileURLToPath(new URL(name, packageRoot));
@@ -62,10 +64,12 @@ function resolveConsentOptions(analytics, posthogEnabled) {
     if (consent?.enabled !== undefined && typeof consent.enabled !== 'boolean') {
         throw new TypeError('Hagilight analytics consent enabled option must be a boolean.');
     }
+    // Regional options are validated by the core, so every integration throws the same named error.
     return {
         enabled: posthogEnabled && (consent?.enabled ?? true),
         privacyUrl: validatePrivacyUrl(consent?.privacyUrl),
         policyVersion: validatePolicyVersion(consent?.policyVersion),
+        regional: resolveRegionalOptions(consent, consent?.enabled !== false),
     };
 }
 function postHogSiteContext(site) {
@@ -164,10 +168,27 @@ export function hagilight({ enabled = true, rss, contentImages, llms, metadata,
                             const loader = posthogInitScript(posthogApiKey, postHogSiteContext(config.site));
                             injectScript('head-inline', consentHeadScript({
                                 posthog: { apiKey: posthogApiKey, loader },
-                                config: { providers: ['posthog'], privacyUrl: consent.privacyUrl, policyVersion: consent.policyVersion },
+                                config: {
+                                    providers: ['posthog'],
+                                    privacyUrl: consent.privacyUrl,
+                                    policyVersion: consent.policyVersion,
+                                    regional: consent.regional,
+                                },
                             }));
                             const mountModule = fileURLToPath(import.meta.resolve('@hagicode/hagilight-core/consent-mount'));
                             injectScript('page', `import { mountConsent } from ${JSON.stringify(mountModule)};\nmountConsent();`);
+                            if (consent.regional) {
+                                // The footer reads these per request, so its hidden entries follow the descriptor it was built with.
+                                updateConfig({
+                                    vite: {
+                                        plugins: [createConsentFooterPlugin({
+                                                regional: true,
+                                                replayEntry: consent.regional.sessionReplay === 'optIn',
+                                            })],
+                                    },
+                                });
+                                addMiddleware({ entrypoint: fileURLToPath(new URL('./consent-middleware.js', import.meta.url)), order: 'pre' });
+                            }
                         }
                         else {
                             injectScript('head-inline', posthogInitScript(posthogApiKey, postHogSiteContext(config.site)));
@@ -445,6 +466,19 @@ function createVirtualPlugin({ modulePath, site, baseUrl, locales, defaultFeedUr
         },
     };
 }
+function createConsentFooterPlugin(state) {
+    return {
+        name: '@hagicode/hagilight:consent-footer',
+        resolveId(id) {
+            return id === VIRTUAL_CONSENT_FOOTER ? VIRTUAL_CONSENT_FOOTER_RESOLVED : null;
+        },
+        load(id) {
+            if (id !== VIRTUAL_CONSENT_FOOTER_RESOLVED)
+                return null;
+            return `export default ${JSON.stringify(state)};`;
+        },
+    };
+}
 function createBuildInfoPlugin(buildInfo) {
     return {
         name: '@hagicode/hagilight:build-info',

package/dist/site-metadata.js

@@ -7,7 +7,7 @@ import { existsSync, readFileSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { CONSENT_DESCRIPTOR_ID } from '@hagicode/hagilight-core/consent-markup';
-import { buildSiteMetadata, detectAnalyticsLoaders, SITE_METADATA_PATH, } from '@hagicode/hagilight-core/site-metadata';
+import { buildSiteMetadata, detectAnalyticsLoaders, detectConsentMode, SITE_METADATA_PATH, } from '@hagicode/hagilight-core/site-metadata';
 import { findDiscoveryOutputs, writeSiteMetadata } from '@hagicode/hagilight-core/site-metadata-writer';
 import { parseHeadMeta } from './llms.js';
 const ASTRO_PACKAGE_VERSION = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
@@ -99,7 +99,7 @@ export function writeAstroSiteMetadata({ config, outDir, pages, build, options,
         discovery: findDiscoveryOutputs(outDir),
         analytics: detectAnalyticsLoaders(pageHtml),
         // The popup is mounted exactly when a built page carries its config descriptor.
-        features: { consent: pageHtml.some((html) => html.includes(CONSENT_DESCRIPTOR_ID)) },
+        features: { consent: pageHtml.some((html) => html.includes(CONSENT_DESCRIPTOR_ID)), consentMode: detectConsentMode(pageHtml) },
     });
     writeSiteMetadata({
         outDir,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hagicode/hagilight",
-  "version": "0.20.1-dev.196.1.d67f4e4",
+  "version": "0.20.1-dev.199.1.c17b214",
   "type": "module",
   "description": "Astro integrations and components for HagiCode sites",
   "repository": {
@@ -40,7 +40,7 @@
   },
   "dependencies": {
     "@astrojs/sitemap": "^3.7.4",
-    "@hagicode/hagilight-core": "0.20.1-dev.196.1.d67f4e4"
+    "@hagicode/hagilight-core": "0.20.1-dev.199.1.c17b214"
   },
   "keywords": [
     "hagicode",