@astronox/core 0.5.0 → 0.5.2

package/README.md

@@ -63,7 +63,7 @@ component labels can extend `defaultCoreMessages` through
   claims, Firestore, and app-owned mappings.
 - [`R2 publication`](docs/integrations/r2-publication.md): full provider
   snapshots and build-time public projection.
-- [`AdSense`](docs/integrations/adsense.md): typed configuration, responsive
-  units, host policy, Privacy & Messaging, and deployment.
+- [`AdSense`](docs/integrations/adsense.md): typed configuration, Privacy &
+  Messaging policy, annotation exclusions, and deployment.
 - [`release workflow`](docs/release-workflow.md): local links, verification, and
   consumer pinning order.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astronox/core",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Reusable Astro components, patterns, styles, and infrastructure for AstroNox sites.",
   "license": "MIT",
   "keywords": [

package/src/ads/adsense/AdsenseAdBlockingRecoveryHead.astro

@@ -0,0 +1,30 @@
+---
+type Props = {
+  publisherId: string;
+};
+
+const { publisherId }: Props = Astro.props;
+const scriptSource = `https://fundingchoicesmessages.google.com/i/${encodeURIComponent(publisherId)}?ers=1`;
+---
+
+<script is:inline async src={scriptSource}></script>
+<script is:inline>
+  (() => {
+    const signalGooglefcPresent = () => {
+      if (window.frames['googlefcPresent']) return;
+
+      if (!document.body) {
+        setTimeout(signalGooglefcPresent, 0);
+        return;
+      }
+
+      const frame = document.createElement('iframe');
+      frame.name = 'googlefcPresent';
+      frame.style.cssText =
+        'display: none; width: 0; height: 0; border: none; z-index: -1000; left: -1000px; top: -1000px;';
+      document.body.appendChild(frame);
+    };
+
+    signalGooglefcPresent();
+  })();
+</script>

package/src/ads/adsense/AdsenseHead.astro

@@ -1,5 +1,7 @@
 ---
 import type { AdsenseAdsConfig } from '../contracts';
+import AdsenseAdBlockingRecoveryHead from './AdsenseAdBlockingRecoveryHead.astro';
+import AdsenseMessagingBootstrap from './AdsenseMessagingBootstrap.astro';
 import { toAdsenseClientId } from './provider';
 
 type Props = {
@@ -9,30 +11,22 @@ type Props = {
 const { config }: Props = Astro.props;
 const clientId = toAdsenseClientId(config.publisherId);
 const scriptSource = `https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=${encodeURIComponent(clientId)}`;
-const adBlockingRecoverySource = `https://fundingchoicesmessages.google.com/i/${encodeURIComponent(config.publisherId)}?ers=1`;
+const adBlockingRecoveryEnabled = Boolean(
+  config.privacyMessaging?.adBlockingRecovery,
+);
 ---
 
-<script is:inline async src={adBlockingRecoverySource}></script>
-<script is:inline>
-  (() => {
-    const signalGooglefcPresent = () => {
-      if (window.frames['googlefcPresent']) return;
-
-      if (!document.body) {
-        setTimeout(signalGooglefcPresent, 0);
-        return;
-      }
-
-      const frame = document.createElement('iframe');
-      frame.name = 'googlefcPresent';
-      frame.style.cssText =
-        'display: none; width: 0; height: 0; border: none; z-index: -1000; left: -1000px; top: -1000px;';
-      document.body.appendChild(frame);
-    };
-
-    signalGooglefcPresent();
-  })();
-</script>
+{
+  config.privacyMessaging ? (
+    <AdsenseMessagingBootstrap config={config.privacyMessaging} />
+  ) : null
+}
+
+{
+  adBlockingRecoveryEnabled ? (
+    <AdsenseAdBlockingRecoveryHead publisherId={config.publisherId} />
+  ) : null
+}
 
 <meta name="google-adsense-account" content={clientId} />
 <script is:inline async crossorigin="anonymous" src={scriptSource}></script>

package/src/ads/adsense/AdsenseMessagingBootstrap.astro

@@ -0,0 +1,179 @@
+---
+import type { AdsensePrivacyMessagingConfig } from '../contracts';
+import AdsensePublisherRevocationStyle from './AdsensePublisherRevocationStyle.astro';
+
+type Props = {
+  config: AdsensePrivacyMessagingConfig;
+};
+
+const { config }: Props = Astro.props;
+const adBlockingRecovery = config.adBlockingRecovery;
+const publisherLauncher = config.consentRevocation?.launcher === 'publisher';
+const adBlockingEnabled = Boolean(adBlockingRecovery);
+const adBlockingRedisplayIntervalMs =
+  adBlockingRecovery?.redisplayIntervalMs ?? 0;
+const adBlockingStorageKey = adBlockingRecovery?.storageKey ?? '';
+---
+
+{publisherLauncher ? <AdsensePublisherRevocationStyle /> : null}
+
+<script
+  is:inline
+  define:vars={{
+    adBlockingEnabled,
+    adBlockingRedisplayIntervalMs,
+    adBlockingStorageKey,
+    publisherLauncher,
+  }}
+>
+  (() => {
+    const bootstrapKey = Symbol.for('astronox.adsense.messaging');
+    if (window[bootstrapKey]) return;
+    window[bootstrapKey] = true;
+
+    const googlefc = (window.googlefc ??= {});
+    googlefc.callbackQueue ??= [];
+
+    if (adBlockingEnabled) {
+      const now = Date.now();
+      let storageAvailable = true;
+      let storedTimestamp;
+
+      try {
+        const storedValue = window.localStorage.getItem(adBlockingStorageKey);
+        const parsedTimestamp = Number(storedValue);
+        if (
+          storedValue !== null &&
+          Number.isFinite(parsedTimestamp) &&
+          parsedTimestamp > 0 &&
+          parsedTimestamp <= now
+        ) {
+          storedTimestamp = parsedTimestamp;
+        }
+      } catch {
+        storageAvailable = false;
+      }
+
+      let cooldownActive =
+        storedTimestamp !== undefined &&
+        now - storedTimestamp < adBlockingRedisplayIntervalMs;
+
+      const startCooldown = () => {
+        if (cooldownActive) return;
+
+        cooldownActive = true;
+        if (!storageAvailable) return;
+
+        try {
+          window.localStorage.setItem(adBlockingStorageKey, String(Date.now()));
+        } catch {
+          storageAvailable = false;
+        }
+      };
+
+      googlefc.controlledMessagingFunction = (message) => {
+        if (!message || typeof message.proceed !== 'function') return;
+
+        if (cooldownActive) {
+          const adBlockingType = googlefc.MessageTypeEnum?.AD_BLOCKING;
+          if (typeof adBlockingType === 'number') {
+            message.proceed(false, [adBlockingType]);
+            return;
+          }
+
+          message.proceed(true);
+          return;
+        }
+
+        startCooldown();
+        message.proceed(true);
+      };
+    }
+
+    if (!publisherLauncher) return;
+
+    const legacyLauncherSelector = '.google-revocation-link-placeholder';
+    const toolbarSelector = '#ft-floating-toolbar';
+    const hostObservers = new WeakMap();
+
+    const disconnectHostObserver = (host) => {
+      hostObservers.get(host)?.disconnect();
+      hostObservers.delete(host);
+    };
+
+    const suppressToolbarLauncher = (host, shadowRoot) => {
+      const toolbar = shadowRoot.querySelector(toolbarSelector);
+      if (!toolbar) return;
+
+      toolbar
+        .querySelectorAll('.ft-reg-button, #ft-reg-bubble')
+        .forEach((element) => element.remove());
+
+      const remainingToolbarAction = toolbar.querySelector(
+        '.ft-button-holder button, .ft-bottom-button-holder button',
+      );
+      if (remainingToolbarAction) return;
+
+      disconnectHostObserver(host);
+      host.remove();
+    };
+
+    const observeShadowRoot = (host) => {
+      const shadowRoot = host.shadowRoot;
+      if (!shadowRoot || hostObservers.has(host)) return;
+
+      suppressToolbarLauncher(host, shadowRoot);
+      if (!host.isConnected) return;
+
+      const observer = new MutationObserver(() => {
+        suppressToolbarLauncher(host, shadowRoot);
+      });
+      observer.observe(shadowRoot, { childList: true, subtree: true });
+      hostObservers.set(host, observer);
+    };
+
+    const inspectBodyChild = (element) => {
+      if (element.matches(legacyLauncherSelector)) {
+        element.remove();
+        return;
+      }
+
+      element
+        .querySelectorAll(legacyLauncherSelector)
+        .forEach((launcher) => launcher.remove());
+      observeShadowRoot(element);
+    };
+
+    const startLauncherSuppression = () => {
+      if (!document.body) return;
+
+      for (const child of [...document.body.children]) {
+        inspectBodyChild(child);
+      }
+
+      new MutationObserver((records) => {
+        for (const record of records) {
+          for (const node of record.removedNodes) {
+            if (node instanceof Element) disconnectHostObserver(node);
+          }
+          for (const node of record.addedNodes) {
+            if (node instanceof Element) inspectBodyChild(node);
+          }
+        }
+      }).observe(document.body, { childList: true });
+    };
+
+    if (document.body) {
+      startLauncherSuppression();
+      return;
+    }
+
+    const documentObserver = new MutationObserver(() => {
+      if (!document.body) return;
+
+      documentObserver.disconnect();
+      startLauncherSuppression();
+    });
+    documentObserver.observe(document.documentElement, { childList: true });
+  })();
+</script>

package/src/ads/adsense/AdsensePublisherRevocationStyle.astro

@@ -0,0 +1,5 @@
+<style is:global>
+  .google-revocation-link-placeholder {
+    display: none !important;
+  }
+</style>

package/src/ads/contracts.ts

@@ -2,10 +2,25 @@ export type DisabledAdsConfig = {
   enabled: false;
 };
 
+export type AdsenseAdBlockingRecoveryConfig = {
+  redisplayIntervalMs: number;
+  storageKey: string;
+};
+
+export type AdsenseConsentRevocationConfig = {
+  launcher: 'google' | 'publisher';
+};
+
+export type AdsensePrivacyMessagingConfig = {
+  adBlockingRecovery?: AdsenseAdBlockingRecoveryConfig;
+  consentRevocation?: AdsenseConsentRevocationConfig;
+};
+
 export type AdsenseAdsConfig = {
   enabled: true;
   provider: 'adsense';
   publisherId: string;
+  privacyMessaging?: AdsensePrivacyMessagingConfig;
 };
 
 export type AdsConfig = DisabledAdsConfig | AdsenseAdsConfig;
@@ -22,5 +37,35 @@ export function defineAdsConfig<const TConfig extends AdsConfig>(
   if (!/^pub-\d+$/.test(config.publisherId)) {
     throw new Error('Invalid AdSense publisher id');
   }
+
+  const adBlockingRecovery = config.privacyMessaging?.adBlockingRecovery;
+  if (adBlockingRecovery) {
+    if (
+      !Number.isFinite(adBlockingRecovery.redisplayIntervalMs) ||
+      adBlockingRecovery.redisplayIntervalMs <= 0
+    ) {
+      throw new Error(
+        'AdSense ad blocking recovery redisplay interval must be positive',
+      );
+    }
+    if (
+      typeof adBlockingRecovery.storageKey !== 'string' ||
+      adBlockingRecovery.storageKey.trim().length === 0
+    ) {
+      throw new Error(
+        'AdSense ad blocking recovery storage key must not be empty',
+      );
+    }
+  }
+
+  const consentLauncher = config.privacyMessaging?.consentRevocation?.launcher;
+  if (
+    consentLauncher !== undefined &&
+    consentLauncher !== 'google' &&
+    consentLauncher !== 'publisher'
+  ) {
+    throw new Error('Invalid AdSense consent revocation launcher');
+  }
+
   return config;
 }