@stackonward/google-tag-manager-nuxt 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @stackonward/google-tag-manager-nuxt
 
+## 0.2.0
+
+### Minor Changes
+
+- Add provider-neutral structured analytics values, Google-owned recommended event contracts, a framework-independent Google Tag Manager adapter, and a provider-registered CLI that generates reviewed GTM container import artifacts. Keep recommended GA4 event names intact, disable duplicate automatic page views, and verify packed external consumers.
+
+### Patch Changes
+
+- Updated dependencies
+- Updated dependencies
+  - @stackonward/analytics-nuxt@0.1.1
+  - @stackonward/analytics-core@0.2.0
+  - @stackonward/google-tag-manager@0.1.0
+
 ## 0.1.0
 
 ### Minor Changes

package/README.md

@@ -28,7 +28,7 @@ export default defineNuxtConfig({
 
 The integration starts disabled when the container ID is empty. Its default consent state denies every Google storage category. The product or CMP restores the user's decision and calls `useAnalyticsConsent().grant()` or `.deny()`.
 
-The remote GTM container must contain and publish the required GA4 tags, triggers and consent checks. This package does not mutate Google account configuration.
+Generate the matching GTM import artifact with `stackonward analytics generate`, import it into a GTM web-container workspace, preview it, and publish the reviewed container version. This package does not mutate Google account configuration.
 
 ## License
 

package/dist/module.json

@@ -4,9 +4,9 @@
   "compatibility": {
     "nuxt": ">=3.15.0"
   },
-  "version": "0.1.0",
+  "version": "0.2.0",
   "builder": {
     "@nuxt/module-builder": "1.0.3",
-    "unbuild": "3.6.1"
+    "unbuild": "unknown"
   }
 }

package/dist/runtime/plugins/google-tag-manager.client.js

@@ -1,5 +1,7 @@
+import {
+  createGoogleTagManagerTransport
+} from "@stackonward/google-tag-manager";
 import { defineNuxtPlugin, useNuxtApp, useRuntimeConfig } from "nuxt/app";
-import { createGoogleTagManagerTransport } from "../../google-tag-manager-transport";
 import { createGoogleTagManagerLifecycleParticipant } from "../google-tag-manager-lifecycle.js";
 export default defineNuxtPlugin({
   name: "stackonward:google-tag-manager",
@@ -27,7 +29,7 @@ export default defineNuxtPlugin({
     );
     analytics.registerTransport(
       createGoogleTagManagerTransport({
-        push: (event) => script.proxy.dataLayer.push(event)
+        push: (message) => script.proxy.dataLayer.push(message)
       })
     );
   }

package/dist/types.d.mts

@@ -4,6 +4,6 @@ import type { default as Module } from './module.mjs'
 
 export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>
 
-export { default, type normalizeGoogleTagManagerNuxtOptions } from './module.mjs'
+export { type GoogleConsentState, type GoogleConsentValue, type GoogleTagManagerNuxtModuleOptions, type GoogleTagManagerNuxtRuntimeConfig, type GoogleTagManagerScriptOptions } from '../dist/runtime/types.js'
 
-export { type GoogleConsentState, type GoogleConsentValue, type GoogleTagManagerNuxtModuleOptions, type GoogleTagManagerNuxtRuntimeConfig, type GoogleTagManagerScriptOptions } from './module.mjs'
+export { default, type normalizeGoogleTagManagerNuxtOptions } from './module.mjs'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackonward/google-tag-manager-nuxt",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Consent-aware Google Tag Manager transport and analytics composition module for Nuxt",
   "type": "module",
   "main": "./dist/module.mjs",
@@ -9,10 +9,6 @@
     ".": {
       "types": "./dist/module.d.mts",
       "import": "./dist/module.mjs"
-    },
-    "./transport": {
-      "types": "./dist/transport.d.mts",
-      "import": "./dist/transport.mjs"
     }
   },
   "files": [
@@ -22,6 +18,12 @@
     "CHANGELOG.md"
   ],
   "sideEffects": false,
+  "scripts": {
+    "build": "nuxt-module-build build",
+    "prepack": "pnpm build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -38,9 +40,10 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "zod": "^3.24.0",
-    "@stackonward/analytics-core": "^0.1.0",
-    "@stackonward/analytics-nuxt": "^0.1.0"
+    "@stackonward/analytics-core": "workspace:^",
+    "@stackonward/analytics-nuxt": "workspace:^",
+    "@stackonward/google-tag-manager": "workspace:^",
+    "zod": "^3.24.0"
   },
   "peerDependencies": {
     "@nuxt/scripts": ">=1.3.0 <2",
@@ -55,16 +58,10 @@
     "happy-dom": "^17.6.3",
     "nuxt": "^3.20.1",
     "typescript": "^5.9.3",
-    "unbuild": "^3.5.0",
     "vitest": "^3.2.4",
     "vue": "^3.5.0"
   },
   "engines": {
     "node": ">=20"
-  },
-  "scripts": {
-    "build": "nuxt-module-build build && unbuild",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run"
   }
-}
+}

package/dist/module.d.ts

@@ -1,22 +0,0 @@
-import { NuxtModule } from '@nuxt/schema';
-import { GoogleTagManagerNuxtRuntimeConfig, GoogleTagManagerNuxtModuleOptions } from '../dist/runtime/types.js';
-export { GoogleConsentState, GoogleConsentValue, GoogleTagManagerNuxtModuleOptions, GoogleTagManagerNuxtRuntimeConfig, GoogleTagManagerScriptOptions } from '../dist/runtime/types.js';
-import { AnalyticsNuxtRuntimeConfig } from '@stackonward/analytics-nuxt';
-
-interface NormalizedGoogleTagManagerOptions {
-    readonly runtime: GoogleTagManagerNuxtRuntimeConfig;
-    readonly analytics: AnalyticsNuxtRuntimeConfig;
-}
-declare function normalizeGoogleTagManagerNuxtOptions(input?: unknown): NormalizedGoogleTagManagerOptions;
-
-declare module "@nuxt/schema" {
-    interface NuxtConfig {
-        googleTagManager?: GoogleTagManagerNuxtModuleOptions;
-    }
-    interface NuxtOptions {
-        googleTagManager?: GoogleTagManagerNuxtModuleOptions;
-    }
-}
-declare const module$1: NuxtModule<GoogleTagManagerNuxtModuleOptions>;
-
-export { module$1 as default, normalizeGoogleTagManagerNuxtOptions };

package/dist/transport.d.mts

@@ -1,30 +0,0 @@
-import * as _stackonward_analytics_core from '@stackonward/analytics-core';
-import { AnalyticsPrimitive, AnalyticsEnvelope, AnalyticsValidationIssue, AnalyticsTransport } from '@stackonward/analytics-core';
-
-type GoogleTagManagerDataLayerEvent = Readonly<Record<string, AnalyticsPrimitive> & {
-    event: string;
-}>;
-type GoogleEventProjectionResult = {
-    readonly success: true;
-    readonly data: GoogleTagManagerDataLayerEvent;
-} | {
-    readonly success: false;
-    readonly issues: readonly AnalyticsValidationIssue[];
-};
-declare function projectGoogleTagManagerEvent(envelope: AnalyticsEnvelope): GoogleEventProjectionResult;
-
-declare class GoogleTagManagerProjectionError extends Error {
-    readonly issues: readonly _stackonward_analytics_core.AnalyticsValidationIssue[];
-    constructor(issues: ReturnType<typeof projectGoogleTagManagerEvent> & {
-        success: false;
-    });
-}
-interface GoogleTagManagerTransportOptions {
-    readonly beforeSend?: () => void | Promise<void>;
-    readonly push: (event: GoogleTagManagerDataLayerEvent) => void;
-    readonly dispose?: () => void | Promise<void>;
-}
-declare function createGoogleTagManagerTransport(options: GoogleTagManagerTransportOptions): AnalyticsTransport;
-
-export { GoogleTagManagerProjectionError, createGoogleTagManagerTransport, projectGoogleTagManagerEvent };
-export type { GoogleEventProjectionResult, GoogleTagManagerDataLayerEvent, GoogleTagManagerTransportOptions };

package/dist/transport.d.ts

@@ -1,30 +0,0 @@
-import * as _stackonward_analytics_core from '@stackonward/analytics-core';
-import { AnalyticsPrimitive, AnalyticsEnvelope, AnalyticsValidationIssue, AnalyticsTransport } from '@stackonward/analytics-core';
-
-type GoogleTagManagerDataLayerEvent = Readonly<Record<string, AnalyticsPrimitive> & {
-    event: string;
-}>;
-type GoogleEventProjectionResult = {
-    readonly success: true;
-    readonly data: GoogleTagManagerDataLayerEvent;
-} | {
-    readonly success: false;
-    readonly issues: readonly AnalyticsValidationIssue[];
-};
-declare function projectGoogleTagManagerEvent(envelope: AnalyticsEnvelope): GoogleEventProjectionResult;
-
-declare class GoogleTagManagerProjectionError extends Error {
-    readonly issues: readonly _stackonward_analytics_core.AnalyticsValidationIssue[];
-    constructor(issues: ReturnType<typeof projectGoogleTagManagerEvent> & {
-        success: false;
-    });
-}
-interface GoogleTagManagerTransportOptions {
-    readonly beforeSend?: () => void | Promise<void>;
-    readonly push: (event: GoogleTagManagerDataLayerEvent) => void;
-    readonly dispose?: () => void | Promise<void>;
-}
-declare function createGoogleTagManagerTransport(options: GoogleTagManagerTransportOptions): AnalyticsTransport;
-
-export { GoogleTagManagerProjectionError, createGoogleTagManagerTransport, projectGoogleTagManagerEvent };
-export type { GoogleEventProjectionResult, GoogleTagManagerDataLayerEvent, GoogleTagManagerTransportOptions };

package/dist/transport.mjs

@@ -1,97 +0,0 @@
-const GOOGLE_NAME_PATTERN = /^[A-Za-z][A-Za-z0-9_]{0,39}$/;
-const RESERVED_PREFIXES = ["firebase_", "google_", "ga_"];
-const GOOGLE_PARAMETER_LIMIT = 25;
-function projectGoogleTagManagerEvent(envelope) {
-  const issues = [];
-  validateGoogleName("name", envelope.name, issues);
-  const contextKeys = new Set(Object.keys(envelope.context));
-  for (const name of Object.keys(envelope.properties)) {
-    if (contextKeys.has(name)) {
-      issues.push({
-        path: `properties.${name}`,
-        code: "context_property_collision",
-        message: "Event properties cannot overwrite analytics context"
-      });
-    }
-  }
-  const merged = { ...envelope.context, ...envelope.properties, event_source: envelope.source };
-  const entries = Object.entries(merged);
-  if (entries.length > GOOGLE_PARAMETER_LIMIT) {
-    issues.push({
-      path: "properties",
-      code: "too_many_parameters",
-      message: `Google events cannot exceed ${GOOGLE_PARAMETER_LIMIT} parameters`
-    });
-  }
-  for (const [name, value] of entries) {
-    validateGoogleName(`properties.${name}`, name, issues);
-    if (Array.isArray(value)) {
-      issues.push({
-        path: `properties.${name}`,
-        code: "unsupported_array",
-        message: "Google Tag Manager event parameters must be primitive values"
-      });
-    }
-  }
-  if (issues.length > 0) {
-    return { success: false, issues: Object.freeze(issues) };
-  }
-  return {
-    success: true,
-    data: Object.freeze({
-      event: envelope.name,
-      ...Object.fromEntries(entries)
-    })
-  };
-}
-function validateGoogleName(path, value, issues) {
-  if (!GOOGLE_NAME_PATTERN.test(value)) {
-    issues.push({
-      path,
-      code: "invalid_google_name",
-      message: "Google names must start with a letter and contain at most 40 alphanumeric or underscore characters"
-    });
-  }
-  if (RESERVED_PREFIXES.some((prefix) => value.toLowerCase().startsWith(prefix))) {
-    issues.push({
-      path,
-      code: "reserved_google_prefix",
-      message: "Google event and parameter names cannot use reserved prefixes"
-    });
-  }
-}
-
-class GoogleTagManagerProjectionError extends Error {
-  issues;
-  constructor(issues) {
-    super("Analytics event is not compatible with Google Tag Manager");
-    this.name = "GoogleTagManagerProjectionError";
-    this.issues = issues.issues;
-  }
-}
-function createGoogleTagManagerTransport(options) {
-  let disposed = false;
-  return {
-    id: "google-tag-manager",
-    async send(envelope) {
-      if (disposed) {
-        throw new Error("Google Tag Manager transport is disposed");
-      }
-      const projection = projectGoogleTagManagerEvent(envelope);
-      if (!projection.success) {
-        throw new GoogleTagManagerProjectionError(projection);
-      }
-      await options.beforeSend?.();
-      options.push(projection.data);
-    },
-    async dispose() {
-      if (disposed) {
-        return;
-      }
-      disposed = true;
-      await options.dispose?.();
-    }
-  };
-}
-
-export { GoogleTagManagerProjectionError, createGoogleTagManagerTransport, projectGoogleTagManagerEvent };