npm - @jwiedeman/gtm-kit-astro - Versions diffs - 1.1.3 - Mend

@jwiedeman/gtm-kit-astro 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/README.md +331 -0
package/dist/components/index.cjs +31 -0
package/dist/components/index.cjs.map +1 -0
package/dist/components/index.d.cts +41 -0
package/dist/components/index.d.ts +41 -0
package/dist/components/index.js +8 -0
package/dist/components/index.js.map +1 -0
package/dist/index.cjs +39 -0
package/dist/index.cjs.map +1 -0
package/dist/index.d.cts +182 -0
package/dist/index.d.ts +182 -0
package/dist/index.js +8 -0
package/dist/index.js.map +1 -0
package/package.json +59 -0
package/src/components/GtmHead.astro +117 -0
package/src/components/GtmNoScript.astro +56 -0
package/src/components/GtmScript.astro +70 -0

package/README.md ADDED Viewed

@@ -0,0 +1,331 @@
+# @jwiedeman/gtm-kit-astro
+[![CI](https://github.com/jwiedeman/GTM-Kit/actions/workflows/ci.yml/badge.svg)](https://github.com/jwiedeman/GTM-Kit/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@jwiedeman/gtm-kit-astro.svg)](https://www.npmjs.com/package/@jwiedeman/gtm-kit-astro)
+[![Bundle Size](https://img.shields.io/bundlephobia/minzip/@jwiedeman/gtm-kit-astro)](https://bundlephobia.com/package/@jwiedeman/gtm-kit-astro)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Astro](https://img.shields.io/badge/Astro-3.0+-BC52EE.svg?logo=astro)](https://astro.build/)
+**Astro components and helpers for Google Tag Manager. Supports View Transitions API.**
+The Astro integration for GTM Kit - includes ready-to-use components and client-side helpers for page tracking.
+---
+## Installation
+```bash
+npm install @jwiedeman/gtm-kit @jwiedeman/gtm-kit-astro
+```
+```bash
+yarn add @jwiedeman/gtm-kit @jwiedeman/gtm-kit-astro
+```
+```bash
+pnpm add @jwiedeman/gtm-kit @jwiedeman/gtm-kit-astro
+```
+---
+## Quick Start
+### Option 1: Use the GtmHead Component (Recommended)
+The easiest way to add GTM to your Astro site:
+```astro
+---
+// src/layouts/Layout.astro
+import { GtmHead } from '@jwiedeman/gtm-kit-astro/components';
+---
+<html>
+  <head>
+    <GtmHead
+      containers="GTM-XXXXXX"
+      enablePageTracking
+    />
+  </head>
+  <body>
+    <slot />
+  </body>
+</html>
+```
+### Option 2: Use Individual Components
+For more control, use the script and noscript components separately:
+```astro
+---
+// src/layouts/Layout.astro
+import { GtmScript, GtmNoScript } from '@jwiedeman/gtm-kit-astro/components';
+---
+<html>
+  <head>
+    <GtmScript containers="GTM-XXXXXX" />
+  </head>
+  <body>
+    <GtmNoScript containers="GTM-XXXXXX" />
+    <slot />
+  </body>
+</html>
+```
+### Option 3: Client-Side API
+For programmatic control:
+```astro
+---
+// src/layouts/Layout.astro
+---
+<html>
+  <head>
+    <!-- Your head content -->
+  </head>
+  <body>
+    <slot />
+    <script>
+      import { initGtm, push, setupPageTracking } from '@jwiedeman/gtm-kit-astro';
+      initGtm({ containers: 'GTM-XXXXXX' });
+      setupPageTracking();
+      // Push custom events
+      push({ event: 'page_loaded', page_type: 'home' });
+    </script>
+  </body>
+</html>
+```
+---
+## Features
+| Feature              | Description                                               |
+| -------------------- | --------------------------------------------------------- |
+| **View Transitions** | Automatic page tracking with Astro's View Transitions API |
+| **Zero Config**      | Works out of the box with sensible defaults               |
+| **Astro 3, 4, 5**    | Compatible with all modern Astro versions                 |
+| **TypeScript**       | Full type definitions included                            |
+| **Consent Mode v2**  | Built-in GDPR compliance support                          |
+| **SSR Safe**         | Works with static and SSR modes                           |
+---
+## Components
+### `<GtmHead />`
+All-in-one component for the `<head>` section. Includes script loading, consent setup, and optional page tracking.
+```astro
+<GtmHead
+  containers="GTM-XXXXXX"
+  enablePageTracking
+  defaultConsent={{
+    ad_storage: 'denied',
+    analytics_storage: 'denied'
+  }}
+  pageViewEventName="page_view"
+/>
+```
+#### Props
+| Prop                 | Type                 | Default                            | Description                     |
+| -------------------- | -------------------- | ---------------------------------- | ------------------------------- |
+| `containers`         | `string \| string[]` | Required                           | GTM container ID(s)             |
+| `host`               | `string`             | `https://www.googletagmanager.com` | Custom GTM host                 |
+| `dataLayerName`      | `string`             | `dataLayer`                        | Custom dataLayer name           |
+| `defaultConsent`     | `ConsentState`       | -                                  | Default consent state           |
+| `enablePageTracking` | `boolean`            | `false`                            | Enable automatic page tracking  |
+| `pageViewEventName`  | `string`             | `page_view`                        | Custom page view event name     |
+| `scriptAttributes`   | `object`             | -                                  | Script attributes (nonce, etc.) |
+### `<GtmScript />`
+Generates GTM script tags for the `<head>`.
+```astro
+<GtmScript
+  containers="GTM-XXXXXX"
+  scriptAttributes={{ nonce: 'abc123' }}
+/>
+```
+### `<GtmNoScript />`
+Generates noscript iframe fallback for the `<body>`.
+```astro
+<GtmNoScript containers="GTM-XXXXXX" />
+```
+---
+## Client-Side API
+### `initGtm(options)`
+Initialize GTM on the client side.
+```typescript
+import { initGtm } from '@jwiedeman/gtm-kit-astro';
+initGtm({
+  containers: 'GTM-XXXXXX',
+  dataLayerName: 'dataLayer'
+});
+```
+### `push(data)`
+Push data to the dataLayer.
+```typescript
+import { push } from '@jwiedeman/gtm-kit-astro';
+push({ event: 'button_click', button_id: 'cta-main' });
+```
+### `setupPageTracking(options)`
+Set up automatic page view tracking. Works with Astro's View Transitions.
+```typescript
+import { setupPageTracking } from '@jwiedeman/gtm-kit-astro';
+setupPageTracking({
+  eventName: 'page_view' // Optional, defaults to 'page_view'
+});
+```
+### `setupViewTransitions(options)`
+Alias for `setupPageTracking`. Sets up tracking for View Transitions API.
+```typescript
+import { setupViewTransitions } from '@jwiedeman/gtm-kit-astro';
+setupViewTransitions({ eventName: 'virtual_page_view' });
+```
+### `trackPageView(options)`
+Manually track a page view.
+```typescript
+import { trackPageView } from '@jwiedeman/gtm-kit-astro';
+trackPageView({
+  eventName: 'page_view',
+  pagePath: '/custom-path',
+  pageTitle: 'Custom Title'
+});
+```
+---
+## Consent Mode v2 (GDPR)
+### Setting Default Consent
+```astro
+<GtmHead
+  containers="GTM-XXXXXX"
+  defaultConsent={{
+    ad_storage: 'denied',
+    ad_user_data: 'denied',
+    ad_personalization: 'denied',
+    analytics_storage: 'denied'
+  }}
+/>
+```
+### Updating Consent After User Choice
+```typescript
+import { updateConsent } from '@jwiedeman/gtm-kit-astro';
+// User accepts analytics
+updateConsent({
+  analytics_storage: 'granted'
+});
+// User accepts all
+updateConsent({
+  ad_storage: 'granted',
+  ad_user_data: 'granted',
+  ad_personalization: 'granted',
+  analytics_storage: 'granted'
+});
+```
+---
+## View Transitions Integration
+GTM Kit automatically tracks page views when using Astro's View Transitions. Just enable page tracking:
+```astro
+---
+import { GtmHead } from '@jwiedeman/gtm-kit-astro/components';
+import { ViewTransitions } from 'astro:transitions';
+---
+<html>
+  <head>
+    <ViewTransitions />
+    <GtmHead
+      containers="GTM-XXXXXX"
+      enablePageTracking
+    />
+  </head>
+  <body>
+    <slot />
+  </body>
+</html>
+```
+Page views are automatically tracked on:
+- Initial page load
+- Client-side navigation via View Transitions
+- Browser back/forward navigation
+---
+## Multiple Containers
+```astro
+<GtmHead
+  containers={['GTM-XXXXXX', 'GTM-YYYYYY']}
+  enablePageTracking
+/>
+```
+---
+## CSP (Content Security Policy)
+```astro
+<GtmHead
+  containers="GTM-XXXXXX"
+  scriptAttributes={{ nonce: 'your-nonce-value' }}
+/>
+```
+---
+## Requirements
+- Astro 3.0+, 4.0+, or 5.0+
+- `@jwiedeman/gtm-kit` (peer dependency)
+---
+## License
+MIT

package/dist/components/index.cjs ADDED Viewed

@@ -0,0 +1,31 @@
+'use strict';
+var gtmKit = require('@jwiedeman/gtm-kit');
+var h=r=>{let{containers:s,host:c=gtmKit.DEFAULT_GTM_HOST,defaultQueryParams:g,scriptAttributes:e,dataLayerName:d=gtmKit.DEFAULT_DATA_LAYER_NAME}=r,i=gtmKit.normalizeContainers(s);if(!i.length)throw new Error("At least one GTM container is required.");return i.map(t=>{if(!t.id)throw new Error("Container id is required.");let p={...g,...t.queryParams},u=gtmKit.buildGtmScriptUrl(c,t.id,p,d),{async:n,defer:a,nonce:l,...o}=e!=null?e:{},T={};for(let[y,m]of Object.entries(o))m!=null&&(T[y]=m);return {id:t.id,src:u,async:n!=null?n:!0,defer:a,nonce:l,attributes:T}})},w={height:"0",width:"0",style:"display:none;visibility:hidden",title:"Google Tag Manager"},D=r=>{let{containers:s,host:c=gtmKit.DEFAULT_GTM_HOST,defaultQueryParams:g,iframeAttributes:e,dataLayerName:d=gtmKit.DEFAULT_DATA_LAYER_NAME}=r,i=gtmKit.normalizeContainers(s);if(!i.length)throw new Error("At least one GTM container is required.");return i.map(t=>{if(!t.id)throw new Error("Container id is required.");let p={...g,...t.queryParams},u=gtmKit.buildGtmNoscriptUrl(c,t.id,p,d),n={...w,...e},a={};for(let[l,o]of Object.entries(n))o!=null&&(a[l]=String(o));return {id:t.id,src:u,attributes:a}})},G=(r=gtmKit.DEFAULT_DATA_LAYER_NAME)=>`window.${r}=window.${r}||[];`;
+Object.defineProperty(exports, 'DEFAULT_GTM_HOST', {
+	enumerable: true,
+	get: function () { return gtmKit.DEFAULT_GTM_HOST; }
+});
+Object.defineProperty(exports, 'buildNoscriptUrl', {
+	enumerable: true,
+	get: function () { return gtmKit.buildGtmNoscriptUrl; }
+});
+Object.defineProperty(exports, 'buildScriptUrl', {
+	enumerable: true,
+	get: function () { return gtmKit.buildGtmScriptUrl; }
+});
+Object.defineProperty(exports, 'normalizeContainer', {
+	enumerable: true,
+	get: function () { return gtmKit.normalizeContainer; }
+});
+Object.defineProperty(exports, 'normalizeContainers', {
+	enumerable: true,
+	get: function () { return gtmKit.normalizeContainers; }
+});
+exports.generateDataLayerScript = G;
+exports.generateNoscriptTags = D;
+exports.generateScriptTags = h;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.cjs.map

package/dist/components/index.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../../src/components/helpers.ts","../../src/components/index.ts"],"names":["DEFAULT_DATA_LAYER_NAME","DEFAULT_GTM_HOST","normalizeContainer","normalizeContainers","buildGtmScriptUrl","buildGtmNoscriptUrl","generateScriptTags","config","containers","host","defaultQueryParams","scriptAttributes","dataLayerName","normalized","container","params","src","asyncAttr","defer","nonce","restAttributes","attributes","key","value","DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES","generateNoscriptTags","iframeAttributes","mergedAttributes","generateDataLayerScript"],"mappings":"AAAA,OACE,2BAAAA,EACA,oBAAAC,EACA,sBAAAC,EACA,uBAAAC,EACA,qBAAAC,EACA,uBAAAC,MACK,qBAiCA,IAAMC,EAAsBC,GAA6C,CAC9E,GAAM,CACJ,WAAAC,EACA,KAAAC,EAAOR,EACP,mBAAAS,EACA,iBAAAC,EACA,cAAAC,EAAgBZ,CAClB,EAAIO,EAEEM,EAAaV,EAAoBK,CAAU,EAEjD,GAAI,CAACK,EAAW,OACd,MAAM,IAAI,MAAM,yCAAyC,EAG3D,OAAOA,EAAW,IAAKC,GAAc,CACnC,GAAI,CAACA,EAAU,GACb,MAAM,IAAI,MAAM,2BAA2B,EAG7C,IAAMC,EAAS,CACb,GAAGL,EACH,GAAGI,EAAU,WACf,EAEME,EAAMZ,EAAkBK,EAAMK,EAAU,GAAIC,EAAQH,CAAa,EACjE,CAAE,MAAOK,EAAW,MAAAC,EAAO,MAAAC,EAAO,GAAGC,CAAe,EAAIT,GAAA,KAAAA,EAAoB,CAAC,EAE7EU,EAA+C,CAAC,EAEtD,OAAW,CAACC,EAAKC,CAAK,IAAK,OAAO,QAAQH,CAAc,EAC3BG,GAAU,OACnCF,EAAWC,CAAG,EAAIC,GAItB,MAAO,CACL,GAAIT,EAAU,GACd,IAAAE,EACA,MAAOC,GAAA,KAAAA,EAAa,GACpB,MAAAC,EACA,MAAAC,EACA,WAAAE,CACF,CACF,CAAC,CACH,EAQMG,EAA6D,CACjE,OAAQ,IACR,MAAO,IACP,MAAO,iCACP,MAAO,oBACT,EAMaC,EACXlB,GAGsB,CACtB,GAAM,CACJ,WAAAC,EACA,KAAAC,EAAOR,EACP,mBAAAS,EACA,iBAAAgB,EACA,cAAAd,EAAgBZ,CAClB,EAAIO,EAEEM,EAAaV,EAAoBK,CAAU,EAEjD,GAAI,CAACK,EAAW,OACd,MAAM,IAAI,MAAM,yCAAyC,EAG3D,OAAOA,EAAW,IAAKC,GAAc,CACnC,GAAI,CAACA,EAAU,GACb,MAAM,IAAI,MAAM,2BAA2B,EAG7C,IAAMC,EAAS,CACb,GAAGL,EACH,GAAGI,EAAU,WACf,EAEME,EAAMX,EAAoBI,EAAMK,EAAU,GAAIC,EAAQH,CAAa,EACnEe,EAAmB,CACvB,GAAGH,EACH,GAAGE,CACL,EAEML,EAAqC,CAAC,EAC5C,OAAW,CAACC,EAAKC,CAAK,IAAK,OAAO,QAAQI,CAAgB,EAC7BJ,GAAU,OACnCF,EAAWC,CAAG,EAAI,OAAOC,CAAK,GAIlC,MAAO,CACL,GAAIT,EAAU,GACd,IAAAE,EACA,WAAAK,CACF,CACF,CAAC,CACH,EAKaO,EAA0B,CAAChB,EAAwBZ,IACvD,UAAUY,CAAa,WAAWA,CAAa,QC3JxD,OACE,uBAAAT,EACA,sBAAAD,EACqB,qBAArBE,EACuB,uBAAvBC,MACK","sourcesContent":["import {\n DEFAULT_DATA_LAYER_NAME,\n DEFAULT_GTM_HOST,\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 normalizeContainer,\n normalizeContainers,\n buildGtmScriptUrl as buildScriptUrl,\n buildGtmNoscriptUrl as buildNoscriptUrl\n};\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 const attributes: Record<string, string | boolean> = {};\n\n for (const [key, value] of Object.entries(restAttributes)) {\n if (value !== undefined && value !== null) {\n attributes[key] = value;\n }\n }\n\n return {\n id: container.id,\n src,\n async: asyncAttr ?? true,\n defer,\n nonce,\n attributes\n };\n });\n};\n\nexport interface NoscriptTagData {\n id: string;\n src: string;\n attributes: Record<string, string>;\n}\n\nconst DEFAULT_NOSCRIPT_IFRAME_ATTRIBUTES: Record<string, string> = {\n height: '0',\n width: '0',\n style: 'display:none;visibility:hidden',\n title: 'Google Tag Manager'\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 const attributes: Record<string, string> = {};\n for (const [key, value] of Object.entries(mergedAttributes)) {\n if (value !== undefined && value !== null) {\n attributes[key] = String(value);\n }\n }\n\n return {\n id: container.id,\n src,\n attributes\n };\n });\n};\n\n/**\n * Generate the dataLayer initialization script.\n */\nexport const generateDataLayerScript = (dataLayerName: string = DEFAULT_DATA_LAYER_NAME): string => {\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"]}

package/dist/components/index.d.cts ADDED Viewed

@@ -0,0 +1,41 @@
+import { ContainerConfigInput, ScriptAttributes } from '@jwiedeman/gtm-kit';
+export { DEFAULT_GTM_HOST, buildGtmNoscriptUrl as buildNoscriptUrl, buildGtmScriptUrl as buildScriptUrl, normalizeContainer, normalizeContainers } from '@jwiedeman/gtm-kit';
+interface GtmScriptConfig {
+    containers: ContainerConfigInput | ContainerConfigInput[];
+    host?: string;
+    defaultQueryParams?: Record<string, string | number | boolean>;
+    scriptAttributes?: ScriptAttributes;
+    dataLayerName?: string;
+}
+interface ScriptTagData {
+    id: string;
+    src: string;
+    async: boolean;
+    defer?: boolean;
+    nonce?: string;
+    attributes: Record<string, string | boolean>;
+}
+/**
+ * Generate script tag data for GTM containers.
+ * Used by Astro components to render script tags.
+ */
+declare const generateScriptTags: (config: GtmScriptConfig) => ScriptTagData[];
+interface NoscriptTagData {
+    id: string;
+    src: string;
+    attributes: Record<string, string>;
+}
+/**
+ * Generate noscript iframe data for GTM containers.
+ * Used by Astro components to render noscript fallbacks.
+ */
+declare const generateNoscriptTags: (config: Omit<GtmScriptConfig, 'scriptAttributes'> & {
+    iframeAttributes?: Record<string, string | number | boolean>;
+}) => NoscriptTagData[];
+/**
+ * Generate the dataLayer initialization script.
+ */
+declare const generateDataLayerScript: (dataLayerName?: string) => string;
+export { GtmScriptConfig, NoscriptTagData, ScriptTagData, generateDataLayerScript, generateNoscriptTags, generateScriptTags };

package/dist/components/index.d.ts ADDED Viewed

@@ -0,0 +1,41 @@
+import { ContainerConfigInput, ScriptAttributes } from '@jwiedeman/gtm-kit';
+export { DEFAULT_GTM_HOST, buildGtmNoscriptUrl as buildNoscriptUrl, buildGtmScriptUrl as buildScriptUrl, normalizeContainer, normalizeContainers } from '@jwiedeman/gtm-kit';
+interface GtmScriptConfig {
+    containers: ContainerConfigInput | ContainerConfigInput[];
+    host?: string;
+    defaultQueryParams?: Record<string, string | number | boolean>;
+    scriptAttributes?: ScriptAttributes;
+    dataLayerName?: string;
+}
+interface ScriptTagData {
+    id: string;
+    src: string;
+    async: boolean;
+    defer?: boolean;
+    nonce?: string;
+    attributes: Record<string, string | boolean>;
+}
+/**
+ * Generate script tag data for GTM containers.
+ * Used by Astro components to render script tags.
+ */
+declare const generateScriptTags: (config: GtmScriptConfig) => ScriptTagData[];
+interface NoscriptTagData {
+    id: string;
+    src: string;
+    attributes: Record<string, string>;
+}
+/**
+ * Generate noscript iframe data for GTM containers.
+ * Used by Astro components to render noscript fallbacks.
+ */
+declare const generateNoscriptTags: (config: Omit<GtmScriptConfig, 'scriptAttributes'> & {
+    iframeAttributes?: Record<string, string | number | boolean>;
+}) => NoscriptTagData[];
+/**
+ * Generate the dataLayer initialization script.
+ */
+declare const generateDataLayerScript: (dataLayerName?: string) => string;
+export { GtmScriptConfig, NoscriptTagData, ScriptTagData, generateDataLayerScript, generateNoscriptTags, generateScriptTags };

package/dist/components/index.js ADDED Viewed

@@ -0,0 +1,8 @@
+import { normalizeContainers, buildGtmScriptUrl, buildGtmNoscriptUrl, DEFAULT_DATA_LAYER_NAME, DEFAULT_GTM_HOST } from '@jwiedeman/gtm-kit';
+export { DEFAULT_GTM_HOST, buildGtmNoscriptUrl as buildNoscriptUrl, buildGtmScriptUrl as buildScriptUrl, normalizeContainer, normalizeContainers } from '@jwiedeman/gtm-kit';
+var h=r=>{let{containers:s,host:c=DEFAULT_GTM_HOST,defaultQueryParams:g,scriptAttributes:e,dataLayerName:d=DEFAULT_DATA_LAYER_NAME}=r,i=normalizeContainers(s);if(!i.length)throw new Error("At least one GTM container is required.");return i.map(t=>{if(!t.id)throw new Error("Container id is required.");let p={...g,...t.queryParams},u=buildGtmScriptUrl(c,t.id,p,d),{async:n,defer:a,nonce:l,...o}=e!=null?e:{},T={};for(let[y,m]of Object.entries(o))m!=null&&(T[y]=m);return {id:t.id,src:u,async:n!=null?n:!0,defer:a,nonce:l,attributes:T}})},w={height:"0",width:"0",style:"display:none;visibility:hidden",title:"Google Tag Manager"},D=r=>{let{containers:s,host:c=DEFAULT_GTM_HOST,defaultQueryParams:g,iframeAttributes:e,dataLayerName:d=DEFAULT_DATA_LAYER_NAME}=r,i=normalizeContainers(s);if(!i.length)throw new Error("At least one GTM container is required.");return i.map(t=>{if(!t.id)throw new Error("Container id is required.");let p={...g,...t.queryParams},u=buildGtmNoscriptUrl(c,t.id,p,d),n={...w,...e},a={};for(let[l,o]of Object.entries(n))o!=null&&(a[l]=String(o));return {id:t.id,src:u,attributes:a}})},G=(r=DEFAULT_DATA_LAYER_NAME)=>`window.${r}=window.${r}||[];`;
+export { G as generateDataLayerScript, D as generateNoscriptTags, h as generateScriptTags };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map ADDED Viewed

@@ -0,0 +1 @@

package/dist/index.cjs ADDED Viewed

@@ -0,0 +1,39 @@
+'use strict';
+var gtmKit = require('@jwiedeman/gtm-kit');
+var o=null,r=null,f=e=>o||(o=gtmKit.createGtmClient(e),r=e,o.init(),o),i=()=>o,m=()=>{if(!o)throw new Error("[gtm-kit/astro] GTM client not initialized. Call initGtm() first or ensure the GTM script has loaded.");return o},p=e=>{var t;let n=i();if(n)return n.push(e),!0;if(typeof window!="undefined"){let c=(t=r==null?void 0:r.dataLayerName)!=null?t:"dataLayer",l=window[c];return Array.isArray(l)?(l.push(e),!0):(console.warn("[gtm-kit/astro] GTM not initialized and dataLayer not found."),!1)}return !1},C=(e,n)=>{let t=i();return t?(t.setConsentDefaults(e,n),!0):(console.warn("[gtm-kit/astro] GTM not initialized. Consent defaults should be set before init."),!1)},y=(e,n)=>{let t=i();return t?(t.updateConsent(e,n),!0):(console.warn("[gtm-kit/astro] GTM not initialized. Cannot update consent."),!1)},h=()=>{let e=i();return e?e.whenReady():Promise.reject(new Error("[gtm-kit/astro] GTM not initialized."))},k=()=>{o&&(o.teardown(),o=null,r=null);};var d=()=>{},P=e=>typeof e=="function"?e():e!=null?e:{},s=(e={})=>{let{eventName:n="page_view",includeQueryParams:t=!0,additionalData:c}=e;if(typeof window=="undefined")return;let w=t?window.location.pathname+window.location.search:window.location.pathname,l={event:n,page_path:w,page_location:window.location.href,page_title:document.title,...P(c)};p(l);},u=!1,a="";var G=(e={})=>{if(typeof window=="undefined"||typeof document=="undefined"||u)return d;u=!0,a=window.location.pathname+window.location.search,s(e);let n=()=>{let t=window.location.pathname+window.location.search;t!==a&&(a=t,s(e));};return document.addEventListener("astro:page-load",n),()=>{document.removeEventListener("astro:page-load",n),u=!1,a="";}},x=(e={})=>{if(typeof window=="undefined")return d;a=window.location.pathname+window.location.search,s(e);let n=()=>{let t=window.location.pathname+window.location.search;t!==a&&(a=t,s(e));};return window.addEventListener("popstate",n),()=>{window.removeEventListener("popstate",n),a="";}};
+Object.defineProperty(exports, 'allGranted', {
+	enumerable: true,
+	get: function () { return gtmKit.allGranted; }
+});
+Object.defineProperty(exports, 'analyticsOnly', {
+	enumerable: true,
+	get: function () { return gtmKit.analyticsOnly; }
+});
+Object.defineProperty(exports, 'consentPresets', {
+	enumerable: true,
+	get: function () { return gtmKit.consentPresets; }
+});
+Object.defineProperty(exports, 'eeaDefault', {
+	enumerable: true,
+	get: function () { return gtmKit.eeaDefault; }
+});
+Object.defineProperty(exports, 'getConsentPreset', {
+	enumerable: true,
+	get: function () { return gtmKit.getConsentPreset; }
+});
+exports.getGtmClient = i;
+exports.initGtm = f;
+exports.push = p;
+exports.requireGtmClient = m;
+exports.setConsentDefaults = C;
+exports.setupPageTracking = x;
+exports.setupViewTransitions = G;
+exports.teardown = k;
+exports.trackPageView = s;
+exports.updateConsent = y;
+exports.whenReady = h;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/client.ts","../src/page-tracking.ts","../src/index.ts"],"names":["createGtmClient","clientInstance","clientConfig","initGtm","options","getGtmClient","requireGtmClient","push","value","_a","client","dataLayerName","dataLayer","setConsentDefaults","state","updateConsent","whenReady","teardown","noop","getAdditionalData","additionalData","trackPageView","eventName","includeQueryParams","pagePath","pageViewData","viewTransitionsSetup","lastTrackedPath","setupViewTransitions","handlePageLoad","currentPath","setupPageTracking","handlePopState","consentPresets","getConsentPreset","eeaDefault","allGranted","analyticsOnly"],"mappings":"AAAA,OACE,mBAAAA,MAOK,qBAEP,IAAIC,EAAmC,KACnCC,EAA8C,KAcrCC,EAAWC,GAGlBH,IAIJA,EAAiBD,EAAgBI,CAAO,EACxCF,EAAeE,EACfH,EAAe,KAAK,EAEbA,GAiBII,EAAe,IAAwBJ,EAQvCK,EAAmB,IAAiB,CAC/C,GAAI,CAACL,EACH,MAAM,IAAI,MACR,uGACF,EAEF,OAAOA,CACT,EAkBaM,EAAQC,GAAmC,CAtFxD,IAAAC,EAuFE,IAAMC,EAASL,EAAa,EAC5B,GAAIK,EACF,OAAAA,EAAO,KAAKF,CAAK,EACV,GACF,GAAI,OAAO,QAAW,YAAa,CAExC,IAAMG,GAAgBF,EAAAP,GAAA,YAAAA,EAAc,gBAAd,KAAAO,EAA+B,YAE/CG,EADM,OACUD,CAAa,EACnC,OAAI,MAAM,QAAQC,CAAS,GACzBA,EAAU,KAAKJ,CAAK,EACb,KAEP,QAAQ,KAAK,8DAA8D,EACpE,GAEX,CACA,MAAO,EACT,EAiBaK,EAAqB,CAACC,EAAqBV,IAA4C,CAClG,IAAMM,EAASL,EAAa,EAC5B,OAAIK,GACFA,EAAO,mBAAmBI,EAAOV,CAAO,EACjC,KAEP,QAAQ,KAAK,kFAAkF,EACxF,GAEX,EAoBaW,EAAgB,CAACD,EAAqBV,IAA4C,CAC7F,IAAMM,EAASL,EAAa,EAC5B,OAAIK,GACFA,EAAO,cAAcI,EAAOV,CAAO,EAC5B,KAEP,QAAQ,KAAK,6DAA6D,EACnE,GAEX,EAcaY,EAAY,IAAkC,CACzD,IAAMN,EAASL,EAAa,EAC5B,OAAIK,EACKA,EAAO,UAAU,EAEnB,QAAQ,OAAO,IAAI,MAAM,sCAAsC,CAAC,CACzE,EAMaO,EAAW,IAAY,CAC9BhB,IACFA,EAAe,SAAS,EACxBA,EAAiB,KACjBC,EAAe,KAEnB,EC7LA,IAAMgB,EAAO,IAAY,CAEzB,EA8BMC,EAAqBC,GACrB,OAAOA,GAAmB,WACrBA,EAAe,EAEjBA,GAAA,KAAAA,EAAkB,CAAC,EAmBfC,EAAgB,CAACjB,EAAgC,CAAC,IAAY,CACzE,GAAM,CAAE,UAAAkB,EAAY,YAAa,mBAAAC,EAAqB,GAAM,eAAAH,CAAe,EAAIhB,EAE/E,GAAI,OAAO,QAAW,YACpB,OAGF,IAAMoB,EAAWD,EAAqB,OAAO,SAAS,SAAW,OAAO,SAAS,OAAS,OAAO,SAAS,SAEpGE,EAA6B,CACjC,MAAOH,EACP,UAAWE,EACX,cAAe,OAAO,SAAS,KAC/B,WAAY,SAAS,MACrB,GAAGL,EAAkBC,CAAc,CACrC,EAEAb,EAAKkB,CAAY,CACnB,EAEIC,EAAuB,GACvBC,EAAkB,GA4Bf,IAAMC,EAAuB,CAACxB,EAAgC,CAAC,IAAoB,CAMxF,GALI,OAAO,QAAW,aAAe,OAAO,UAAa,aAKrDsB,EACF,OAAOR,EAGTQ,EAAuB,GAGvBC,EAAkB,OAAO,SAAS,SAAW,OAAO,SAAS,OAC7DN,EAAcjB,CAAO,EAIrB,IAAMyB,EAAiB,IAAM,CAC3B,IAAMC,EAAc,OAAO,SAAS,SAAW,OAAO,SAAS,OAG3DA,IAAgBH,IAIpBA,EAAkBG,EAClBT,EAAcjB,CAAO,EACvB,EAEA,gBAAS,iBAAiB,kBAAmByB,CAAc,EAGpD,IAAM,CACX,SAAS,oBAAoB,kBAAmBA,CAAc,EAC9DH,EAAuB,GACvBC,EAAkB,EACpB,CACF,EAaaI,EAAoB,CAAC3B,EAAgC,CAAC,IAAoB,CACrF,GAAI,OAAO,QAAW,YACpB,OAAOc,EAITS,EAAkB,OAAO,SAAS,SAAW,OAAO,SAAS,OAC7DN,EAAcjB,CAAO,EAGrB,IAAM4B,EAAiB,IAAM,CAC3B,IAAMF,EAAc,OAAO,SAAS,SAAW,OAAO,SAAS,OAE3DA,IAAgBH,IAIpBA,EAAkBG,EAClBT,EAAcjB,CAAO,EACvB,EAEA,cAAO,iBAAiB,WAAY4B,CAAc,EAE3C,IAAM,CACX,OAAO,oBAAoB,WAAYA,CAAc,EACrDL,EAAkB,EACpB,CACF,EC3JA,OAAS,kBAAAM,EAAgB,oBAAAC,EAAkB,cAAAC,EAAY,cAAAC,EAAY,iBAAAC,MAAqB","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 */\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 win = window as unknown as Record<string, unknown>;\n const dataLayer = win[dataLayerName] as DataLayerValue[] | undefined;\n if (Array.isArray(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"]}

package/dist/index.d.cts ADDED Viewed

@@ -0,0 +1,182 @@
+import { CreateGtmClientOptions, GtmClient, DataLayerValue, ConsentState, ConsentRegionOptions, ScriptLoadState } from '@jwiedeman/gtm-kit';
+export { ConsentRegionOptions, ConsentState, ContainerConfigInput, ContainerDescriptor, CreateGtmClientOptions, DataLayerValue, GtmClient, ScriptAttributes, ScriptLoadState, allGranted, analyticsOnly, consentPresets, eeaDefault, getConsentPreset } from '@jwiedeman/gtm-kit';
+/**
+ * Initialize the GTM client for use in Astro.
+ * Should be called once when the page loads.
+ *
+ * @example
+ * ```ts
+ * // In a client-side script
+ * import { initGtm } from '@jwiedeman/gtm-kit-astro';
+ *
+ * initGtm({ containers: 'GTM-XXXXXX' });
+ * ```
+ */
+declare const initGtm: (options: CreateGtmClientOptions) => GtmClient;
+/**
+ * Get the current GTM client instance.
+ * Returns null if not initialized.
+ *
+ * @example
+ * ```ts
+ * import { getGtmClient } from '@jwiedeman/gtm-kit-astro';
+ *
+ * const client = getGtmClient();
+ * if (client) {
+ *   client.push({ event: 'page_view' });
+ * }
+ * ```
+ */
+declare const getGtmClient: () => GtmClient | null;
+/**
+ * Get the GTM client or throw if not initialized.
+ * Use this when you expect the client to be available.
+ *
+ * @throws Error if GTM client is not initialized
+ */
+declare const requireGtmClient: () => GtmClient;
+/**
+ * Push a value to the GTM dataLayer.
+ * This is a convenience function that handles the case where GTM isn't initialized.
+ *
+ * @returns true if the value was pushed successfully, false otherwise
+ *
+ * @example
+ * ```ts
+ * import { push } from '@jwiedeman/gtm-kit-astro';
+ *
+ * const success = push({ event: 'button_click', button_name: 'hero_cta' });
+ * if (!success) {
+ *   console.warn('GTM not ready');
+ * }
+ * ```
+ */
+declare const push: (value: DataLayerValue) => boolean;
+/**
+ * Set consent defaults (must be called before GTM loads).
+ *
+ * @returns true if consent defaults were set, false if GTM not initialized
+ *
+ * @example
+ * ```ts
+ * import { setConsentDefaults } from '@jwiedeman/gtm-kit-astro';
+ *
+ * const success = setConsentDefaults({
+ *   ad_storage: 'denied',
+ *   analytics_storage: 'denied'
+ * });
+ * ```
+ */
+declare const setConsentDefaults: (state: ConsentState, options?: ConsentRegionOptions) => boolean;
+/**
+ * Update consent state after user interaction.
+ *
+ * @returns true if consent was updated, false if GTM not initialized
+ *
+ * @example
+ * ```ts
+ * import { updateConsent } from '@jwiedeman/gtm-kit-astro';
+ *
+ * // When user accepts cookies
+ * const success = updateConsent({
+ *   ad_storage: 'granted',
+ *   analytics_storage: 'granted',
+ *   ad_user_data: 'granted',
+ *   ad_personalization: 'granted'
+ * });
+ * ```
+ */
+declare const updateConsent: (state: ConsentState, options?: ConsentRegionOptions) => boolean;
+/**
+ * Wait for GTM scripts to be ready.
+ *
+ * @example
+ * ```ts
+ * import { whenReady } from '@jwiedeman/gtm-kit-astro';
+ *
+ * whenReady().then((states) => {
+ *   console.log('GTM loaded:', states);
+ * });
+ * ```
+ */
+declare const whenReady: () => Promise<ScriptLoadState[]>;
+/**
+ * Clean up the GTM client.
+ * Call this when navigating away or cleaning up.
+ */
+declare const teardown: () => void;
+interface PageViewData {
+    event?: string;
+    page_path?: string;
+    page_location?: string;
+    page_title?: string;
+    page_referrer?: string;
+    [key: string]: unknown;
+}
+interface TrackPageViewOptions {
+    /**
+     * The event name to use for page views.
+     * @default 'page_view'
+     */
+    eventName?: string;
+    /**
+     * Whether to include query parameters in the page path.
+     * @default true
+     */
+    includeQueryParams?: boolean;
+    /**
+     * Additional data to include with each page view.
+     */
+    additionalData?: Record<string, unknown> | (() => Record<string, unknown>);
+}
+/**
+ * Track a page view event.
+ *
+ * @example
+ * ```ts
+ * import { trackPageView } from '@jwiedeman/gtm-kit-astro';
+ *
+ * // Track current page
+ * trackPageView();
+ *
+ * // Track with custom data
+ * trackPageView({
+ *   additionalData: { user_type: 'guest' }
+ * });
+ * ```
+ */
+declare const trackPageView: (options?: TrackPageViewOptions) => void;
+/**
+ * Set up automatic page view tracking with Astro View Transitions.
+ * Call this once when the page loads.
+ *
+ * @example
+ * ```astro
+ * ---
+ * // src/layouts/Layout.astro
+ * ---
+ * <script>
+ *   import { initGtm, setupViewTransitions } from '@jwiedeman/gtm-kit-astro';
+ *
+ *   initGtm({ containers: 'GTM-XXXXXX' });
+ *   setupViewTransitions();
+ * </script>
+ * ```
+ */
+declare const setupViewTransitions: (options?: TrackPageViewOptions) => (() => void);
+/**
+ * Set up page view tracking for standard navigation (no View Transitions).
+ * Tracks on popstate (back/forward) and initial load.
+ *
+ * @example
+ * ```ts
+ * import { setupPageTracking } from '@jwiedeman/gtm-kit-astro';
+ *
+ * setupPageTracking();
+ * ```
+ */
+declare const setupPageTracking: (options?: TrackPageViewOptions) => (() => void);
+export { PageViewData, TrackPageViewOptions, getGtmClient, initGtm, push, requireGtmClient, setConsentDefaults, setupPageTracking, setupViewTransitions, teardown, trackPageView, updateConsent, whenReady };

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,182 @@
+import { CreateGtmClientOptions, GtmClient, DataLayerValue, ConsentState, ConsentRegionOptions, ScriptLoadState } from '@jwiedeman/gtm-kit';
+export { ConsentRegionOptions, ConsentState, ContainerConfigInput, ContainerDescriptor, CreateGtmClientOptions, DataLayerValue, GtmClient, ScriptAttributes, ScriptLoadState, allGranted, analyticsOnly, consentPresets, eeaDefault, getConsentPreset } from '@jwiedeman/gtm-kit';
+/**
+ * Initialize the GTM client for use in Astro.
+ * Should be called once when the page loads.
+ *
+ * @example
+ * ```ts
+ * // In a client-side script
+ * import { initGtm } from '@jwiedeman/gtm-kit-astro';
+ *
+ * initGtm({ containers: 'GTM-XXXXXX' });
+ * ```
+ */
+declare const initGtm: (options: CreateGtmClientOptions) => GtmClient;
+/**
+ * Get the current GTM client instance.
+ * Returns null if not initialized.
+ *
+ * @example
+ * ```ts
+ * import { getGtmClient } from '@jwiedeman/gtm-kit-astro';
+ *
+ * const client = getGtmClient();
+ * if (client) {
+ *   client.push({ event: 'page_view' });
+ * }
+ * ```
+ */
+declare const getGtmClient: () => GtmClient | null;
+/**
+ * Get the GTM client or throw if not initialized.
+ * Use this when you expect the client to be available.
+ *
+ * @throws Error if GTM client is not initialized
+ */
+declare const requireGtmClient: () => GtmClient;
+/**
+ * Push a value to the GTM dataLayer.
+ * This is a convenience function that handles the case where GTM isn't initialized.
+ *
+ * @returns true if the value was pushed successfully, false otherwise
+ *
+ * @example
+ * ```ts
+ * import { push } from '@jwiedeman/gtm-kit-astro';
+ *
+ * const success = push({ event: 'button_click', button_name: 'hero_cta' });
+ * if (!success) {
+ *   console.warn('GTM not ready');
+ * }
+ * ```
+ */
+declare const push: (value: DataLayerValue) => boolean;
+/**
+ * Set consent defaults (must be called before GTM loads).
+ *
+ * @returns true if consent defaults were set, false if GTM not initialized
+ *
+ * @example
+ * ```ts
+ * import { setConsentDefaults } from '@jwiedeman/gtm-kit-astro';
+ *
+ * const success = setConsentDefaults({
+ *   ad_storage: 'denied',
+ *   analytics_storage: 'denied'
+ * });
+ * ```
+ */
+declare const setConsentDefaults: (state: ConsentState, options?: ConsentRegionOptions) => boolean;
+/**
+ * Update consent state after user interaction.
+ *
+ * @returns true if consent was updated, false if GTM not initialized
+ *
+ * @example
+ * ```ts
+ * import { updateConsent } from '@jwiedeman/gtm-kit-astro';
+ *
+ * // When user accepts cookies
+ * const success = updateConsent({
+ *   ad_storage: 'granted',
+ *   analytics_storage: 'granted',
+ *   ad_user_data: 'granted',
+ *   ad_personalization: 'granted'
+ * });
+ * ```
+ */
+declare const updateConsent: (state: ConsentState, options?: ConsentRegionOptions) => boolean;
+/**
+ * Wait for GTM scripts to be ready.
+ *
+ * @example
+ * ```ts
+ * import { whenReady } from '@jwiedeman/gtm-kit-astro';
+ *
+ * whenReady().then((states) => {
+ *   console.log('GTM loaded:', states);
+ * });
+ * ```
+ */
+declare const whenReady: () => Promise<ScriptLoadState[]>;
+/**
+ * Clean up the GTM client.
+ * Call this when navigating away or cleaning up.
+ */
+declare const teardown: () => void;
+interface PageViewData {
+    event?: string;
+    page_path?: string;
+    page_location?: string;
+    page_title?: string;
+    page_referrer?: string;
+    [key: string]: unknown;
+}
+interface TrackPageViewOptions {
+    /**
+     * The event name to use for page views.
+     * @default 'page_view'
+     */
+    eventName?: string;
+    /**
+     * Whether to include query parameters in the page path.
+     * @default true
+     */
+    includeQueryParams?: boolean;
+    /**
+     * Additional data to include with each page view.
+     */
+    additionalData?: Record<string, unknown> | (() => Record<string, unknown>);
+}
+/**
+ * Track a page view event.
+ *
+ * @example
+ * ```ts
+ * import { trackPageView } from '@jwiedeman/gtm-kit-astro';
+ *
+ * // Track current page
+ * trackPageView();
+ *
+ * // Track with custom data
+ * trackPageView({
+ *   additionalData: { user_type: 'guest' }
+ * });
+ * ```
+ */
+declare const trackPageView: (options?: TrackPageViewOptions) => void;
+/**
+ * Set up automatic page view tracking with Astro View Transitions.
+ * Call this once when the page loads.
+ *
+ * @example
+ * ```astro
+ * ---
+ * // src/layouts/Layout.astro
+ * ---
+ * <script>
+ *   import { initGtm, setupViewTransitions } from '@jwiedeman/gtm-kit-astro';
+ *
+ *   initGtm({ containers: 'GTM-XXXXXX' });
+ *   setupViewTransitions();
+ * </script>
+ * ```
+ */
+declare const setupViewTransitions: (options?: TrackPageViewOptions) => (() => void);
+/**
+ * Set up page view tracking for standard navigation (no View Transitions).
+ * Tracks on popstate (back/forward) and initial load.
+ *
+ * @example
+ * ```ts
+ * import { setupPageTracking } from '@jwiedeman/gtm-kit-astro';
+ *
+ * setupPageTracking();
+ * ```
+ */
+declare const setupPageTracking: (options?: TrackPageViewOptions) => (() => void);
+export { PageViewData, TrackPageViewOptions, getGtmClient, initGtm, push, requireGtmClient, setConsentDefaults, setupPageTracking, setupViewTransitions, teardown, trackPageView, updateConsent, whenReady };

package/dist/index.js ADDED Viewed

@@ -0,0 +1,8 @@
+import { createGtmClient } from '@jwiedeman/gtm-kit';
+export { allGranted, analyticsOnly, consentPresets, eeaDefault, getConsentPreset } from '@jwiedeman/gtm-kit';
+var o=null,r=null,f=e=>o||(o=createGtmClient(e),r=e,o.init(),o),i=()=>o,m=()=>{if(!o)throw new Error("[gtm-kit/astro] GTM client not initialized. Call initGtm() first or ensure the GTM script has loaded.");return o},p=e=>{var t;let n=i();if(n)return n.push(e),!0;if(typeof window!="undefined"){let c=(t=r==null?void 0:r.dataLayerName)!=null?t:"dataLayer",l=window[c];return Array.isArray(l)?(l.push(e),!0):(console.warn("[gtm-kit/astro] GTM not initialized and dataLayer not found."),!1)}return !1},C=(e,n)=>{let t=i();return t?(t.setConsentDefaults(e,n),!0):(console.warn("[gtm-kit/astro] GTM not initialized. Consent defaults should be set before init."),!1)},y=(e,n)=>{let t=i();return t?(t.updateConsent(e,n),!0):(console.warn("[gtm-kit/astro] GTM not initialized. Cannot update consent."),!1)},h=()=>{let e=i();return e?e.whenReady():Promise.reject(new Error("[gtm-kit/astro] GTM not initialized."))},k=()=>{o&&(o.teardown(),o=null,r=null);};var d=()=>{},P=e=>typeof e=="function"?e():e!=null?e:{},s=(e={})=>{let{eventName:n="page_view",includeQueryParams:t=!0,additionalData:c}=e;if(typeof window=="undefined")return;let w=t?window.location.pathname+window.location.search:window.location.pathname,l={event:n,page_path:w,page_location:window.location.href,page_title:document.title,...P(c)};p(l);},u=!1,a="";var G=(e={})=>{if(typeof window=="undefined"||typeof document=="undefined"||u)return d;u=!0,a=window.location.pathname+window.location.search,s(e);let n=()=>{let t=window.location.pathname+window.location.search;t!==a&&(a=t,s(e));};return document.addEventListener("astro:page-load",n),()=>{document.removeEventListener("astro:page-load",n),u=!1,a="";}},x=(e={})=>{if(typeof window=="undefined")return d;a=window.location.pathname+window.location.search,s(e);let n=()=>{let t=window.location.pathname+window.location.search;t!==a&&(a=t,s(e));};return window.addEventListener("popstate",n),()=>{window.removeEventListener("popstate",n),a="";}};
+export { i as getGtmClient, f as initGtm, p as push, m as requireGtmClient, C as setConsentDefaults, x as setupPageTracking, G as setupViewTransitions, k as teardown, s as trackPageView, y as updateConsent, h as whenReady };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

package/package.json ADDED Viewed

@@ -0,0 +1,59 @@
+{
+  "name": "@jwiedeman/gtm-kit-astro",
+  "version": "1.1.3",
+  "description": "Astro components and helpers for GTM Kit - Google Tag Manager integration.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jwiedeman/GTM-Kit.git",
+    "directory": "packages/astro"
+  },
+  "author": "jwiedeman",
+  "keywords": [
+    "gtm",
+    "google-tag-manager",
+    "astro",
+    "astrojs",
+    "view-transitions"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./components": {
+      "types": "./dist/components/index.d.ts",
+      "import": "./dist/components/index.js",
+      "require": "./dist/components/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src/components/*.astro"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "lint": "eslint --max-warnings=0 \"src/**/*.ts\"",
+    "test": "jest --config ./jest.config.cjs --runInBand",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@jwiedeman/gtm-kit": "workspace:*"
+  },
+  "peerDependencies": {
+    "astro": "^3.0.0 || ^4.0.0 || ^5.0.0"
+  },
+  "devDependencies": {
+    "astro": "^4.16.0",
+    "tslib": "^2.6.2"
+  }
+}

package/src/components/GtmHead.astro ADDED Viewed

@@ -0,0 +1,117 @@
+---
+/**
+ * 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,
+  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) {
+  const consentEntries = Object.entries(defaultConsent)
+    .map(([key, value]) => `'${key}':'${value}'`)
+    .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 ADDED Viewed

@@ -0,0 +1,56 @@
+---
+/**
+ * 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 ADDED Viewed

@@ -0,0 +1,70 @@
+---
+/**
+ * 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}
+  />
+))}