@jwiedeman/gtm-kit-astro 1.2.0 → 1.3.0

package/dist/components/index.cjs

@@ -6,6 +6,9 @@ var gtmKit = require('@jwiedeman/gtm-kit');
 var isValidJsIdentifier = (value) => {
   return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(value);
 };
+var escapeJsString = (value) => {
+  return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/</g, "\\x3c").replace(/>/g, "\\x3e").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+};
 var filterNullish = (obj) => Object.fromEntries(Object.entries(obj).filter(([, v]) => v != null));
 var generateScriptTags = (config) => {
   const {
@@ -19,6 +22,11 @@ var generateScriptTags = (config) => {
   if (!normalized.length) {
     throw new Error("At least one GTM container is required.");
   }
+  if (!isValidJsIdentifier(dataLayerName)) {
+    throw new Error(
+      `Invalid dataLayerName: "${dataLayerName}". Must be a valid JavaScript identifier.`
+    );
+  }
   return normalized.map((container) => {
     if (!container.id) {
       throw new Error("Container id is required.");
@@ -29,16 +37,47 @@ var generateScriptTags = (config) => {
     };
     const src = gtmKit.buildGtmScriptUrl(host, container.id, params, dataLayerName);
     const { async: asyncAttr, defer, nonce, ...restAttributes } = scriptAttributes != null ? scriptAttributes : {};
+    escapeJsString(container.id);
+    const initScript = `window.${dataLayerName}=window.${dataLayerName}||[];window.${dataLayerName}.push({'gtm.start':new Date().getTime(),event:'gtm.js'});`;
     return {
       id: container.id,
       src,
       async: asyncAttr != null ? asyncAttr : true,
       defer,
       nonce,
-      attributes: filterNullish(restAttributes)
+      attributes: filterNullish(restAttributes),
+      initScript
     };
   });
 };
+var generateGtmScript = (config) => {
+  const {
+    containers,
+    host = gtmKit.DEFAULT_GTM_HOST,
+    defaultQueryParams,
+    dataLayerName = gtmKit.DEFAULT_DATA_LAYER_NAME
+  } = config;
+  const normalized = gtmKit.normalizeContainers(containers);
+  if (!normalized.length) {
+    throw new Error("At least one GTM container is required.");
+  }
+  if (!isValidJsIdentifier(dataLayerName)) {
+    throw new Error(
+      `Invalid dataLayerName: "${dataLayerName}". Must be a valid JavaScript identifier.`
+    );
+  }
+  return normalized.map((container) => {
+    if (!container.id) {
+      throw new Error("Container id is required.");
+    }
+    const escapedId = escapeJsString(container.id);
+    dataLayerName !== gtmKit.DEFAULT_DATA_LAYER_NAME ? `,'${escapeJsString(dataLayerName)}'` : "";
+    const mergedParams = { ...defaultQueryParams, ...container.queryParams };
+    const extraParams = Object.entries(mergedParams).filter(([, v]) => v != null).map(([k, v]) => `&${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`).join("");
+    const hostUrl = (host != null ? host : gtmKit.DEFAULT_GTM_HOST).replace(/\/+$/, "");
+    return `(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src='${escapeJsString(hostUrl)}/gtm.js?id='+i+dl${extraParams ? `+'${escapeJsString(extraParams)}'` : ""};f.parentNode.insertBefore(j,f);})(window,document,'script','${escapeJsString(dataLayerName)}','${escapedId}');`;
+  }).join("\n");
+};
 var generateNoscriptTags = (config) => {
   const {
     containers,
@@ -104,6 +143,7 @@ Object.defineProperty(exports, 'normalizeContainers', {
   get: function () { return gtmKit.normalizeContainers; }
 });
 exports.generateDataLayerScript = generateDataLayerScript;
+exports.generateGtmScript = generateGtmScript;
 exports.generateNoscriptTags = generateNoscriptTags;
 exports.generateScriptTags = generateScriptTags;
 //# sourceMappingURL=out.js.map

package/dist/components/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/helpers.ts","../../src/components/index.ts"],"names":["normalizeContainers","normalizeContainer","buildGtmScriptUrl","buildGtmNoscriptUrl"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAiBA,IAAM,sBAAsB,CAAC,UAA2B;AAE7D,SAAO,6BAA6B,KAAK,KAAK;AAChD;AAoBA,IAAM,gBAAgB,CAAoC,QACxD,OAAO,YAAY,OAAO,QAAQ,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC;AAuB9D,IAAM,qBAAqB,CAAC,WAA6C;AAC9E,QAAM;AAAA,IACJ;AAAA,IACA,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA,gBAAgB;AAAA,EAClB,IAAI;AAEJ,QAAM,aAAa,oBAAoB,UAAU;AAEjD,MAAI,CAAC,WAAW,QAAQ;AACtB,UAAM,IAAI,MAAM,yCAAyC;AAAA,EAC3D;AAEA,SAAO,WAAW,IAAI,CAAC,cAAc;AACnC,QAAI,CAAC,UAAU,IAAI;AACjB,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AAEA,UAAM,SAAS;AAAA,MACb,GAAG;AAAA,MACH,GAAG,UAAU;AAAA,IACf;AAEA,UAAM,MAAM,kBAAkB,MAAM,UAAU,IAAI,QAAQ,aAAa;AACvE,UAAM,EAAE,OAAO,WAAW,OAAO,OAAO,GAAG,eAAe,IAAI,8CAAoB,CAAC;AAEnF,WAAO;AAAA,MACL,IAAI,UAAU;AAAA,MACd;AAAA,MACA,OAAO,gCAAa;AAAA,MACpB;AAAA,MACA;AAAA,MACA,YAAY,cAAc,cAAc;AAAA,IAC1C;AAAA,EACF,CAAC;AACH;AAYO,IAAM,uBAAuB,CAClC,WAGsB;AACtB,QAAM;AAAA,IACJ;AAAA,IACA,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA,gBAAgB;AAAA,EAClB,IAAI;AAEJ,QAAM,aAAa,oBAAoB,UAAU;AAEjD,MAAI,CAAC,WAAW,QAAQ;AACtB,UAAM,IAAI,MAAM,yCAAyC;AAAA,EAC3D;AAEA,SAAO,WAAW,IAAI,CAAC,cAAc;AACnC,QAAI,CAAC,UAAU,IAAI;AACjB,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AAEA,UAAM,SAAS;AAAA,MACb,GAAG;AAAA,MACH,GAAG,UAAU;AAAA,IACf;AAEA,UAAM,MAAM,oBAAoB,MAAM,UAAU,IAAI,QAAQ,aAAa;AACzE,UAAM,mBAAmB;AAAA,MACvB,GAAG;AAAA,MACH,GAAG;AAAA,IACL;AAGA,UAAM,aAAa,OAAO;AAAA,MACxB,OAAO,QAAQ,gBAAgB,EAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,KAAK,IAAI,EAC3B,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;AAAA,IACnC;AAEA,WAAO;AAAA,MACL,IAAI,UAAU;AAAA,MACd;AAAA,MACA;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAMO,IAAM,0BAA0B,CAAC,gBAAwB,4BAAoC;AAClG,MAAI,CAAC,oBAAoB,aAAa,GAAG;AACvC,UAAM,IAAI;AAAA,MACR,2BAA2B,aAAa;AAAA,IAC1C;AAAA,EACF;AACA,SAAO,UAAU,aAAa,WAAW,aAAa;AACxD;;;ACnLA;AAAA,EACE,uBAAAA;AAAA,EACA,sBAAAC;AAAA,EACqB,qBAArBC;AAAA,EACuB,uBAAvBC;AAAA,OACK","sourcesContent":["import {\n  DEFAULT_DATA_LAYER_NAME,\n  DEFAULT_GTM_HOST,\n  DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES,\n  normalizeContainer,\n  normalizeContainers,\n  buildGtmScriptUrl,\n  buildGtmNoscriptUrl\n} from '@jwiedeman/gtm-kit';\nimport type { ContainerConfigInput, ScriptAttributes } from '@jwiedeman/gtm-kit';\n\n// Re-export for convenience\nexport {\n  DEFAULT_GTM_HOST,\n  DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES,\n  normalizeContainer,\n  normalizeContainers,\n  buildGtmScriptUrl as buildScriptUrl,\n  buildGtmNoscriptUrl as buildNoscriptUrl\n};\n\n/**\n * Validate that a string is a valid JavaScript identifier.\n * This prevents XSS attacks through dataLayerName injection.\n */\nexport const isValidJsIdentifier = (value: string): boolean => {\n  // Must be a valid JS identifier: starts with letter/$/_, followed by letters/digits/$/_\n  return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(value);\n};\n\n/**\n * Escape a string for safe use in JavaScript string literals.\n * Prevents XSS when interpolating user-provided values into inline scripts.\n */\nexport const escapeJsString = (value: string): string => {\n  return value\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/'/g, \"\\\\'\")\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, '\\\\n')\n    .replace(/\\r/g, '\\\\r')\n    .replace(/</g, '\\\\x3c')\n    .replace(/>/g, '\\\\x3e')\n    .replace(/\\u2028/g, '\\\\u2028')\n    .replace(/\\u2029/g, '\\\\u2029');\n};\n\n/** Filter out null/undefined values from an object */\nconst filterNullish = <T extends Record<string, unknown>>(obj: T): T =>\n  Object.fromEntries(Object.entries(obj).filter(([, v]) => v != null)) as T;\n\nexport interface GtmScriptConfig {\n  containers: ContainerConfigInput | ContainerConfigInput[];\n  host?: string;\n  defaultQueryParams?: Record<string, string | number | boolean>;\n  scriptAttributes?: ScriptAttributes;\n  dataLayerName?: string;\n}\n\nexport interface ScriptTagData {\n  id: string;\n  src: string;\n  async: boolean;\n  defer?: boolean;\n  nonce?: string;\n  attributes: Record<string, string | boolean>;\n}\n\n/**\n * Generate script tag data for GTM containers.\n * Used by Astro components to render script tags.\n */\nexport const generateScriptTags = (config: GtmScriptConfig): ScriptTagData[] => {\n  const {\n    containers,\n    host = DEFAULT_GTM_HOST,\n    defaultQueryParams,\n    scriptAttributes,\n    dataLayerName = DEFAULT_DATA_LAYER_NAME\n  } = config;\n\n  const normalized = normalizeContainers(containers);\n\n  if (!normalized.length) {\n    throw new Error('At least one GTM container is required.');\n  }\n\n  return normalized.map((container) => {\n    if (!container.id) {\n      throw new Error('Container id is required.');\n    }\n\n    const params = {\n      ...defaultQueryParams,\n      ...container.queryParams\n    };\n\n    const src = buildGtmScriptUrl(host, container.id, params, dataLayerName);\n    const { async: asyncAttr, defer, nonce, ...restAttributes } = scriptAttributes ?? {};\n\n    return {\n      id: container.id,\n      src,\n      async: asyncAttr ?? true,\n      defer,\n      nonce,\n      attributes: filterNullish(restAttributes) as Record<string, string | boolean>\n    };\n  });\n};\n\nexport interface NoscriptTagData {\n  id: string;\n  src: string;\n  attributes: Record<string, string>;\n}\n\n/**\n * Generate noscript iframe data for GTM containers.\n * Used by Astro components to render noscript fallbacks.\n */\nexport const generateNoscriptTags = (\n  config: Omit<GtmScriptConfig, 'scriptAttributes'> & {\n    iframeAttributes?: Record<string, string | number | boolean>;\n  }\n): NoscriptTagData[] => {\n  const {\n    containers,\n    host = DEFAULT_GTM_HOST,\n    defaultQueryParams,\n    iframeAttributes,\n    dataLayerName = DEFAULT_DATA_LAYER_NAME\n  } = config;\n\n  const normalized = normalizeContainers(containers);\n\n  if (!normalized.length) {\n    throw new Error('At least one GTM container is required.');\n  }\n\n  return normalized.map((container) => {\n    if (!container.id) {\n      throw new Error('Container id is required.');\n    }\n\n    const params = {\n      ...defaultQueryParams,\n      ...container.queryParams\n    };\n\n    const src = buildGtmNoscriptUrl(host, container.id, params, dataLayerName);\n    const mergedAttributes = {\n      ...DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES,\n      ...iframeAttributes\n    };\n\n    // Filter nullish values and convert to strings\n    const attributes = Object.fromEntries(\n      Object.entries(mergedAttributes)\n        .filter(([, v]) => v != null)\n        .map(([k, v]) => [k, String(v)])\n    ) as Record<string, string>;\n\n    return {\n      id: container.id,\n      src,\n      attributes\n    };\n  });\n};\n\n/**\n * Generate the dataLayer initialization script.\n * @throws {Error} If dataLayerName is not a valid JavaScript identifier\n */\nexport const generateDataLayerScript = (dataLayerName: string = DEFAULT_DATA_LAYER_NAME): string => {\n  if (!isValidJsIdentifier(dataLayerName)) {\n    throw new Error(\n      `Invalid dataLayerName: \"${dataLayerName}\". Must be a valid JavaScript identifier (letters, digits, $, _ only, cannot start with a digit).`\n    );\n  }\n  return `window.${dataLayerName}=window.${dataLayerName}||[];`;\n};\n","export { generateScriptTags, generateNoscriptTags, generateDataLayerScript, DEFAULT_GTM_HOST } from './helpers';\n\n// Re-export URL utilities from core for backwards compatibility\nexport {\n  normalizeContainers,\n  normalizeContainer,\n  buildGtmScriptUrl as buildScriptUrl,\n  buildGtmNoscriptUrl as buildNoscriptUrl\n} from '@jwiedeman/gtm-kit';\n\nexport type { GtmScriptConfig, ScriptTagData, NoscriptTagData } from './helpers';\n"]}
+{"version":3,"sources":["../../src/components/helpers.ts","../../src/components/index.ts"],"names":["normalizeContainers","normalizeContainer","buildGtmScriptUrl","buildGtmNoscriptUrl"],"mappings":"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","sourcesContent":["import {\n  DEFAULT_DATA_LAYER_NAME,\n  DEFAULT_GTM_HOST,\n  DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES,\n  normalizeContainer,\n  normalizeContainers,\n  buildGtmScriptUrl,\n  buildGtmNoscriptUrl\n} from '@jwiedeman/gtm-kit';\nimport type { ContainerConfigInput, ScriptAttributes } from '@jwiedeman/gtm-kit';\n\n// Re-export for convenience\nexport {\n  DEFAULT_GTM_HOST,\n  DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES,\n  normalizeContainer,\n  normalizeContainers,\n  buildGtmScriptUrl as buildScriptUrl,\n  buildGtmNoscriptUrl as buildNoscriptUrl\n};\n\n/**\n * Validate that a string is a valid JavaScript identifier.\n * This prevents XSS attacks through dataLayerName injection.\n */\nexport const isValidJsIdentifier = (value: string): boolean => {\n  // Must be a valid JS identifier: starts with letter/$/_, followed by letters/digits/$/_\n  return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(value);\n};\n\n/**\n * Escape a string for safe use in JavaScript string literals.\n * Prevents XSS when interpolating user-provided values into inline scripts.\n */\nexport const escapeJsString = (value: string): string => {\n  return value\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/'/g, \"\\\\'\")\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, '\\\\n')\n    .replace(/\\r/g, '\\\\r')\n    .replace(/</g, '\\\\x3c')\n    .replace(/>/g, '\\\\x3e')\n    .replace(/\\u2028/g, '\\\\u2028')\n    .replace(/\\u2029/g, '\\\\u2029');\n};\n\n/** Filter out null/undefined values from an object */\nconst filterNullish = <T extends Record<string, unknown>>(obj: T): T =>\n  Object.fromEntries(Object.entries(obj).filter(([, v]) => v != null)) as T;\n\nexport interface GtmScriptConfig {\n  containers: ContainerConfigInput | ContainerConfigInput[];\n  host?: string;\n  defaultQueryParams?: Record<string, string | number | boolean>;\n  scriptAttributes?: ScriptAttributes;\n  dataLayerName?: string;\n}\n\nexport interface ScriptTagData {\n  id: string;\n  src: string;\n  async: boolean;\n  defer?: boolean;\n  nonce?: string;\n  attributes: Record<string, string | boolean>;\n  /**\n   * Inline JavaScript that must be executed before the GTM script loads.\n   * Initializes the dataLayer and pushes the gtm.start event, which is\n   * required for GTM's built-in \"All Pages\" trigger to fire.\n   *\n   * Render this as a `<script>` tag (or `<script is:inline>` in Astro)\n   * immediately before the GTM `<script async src=\"...\">` tag.\n   */\n  initScript: string;\n}\n\n/**\n * Generate script tag data for GTM containers.\n * Used by Astro components to render script tags.\n *\n * Each tag includes an `initScript` property containing the dataLayer\n * initialization and gtm.start event push. This MUST be rendered as an\n * inline script before the GTM script tag, or GTM's \"All Pages\" trigger\n * will not fire.\n */\nexport const generateScriptTags = (config: GtmScriptConfig): ScriptTagData[] => {\n  const {\n    containers,\n    host = DEFAULT_GTM_HOST,\n    defaultQueryParams,\n    scriptAttributes,\n    dataLayerName = DEFAULT_DATA_LAYER_NAME\n  } = config;\n\n  const normalized = normalizeContainers(containers);\n\n  if (!normalized.length) {\n    throw new Error('At least one GTM container is required.');\n  }\n\n  if (!isValidJsIdentifier(dataLayerName)) {\n    throw new Error(\n      `Invalid dataLayerName: \"${dataLayerName}\". Must be a valid JavaScript identifier.`\n    );\n  }\n\n  return normalized.map((container) => {\n    if (!container.id) {\n      throw new Error('Container id is required.');\n    }\n\n    const params = {\n      ...defaultQueryParams,\n      ...container.queryParams\n    };\n\n    const src = buildGtmScriptUrl(host, container.id, params, dataLayerName);\n    const { async: asyncAttr, defer, nonce, ...restAttributes } = scriptAttributes ?? {};\n\n    // Generate the standard GTM initialization script.\n    // This pushes the gtm.start event to the dataLayer, which is required\n    // for GTM to trigger its built-in \"All Pages\" / \"Container Loaded\" trigger.\n    const escapedId = escapeJsString(container.id);\n    const dlParam = dataLayerName !== DEFAULT_DATA_LAYER_NAME ? `'&l='+l` : `''`;\n    const initScript =\n      `window.${dataLayerName}=window.${dataLayerName}||[];` +\n      `window.${dataLayerName}.push({'gtm.start':new Date().getTime(),event:'gtm.js'});`;\n\n    return {\n      id: container.id,\n      src,\n      async: asyncAttr ?? true,\n      defer,\n      nonce,\n      attributes: filterNullish(restAttributes) as Record<string, string | boolean>,\n      initScript\n    };\n  });\n};\n\n/**\n * Generate the complete standard GTM snippet as an inline script string.\n *\n * This produces the Google-recommended GTM installation code that:\n * 1. Initializes the dataLayer array\n * 2. Pushes the gtm.start event (required for \"All Pages\" trigger)\n * 3. Dynamically creates and inserts the GTM script element\n *\n * Usage in Astro:\n * ```astro\n * <script is:inline set:html={generateGtmScript({ containers: 'GTM-XXXX' })} />\n * ```\n *\n * For the noscript fallback, use `generateNoscriptTags()` separately.\n */\nexport const generateGtmScript = (config: Omit<GtmScriptConfig, 'scriptAttributes'>): string => {\n  const {\n    containers,\n    host = DEFAULT_GTM_HOST,\n    defaultQueryParams,\n    dataLayerName = DEFAULT_DATA_LAYER_NAME\n  } = config;\n\n  const normalized = normalizeContainers(containers);\n\n  if (!normalized.length) {\n    throw new Error('At least one GTM container is required.');\n  }\n\n  if (!isValidJsIdentifier(dataLayerName)) {\n    throw new Error(\n      `Invalid dataLayerName: \"${dataLayerName}\". Must be a valid JavaScript identifier.`\n    );\n  }\n\n  // Generate one standard snippet per container\n  return normalized.map((container) => {\n    if (!container.id) {\n      throw new Error('Container id is required.');\n    }\n\n    const escapedId = escapeJsString(container.id);\n    const dlArg = dataLayerName !== DEFAULT_DATA_LAYER_NAME\n      ? `,'${escapeJsString(dataLayerName)}'`\n      : '';\n\n    // Build query params string for additional params (auth, preview, etc.)\n    const mergedParams = { ...defaultQueryParams, ...container.queryParams };\n    const extraParams = Object.entries(mergedParams)\n      .filter(([, v]) => v != null)\n      .map(([k, v]) => `&${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)\n      .join('');\n\n    const hostUrl = (host ?? DEFAULT_GTM_HOST).replace(/\\/+$/, '');\n\n    // Standard GTM snippet — matches Google's recommended installation\n    return `(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':` +\n      `new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],` +\n      `j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=` +\n      `'${escapeJsString(hostUrl)}/gtm.js?id='+i+dl${extraParams ? `+'${escapeJsString(extraParams)}'` : ''};f.parentNode.insertBefore(j,f);` +\n      `})(window,document,'script','${escapeJsString(dataLayerName)}','${escapedId}');`;\n  }).join('\\n');\n};\n\nexport interface NoscriptTagData {\n  id: string;\n  src: string;\n  attributes: Record<string, string>;\n}\n\n/**\n * Generate noscript iframe data for GTM containers.\n * Used by Astro components to render noscript fallbacks.\n */\nexport const generateNoscriptTags = (\n  config: Omit<GtmScriptConfig, 'scriptAttributes'> & {\n    iframeAttributes?: Record<string, string | number | boolean>;\n  }\n): NoscriptTagData[] => {\n  const {\n    containers,\n    host = DEFAULT_GTM_HOST,\n    defaultQueryParams,\n    iframeAttributes,\n    dataLayerName = DEFAULT_DATA_LAYER_NAME\n  } = config;\n\n  const normalized = normalizeContainers(containers);\n\n  if (!normalized.length) {\n    throw new Error('At least one GTM container is required.');\n  }\n\n  return normalized.map((container) => {\n    if (!container.id) {\n      throw new Error('Container id is required.');\n    }\n\n    const params = {\n      ...defaultQueryParams,\n      ...container.queryParams\n    };\n\n    const src = buildGtmNoscriptUrl(host, container.id, params, dataLayerName);\n    const mergedAttributes = {\n      ...DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES,\n      ...iframeAttributes\n    };\n\n    // Filter nullish values and convert to strings\n    const attributes = Object.fromEntries(\n      Object.entries(mergedAttributes)\n        .filter(([, v]) => v != null)\n        .map(([k, v]) => [k, String(v)])\n    ) as Record<string, string>;\n\n    return {\n      id: container.id,\n      src,\n      attributes\n    };\n  });\n};\n\n/**\n * Generate the dataLayer initialization script.\n * @throws {Error} If dataLayerName is not a valid JavaScript identifier\n */\nexport const generateDataLayerScript = (dataLayerName: string = DEFAULT_DATA_LAYER_NAME): string => {\n  if (!isValidJsIdentifier(dataLayerName)) {\n    throw new Error(\n      `Invalid dataLayerName: \"${dataLayerName}\". Must be a valid JavaScript identifier (letters, digits, $, _ only, cannot start with a digit).`\n    );\n  }\n  return `window.${dataLayerName}=window.${dataLayerName}||[];`;\n};\n","export { generateScriptTags, generateNoscriptTags, generateDataLayerScript, generateGtmScript, DEFAULT_GTM_HOST } from './helpers';\n\n// Re-export URL utilities from core for backwards compatibility\nexport {\n  normalizeContainers,\n  normalizeContainer,\n  buildGtmScriptUrl as buildScriptUrl,\n  buildGtmNoscriptUrl as buildNoscriptUrl\n} from '@jwiedeman/gtm-kit';\n\nexport type { GtmScriptConfig, ScriptTagData, NoscriptTagData } from './helpers';\n"]}

package/dist/components/index.d.cts

@@ -15,12 +15,42 @@ interface ScriptTagData {
     defer?: boolean;
     nonce?: string;
     attributes: Record<string, string | boolean>;
+    /**
+     * Inline JavaScript that must be executed before the GTM script loads.
+     * Initializes the dataLayer and pushes the gtm.start event, which is
+     * required for GTM's built-in "All Pages" trigger to fire.
+     *
+     * Render this as a `<script>` tag (or `<script is:inline>` in Astro)
+     * immediately before the GTM `<script async src="...">` tag.
+     */
+    initScript: string;
 }
 /**
  * Generate script tag data for GTM containers.
  * Used by Astro components to render script tags.
+ *
+ * Each tag includes an `initScript` property containing the dataLayer
+ * initialization and gtm.start event push. This MUST be rendered as an
+ * inline script before the GTM script tag, or GTM's "All Pages" trigger
+ * will not fire.
  */
 declare const generateScriptTags: (config: GtmScriptConfig) => ScriptTagData[];
+/**
+ * Generate the complete standard GTM snippet as an inline script string.
+ *
+ * This produces the Google-recommended GTM installation code that:
+ * 1. Initializes the dataLayer array
+ * 2. Pushes the gtm.start event (required for "All Pages" trigger)
+ * 3. Dynamically creates and inserts the GTM script element
+ *
+ * Usage in Astro:
+ * ```astro
+ * <script is:inline set:html={generateGtmScript({ containers: 'GTM-XXXX' })} />
+ * ```
+ *
+ * For the noscript fallback, use `generateNoscriptTags()` separately.
+ */
+declare const generateGtmScript: (config: Omit<GtmScriptConfig, 'scriptAttributes'>) => string;
 interface NoscriptTagData {
     id: string;
     src: string;
@@ -39,4 +69,4 @@ declare const generateNoscriptTags: (config: Omit<GtmScriptConfig, 'scriptAttrib
  */
 declare const generateDataLayerScript: (dataLayerName?: string) => string;
 
-export { GtmScriptConfig, NoscriptTagData, ScriptTagData, generateDataLayerScript, generateNoscriptTags, generateScriptTags };
+export { GtmScriptConfig, NoscriptTagData, ScriptTagData, generateDataLayerScript, generateGtmScript, generateNoscriptTags, generateScriptTags };

package/dist/components/index.d.ts

@@ -15,12 +15,42 @@ interface ScriptTagData {
     defer?: boolean;
     nonce?: string;
     attributes: Record<string, string | boolean>;
+    /**
+     * Inline JavaScript that must be executed before the GTM script loads.
+     * Initializes the dataLayer and pushes the gtm.start event, which is
+     * required for GTM's built-in "All Pages" trigger to fire.
+     *
+     * Render this as a `<script>` tag (or `<script is:inline>` in Astro)
+     * immediately before the GTM `<script async src="...">` tag.
+     */
+    initScript: string;
 }
 /**
  * Generate script tag data for GTM containers.
  * Used by Astro components to render script tags.
+ *
+ * Each tag includes an `initScript` property containing the dataLayer
+ * initialization and gtm.start event push. This MUST be rendered as an
+ * inline script before the GTM script tag, or GTM's "All Pages" trigger
+ * will not fire.
  */
 declare const generateScriptTags: (config: GtmScriptConfig) => ScriptTagData[];
+/**
+ * Generate the complete standard GTM snippet as an inline script string.
+ *
+ * This produces the Google-recommended GTM installation code that:
+ * 1. Initializes the dataLayer array
+ * 2. Pushes the gtm.start event (required for "All Pages" trigger)
+ * 3. Dynamically creates and inserts the GTM script element
+ *
+ * Usage in Astro:
+ * ```astro
+ * <script is:inline set:html={generateGtmScript({ containers: 'GTM-XXXX' })} />
+ * ```
+ *
+ * For the noscript fallback, use `generateNoscriptTags()` separately.
+ */
+declare const generateGtmScript: (config: Omit<GtmScriptConfig, 'scriptAttributes'>) => string;
 interface NoscriptTagData {
     id: string;
     src: string;
@@ -39,4 +69,4 @@ declare const generateNoscriptTags: (config: Omit<GtmScriptConfig, 'scriptAttrib
  */
 declare const generateDataLayerScript: (dataLayerName?: string) => string;
 
-export { GtmScriptConfig, NoscriptTagData, ScriptTagData, generateDataLayerScript, generateNoscriptTags, generateScriptTags };
+export { GtmScriptConfig, NoscriptTagData, ScriptTagData, generateDataLayerScript, generateGtmScript, generateNoscriptTags, generateScriptTags };

package/dist/components/index.js

@@ -1,10 +1,13 @@
-import { normalizeContainers, buildGtmScriptUrl, buildGtmNoscriptUrl, DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES, DEFAULT_DATA_LAYER_NAME, DEFAULT_GTM_HOST } from '@jwiedeman/gtm-kit';
+import { normalizeContainers, buildGtmScriptUrl, DEFAULT_DATA_LAYER_NAME, DEFAULT_GTM_HOST, buildGtmNoscriptUrl, DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES } from '@jwiedeman/gtm-kit';
 export { DEFAULT_GTM_HOST, buildGtmNoscriptUrl as buildNoscriptUrl, buildGtmScriptUrl as buildScriptUrl, normalizeContainer, normalizeContainers } from '@jwiedeman/gtm-kit';
 
 // src/components/helpers.ts
 var isValidJsIdentifier = (value) => {
   return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(value);
 };
+var escapeJsString = (value) => {
+  return value.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/</g, "\\x3c").replace(/>/g, "\\x3e").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+};
 var filterNullish = (obj) => Object.fromEntries(Object.entries(obj).filter(([, v]) => v != null));
 var generateScriptTags = (config) => {
   const {
@@ -18,6 +21,11 @@ var generateScriptTags = (config) => {
   if (!normalized.length) {
     throw new Error("At least one GTM container is required.");
   }
+  if (!isValidJsIdentifier(dataLayerName)) {
+    throw new Error(
+      `Invalid dataLayerName: "${dataLayerName}". Must be a valid JavaScript identifier.`
+    );
+  }
   return normalized.map((container) => {
     if (!container.id) {
       throw new Error("Container id is required.");
@@ -28,16 +36,47 @@ var generateScriptTags = (config) => {
     };
     const src = buildGtmScriptUrl(host, container.id, params, dataLayerName);
     const { async: asyncAttr, defer, nonce, ...restAttributes } = scriptAttributes != null ? scriptAttributes : {};
+    escapeJsString(container.id);
+    const initScript = `window.${dataLayerName}=window.${dataLayerName}||[];window.${dataLayerName}.push({'gtm.start':new Date().getTime(),event:'gtm.js'});`;
     return {
       id: container.id,
       src,
       async: asyncAttr != null ? asyncAttr : true,
       defer,
       nonce,
-      attributes: filterNullish(restAttributes)
+      attributes: filterNullish(restAttributes),
+      initScript
     };
   });
 };
+var generateGtmScript = (config) => {
+  const {
+    containers,
+    host = DEFAULT_GTM_HOST,
+    defaultQueryParams,
+    dataLayerName = DEFAULT_DATA_LAYER_NAME
+  } = config;
+  const normalized = normalizeContainers(containers);
+  if (!normalized.length) {
+    throw new Error("At least one GTM container is required.");
+  }
+  if (!isValidJsIdentifier(dataLayerName)) {
+    throw new Error(
+      `Invalid dataLayerName: "${dataLayerName}". Must be a valid JavaScript identifier.`
+    );
+  }
+  return normalized.map((container) => {
+    if (!container.id) {
+      throw new Error("Container id is required.");
+    }
+    const escapedId = escapeJsString(container.id);
+    dataLayerName !== DEFAULT_DATA_LAYER_NAME ? `,'${escapeJsString(dataLayerName)}'` : "";
+    const mergedParams = { ...defaultQueryParams, ...container.queryParams };
+    const extraParams = Object.entries(mergedParams).filter(([, v]) => v != null).map(([k, v]) => `&${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`).join("");
+    const hostUrl = (host != null ? host : DEFAULT_GTM_HOST).replace(/\/+$/, "");
+    return `(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src='${escapeJsString(hostUrl)}/gtm.js?id='+i+dl${extraParams ? `+'${escapeJsString(extraParams)}'` : ""};f.parentNode.insertBefore(j,f);})(window,document,'script','${escapeJsString(dataLayerName)}','${escapedId}');`;
+  }).join("\n");
+};
 var generateNoscriptTags = (config) => {
   const {
     containers,
@@ -82,6 +121,6 @@ var generateDataLayerScript = (dataLayerName = DEFAULT_DATA_LAYER_NAME) => {
   return `window.${dataLayerName}=window.${dataLayerName}||[];`;
 };
 
-export { generateDataLayerScript, generateNoscriptTags, generateScriptTags };
+export { generateDataLayerScript, generateGtmScript, generateNoscriptTags, generateScriptTags };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/helpers.ts","../../src/components/index.ts"],"names":["normalizeContainers","normalizeContainer","buildGtmScriptUrl","buildGtmNoscriptUrl"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAiBA,IAAM,sBAAsB,CAAC,UAA2B;AAE7D,SAAO,6BAA6B,KAAK,KAAK;AAChD;AAoBA,IAAM,gBAAgB,CAAoC,QACxD,OAAO,YAAY,OAAO,QAAQ,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC;AAuB9D,IAAM,qBAAqB,CAAC,WAA6C;AAC9E,QAAM;AAAA,IACJ;AAAA,IACA,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA,gBAAgB;AAAA,EAClB,IAAI;AAEJ,QAAM,aAAa,oBAAoB,UAAU;AAEjD,MAAI,CAAC,WAAW,QAAQ;AACtB,UAAM,IAAI,MAAM,yCAAyC;AAAA,EAC3D;AAEA,SAAO,WAAW,IAAI,CAAC,cAAc;AACnC,QAAI,CAAC,UAAU,IAAI;AACjB,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AAEA,UAAM,SAAS;AAAA,MACb,GAAG;AAAA,MACH,GAAG,UAAU;AAAA,IACf;AAEA,UAAM,MAAM,kBAAkB,MAAM,UAAU,IAAI,QAAQ,aAAa;AACvE,UAAM,EAAE,OAAO,WAAW,OAAO,OAAO,GAAG,eAAe,IAAI,8CAAoB,CAAC;AAEnF,WAAO;AAAA,MACL,IAAI,UAAU;AAAA,MACd;AAAA,MACA,OAAO,gCAAa;AAAA,MACpB;AAAA,MACA;AAAA,MACA,YAAY,cAAc,cAAc;AAAA,IAC1C;AAAA,EACF,CAAC;AACH;AAYO,IAAM,uBAAuB,CAClC,WAGsB;AACtB,QAAM;AAAA,IACJ;AAAA,IACA,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA,gBAAgB;AAAA,EAClB,IAAI;AAEJ,QAAM,aAAa,oBAAoB,UAAU;AAEjD,MAAI,CAAC,WAAW,QAAQ;AACtB,UAAM,IAAI,MAAM,yCAAyC;AAAA,EAC3D;AAEA,SAAO,WAAW,IAAI,CAAC,cAAc;AACnC,QAAI,CAAC,UAAU,IAAI;AACjB,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC7C;AAEA,UAAM,SAAS;AAAA,MACb,GAAG;AAAA,MACH,GAAG,UAAU;AAAA,IACf;AAEA,UAAM,MAAM,oBAAoB,MAAM,UAAU,IAAI,QAAQ,aAAa;AACzE,UAAM,mBAAmB;AAAA,MACvB,GAAG;AAAA,MACH,GAAG;AAAA,IACL;AAGA,UAAM,aAAa,OAAO;AAAA,MACxB,OAAO,QAAQ,gBAAgB,EAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,KAAK,IAAI,EAC3B,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;AAAA,IACnC;AAEA,WAAO;AAAA,MACL,IAAI,UAAU;AAAA,MACd;AAAA,MACA;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAMO,IAAM,0BAA0B,CAAC,gBAAwB,4BAAoC;AAClG,MAAI,CAAC,oBAAoB,aAAa,GAAG;AACvC,UAAM,IAAI;AAAA,MACR,2BAA2B,aAAa;AAAA,IAC1C;AAAA,EACF;AACA,SAAO,UAAU,aAAa,WAAW,aAAa;AACxD;;;ACnLA;AAAA,EACE,uBAAAA;AAAA,EACA,sBAAAC;AAAA,EACqB,qBAArBC;AAAA,EACuB,uBAAvBC;AAAA,OACK","sourcesContent":["import {\n  DEFAULT_DATA_LAYER_NAME,\n  DEFAULT_GTM_HOST,\n  DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES,\n  normalizeContainer,\n  normalizeContainers,\n  buildGtmScriptUrl,\n  buildGtmNoscriptUrl\n} from '@jwiedeman/gtm-kit';\nimport type { ContainerConfigInput, ScriptAttributes } from '@jwiedeman/gtm-kit';\n\n// Re-export for convenience\nexport {\n  DEFAULT_GTM_HOST,\n  DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES,\n  normalizeContainer,\n  normalizeContainers,\n  buildGtmScriptUrl as buildScriptUrl,\n  buildGtmNoscriptUrl as buildNoscriptUrl\n};\n\n/**\n * Validate that a string is a valid JavaScript identifier.\n * This prevents XSS attacks through dataLayerName injection.\n */\nexport const isValidJsIdentifier = (value: string): boolean => {\n  // Must be a valid JS identifier: starts with letter/$/_, followed by letters/digits/$/_\n  return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(value);\n};\n\n/**\n * Escape a string for safe use in JavaScript string literals.\n * Prevents XSS when interpolating user-provided values into inline scripts.\n */\nexport const escapeJsString = (value: string): string => {\n  return value\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/'/g, \"\\\\'\")\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, '\\\\n')\n    .replace(/\\r/g, '\\\\r')\n    .replace(/</g, '\\\\x3c')\n    .replace(/>/g, '\\\\x3e')\n    .replace(/\\u2028/g, '\\\\u2028')\n    .replace(/\\u2029/g, '\\\\u2029');\n};\n\n/** Filter out null/undefined values from an object */\nconst filterNullish = <T extends Record<string, unknown>>(obj: T): T =>\n  Object.fromEntries(Object.entries(obj).filter(([, v]) => v != null)) as T;\n\nexport interface GtmScriptConfig {\n  containers: ContainerConfigInput | ContainerConfigInput[];\n  host?: string;\n  defaultQueryParams?: Record<string, string | number | boolean>;\n  scriptAttributes?: ScriptAttributes;\n  dataLayerName?: string;\n}\n\nexport interface ScriptTagData {\n  id: string;\n  src: string;\n  async: boolean;\n  defer?: boolean;\n  nonce?: string;\n  attributes: Record<string, string | boolean>;\n}\n\n/**\n * Generate script tag data for GTM containers.\n * Used by Astro components to render script tags.\n */\nexport const generateScriptTags = (config: GtmScriptConfig): ScriptTagData[] => {\n  const {\n    containers,\n    host = DEFAULT_GTM_HOST,\n    defaultQueryParams,\n    scriptAttributes,\n    dataLayerName = DEFAULT_DATA_LAYER_NAME\n  } = config;\n\n  const normalized = normalizeContainers(containers);\n\n  if (!normalized.length) {\n    throw new Error('At least one GTM container is required.');\n  }\n\n  return normalized.map((container) => {\n    if (!container.id) {\n      throw new Error('Container id is required.');\n    }\n\n    const params = {\n      ...defaultQueryParams,\n      ...container.queryParams\n    };\n\n    const src = buildGtmScriptUrl(host, container.id, params, dataLayerName);\n    const { async: asyncAttr, defer, nonce, ...restAttributes } = scriptAttributes ?? {};\n\n    return {\n      id: container.id,\n      src,\n      async: asyncAttr ?? true,\n      defer,\n      nonce,\n      attributes: filterNullish(restAttributes) as Record<string, string | boolean>\n    };\n  });\n};\n\nexport interface NoscriptTagData {\n  id: string;\n  src: string;\n  attributes: Record<string, string>;\n}\n\n/**\n * Generate noscript iframe data for GTM containers.\n * Used by Astro components to render noscript fallbacks.\n */\nexport const generateNoscriptTags = (\n  config: Omit<GtmScriptConfig, 'scriptAttributes'> & {\n    iframeAttributes?: Record<string, string | number | boolean>;\n  }\n): NoscriptTagData[] => {\n  const {\n    containers,\n    host = DEFAULT_GTM_HOST,\n    defaultQueryParams,\n    iframeAttributes,\n    dataLayerName = DEFAULT_DATA_LAYER_NAME\n  } = config;\n\n  const normalized = normalizeContainers(containers);\n\n  if (!normalized.length) {\n    throw new Error('At least one GTM container is required.');\n  }\n\n  return normalized.map((container) => {\n    if (!container.id) {\n      throw new Error('Container id is required.');\n    }\n\n    const params = {\n      ...defaultQueryParams,\n      ...container.queryParams\n    };\n\n    const src = buildGtmNoscriptUrl(host, container.id, params, dataLayerName);\n    const mergedAttributes = {\n      ...DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES,\n      ...iframeAttributes\n    };\n\n    // Filter nullish values and convert to strings\n    const attributes = Object.fromEntries(\n      Object.entries(mergedAttributes)\n        .filter(([, v]) => v != null)\n        .map(([k, v]) => [k, String(v)])\n    ) as Record<string, string>;\n\n    return {\n      id: container.id,\n      src,\n      attributes\n    };\n  });\n};\n\n/**\n * Generate the dataLayer initialization script.\n * @throws {Error} If dataLayerName is not a valid JavaScript identifier\n */\nexport const generateDataLayerScript = (dataLayerName: string = DEFAULT_DATA_LAYER_NAME): string => {\n  if (!isValidJsIdentifier(dataLayerName)) {\n    throw new Error(\n      `Invalid dataLayerName: \"${dataLayerName}\". Must be a valid JavaScript identifier (letters, digits, $, _ only, cannot start with a digit).`\n    );\n  }\n  return `window.${dataLayerName}=window.${dataLayerName}||[];`;\n};\n","export { generateScriptTags, generateNoscriptTags, generateDataLayerScript, DEFAULT_GTM_HOST } from './helpers';\n\n// Re-export URL utilities from core for backwards compatibility\nexport {\n  normalizeContainers,\n  normalizeContainer,\n  buildGtmScriptUrl as buildScriptUrl,\n  buildGtmNoscriptUrl as buildNoscriptUrl\n} from '@jwiedeman/gtm-kit';\n\nexport type { GtmScriptConfig, ScriptTagData, NoscriptTagData } from './helpers';\n"]}
+{"version":3,"sources":["../../src/components/helpers.ts","../../src/components/index.ts"],"names":["normalizeContainers","normalizeContainer","buildGtmScriptUrl","buildGtmNoscriptUrl"],"mappings":"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","sourcesContent":["import {\n  DEFAULT_DATA_LAYER_NAME,\n  DEFAULT_GTM_HOST,\n  DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES,\n  normalizeContainer,\n  normalizeContainers,\n  buildGtmScriptUrl,\n  buildGtmNoscriptUrl\n} from '@jwiedeman/gtm-kit';\nimport type { ContainerConfigInput, ScriptAttributes } from '@jwiedeman/gtm-kit';\n\n// Re-export for convenience\nexport {\n  DEFAULT_GTM_HOST,\n  DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES,\n  normalizeContainer,\n  normalizeContainers,\n  buildGtmScriptUrl as buildScriptUrl,\n  buildGtmNoscriptUrl as buildNoscriptUrl\n};\n\n/**\n * Validate that a string is a valid JavaScript identifier.\n * This prevents XSS attacks through dataLayerName injection.\n */\nexport const isValidJsIdentifier = (value: string): boolean => {\n  // Must be a valid JS identifier: starts with letter/$/_, followed by letters/digits/$/_\n  return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(value);\n};\n\n/**\n * Escape a string for safe use in JavaScript string literals.\n * Prevents XSS when interpolating user-provided values into inline scripts.\n */\nexport const escapeJsString = (value: string): string => {\n  return value\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/'/g, \"\\\\'\")\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, '\\\\n')\n    .replace(/\\r/g, '\\\\r')\n    .replace(/</g, '\\\\x3c')\n    .replace(/>/g, '\\\\x3e')\n    .replace(/\\u2028/g, '\\\\u2028')\n    .replace(/\\u2029/g, '\\\\u2029');\n};\n\n/** Filter out null/undefined values from an object */\nconst filterNullish = <T extends Record<string, unknown>>(obj: T): T =>\n  Object.fromEntries(Object.entries(obj).filter(([, v]) => v != null)) as T;\n\nexport interface GtmScriptConfig {\n  containers: ContainerConfigInput | ContainerConfigInput[];\n  host?: string;\n  defaultQueryParams?: Record<string, string | number | boolean>;\n  scriptAttributes?: ScriptAttributes;\n  dataLayerName?: string;\n}\n\nexport interface ScriptTagData {\n  id: string;\n  src: string;\n  async: boolean;\n  defer?: boolean;\n  nonce?: string;\n  attributes: Record<string, string | boolean>;\n  /**\n   * Inline JavaScript that must be executed before the GTM script loads.\n   * Initializes the dataLayer and pushes the gtm.start event, which is\n   * required for GTM's built-in \"All Pages\" trigger to fire.\n   *\n   * Render this as a `<script>` tag (or `<script is:inline>` in Astro)\n   * immediately before the GTM `<script async src=\"...\">` tag.\n   */\n  initScript: string;\n}\n\n/**\n * Generate script tag data for GTM containers.\n * Used by Astro components to render script tags.\n *\n * Each tag includes an `initScript` property containing the dataLayer\n * initialization and gtm.start event push. This MUST be rendered as an\n * inline script before the GTM script tag, or GTM's \"All Pages\" trigger\n * will not fire.\n */\nexport const generateScriptTags = (config: GtmScriptConfig): ScriptTagData[] => {\n  const {\n    containers,\n    host = DEFAULT_GTM_HOST,\n    defaultQueryParams,\n    scriptAttributes,\n    dataLayerName = DEFAULT_DATA_LAYER_NAME\n  } = config;\n\n  const normalized = normalizeContainers(containers);\n\n  if (!normalized.length) {\n    throw new Error('At least one GTM container is required.');\n  }\n\n  if (!isValidJsIdentifier(dataLayerName)) {\n    throw new Error(\n      `Invalid dataLayerName: \"${dataLayerName}\". Must be a valid JavaScript identifier.`\n    );\n  }\n\n  return normalized.map((container) => {\n    if (!container.id) {\n      throw new Error('Container id is required.');\n    }\n\n    const params = {\n      ...defaultQueryParams,\n      ...container.queryParams\n    };\n\n    const src = buildGtmScriptUrl(host, container.id, params, dataLayerName);\n    const { async: asyncAttr, defer, nonce, ...restAttributes } = scriptAttributes ?? {};\n\n    // Generate the standard GTM initialization script.\n    // This pushes the gtm.start event to the dataLayer, which is required\n    // for GTM to trigger its built-in \"All Pages\" / \"Container Loaded\" trigger.\n    const escapedId = escapeJsString(container.id);\n    const dlParam = dataLayerName !== DEFAULT_DATA_LAYER_NAME ? `'&l='+l` : `''`;\n    const initScript =\n      `window.${dataLayerName}=window.${dataLayerName}||[];` +\n      `window.${dataLayerName}.push({'gtm.start':new Date().getTime(),event:'gtm.js'});`;\n\n    return {\n      id: container.id,\n      src,\n      async: asyncAttr ?? true,\n      defer,\n      nonce,\n      attributes: filterNullish(restAttributes) as Record<string, string | boolean>,\n      initScript\n    };\n  });\n};\n\n/**\n * Generate the complete standard GTM snippet as an inline script string.\n *\n * This produces the Google-recommended GTM installation code that:\n * 1. Initializes the dataLayer array\n * 2. Pushes the gtm.start event (required for \"All Pages\" trigger)\n * 3. Dynamically creates and inserts the GTM script element\n *\n * Usage in Astro:\n * ```astro\n * <script is:inline set:html={generateGtmScript({ containers: 'GTM-XXXX' })} />\n * ```\n *\n * For the noscript fallback, use `generateNoscriptTags()` separately.\n */\nexport const generateGtmScript = (config: Omit<GtmScriptConfig, 'scriptAttributes'>): string => {\n  const {\n    containers,\n    host = DEFAULT_GTM_HOST,\n    defaultQueryParams,\n    dataLayerName = DEFAULT_DATA_LAYER_NAME\n  } = config;\n\n  const normalized = normalizeContainers(containers);\n\n  if (!normalized.length) {\n    throw new Error('At least one GTM container is required.');\n  }\n\n  if (!isValidJsIdentifier(dataLayerName)) {\n    throw new Error(\n      `Invalid dataLayerName: \"${dataLayerName}\". Must be a valid JavaScript identifier.`\n    );\n  }\n\n  // Generate one standard snippet per container\n  return normalized.map((container) => {\n    if (!container.id) {\n      throw new Error('Container id is required.');\n    }\n\n    const escapedId = escapeJsString(container.id);\n    const dlArg = dataLayerName !== DEFAULT_DATA_LAYER_NAME\n      ? `,'${escapeJsString(dataLayerName)}'`\n      : '';\n\n    // Build query params string for additional params (auth, preview, etc.)\n    const mergedParams = { ...defaultQueryParams, ...container.queryParams };\n    const extraParams = Object.entries(mergedParams)\n      .filter(([, v]) => v != null)\n      .map(([k, v]) => `&${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)\n      .join('');\n\n    const hostUrl = (host ?? DEFAULT_GTM_HOST).replace(/\\/+$/, '');\n\n    // Standard GTM snippet — matches Google's recommended installation\n    return `(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':` +\n      `new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],` +\n      `j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=` +\n      `'${escapeJsString(hostUrl)}/gtm.js?id='+i+dl${extraParams ? `+'${escapeJsString(extraParams)}'` : ''};f.parentNode.insertBefore(j,f);` +\n      `})(window,document,'script','${escapeJsString(dataLayerName)}','${escapedId}');`;\n  }).join('\\n');\n};\n\nexport interface NoscriptTagData {\n  id: string;\n  src: string;\n  attributes: Record<string, string>;\n}\n\n/**\n * Generate noscript iframe data for GTM containers.\n * Used by Astro components to render noscript fallbacks.\n */\nexport const generateNoscriptTags = (\n  config: Omit<GtmScriptConfig, 'scriptAttributes'> & {\n    iframeAttributes?: Record<string, string | number | boolean>;\n  }\n): NoscriptTagData[] => {\n  const {\n    containers,\n    host = DEFAULT_GTM_HOST,\n    defaultQueryParams,\n    iframeAttributes,\n    dataLayerName = DEFAULT_DATA_LAYER_NAME\n  } = config;\n\n  const normalized = normalizeContainers(containers);\n\n  if (!normalized.length) {\n    throw new Error('At least one GTM container is required.');\n  }\n\n  return normalized.map((container) => {\n    if (!container.id) {\n      throw new Error('Container id is required.');\n    }\n\n    const params = {\n      ...defaultQueryParams,\n      ...container.queryParams\n    };\n\n    const src = buildGtmNoscriptUrl(host, container.id, params, dataLayerName);\n    const mergedAttributes = {\n      ...DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES,\n      ...iframeAttributes\n    };\n\n    // Filter nullish values and convert to strings\n    const attributes = Object.fromEntries(\n      Object.entries(mergedAttributes)\n        .filter(([, v]) => v != null)\n        .map(([k, v]) => [k, String(v)])\n    ) as Record<string, string>;\n\n    return {\n      id: container.id,\n      src,\n      attributes\n    };\n  });\n};\n\n/**\n * Generate the dataLayer initialization script.\n * @throws {Error} If dataLayerName is not a valid JavaScript identifier\n */\nexport const generateDataLayerScript = (dataLayerName: string = DEFAULT_DATA_LAYER_NAME): string => {\n  if (!isValidJsIdentifier(dataLayerName)) {\n    throw new Error(\n      `Invalid dataLayerName: \"${dataLayerName}\". Must be a valid JavaScript identifier (letters, digits, $, _ only, cannot start with a digit).`\n    );\n  }\n  return `window.${dataLayerName}=window.${dataLayerName}||[];`;\n};\n","export { generateScriptTags, generateNoscriptTags, generateDataLayerScript, generateGtmScript, DEFAULT_GTM_HOST } from './helpers';\n\n// Re-export URL utilities from core for backwards compatibility\nexport {\n  normalizeContainers,\n  normalizeContainer,\n  buildGtmScriptUrl as buildScriptUrl,\n  buildGtmNoscriptUrl as buildNoscriptUrl\n} from '@jwiedeman/gtm-kit';\n\nexport type { GtmScriptConfig, ScriptTagData, NoscriptTagData } from './helpers';\n"]}

package/dist/index.cjs

@@ -7,6 +7,11 @@ var clientInstance = null;
 var clientConfig = null;
 var initGtm = (options) => {
   if (clientInstance) {
+    if (process.env.NODE_ENV === "development" && clientConfig && JSON.stringify(options) !== JSON.stringify(clientConfig)) {
+      console.warn(
+        "[gtm-kit/astro] initGtm() called again with different options. The original configuration is kept. Call teardown() first if you need to reinitialize with new options."
+      );
+    }
     return clientInstance;
   }
   clientInstance = gtmKit.createGtmClient(options);
@@ -110,6 +115,7 @@ var trackPageView = (options = {}) => {
   push(pageViewData);
 };
 var viewTransitionsSetup = false;
+var pageTrackingSetup = false;
 var lastTrackedPath = "";
 var setupViewTransitions = (options = {}) => {
   if (typeof window === "undefined" || typeof document === "undefined") {
@@ -140,6 +146,10 @@ var setupPageTracking = (options = {}) => {
   if (typeof window === "undefined") {
     return noop;
   }
+  if (pageTrackingSetup) {
+    return noop;
+  }
+  pageTrackingSetup = true;
   lastTrackedPath = window.location.pathname + window.location.search;
   trackPageView(options);
   const handlePopState = () => {
@@ -153,6 +163,7 @@ var setupPageTracking = (options = {}) => {
   window.addEventListener("popstate", handlePopState);
   return () => {
     window.removeEventListener("popstate", handlePopState);
+    pageTrackingSetup = false;
     lastTrackedPath = "";
   };
 };

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/page-tracking.ts","../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createGtmClient,\n  type ConsentRegionOptions,\n  type ConsentState,\n  type CreateGtmClientOptions,\n  type DataLayerValue,\n  type GtmClient,\n  type ScriptLoadState\n} from '@jwiedeman/gtm-kit';\n\nlet clientInstance: GtmClient | null = null;\nlet clientConfig: CreateGtmClientOptions | null = null;\n\n/**\n * Initialize the GTM client for use in Astro.\n * Should be called once when the page loads.\n *\n * @example\n * ```ts\n * // In a client-side script\n * import { initGtm } from '@jwiedeman/gtm-kit-astro';\n *\n * initGtm({ containers: 'GTM-XXXXXX' });\n * ```\n */\nexport const initGtm = (options: CreateGtmClientOptions): GtmClient => {\n  // If already initialized, return existing instance\n  // (common in Astro with view transitions where initGtm may be called multiple times)\n  if (clientInstance) {\n    return clientInstance;\n  }\n\n  clientInstance = createGtmClient(options);\n  clientConfig = options;\n  clientInstance.init();\n\n  return clientInstance;\n};\n\n/**\n * Get the current GTM client instance.\n * Returns null if not initialized.\n *\n * @example\n * ```ts\n * import { getGtmClient } from '@jwiedeman/gtm-kit-astro';\n *\n * const client = getGtmClient();\n * if (client) {\n *   client.push({ event: 'page_view' });\n * }\n * ```\n */\nexport const getGtmClient = (): GtmClient | null => clientInstance;\n\n/**\n * Get the GTM client or throw if not initialized.\n * Use this when you expect the client to be available.\n *\n * @throws Error if GTM client is not initialized\n */\nexport const requireGtmClient = (): GtmClient => {\n  if (!clientInstance) {\n    throw new Error(\n      '[gtm-kit/astro] GTM client not initialized. Call initGtm() first or ensure the GTM script has loaded.'\n    );\n  }\n  return clientInstance;\n};\n\n/**\n * Push a value to the GTM dataLayer.\n * This is a convenience function that handles the case where GTM isn't initialized.\n *\n * @returns true if the value was pushed successfully, false otherwise\n *\n * @example\n * ```ts\n * import { push } from '@jwiedeman/gtm-kit-astro';\n *\n * const success = push({ event: 'button_click', button_name: 'hero_cta' });\n * if (!success) {\n *   console.warn('GTM not ready');\n * }\n * ```\n */\n/**\n * Type-safe access to window properties for dataLayer.\n */\nconst getWindowDataLayer = (name: string): DataLayerValue[] | undefined => {\n  if (typeof window === 'undefined') {\n    return undefined;\n  }\n  const win = window as typeof window & Record<string, unknown>;\n  const layer = win[name];\n  return Array.isArray(layer) ? (layer as DataLayerValue[]) : undefined;\n};\n\nexport const push = (value: DataLayerValue): boolean => {\n  const client = getGtmClient();\n  if (client) {\n    client.push(value);\n    return true;\n  } else if (typeof window !== 'undefined') {\n    // Fallback: push directly to dataLayer if it exists\n    const dataLayerName = clientConfig?.dataLayerName ?? 'dataLayer';\n    const dataLayer = getWindowDataLayer(dataLayerName);\n    if (dataLayer) {\n      dataLayer.push(value);\n      return true;\n    } else {\n      console.warn('[gtm-kit/astro] GTM not initialized and dataLayer not found.');\n      return false;\n    }\n  }\n  return false;\n};\n\n/**\n * Set consent defaults (must be called before GTM loads).\n *\n * @returns true if consent defaults were set, false if GTM not initialized\n *\n * @example\n * ```ts\n * import { setConsentDefaults } from '@jwiedeman/gtm-kit-astro';\n *\n * const success = setConsentDefaults({\n *   ad_storage: 'denied',\n *   analytics_storage: 'denied'\n * });\n * ```\n */\nexport const setConsentDefaults = (state: ConsentState, options?: ConsentRegionOptions): boolean => {\n  const client = getGtmClient();\n  if (client) {\n    client.setConsentDefaults(state, options);\n    return true;\n  } else {\n    console.warn('[gtm-kit/astro] GTM not initialized. Consent defaults should be set before init.');\n    return false;\n  }\n};\n\n/**\n * Update consent state after user interaction.\n *\n * @returns true if consent was updated, false if GTM not initialized\n *\n * @example\n * ```ts\n * import { updateConsent } from '@jwiedeman/gtm-kit-astro';\n *\n * // When user accepts cookies\n * const success = updateConsent({\n *   ad_storage: 'granted',\n *   analytics_storage: 'granted',\n *   ad_user_data: 'granted',\n *   ad_personalization: 'granted'\n * });\n * ```\n */\nexport const updateConsent = (state: ConsentState, options?: ConsentRegionOptions): boolean => {\n  const client = getGtmClient();\n  if (client) {\n    client.updateConsent(state, options);\n    return true;\n  } else {\n    console.warn('[gtm-kit/astro] GTM not initialized. Cannot update consent.');\n    return false;\n  }\n};\n\n/**\n * Wait for GTM scripts to be ready.\n *\n * @example\n * ```ts\n * import { whenReady } from '@jwiedeman/gtm-kit-astro';\n *\n * whenReady().then((states) => {\n *   console.log('GTM loaded:', states);\n * });\n * ```\n */\nexport const whenReady = (): Promise<ScriptLoadState[]> => {\n  const client = getGtmClient();\n  if (client) {\n    return client.whenReady();\n  }\n  return Promise.reject(new Error('[gtm-kit/astro] GTM not initialized.'));\n};\n\n/**\n * Clean up the GTM client.\n * Call this when navigating away or cleaning up.\n */\nexport const teardown = (): void => {\n  if (clientInstance) {\n    clientInstance.teardown();\n    clientInstance = null;\n    clientConfig = null;\n  }\n};\n","import { push } from './client';\n\n// No-op function for SSR/cleanup returns\nconst noop = (): void => {\n  /* no-op */\n};\n\nexport interface PageViewData {\n  event?: string;\n  page_path?: string;\n  page_location?: string;\n  page_title?: string;\n  page_referrer?: string;\n  [key: string]: unknown;\n}\n\nexport interface TrackPageViewOptions {\n  /**\n   * The event name to use for page views.\n   * @default 'page_view'\n   */\n  eventName?: string;\n\n  /**\n   * Whether to include query parameters in the page path.\n   * @default true\n   */\n  includeQueryParams?: boolean;\n\n  /**\n   * Additional data to include with each page view.\n   */\n  additionalData?: Record<string, unknown> | (() => Record<string, unknown>);\n}\n\nconst getAdditionalData = (additionalData: TrackPageViewOptions['additionalData']): Record<string, unknown> => {\n  if (typeof additionalData === 'function') {\n    return additionalData();\n  }\n  return additionalData ?? {};\n};\n\n/**\n * Track a page view event.\n *\n * @example\n * ```ts\n * import { trackPageView } from '@jwiedeman/gtm-kit-astro';\n *\n * // Track current page\n * trackPageView();\n *\n * // Track with custom data\n * trackPageView({\n *   additionalData: { user_type: 'guest' }\n * });\n * ```\n */\nexport const trackPageView = (options: TrackPageViewOptions = {}): void => {\n  const { eventName = 'page_view', includeQueryParams = true, additionalData } = options;\n\n  if (typeof window === 'undefined') {\n    return;\n  }\n\n  const pagePath = includeQueryParams ? window.location.pathname + window.location.search : window.location.pathname;\n\n  const pageViewData: PageViewData = {\n    event: eventName,\n    page_path: pagePath,\n    page_location: window.location.href,\n    page_title: document.title,\n    ...getAdditionalData(additionalData)\n  };\n\n  push(pageViewData);\n};\n\nlet viewTransitionsSetup = false;\nlet lastTrackedPath = '';\n\n/**\n * Reset page tracking state (for testing only).\n * @internal\n */\nexport const _resetPageTrackingState = (): void => {\n  viewTransitionsSetup = false;\n  lastTrackedPath = '';\n};\n\n/**\n * Set up automatic page view tracking with Astro View Transitions.\n * Call this once when the page loads.\n *\n * @example\n * ```astro\n * ---\n * // src/layouts/Layout.astro\n * ---\n * <script>\n *   import { initGtm, setupViewTransitions } from '@jwiedeman/gtm-kit-astro';\n *\n *   initGtm({ containers: 'GTM-XXXXXX' });\n *   setupViewTransitions();\n * </script>\n * ```\n */\nexport const setupViewTransitions = (options: TrackPageViewOptions = {}): (() => void) => {\n  if (typeof window === 'undefined' || typeof document === 'undefined') {\n    return noop;\n  }\n\n  // Prevent duplicate setup\n  if (viewTransitionsSetup) {\n    return noop;\n  }\n\n  viewTransitionsSetup = true;\n\n  // Track initial page view\n  lastTrackedPath = window.location.pathname + window.location.search;\n  trackPageView(options);\n\n  // Handle Astro View Transitions\n  // The 'astro:page-load' event fires after every page load, including View Transitions\n  const handlePageLoad = () => {\n    const currentPath = window.location.pathname + window.location.search;\n\n    // Avoid duplicate tracking for the same path\n    if (currentPath === lastTrackedPath) {\n      return;\n    }\n\n    lastTrackedPath = currentPath;\n    trackPageView(options);\n  };\n\n  document.addEventListener('astro:page-load', handlePageLoad);\n\n  // Cleanup function\n  return () => {\n    document.removeEventListener('astro:page-load', handlePageLoad);\n    viewTransitionsSetup = false;\n    lastTrackedPath = '';\n  };\n};\n\n/**\n * Set up page view tracking for standard navigation (no View Transitions).\n * Tracks on popstate (back/forward) and initial load.\n *\n * @example\n * ```ts\n * import { setupPageTracking } from '@jwiedeman/gtm-kit-astro';\n *\n * setupPageTracking();\n * ```\n */\nexport const setupPageTracking = (options: TrackPageViewOptions = {}): (() => void) => {\n  if (typeof window === 'undefined') {\n    return noop;\n  }\n\n  // Track initial page view\n  lastTrackedPath = window.location.pathname + window.location.search;\n  trackPageView(options);\n\n  // Handle browser back/forward navigation\n  const handlePopState = () => {\n    const currentPath = window.location.pathname + window.location.search;\n\n    if (currentPath === lastTrackedPath) {\n      return;\n    }\n\n    lastTrackedPath = currentPath;\n    trackPageView(options);\n  };\n\n  window.addEventListener('popstate', handlePopState);\n\n  return () => {\n    window.removeEventListener('popstate', handlePopState);\n    lastTrackedPath = '';\n  };\n};\n","// Client-side GTM management\nexport {\n  initGtm,\n  getGtmClient,\n  requireGtmClient,\n  push,\n  setConsentDefaults,\n  updateConsent,\n  whenReady,\n  teardown\n} from './client';\n\n// Page tracking\nexport { trackPageView, setupViewTransitions, setupPageTracking } from './page-tracking';\nexport type { PageViewData, TrackPageViewOptions } from './page-tracking';\n\n// Re-export core types for convenience\nexport type {\n  ConsentState,\n  ConsentRegionOptions,\n  CreateGtmClientOptions,\n  DataLayerValue,\n  GtmClient,\n  ScriptLoadState,\n  ContainerConfigInput,\n  ContainerDescriptor,\n  ScriptAttributes\n} from '@jwiedeman/gtm-kit';\n\n// Re-export consent helpers\nexport { consentPresets, getConsentPreset, eeaDefault, allGranted, analyticsOnly } from '@jwiedeman/gtm-kit';\n"]}
+{"version":3,"sources":["../src/client.ts","../src/page-tracking.ts","../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createGtmClient,\n  type ConsentRegionOptions,\n  type ConsentState,\n  type CreateGtmClientOptions,\n  type DataLayerValue,\n  type GtmClient,\n  type ScriptLoadState\n} from '@jwiedeman/gtm-kit';\n\nlet clientInstance: GtmClient | null = null;\nlet clientConfig: CreateGtmClientOptions | null = null;\n\n/**\n * Initialize the GTM client for use in Astro.\n * Should be called once when the page loads.\n *\n * @example\n * ```ts\n * // In a client-side script\n * import { initGtm } from '@jwiedeman/gtm-kit-astro';\n *\n * initGtm({ containers: 'GTM-XXXXXX' });\n * ```\n */\nexport const initGtm = (options: CreateGtmClientOptions): GtmClient => {\n  // If already initialized, return existing instance\n  // (common in Astro with view transitions where initGtm may be called multiple times)\n  if (clientInstance) {\n    if (\n      process.env.NODE_ENV === 'development' &&\n      clientConfig &&\n      JSON.stringify(options) !== JSON.stringify(clientConfig)\n    ) {\n      console.warn(\n        '[gtm-kit/astro] initGtm() called again with different options. ' +\n          'The original configuration is kept. Call teardown() first if you need to reinitialize with new options.'\n      );\n    }\n    return clientInstance;\n  }\n\n  clientInstance = createGtmClient(options);\n  clientConfig = options;\n  clientInstance.init();\n\n  return clientInstance;\n};\n\n/**\n * Get the current GTM client instance.\n * Returns null if not initialized.\n *\n * @example\n * ```ts\n * import { getGtmClient } from '@jwiedeman/gtm-kit-astro';\n *\n * const client = getGtmClient();\n * if (client) {\n *   client.push({ event: 'page_view' });\n * }\n * ```\n */\nexport const getGtmClient = (): GtmClient | null => clientInstance;\n\n/**\n * Get the GTM client or throw if not initialized.\n * Use this when you expect the client to be available.\n *\n * @throws Error if GTM client is not initialized\n */\nexport const requireGtmClient = (): GtmClient => {\n  if (!clientInstance) {\n    throw new Error(\n      '[gtm-kit/astro] GTM client not initialized. Call initGtm() first or ensure the GTM script has loaded.'\n    );\n  }\n  return clientInstance;\n};\n\n/**\n * Push a value to the GTM dataLayer.\n * This is a convenience function that handles the case where GTM isn't initialized.\n *\n * @returns true if the value was pushed successfully, false otherwise\n *\n * @example\n * ```ts\n * import { push } from '@jwiedeman/gtm-kit-astro';\n *\n * const success = push({ event: 'button_click', button_name: 'hero_cta' });\n * if (!success) {\n *   console.warn('GTM not ready');\n * }\n * ```\n */\n/**\n * Type-safe access to window properties for dataLayer.\n */\nconst getWindowDataLayer = (name: string): DataLayerValue[] | undefined => {\n  if (typeof window === 'undefined') {\n    return undefined;\n  }\n  const win = window as typeof window & Record<string, unknown>;\n  const layer = win[name];\n  return Array.isArray(layer) ? (layer as DataLayerValue[]) : undefined;\n};\n\nexport const push = (value: DataLayerValue): boolean => {\n  const client = getGtmClient();\n  if (client) {\n    client.push(value);\n    return true;\n  } else if (typeof window !== 'undefined') {\n    // Fallback: push directly to dataLayer if it exists\n    const dataLayerName = clientConfig?.dataLayerName ?? 'dataLayer';\n    const dataLayer = getWindowDataLayer(dataLayerName);\n    if (dataLayer) {\n      dataLayer.push(value);\n      return true;\n    } else {\n      console.warn('[gtm-kit/astro] GTM not initialized and dataLayer not found.');\n      return false;\n    }\n  }\n  return false;\n};\n\n/**\n * Set consent defaults (must be called before GTM loads).\n *\n * @returns true if consent defaults were set, false if GTM not initialized\n *\n * @example\n * ```ts\n * import { setConsentDefaults } from '@jwiedeman/gtm-kit-astro';\n *\n * const success = setConsentDefaults({\n *   ad_storage: 'denied',\n *   analytics_storage: 'denied'\n * });\n * ```\n */\nexport const setConsentDefaults = (state: ConsentState, options?: ConsentRegionOptions): boolean => {\n  const client = getGtmClient();\n  if (client) {\n    client.setConsentDefaults(state, options);\n    return true;\n  } else {\n    console.warn('[gtm-kit/astro] GTM not initialized. Consent defaults should be set before init.');\n    return false;\n  }\n};\n\n/**\n * Update consent state after user interaction.\n *\n * @returns true if consent was updated, false if GTM not initialized\n *\n * @example\n * ```ts\n * import { updateConsent } from '@jwiedeman/gtm-kit-astro';\n *\n * // When user accepts cookies\n * const success = updateConsent({\n *   ad_storage: 'granted',\n *   analytics_storage: 'granted',\n *   ad_user_data: 'granted',\n *   ad_personalization: 'granted'\n * });\n * ```\n */\nexport const updateConsent = (state: ConsentState, options?: ConsentRegionOptions): boolean => {\n  const client = getGtmClient();\n  if (client) {\n    client.updateConsent(state, options);\n    return true;\n  } else {\n    console.warn('[gtm-kit/astro] GTM not initialized. Cannot update consent.');\n    return false;\n  }\n};\n\n/**\n * Wait for GTM scripts to be ready.\n *\n * @example\n * ```ts\n * import { whenReady } from '@jwiedeman/gtm-kit-astro';\n *\n * whenReady().then((states) => {\n *   console.log('GTM loaded:', states);\n * });\n * ```\n */\nexport const whenReady = (): Promise<ScriptLoadState[]> => {\n  const client = getGtmClient();\n  if (client) {\n    return client.whenReady();\n  }\n  return Promise.reject(new Error('[gtm-kit/astro] GTM not initialized.'));\n};\n\n/**\n * Clean up the GTM client.\n * Call this when navigating away or cleaning up.\n */\nexport const teardown = (): void => {\n  if (clientInstance) {\n    clientInstance.teardown();\n    clientInstance = null;\n    clientConfig = null;\n  }\n};\n","import { push } from './client';\n\n// No-op function for SSR/cleanup returns\nconst noop = (): void => {\n  /* no-op */\n};\n\nexport interface PageViewData {\n  event?: string;\n  page_path?: string;\n  page_location?: string;\n  page_title?: string;\n  page_referrer?: string;\n  [key: string]: unknown;\n}\n\nexport interface TrackPageViewOptions {\n  /**\n   * The event name to use for page views.\n   * @default 'page_view'\n   */\n  eventName?: string;\n\n  /**\n   * Whether to include query parameters in the page path.\n   * @default true\n   */\n  includeQueryParams?: boolean;\n\n  /**\n   * Additional data to include with each page view.\n   */\n  additionalData?: Record<string, unknown> | (() => Record<string, unknown>);\n}\n\nconst getAdditionalData = (additionalData: TrackPageViewOptions['additionalData']): Record<string, unknown> => {\n  if (typeof additionalData === 'function') {\n    return additionalData();\n  }\n  return additionalData ?? {};\n};\n\n/**\n * Track a page view event.\n *\n * @example\n * ```ts\n * import { trackPageView } from '@jwiedeman/gtm-kit-astro';\n *\n * // Track current page\n * trackPageView();\n *\n * // Track with custom data\n * trackPageView({\n *   additionalData: { user_type: 'guest' }\n * });\n * ```\n */\nexport const trackPageView = (options: TrackPageViewOptions = {}): void => {\n  const { eventName = 'page_view', includeQueryParams = true, additionalData } = options;\n\n  if (typeof window === 'undefined') {\n    return;\n  }\n\n  const pagePath = includeQueryParams ? window.location.pathname + window.location.search : window.location.pathname;\n\n  const pageViewData: PageViewData = {\n    event: eventName,\n    page_path: pagePath,\n    page_location: window.location.href,\n    page_title: document.title,\n    ...getAdditionalData(additionalData)\n  };\n\n  push(pageViewData);\n};\n\nlet viewTransitionsSetup = false;\nlet pageTrackingSetup = false;\nlet lastTrackedPath = '';\n\n/**\n * Reset page tracking state (for testing only).\n * @internal\n */\nexport const _resetPageTrackingState = (): void => {\n  viewTransitionsSetup = false;\n  pageTrackingSetup = false;\n  lastTrackedPath = '';\n};\n\n/**\n * Set up automatic page view tracking with Astro View Transitions.\n * Call this once when the page loads.\n *\n * @example\n * ```astro\n * ---\n * // src/layouts/Layout.astro\n * ---\n * <script>\n *   import { initGtm, setupViewTransitions } from '@jwiedeman/gtm-kit-astro';\n *\n *   initGtm({ containers: 'GTM-XXXXXX' });\n *   setupViewTransitions();\n * </script>\n * ```\n */\nexport const setupViewTransitions = (options: TrackPageViewOptions = {}): (() => void) => {\n  if (typeof window === 'undefined' || typeof document === 'undefined') {\n    return noop;\n  }\n\n  // Prevent duplicate setup\n  if (viewTransitionsSetup) {\n    return noop;\n  }\n\n  viewTransitionsSetup = true;\n\n  // Track initial page view\n  lastTrackedPath = window.location.pathname + window.location.search;\n  trackPageView(options);\n\n  // Handle Astro View Transitions\n  // The 'astro:page-load' event fires after every page load, including View Transitions\n  const handlePageLoad = () => {\n    const currentPath = window.location.pathname + window.location.search;\n\n    // Avoid duplicate tracking for the same path\n    if (currentPath === lastTrackedPath) {\n      return;\n    }\n\n    lastTrackedPath = currentPath;\n    trackPageView(options);\n  };\n\n  document.addEventListener('astro:page-load', handlePageLoad);\n\n  // Cleanup function\n  return () => {\n    document.removeEventListener('astro:page-load', handlePageLoad);\n    viewTransitionsSetup = false;\n    lastTrackedPath = '';\n  };\n};\n\n/**\n * Set up page view tracking for standard navigation (no View Transitions).\n * Tracks on popstate (back/forward) and initial load.\n *\n * @example\n * ```ts\n * import { setupPageTracking } from '@jwiedeman/gtm-kit-astro';\n *\n * setupPageTracking();\n * ```\n */\nexport const setupPageTracking = (options: TrackPageViewOptions = {}): (() => void) => {\n  if (typeof window === 'undefined') {\n    return noop;\n  }\n\n  // Prevent duplicate setup\n  if (pageTrackingSetup) {\n    return noop;\n  }\n\n  pageTrackingSetup = true;\n\n  // Track initial page view\n  lastTrackedPath = window.location.pathname + window.location.search;\n  trackPageView(options);\n\n  // Handle browser back/forward navigation\n  const handlePopState = () => {\n    const currentPath = window.location.pathname + window.location.search;\n\n    if (currentPath === lastTrackedPath) {\n      return;\n    }\n\n    lastTrackedPath = currentPath;\n    trackPageView(options);\n  };\n\n  window.addEventListener('popstate', handlePopState);\n\n  return () => {\n    window.removeEventListener('popstate', handlePopState);\n    pageTrackingSetup = false;\n    lastTrackedPath = '';\n  };\n};\n","// Client-side GTM management\nexport {\n  initGtm,\n  getGtmClient,\n  requireGtmClient,\n  push,\n  setConsentDefaults,\n  updateConsent,\n  whenReady,\n  teardown\n} from './client';\n\n// Page tracking\nexport { trackPageView, setupViewTransitions, setupPageTracking } from './page-tracking';\nexport type { PageViewData, TrackPageViewOptions } from './page-tracking';\n\n// Re-export core types for convenience\nexport type {\n  ConsentState,\n  ConsentRegionOptions,\n  CreateGtmClientOptions,\n  DataLayerValue,\n  GtmClient,\n  ScriptLoadState,\n  ContainerConfigInput,\n  ContainerDescriptor,\n  ScriptAttributes\n} from '@jwiedeman/gtm-kit';\n\n// Re-export consent helpers\nexport { consentPresets, getConsentPreset, eeaDefault, allGranted, analyticsOnly } from '@jwiedeman/gtm-kit';\n"]}

package/dist/index.js

@@ -6,6 +6,11 @@ var clientInstance = null;
 var clientConfig = null;
 var initGtm = (options) => {
   if (clientInstance) {
+    if (process.env.NODE_ENV === "development" && clientConfig && JSON.stringify(options) !== JSON.stringify(clientConfig)) {
+      console.warn(
+        "[gtm-kit/astro] initGtm() called again with different options. The original configuration is kept. Call teardown() first if you need to reinitialize with new options."
+      );
+    }
     return clientInstance;
   }
   clientInstance = createGtmClient(options);
@@ -109,6 +114,7 @@ var trackPageView = (options = {}) => {
   push(pageViewData);
 };
 var viewTransitionsSetup = false;
+var pageTrackingSetup = false;
 var lastTrackedPath = "";
 var setupViewTransitions = (options = {}) => {
   if (typeof window === "undefined" || typeof document === "undefined") {
@@ -139,6 +145,10 @@ var setupPageTracking = (options = {}) => {
   if (typeof window === "undefined") {
     return noop;
   }
+  if (pageTrackingSetup) {
+    return noop;
+  }
+  pageTrackingSetup = true;
   lastTrackedPath = window.location.pathname + window.location.search;
   trackPageView(options);
   const handlePopState = () => {
@@ -152,6 +162,7 @@ var setupPageTracking = (options = {}) => {
   window.addEventListener("popstate", handlePopState);
   return () => {
     window.removeEventListener("popstate", handlePopState);
+    pageTrackingSetup = false;
     lastTrackedPath = "";
   };
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/page-tracking.ts","../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createGtmClient,\n  type ConsentRegionOptions,\n  type ConsentState,\n  type CreateGtmClientOptions,\n  type DataLayerValue,\n  type GtmClient,\n  type ScriptLoadState\n} from '@jwiedeman/gtm-kit';\n\nlet clientInstance: GtmClient | null = null;\nlet clientConfig: CreateGtmClientOptions | null = null;\n\n/**\n * Initialize the GTM client for use in Astro.\n * Should be called once when the page loads.\n *\n * @example\n * ```ts\n * // In a client-side script\n * import { initGtm } from '@jwiedeman/gtm-kit-astro';\n *\n * initGtm({ containers: 'GTM-XXXXXX' });\n * ```\n */\nexport const initGtm = (options: CreateGtmClientOptions): GtmClient => {\n  // If already initialized, return existing instance\n  // (common in Astro with view transitions where initGtm may be called multiple times)\n  if (clientInstance) {\n    return clientInstance;\n  }\n\n  clientInstance = createGtmClient(options);\n  clientConfig = options;\n  clientInstance.init();\n\n  return clientInstance;\n};\n\n/**\n * Get the current GTM client instance.\n * Returns null if not initialized.\n *\n * @example\n * ```ts\n * import { getGtmClient } from '@jwiedeman/gtm-kit-astro';\n *\n * const client = getGtmClient();\n * if (client) {\n *   client.push({ event: 'page_view' });\n * }\n * ```\n */\nexport const getGtmClient = (): GtmClient | null => clientInstance;\n\n/**\n * Get the GTM client or throw if not initialized.\n * Use this when you expect the client to be available.\n *\n * @throws Error if GTM client is not initialized\n */\nexport const requireGtmClient = (): GtmClient => {\n  if (!clientInstance) {\n    throw new Error(\n      '[gtm-kit/astro] GTM client not initialized. Call initGtm() first or ensure the GTM script has loaded.'\n    );\n  }\n  return clientInstance;\n};\n\n/**\n * Push a value to the GTM dataLayer.\n * This is a convenience function that handles the case where GTM isn't initialized.\n *\n * @returns true if the value was pushed successfully, false otherwise\n *\n * @example\n * ```ts\n * import { push } from '@jwiedeman/gtm-kit-astro';\n *\n * const success = push({ event: 'button_click', button_name: 'hero_cta' });\n * if (!success) {\n *   console.warn('GTM not ready');\n * }\n * ```\n */\n/**\n * Type-safe access to window properties for dataLayer.\n */\nconst getWindowDataLayer = (name: string): DataLayerValue[] | undefined => {\n  if (typeof window === 'undefined') {\n    return undefined;\n  }\n  const win = window as typeof window & Record<string, unknown>;\n  const layer = win[name];\n  return Array.isArray(layer) ? (layer as DataLayerValue[]) : undefined;\n};\n\nexport const push = (value: DataLayerValue): boolean => {\n  const client = getGtmClient();\n  if (client) {\n    client.push(value);\n    return true;\n  } else if (typeof window !== 'undefined') {\n    // Fallback: push directly to dataLayer if it exists\n    const dataLayerName = clientConfig?.dataLayerName ?? 'dataLayer';\n    const dataLayer = getWindowDataLayer(dataLayerName);\n    if (dataLayer) {\n      dataLayer.push(value);\n      return true;\n    } else {\n      console.warn('[gtm-kit/astro] GTM not initialized and dataLayer not found.');\n      return false;\n    }\n  }\n  return false;\n};\n\n/**\n * Set consent defaults (must be called before GTM loads).\n *\n * @returns true if consent defaults were set, false if GTM not initialized\n *\n * @example\n * ```ts\n * import { setConsentDefaults } from '@jwiedeman/gtm-kit-astro';\n *\n * const success = setConsentDefaults({\n *   ad_storage: 'denied',\n *   analytics_storage: 'denied'\n * });\n * ```\n */\nexport const setConsentDefaults = (state: ConsentState, options?: ConsentRegionOptions): boolean => {\n  const client = getGtmClient();\n  if (client) {\n    client.setConsentDefaults(state, options);\n    return true;\n  } else {\n    console.warn('[gtm-kit/astro] GTM not initialized. Consent defaults should be set before init.');\n    return false;\n  }\n};\n\n/**\n * Update consent state after user interaction.\n *\n * @returns true if consent was updated, false if GTM not initialized\n *\n * @example\n * ```ts\n * import { updateConsent } from '@jwiedeman/gtm-kit-astro';\n *\n * // When user accepts cookies\n * const success = updateConsent({\n *   ad_storage: 'granted',\n *   analytics_storage: 'granted',\n *   ad_user_data: 'granted',\n *   ad_personalization: 'granted'\n * });\n * ```\n */\nexport const updateConsent = (state: ConsentState, options?: ConsentRegionOptions): boolean => {\n  const client = getGtmClient();\n  if (client) {\n    client.updateConsent(state, options);\n    return true;\n  } else {\n    console.warn('[gtm-kit/astro] GTM not initialized. Cannot update consent.');\n    return false;\n  }\n};\n\n/**\n * Wait for GTM scripts to be ready.\n *\n * @example\n * ```ts\n * import { whenReady } from '@jwiedeman/gtm-kit-astro';\n *\n * whenReady().then((states) => {\n *   console.log('GTM loaded:', states);\n * });\n * ```\n */\nexport const whenReady = (): Promise<ScriptLoadState[]> => {\n  const client = getGtmClient();\n  if (client) {\n    return client.whenReady();\n  }\n  return Promise.reject(new Error('[gtm-kit/astro] GTM not initialized.'));\n};\n\n/**\n * Clean up the GTM client.\n * Call this when navigating away or cleaning up.\n */\nexport const teardown = (): void => {\n  if (clientInstance) {\n    clientInstance.teardown();\n    clientInstance = null;\n    clientConfig = null;\n  }\n};\n","import { push } from './client';\n\n// No-op function for SSR/cleanup returns\nconst noop = (): void => {\n  /* no-op */\n};\n\nexport interface PageViewData {\n  event?: string;\n  page_path?: string;\n  page_location?: string;\n  page_title?: string;\n  page_referrer?: string;\n  [key: string]: unknown;\n}\n\nexport interface TrackPageViewOptions {\n  /**\n   * The event name to use for page views.\n   * @default 'page_view'\n   */\n  eventName?: string;\n\n  /**\n   * Whether to include query parameters in the page path.\n   * @default true\n   */\n  includeQueryParams?: boolean;\n\n  /**\n   * Additional data to include with each page view.\n   */\n  additionalData?: Record<string, unknown> | (() => Record<string, unknown>);\n}\n\nconst getAdditionalData = (additionalData: TrackPageViewOptions['additionalData']): Record<string, unknown> => {\n  if (typeof additionalData === 'function') {\n    return additionalData();\n  }\n  return additionalData ?? {};\n};\n\n/**\n * Track a page view event.\n *\n * @example\n * ```ts\n * import { trackPageView } from '@jwiedeman/gtm-kit-astro';\n *\n * // Track current page\n * trackPageView();\n *\n * // Track with custom data\n * trackPageView({\n *   additionalData: { user_type: 'guest' }\n * });\n * ```\n */\nexport const trackPageView = (options: TrackPageViewOptions = {}): void => {\n  const { eventName = 'page_view', includeQueryParams = true, additionalData } = options;\n\n  if (typeof window === 'undefined') {\n    return;\n  }\n\n  const pagePath = includeQueryParams ? window.location.pathname + window.location.search : window.location.pathname;\n\n  const pageViewData: PageViewData = {\n    event: eventName,\n    page_path: pagePath,\n    page_location: window.location.href,\n    page_title: document.title,\n    ...getAdditionalData(additionalData)\n  };\n\n  push(pageViewData);\n};\n\nlet viewTransitionsSetup = false;\nlet lastTrackedPath = '';\n\n/**\n * Reset page tracking state (for testing only).\n * @internal\n */\nexport const _resetPageTrackingState = (): void => {\n  viewTransitionsSetup = false;\n  lastTrackedPath = '';\n};\n\n/**\n * Set up automatic page view tracking with Astro View Transitions.\n * Call this once when the page loads.\n *\n * @example\n * ```astro\n * ---\n * // src/layouts/Layout.astro\n * ---\n * <script>\n *   import { initGtm, setupViewTransitions } from '@jwiedeman/gtm-kit-astro';\n *\n *   initGtm({ containers: 'GTM-XXXXXX' });\n *   setupViewTransitions();\n * </script>\n * ```\n */\nexport const setupViewTransitions = (options: TrackPageViewOptions = {}): (() => void) => {\n  if (typeof window === 'undefined' || typeof document === 'undefined') {\n    return noop;\n  }\n\n  // Prevent duplicate setup\n  if (viewTransitionsSetup) {\n    return noop;\n  }\n\n  viewTransitionsSetup = true;\n\n  // Track initial page view\n  lastTrackedPath = window.location.pathname + window.location.search;\n  trackPageView(options);\n\n  // Handle Astro View Transitions\n  // The 'astro:page-load' event fires after every page load, including View Transitions\n  const handlePageLoad = () => {\n    const currentPath = window.location.pathname + window.location.search;\n\n    // Avoid duplicate tracking for the same path\n    if (currentPath === lastTrackedPath) {\n      return;\n    }\n\n    lastTrackedPath = currentPath;\n    trackPageView(options);\n  };\n\n  document.addEventListener('astro:page-load', handlePageLoad);\n\n  // Cleanup function\n  return () => {\n    document.removeEventListener('astro:page-load', handlePageLoad);\n    viewTransitionsSetup = false;\n    lastTrackedPath = '';\n  };\n};\n\n/**\n * Set up page view tracking for standard navigation (no View Transitions).\n * Tracks on popstate (back/forward) and initial load.\n *\n * @example\n * ```ts\n * import { setupPageTracking } from '@jwiedeman/gtm-kit-astro';\n *\n * setupPageTracking();\n * ```\n */\nexport const setupPageTracking = (options: TrackPageViewOptions = {}): (() => void) => {\n  if (typeof window === 'undefined') {\n    return noop;\n  }\n\n  // Track initial page view\n  lastTrackedPath = window.location.pathname + window.location.search;\n  trackPageView(options);\n\n  // Handle browser back/forward navigation\n  const handlePopState = () => {\n    const currentPath = window.location.pathname + window.location.search;\n\n    if (currentPath === lastTrackedPath) {\n      return;\n    }\n\n    lastTrackedPath = currentPath;\n    trackPageView(options);\n  };\n\n  window.addEventListener('popstate', handlePopState);\n\n  return () => {\n    window.removeEventListener('popstate', handlePopState);\n    lastTrackedPath = '';\n  };\n};\n","// Client-side GTM management\nexport {\n  initGtm,\n  getGtmClient,\n  requireGtmClient,\n  push,\n  setConsentDefaults,\n  updateConsent,\n  whenReady,\n  teardown\n} from './client';\n\n// Page tracking\nexport { trackPageView, setupViewTransitions, setupPageTracking } from './page-tracking';\nexport type { PageViewData, TrackPageViewOptions } from './page-tracking';\n\n// Re-export core types for convenience\nexport type {\n  ConsentState,\n  ConsentRegionOptions,\n  CreateGtmClientOptions,\n  DataLayerValue,\n  GtmClient,\n  ScriptLoadState,\n  ContainerConfigInput,\n  ContainerDescriptor,\n  ScriptAttributes\n} from '@jwiedeman/gtm-kit';\n\n// Re-export consent helpers\nexport { consentPresets, getConsentPreset, eeaDefault, allGranted, analyticsOnly } from '@jwiedeman/gtm-kit';\n"]}
+{"version":3,"sources":["../src/client.ts","../src/page-tracking.ts","../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createGtmClient,\n  type ConsentRegionOptions,\n  type ConsentState,\n  type CreateGtmClientOptions,\n  type DataLayerValue,\n  type GtmClient,\n  type ScriptLoadState\n} from '@jwiedeman/gtm-kit';\n\nlet clientInstance: GtmClient | null = null;\nlet clientConfig: CreateGtmClientOptions | null = null;\n\n/**\n * Initialize the GTM client for use in Astro.\n * Should be called once when the page loads.\n *\n * @example\n * ```ts\n * // In a client-side script\n * import { initGtm } from '@jwiedeman/gtm-kit-astro';\n *\n * initGtm({ containers: 'GTM-XXXXXX' });\n * ```\n */\nexport const initGtm = (options: CreateGtmClientOptions): GtmClient => {\n  // If already initialized, return existing instance\n  // (common in Astro with view transitions where initGtm may be called multiple times)\n  if (clientInstance) {\n    if (\n      process.env.NODE_ENV === 'development' &&\n      clientConfig &&\n      JSON.stringify(options) !== JSON.stringify(clientConfig)\n    ) {\n      console.warn(\n        '[gtm-kit/astro] initGtm() called again with different options. ' +\n          'The original configuration is kept. Call teardown() first if you need to reinitialize with new options.'\n      );\n    }\n    return clientInstance;\n  }\n\n  clientInstance = createGtmClient(options);\n  clientConfig = options;\n  clientInstance.init();\n\n  return clientInstance;\n};\n\n/**\n * Get the current GTM client instance.\n * Returns null if not initialized.\n *\n * @example\n * ```ts\n * import { getGtmClient } from '@jwiedeman/gtm-kit-astro';\n *\n * const client = getGtmClient();\n * if (client) {\n *   client.push({ event: 'page_view' });\n * }\n * ```\n */\nexport const getGtmClient = (): GtmClient | null => clientInstance;\n\n/**\n * Get the GTM client or throw if not initialized.\n * Use this when you expect the client to be available.\n *\n * @throws Error if GTM client is not initialized\n */\nexport const requireGtmClient = (): GtmClient => {\n  if (!clientInstance) {\n    throw new Error(\n      '[gtm-kit/astro] GTM client not initialized. Call initGtm() first or ensure the GTM script has loaded.'\n    );\n  }\n  return clientInstance;\n};\n\n/**\n * Push a value to the GTM dataLayer.\n * This is a convenience function that handles the case where GTM isn't initialized.\n *\n * @returns true if the value was pushed successfully, false otherwise\n *\n * @example\n * ```ts\n * import { push } from '@jwiedeman/gtm-kit-astro';\n *\n * const success = push({ event: 'button_click', button_name: 'hero_cta' });\n * if (!success) {\n *   console.warn('GTM not ready');\n * }\n * ```\n */\n/**\n * Type-safe access to window properties for dataLayer.\n */\nconst getWindowDataLayer = (name: string): DataLayerValue[] | undefined => {\n  if (typeof window === 'undefined') {\n    return undefined;\n  }\n  const win = window as typeof window & Record<string, unknown>;\n  const layer = win[name];\n  return Array.isArray(layer) ? (layer as DataLayerValue[]) : undefined;\n};\n\nexport const push = (value: DataLayerValue): boolean => {\n  const client = getGtmClient();\n  if (client) {\n    client.push(value);\n    return true;\n  } else if (typeof window !== 'undefined') {\n    // Fallback: push directly to dataLayer if it exists\n    const dataLayerName = clientConfig?.dataLayerName ?? 'dataLayer';\n    const dataLayer = getWindowDataLayer(dataLayerName);\n    if (dataLayer) {\n      dataLayer.push(value);\n      return true;\n    } else {\n      console.warn('[gtm-kit/astro] GTM not initialized and dataLayer not found.');\n      return false;\n    }\n  }\n  return false;\n};\n\n/**\n * Set consent defaults (must be called before GTM loads).\n *\n * @returns true if consent defaults were set, false if GTM not initialized\n *\n * @example\n * ```ts\n * import { setConsentDefaults } from '@jwiedeman/gtm-kit-astro';\n *\n * const success = setConsentDefaults({\n *   ad_storage: 'denied',\n *   analytics_storage: 'denied'\n * });\n * ```\n */\nexport const setConsentDefaults = (state: ConsentState, options?: ConsentRegionOptions): boolean => {\n  const client = getGtmClient();\n  if (client) {\n    client.setConsentDefaults(state, options);\n    return true;\n  } else {\n    console.warn('[gtm-kit/astro] GTM not initialized. Consent defaults should be set before init.');\n    return false;\n  }\n};\n\n/**\n * Update consent state after user interaction.\n *\n * @returns true if consent was updated, false if GTM not initialized\n *\n * @example\n * ```ts\n * import { updateConsent } from '@jwiedeman/gtm-kit-astro';\n *\n * // When user accepts cookies\n * const success = updateConsent({\n *   ad_storage: 'granted',\n *   analytics_storage: 'granted',\n *   ad_user_data: 'granted',\n *   ad_personalization: 'granted'\n * });\n * ```\n */\nexport const updateConsent = (state: ConsentState, options?: ConsentRegionOptions): boolean => {\n  const client = getGtmClient();\n  if (client) {\n    client.updateConsent(state, options);\n    return true;\n  } else {\n    console.warn('[gtm-kit/astro] GTM not initialized. Cannot update consent.');\n    return false;\n  }\n};\n\n/**\n * Wait for GTM scripts to be ready.\n *\n * @example\n * ```ts\n * import { whenReady } from '@jwiedeman/gtm-kit-astro';\n *\n * whenReady().then((states) => {\n *   console.log('GTM loaded:', states);\n * });\n * ```\n */\nexport const whenReady = (): Promise<ScriptLoadState[]> => {\n  const client = getGtmClient();\n  if (client) {\n    return client.whenReady();\n  }\n  return Promise.reject(new Error('[gtm-kit/astro] GTM not initialized.'));\n};\n\n/**\n * Clean up the GTM client.\n * Call this when navigating away or cleaning up.\n */\nexport const teardown = (): void => {\n  if (clientInstance) {\n    clientInstance.teardown();\n    clientInstance = null;\n    clientConfig = null;\n  }\n};\n","import { push } from './client';\n\n// No-op function for SSR/cleanup returns\nconst noop = (): void => {\n  /* no-op */\n};\n\nexport interface PageViewData {\n  event?: string;\n  page_path?: string;\n  page_location?: string;\n  page_title?: string;\n  page_referrer?: string;\n  [key: string]: unknown;\n}\n\nexport interface TrackPageViewOptions {\n  /**\n   * The event name to use for page views.\n   * @default 'page_view'\n   */\n  eventName?: string;\n\n  /**\n   * Whether to include query parameters in the page path.\n   * @default true\n   */\n  includeQueryParams?: boolean;\n\n  /**\n   * Additional data to include with each page view.\n   */\n  additionalData?: Record<string, unknown> | (() => Record<string, unknown>);\n}\n\nconst getAdditionalData = (additionalData: TrackPageViewOptions['additionalData']): Record<string, unknown> => {\n  if (typeof additionalData === 'function') {\n    return additionalData();\n  }\n  return additionalData ?? {};\n};\n\n/**\n * Track a page view event.\n *\n * @example\n * ```ts\n * import { trackPageView } from '@jwiedeman/gtm-kit-astro';\n *\n * // Track current page\n * trackPageView();\n *\n * // Track with custom data\n * trackPageView({\n *   additionalData: { user_type: 'guest' }\n * });\n * ```\n */\nexport const trackPageView = (options: TrackPageViewOptions = {}): void => {\n  const { eventName = 'page_view', includeQueryParams = true, additionalData } = options;\n\n  if (typeof window === 'undefined') {\n    return;\n  }\n\n  const pagePath = includeQueryParams ? window.location.pathname + window.location.search : window.location.pathname;\n\n  const pageViewData: PageViewData = {\n    event: eventName,\n    page_path: pagePath,\n    page_location: window.location.href,\n    page_title: document.title,\n    ...getAdditionalData(additionalData)\n  };\n\n  push(pageViewData);\n};\n\nlet viewTransitionsSetup = false;\nlet pageTrackingSetup = false;\nlet lastTrackedPath = '';\n\n/**\n * Reset page tracking state (for testing only).\n * @internal\n */\nexport const _resetPageTrackingState = (): void => {\n  viewTransitionsSetup = false;\n  pageTrackingSetup = false;\n  lastTrackedPath = '';\n};\n\n/**\n * Set up automatic page view tracking with Astro View Transitions.\n * Call this once when the page loads.\n *\n * @example\n * ```astro\n * ---\n * // src/layouts/Layout.astro\n * ---\n * <script>\n *   import { initGtm, setupViewTransitions } from '@jwiedeman/gtm-kit-astro';\n *\n *   initGtm({ containers: 'GTM-XXXXXX' });\n *   setupViewTransitions();\n * </script>\n * ```\n */\nexport const setupViewTransitions = (options: TrackPageViewOptions = {}): (() => void) => {\n  if (typeof window === 'undefined' || typeof document === 'undefined') {\n    return noop;\n  }\n\n  // Prevent duplicate setup\n  if (viewTransitionsSetup) {\n    return noop;\n  }\n\n  viewTransitionsSetup = true;\n\n  // Track initial page view\n  lastTrackedPath = window.location.pathname + window.location.search;\n  trackPageView(options);\n\n  // Handle Astro View Transitions\n  // The 'astro:page-load' event fires after every page load, including View Transitions\n  const handlePageLoad = () => {\n    const currentPath = window.location.pathname + window.location.search;\n\n    // Avoid duplicate tracking for the same path\n    if (currentPath === lastTrackedPath) {\n      return;\n    }\n\n    lastTrackedPath = currentPath;\n    trackPageView(options);\n  };\n\n  document.addEventListener('astro:page-load', handlePageLoad);\n\n  // Cleanup function\n  return () => {\n    document.removeEventListener('astro:page-load', handlePageLoad);\n    viewTransitionsSetup = false;\n    lastTrackedPath = '';\n  };\n};\n\n/**\n * Set up page view tracking for standard navigation (no View Transitions).\n * Tracks on popstate (back/forward) and initial load.\n *\n * @example\n * ```ts\n * import { setupPageTracking } from '@jwiedeman/gtm-kit-astro';\n *\n * setupPageTracking();\n * ```\n */\nexport const setupPageTracking = (options: TrackPageViewOptions = {}): (() => void) => {\n  if (typeof window === 'undefined') {\n    return noop;\n  }\n\n  // Prevent duplicate setup\n  if (pageTrackingSetup) {\n    return noop;\n  }\n\n  pageTrackingSetup = true;\n\n  // Track initial page view\n  lastTrackedPath = window.location.pathname + window.location.search;\n  trackPageView(options);\n\n  // Handle browser back/forward navigation\n  const handlePopState = () => {\n    const currentPath = window.location.pathname + window.location.search;\n\n    if (currentPath === lastTrackedPath) {\n      return;\n    }\n\n    lastTrackedPath = currentPath;\n    trackPageView(options);\n  };\n\n  window.addEventListener('popstate', handlePopState);\n\n  return () => {\n    window.removeEventListener('popstate', handlePopState);\n    pageTrackingSetup = false;\n    lastTrackedPath = '';\n  };\n};\n","// Client-side GTM management\nexport {\n  initGtm,\n  getGtmClient,\n  requireGtmClient,\n  push,\n  setConsentDefaults,\n  updateConsent,\n  whenReady,\n  teardown\n} from './client';\n\n// Page tracking\nexport { trackPageView, setupViewTransitions, setupPageTracking } from './page-tracking';\nexport type { PageViewData, TrackPageViewOptions } from './page-tracking';\n\n// Re-export core types for convenience\nexport type {\n  ConsentState,\n  ConsentRegionOptions,\n  CreateGtmClientOptions,\n  DataLayerValue,\n  GtmClient,\n  ScriptLoadState,\n  ContainerConfigInput,\n  ContainerDescriptor,\n  ScriptAttributes\n} from '@jwiedeman/gtm-kit';\n\n// Re-export consent helpers\nexport { consentPresets, getConsentPreset, eeaDefault, allGranted, analyticsOnly } from '@jwiedeman/gtm-kit';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jwiedeman/gtm-kit-astro",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Astro components and helpers for GTM Kit - Google Tag Manager integration with View Transitions support.",
   "repository": {
     "type": "git",
@@ -44,8 +44,7 @@
     }
   },
   "files": [
-    "dist",
-    "src/components/*.astro"
+    "dist"
   ],
   "scripts": {
     "build": "tsup",

package/src/components/GtmHead.astro

@@ -1,128 +0,0 @@
----
-/**
- * GTM Head Component
- *
- * A convenience component that sets up GTM in the document head
- * with optional consent mode and auto page tracking.
- *
- * @example
- * ```astro
- * ---
- * import { GtmHead } from '@jwiedeman/gtm-kit-astro/components';
- * ---
- * <head>
- *   <GtmHead
- *     containers="GTM-XXXXXX"
- *     enablePageTracking
- *     defaultConsent={{
- *       ad_storage: 'denied',
- *       analytics_storage: 'denied'
- *     }}
- *   />
- * </head>
- * ```
- */
-import type { ContainerConfigInput, ScriptAttributes, ConsentState } from '@jwiedeman/gtm-kit';
-import {
-  generateScriptTags,
-  generateDataLayerScript,
-  escapeJsString,
-  isValidJsIdentifier,
-  DEFAULT_GTM_HOST
-} from './helpers';
-
-export interface Props {
-  /** GTM container ID(s) - single string or array */
-  containers: ContainerConfigInput | ContainerConfigInput[];
-  /** GTM host URL */
-  host?: string;
-  /** Query parameters to add to all containers */
-  defaultQueryParams?: Record<string, string | number | boolean>;
-  /** Script tag attributes (async, defer, nonce, etc.) */
-  scriptAttributes?: ScriptAttributes;
-  /** Custom dataLayer name */
-  dataLayerName?: string;
-  /** Default consent state (set before GTM loads) */
-  defaultConsent?: ConsentState;
-  /** Enable automatic page view tracking with View Transitions */
-  enablePageTracking?: boolean;
-  /** Custom page view event name */
-  pageViewEventName?: string;
-}
-
-const {
-  containers,
-  host = DEFAULT_GTM_HOST,
-  defaultQueryParams,
-  scriptAttributes,
-  dataLayerName = 'dataLayer',
-  defaultConsent,
-  enablePageTracking = false,
-  pageViewEventName = 'page_view'
-} = Astro.props;
-
-const scripts = generateScriptTags({
-  containers,
-  host,
-  defaultQueryParams,
-  scriptAttributes,
-  dataLayerName
-});
-
-// Build initialization script
-let initScript = generateDataLayerScript(dataLayerName);
-
-// Add consent defaults if provided
-if (defaultConsent) {
-  // Validate consent keys are valid identifiers and escape values to prevent XSS
-  const consentEntries = Object.entries(defaultConsent)
-    .map(([key, value]) => {
-      // Consent keys should be valid identifiers (e.g., 'ad_storage', 'analytics_storage')
-      if (!isValidJsIdentifier(key)) {
-        throw new Error(`Invalid consent key: "${key}". Must be a valid JavaScript identifier.`);
-      }
-      // Escape the value to prevent XSS
-      const escapedValue = escapeJsString(String(value));
-      return `'${key}':'${escapedValue}'`;
-    })
-    .join(',');
-  initScript += `${dataLayerName}.push(['consent','default',{${consentEntries}}]);`;
-}
-
-// Generate the containers config for client-side initialization
-const containersArray = Array.isArray(containers) ? containers : [containers];
-const containersJson = JSON.stringify(containersArray);
----
-
-<script is:inline set:html={initScript} />
-{scripts.map((script) => (
-  <script
-    src={script.src}
-    async={script.async}
-    defer={script.defer}
-    nonce={script.nonce}
-    data-gtm-container-id={script.id}
-    {...script.attributes}
-  />
-))}
-
-{enablePageTracking && (
-  <script
-    define:vars={{ containersJson, dataLayerName, pageViewEventName }}
-  >
-    // Initialize GTM client and set up page tracking
-    import('@jwiedeman/gtm-kit-astro')
-      .then(({ initGtm, setupViewTransitions }) => {
-        try {
-          const containers = JSON.parse(containersJson);
-          initGtm({ containers, dataLayerName });
-          setupViewTransitions({ eventName: pageViewEventName });
-        } catch (error) {
-          console.error('[gtm-kit/astro] Failed to initialize GTM:', error);
-        }
-      })
-      .catch((error) => {
-        console.error('[gtm-kit/astro] Failed to load GTM module:', error);
-      });
-  </script>
-)}

package/src/components/GtmNoScript.astro

@@ -1,56 +0,0 @@
----
-/**
- * GTM NoScript Component
- *
- * Renders the GTM noscript fallback iframe(s).
- * Use this immediately after the opening <body> tag.
- *
- * @example
- * ```astro
- * ---
- * import { GtmNoScript } from '@jwiedeman/gtm-kit-astro/components';
- * ---
- * <body>
- *   <GtmNoScript containers="GTM-XXXXXX" />
- *   <!-- rest of body -->
- * </body>
- * ```
- */
-import type { ContainerConfigInput } from '@jwiedeman/gtm-kit';
-import { generateNoscriptTags, DEFAULT_GTM_HOST } from './helpers';
-
-export interface Props {
-  /** GTM container ID(s) - single string or array */
-  containers: ContainerConfigInput | ContainerConfigInput[];
-  /** GTM host URL */
-  host?: string;
-  /** Query parameters to add to all containers */
-  defaultQueryParams?: Record<string, string | number | boolean>;
-  /** Custom iframe attributes */
-  iframeAttributes?: Record<string, string | number | boolean>;
-  /** Custom dataLayer name */
-  dataLayerName?: string;
-}
-
-const {
-  containers,
-  host = DEFAULT_GTM_HOST,
-  defaultQueryParams,
-  iframeAttributes,
-  dataLayerName = 'dataLayer'
-} = Astro.props;
-
-const noscripts = generateNoscriptTags({
-  containers,
-  host,
-  defaultQueryParams,
-  iframeAttributes,
-  dataLayerName
-});
----
-
-{noscripts.map((ns) => (
-  <noscript>
-    <iframe src={ns.src} {...ns.attributes} />
-  </noscript>
-))}

package/src/components/GtmScript.astro

@@ -1,70 +0,0 @@
----
-/**
- * GTM Script Component
- *
- * Renders the GTM script tag(s) in the document head.
- * Use this in your <head> section.
- *
- * @example
- * ```astro
- * ---
- * import { GtmScript } from '@jwiedeman/gtm-kit-astro/components';
- * ---
- * <head>
- *   <GtmScript containers="GTM-XXXXXX" />
- * </head>
- * ```
- */
-import type { ContainerConfigInput, ScriptAttributes } from '@jwiedeman/gtm-kit';
-import {
-  generateScriptTags,
-  generateDataLayerScript,
-  DEFAULT_GTM_HOST
-} from './helpers';
-
-export interface Props {
-  /** GTM container ID(s) - single string or array */
-  containers: ContainerConfigInput | ContainerConfigInput[];
-  /** GTM host URL */
-  host?: string;
-  /** Query parameters to add to all containers */
-  defaultQueryParams?: Record<string, string | number | boolean>;
-  /** Script tag attributes (async, defer, nonce, etc.) */
-  scriptAttributes?: ScriptAttributes;
-  /** Custom dataLayer name */
-  dataLayerName?: string;
-  /** Whether to include dataLayer initialization script */
-  initDataLayer?: boolean;
-}
-
-const {
-  containers,
-  host = DEFAULT_GTM_HOST,
-  defaultQueryParams,
-  scriptAttributes,
-  dataLayerName = 'dataLayer',
-  initDataLayer = true
-} = Astro.props;
-
-const scripts = generateScriptTags({
-  containers,
-  host,
-  defaultQueryParams,
-  scriptAttributes,
-  dataLayerName
-});
-
-const dataLayerInit = initDataLayer ? generateDataLayerScript(dataLayerName) : null;
----
-
-{dataLayerInit && <script is:inline set:html={dataLayerInit} />}
-{scripts.map((script) => (
-  <script
-    src={script.src}
-    async={script.async}
-    defer={script.defer}
-    nonce={script.nonce}
-    data-gtm-container-id={script.id}
-    {...script.attributes}
-  />
-))}