From b0891e343d070b7edf5f5471786027f1cf5b8bed Mon Sep 17 00:00:00 2001
From: Harlan Wilton <harlan@harlanzw.com>
Date: Fri, 6 Mar 2026 14:28:21 +1100
Subject: [PATCH 1/2] feat: auto-populate runtimeConfig for registry scripts to
 support .env overrides

When a registry script is enabled (e.g., `googleAnalytics: true`), automatically
populate `runtimeConfig.public.scripts.<key>` with empty-string defaults for the
script's primary config keys. This allows env vars like
`NUXT_PUBLIC_SCRIPTS_GOOGLE_ANALYTICS_ID` to work without manually declaring the
runtimeConfig boilerplate.

Closes #239
---
 src/module.ts | 57 +++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 55 insertions(+), 2 deletions(-)

diff --git a/src/module.ts b/src/module.ts
index 9a7755ea..9854aa6d 100644
--- a/src/module.ts
+++ b/src/module.ts
@@ -159,6 +159,36 @@ function fixSelfClosingScriptComponents(nuxt: any) {
   }
 }
 
+const REGISTRY_ENV_DEFAULTS: Record<string, Record<string, string>> = {
+  clarity: { id: '' },
+  cloudflareWebAnalytics: { token: '' },
+  crisp: { id: '' },
+  databuddyAnalytics: { clientId: '' },
+  fathomAnalytics: { site: '' },
+  googleAdsense: { client: '' },
+  googleAnalytics: { id: '' },
+  googleMaps: { apiKey: '' },
+  googleRecaptcha: { siteKey: '' },
+  googleSignIn: { clientId: '' },
+  googleTagManager: { id: '' },
+  hotjar: { id: '' },
+  intercom: { app_id: '' },
+  matomoAnalytics: { matomoUrl: '' },
+  metaPixel: { id: '' },
+  paypal: { clientId: '' },
+  plausibleAnalytics: { domain: '' },
+  posthog: { apiKey: '' },
+  redditPixel: { id: '' },
+  rybbitAnalytics: { siteId: '' },
+  segment: { writeKey: '' },
+  snapchatPixel: { id: '' },
+  stripe: {},
+  tiktokPixel: { id: '' },
+  umamiAnalytics: { websiteId: '' },
+  vercelAnalytics: {},
+  xPixel: { id: '' },
+}
+
 const PARTYTOWN_FORWARDS: Record<string, string[]> = {
   googleAnalytics: ['dataLayer.push', 'gtag'],
   plausible: ['plausible'],
@@ -355,12 +385,35 @@ export default defineNuxtModule<ModuleOptions>({
     // Merge registry config with existing runtimeConfig.public.scripts for proper env var resolution
     // Both scripts.registry and runtimeConfig.public.scripts should be supported
     if (config.registry) {
-      // Ensure runtimeConfig.public exists
       nuxt.options.runtimeConfig.public = nuxt.options.runtimeConfig.public || {}
 
+      // Auto-populate env var defaults for enabled registry scripts so that
+      // NUXT_PUBLIC_SCRIPTS_<SCRIPT>_<KEY> works without manual runtimeConfig
+      const registryWithDefaults: Record<string, any> = {}
+      for (const [key, value] of Object.entries(config.registry)) {
+        if (value && REGISTRY_ENV_DEFAULTS[key]) {
+          const envDefaults = REGISTRY_ENV_DEFAULTS[key]
+          if (value === true || value === 'mock') {
+            registryWithDefaults[key] = { ...envDefaults }
+          }
+          else if (typeof value === 'object' && !Array.isArray(value)) {
+            registryWithDefaults[key] = defu(value, envDefaults)
+          }
+          else if (Array.isArray(value)) {
+            registryWithDefaults[key] = [defu(value[0] || {}, envDefaults), value[1]]
+          }
+          else {
+            registryWithDefaults[key] = value
+          }
+        }
+        else {
+          registryWithDefaults[key] = value
+        }
+      }
+
       nuxt.options.runtimeConfig.public.scripts = defu(
         nuxt.options.runtimeConfig.public.scripts || {},
-        config.registry,
+        registryWithDefaults,
       )
     }
 

From 5efc2d2e3d44695bd31cb59e33eb1b6a5681576c Mon Sep 17 00:00:00 2001
From: Harlan Wilton <harlan@harlanzw.com>
Date: Fri, 6 Mar 2026 15:39:42 +1100
Subject: [PATCH 2/2] fix: flatten array tuple to input-only when writing
 registry defaults to runtimeConfig

---
 src/module.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/module.ts b/src/module.ts
index 9854aa6d..b3c8fd23 100644
--- a/src/module.ts
+++ b/src/module.ts
@@ -400,7 +400,7 @@ export default defineNuxtModule<ModuleOptions>({
             registryWithDefaults[key] = defu(value, envDefaults)
           }
           else if (Array.isArray(value)) {
-            registryWithDefaults[key] = [defu(value[0] || {}, envDefaults), value[1]]
+            registryWithDefaults[key] = defu(value[0] || {}, envDefaults)
           }
           else {
             registryWithDefaults[key] = value