mytart 0.1.7 → 0.2.0

package/dist/index.d.mts

@@ -9,12 +9,14 @@ interface BaseProviderConfig {
     enabled?: boolean;
 }
 type ProviderName = 'google-analytics' | 'mixpanel' | 'segment' | 'amplitude' | 'plausible' | 'posthog';
+type GoogleAnalyticsAppType = 'browser' | 'server';
 interface GoogleAnalyticsConfig extends BaseProviderConfig {
     provider: 'google-analytics';
     measurementId: string;
-    apiSecret: string;
+    apiSecret?: string;
     clientId?: string;
     debug?: boolean;
+    appType?: GoogleAnalyticsAppType;
 }
 interface MixpanelConfig extends BaseProviderConfig {
     provider: 'mixpanel';
@@ -118,12 +120,40 @@ declare abstract class BaseProvider {
     protected buildSuccess(statusCode?: number): TrackResult;
 }
 
+declare global {
+    interface Window {
+        gtag: GtagFn;
+        dataLayer: unknown[];
+    }
+}
+interface GtagFn {
+    (command: 'config', measurementId: string, config?: GtagConfig): void;
+    (command: 'event', eventName: string, params?: Record<string, unknown>): void;
+    (command: 'set', config: Record<string, unknown>): void;
+    (command: string, ...args: unknown[]): void;
+}
+interface GtagConfig {
+    send_page_view?: boolean;
+    page_title?: string;
+    page_location?: string;
+    page_referrer?: string;
+    user_id?: string;
+    [key: string]: unknown;
+}
 declare class GoogleAnalyticsProvider extends BaseProvider {
     readonly name = "google-analytics";
     private readonly config;
     private readonly http;
     private readonly endpoint;
+    private readonly isBrowser;
+    private gtagInitialized;
     constructor(config: GoogleAnalyticsConfig);
+    private ensureGtagLoaded;
+    private injectGtagScript;
+    private buildGtagResult;
+    private trackBrowser;
+    private identifyBrowser;
+    private pageBrowser;
     track({ event, properties, userId, anonymousId, timestamp }: TrackOptions): Promise<TrackResult>;
     identify({ userId, traits }: IdentifyOptions): Promise<TrackResult>;
     page({ name, url, referrer, userId, anonymousId }: PageOptions): Promise<TrackResult>;
@@ -186,4 +216,4 @@ declare class PostHogProvider extends BaseProvider {
     page({ name, url, userId, anonymousId, properties }: PageOptions): Promise<TrackResult>;
 }
 
-export { type AmplitudeConfig, AmplitudeProvider, BaseProvider, type BaseProviderConfig, type EventContext, type GoogleAnalyticsConfig, GoogleAnalyticsProvider, type IdentifyOptions, type MixpanelConfig, MixpanelProvider, Mytart, type MytartConfig, type MytartError, type PageOptions, type PlausibleConfig, PlausibleProvider, type PostHogConfig, PostHogProvider, type ProviderConfig, type ProviderName, type SegmentConfig, SegmentProvider, type TrackOptions, type TrackResult };
+export { type AmplitudeConfig, AmplitudeProvider, BaseProvider, type BaseProviderConfig, type EventContext, type GoogleAnalyticsAppType, type GoogleAnalyticsConfig, GoogleAnalyticsProvider, type IdentifyOptions, type MixpanelConfig, MixpanelProvider, Mytart, type MytartConfig, type MytartError, type PageOptions, type PlausibleConfig, PlausibleProvider, type PostHogConfig, PostHogProvider, type ProviderConfig, type ProviderName, type SegmentConfig, SegmentProvider, type TrackOptions, type TrackResult };

package/dist/index.d.ts

@@ -9,12 +9,14 @@ interface BaseProviderConfig {
     enabled?: boolean;
 }
 type ProviderName = 'google-analytics' | 'mixpanel' | 'segment' | 'amplitude' | 'plausible' | 'posthog';
+type GoogleAnalyticsAppType = 'browser' | 'server';
 interface GoogleAnalyticsConfig extends BaseProviderConfig {
     provider: 'google-analytics';
     measurementId: string;
-    apiSecret: string;
+    apiSecret?: string;
     clientId?: string;
     debug?: boolean;
+    appType?: GoogleAnalyticsAppType;
 }
 interface MixpanelConfig extends BaseProviderConfig {
     provider: 'mixpanel';
@@ -118,12 +120,40 @@ declare abstract class BaseProvider {
     protected buildSuccess(statusCode?: number): TrackResult;
 }
 
+declare global {
+    interface Window {
+        gtag: GtagFn;
+        dataLayer: unknown[];
+    }
+}
+interface GtagFn {
+    (command: 'config', measurementId: string, config?: GtagConfig): void;
+    (command: 'event', eventName: string, params?: Record<string, unknown>): void;
+    (command: 'set', config: Record<string, unknown>): void;
+    (command: string, ...args: unknown[]): void;
+}
+interface GtagConfig {
+    send_page_view?: boolean;
+    page_title?: string;
+    page_location?: string;
+    page_referrer?: string;
+    user_id?: string;
+    [key: string]: unknown;
+}
 declare class GoogleAnalyticsProvider extends BaseProvider {
     readonly name = "google-analytics";
     private readonly config;
     private readonly http;
     private readonly endpoint;
+    private readonly isBrowser;
+    private gtagInitialized;
     constructor(config: GoogleAnalyticsConfig);
+    private ensureGtagLoaded;
+    private injectGtagScript;
+    private buildGtagResult;
+    private trackBrowser;
+    private identifyBrowser;
+    private pageBrowser;
     track({ event, properties, userId, anonymousId, timestamp }: TrackOptions): Promise<TrackResult>;
     identify({ userId, traits }: IdentifyOptions): Promise<TrackResult>;
     page({ name, url, referrer, userId, anonymousId }: PageOptions): Promise<TrackResult>;
@@ -186,4 +216,4 @@ declare class PostHogProvider extends BaseProvider {
     page({ name, url, userId, anonymousId, properties }: PageOptions): Promise<TrackResult>;
 }
 
-export { type AmplitudeConfig, AmplitudeProvider, BaseProvider, type BaseProviderConfig, type EventContext, type GoogleAnalyticsConfig, GoogleAnalyticsProvider, type IdentifyOptions, type MixpanelConfig, MixpanelProvider, Mytart, type MytartConfig, type MytartError, type PageOptions, type PlausibleConfig, PlausibleProvider, type PostHogConfig, PostHogProvider, type ProviderConfig, type ProviderName, type SegmentConfig, SegmentProvider, type TrackOptions, type TrackResult };
+export { type AmplitudeConfig, AmplitudeProvider, BaseProvider, type BaseProviderConfig, type EventContext, type GoogleAnalyticsAppType, type GoogleAnalyticsConfig, GoogleAnalyticsProvider, type IdentifyOptions, type MixpanelConfig, MixpanelProvider, Mytart, type MytartConfig, type MytartError, type PageOptions, type PlausibleConfig, PlausibleProvider, type PostHogConfig, PostHogProvider, type ProviderConfig, type ProviderName, type SegmentConfig, SegmentProvider, type TrackOptions, type TrackResult };

package/dist/index.js

@@ -82,23 +82,104 @@ function isAxiosError(error) {
 // src/providers/google-analytics.ts
 var GA4_ENDPOINT = "https://www.google-analytics.com/mp/collect";
 var GA4_DEBUG_ENDPOINT = "https://www.google-analytics.com/debug/mp/collect";
+var GTAG_URL = "https://www.googletagmanager.com/gtag/js";
 var GoogleAnalyticsProvider = class extends BaseProvider {
   constructor(config) {
     super();
     this.name = "google-analytics";
+    this.gtagInitialized = false;
     this.config = config;
     this.http = createHttpClient();
     this.endpoint = config.debug ? GA4_DEBUG_ENDPOINT : GA4_ENDPOINT;
+    this.isBrowser = config.appType === "browser";
+  }
+  async ensureGtagLoaded() {
+    if (typeof window === "undefined") {
+      return;
+    }
+    if (typeof window.gtag === "function") {
+      return;
+    }
+    await this.injectGtagScript();
+  }
+  injectGtagScript() {
+    return new Promise((resolve) => {
+      const script = document.createElement("script");
+      script.async = true;
+      script.src = `${GTAG_URL}?id=${this.config.measurementId}`;
+      const firstScript = document.getElementsByTagName("script")[0];
+      firstScript.parentNode?.insertBefore(script, firstScript);
+      window.dataLayer = window.dataLayer || [];
+      window.gtag = function gtag(...args) {
+        window.dataLayer.push(args);
+      };
+      window.gtag("config", this.config.measurementId, {
+        send_page_view: false
+      });
+      script.onload = () => resolve();
+      script.onerror = () => resolve();
+    });
+  }
+  buildGtagResult() {
+    return {
+      provider: this.name,
+      success: true,
+      statusCode: 200
+    };
+  }
+  async trackBrowser({ event, properties, userId }) {
+    if (typeof window === "undefined") {
+      return this.buildGtagResult();
+    }
+    await this.ensureGtagLoaded();
+    if (userId) {
+      window.gtag("set", { user_id: userId });
+    }
+    window.gtag("event", event, properties || {});
+    return this.buildGtagResult();
+  }
+  async identifyBrowser({ userId, traits }) {
+    if (typeof window === "undefined") {
+      return this.buildGtagResult();
+    }
+    await this.ensureGtagLoaded();
+    window.gtag("set", { user_id: userId });
+    if (traits) {
+      Object.entries(traits).forEach(([key, value]) => {
+        window.gtag("set", { [key]: value });
+      });
+    }
+    return this.buildGtagResult();
+  }
+  async pageBrowser({ name, url, referrer, userId }) {
+    if (typeof window === "undefined") {
+      return this.buildGtagResult();
+    }
+    await this.ensureGtagLoaded();
+    const config = {
+      page_title: name,
+      page_location: url,
+      page_referrer: referrer,
+      send_page_view: true
+    };
+    if (userId) {
+      config.user_id = userId;
+    }
+    window.gtag("config", this.config.measurementId, config);
+    return this.buildGtagResult();
   }
   async track({ event, properties, userId, anonymousId, timestamp }) {
+    if (this.isBrowser) {
+      return this.trackBrowser({ event, properties, userId, anonymousId, timestamp });
+    }
     try {
-      const clientId = anonymousId ?? this.config.clientId ?? "anonymous";
+      const client_id = anonymousId ?? this.config.clientId ?? "anonymous";
       const params = { ...properties };
       if (timestamp) {
         params["timestamp_micros"] = timestamp.getTime() * 1e3;
       }
       const body = {
-        client_id: clientId,
+        client_id,
         events: [{ name: event, params }]
       };
       if (userId) {
@@ -123,6 +204,9 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
     }
   }
   async identify({ userId, traits }) {
+    if (this.isBrowser) {
+      return this.identifyBrowser({ userId, traits });
+    }
     try {
       const body = {
         client_id: userId,
@@ -151,6 +235,9 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
     }
   }
   async page({ name, url, referrer, userId, anonymousId }) {
+    if (this.isBrowser) {
+      return this.pageBrowser({ name, url, referrer, userId, anonymousId });
+    }
     return this.track({
       event: "page_view",
       properties: {

package/dist/index.mjs

@@ -39,23 +39,104 @@ function isAxiosError(error) {
 // src/providers/google-analytics.ts
 var GA4_ENDPOINT = "https://www.google-analytics.com/mp/collect";
 var GA4_DEBUG_ENDPOINT = "https://www.google-analytics.com/debug/mp/collect";
+var GTAG_URL = "https://www.googletagmanager.com/gtag/js";
 var GoogleAnalyticsProvider = class extends BaseProvider {
   constructor(config) {
     super();
     this.name = "google-analytics";
+    this.gtagInitialized = false;
     this.config = config;
     this.http = createHttpClient();
     this.endpoint = config.debug ? GA4_DEBUG_ENDPOINT : GA4_ENDPOINT;
+    this.isBrowser = config.appType === "browser";
+  }
+  async ensureGtagLoaded() {
+    if (typeof window === "undefined") {
+      return;
+    }
+    if (typeof window.gtag === "function") {
+      return;
+    }
+    await this.injectGtagScript();
+  }
+  injectGtagScript() {
+    return new Promise((resolve) => {
+      const script = document.createElement("script");
+      script.async = true;
+      script.src = `${GTAG_URL}?id=${this.config.measurementId}`;
+      const firstScript = document.getElementsByTagName("script")[0];
+      firstScript.parentNode?.insertBefore(script, firstScript);
+      window.dataLayer = window.dataLayer || [];
+      window.gtag = function gtag(...args) {
+        window.dataLayer.push(args);
+      };
+      window.gtag("config", this.config.measurementId, {
+        send_page_view: false
+      });
+      script.onload = () => resolve();
+      script.onerror = () => resolve();
+    });
+  }
+  buildGtagResult() {
+    return {
+      provider: this.name,
+      success: true,
+      statusCode: 200
+    };
+  }
+  async trackBrowser({ event, properties, userId }) {
+    if (typeof window === "undefined") {
+      return this.buildGtagResult();
+    }
+    await this.ensureGtagLoaded();
+    if (userId) {
+      window.gtag("set", { user_id: userId });
+    }
+    window.gtag("event", event, properties || {});
+    return this.buildGtagResult();
+  }
+  async identifyBrowser({ userId, traits }) {
+    if (typeof window === "undefined") {
+      return this.buildGtagResult();
+    }
+    await this.ensureGtagLoaded();
+    window.gtag("set", { user_id: userId });
+    if (traits) {
+      Object.entries(traits).forEach(([key, value]) => {
+        window.gtag("set", { [key]: value });
+      });
+    }
+    return this.buildGtagResult();
+  }
+  async pageBrowser({ name, url, referrer, userId }) {
+    if (typeof window === "undefined") {
+      return this.buildGtagResult();
+    }
+    await this.ensureGtagLoaded();
+    const config = {
+      page_title: name,
+      page_location: url,
+      page_referrer: referrer,
+      send_page_view: true
+    };
+    if (userId) {
+      config.user_id = userId;
+    }
+    window.gtag("config", this.config.measurementId, config);
+    return this.buildGtagResult();
   }
   async track({ event, properties, userId, anonymousId, timestamp }) {
+    if (this.isBrowser) {
+      return this.trackBrowser({ event, properties, userId, anonymousId, timestamp });
+    }
     try {
-      const clientId = anonymousId ?? this.config.clientId ?? "anonymous";
+      const client_id = anonymousId ?? this.config.clientId ?? "anonymous";
       const params = { ...properties };
       if (timestamp) {
         params["timestamp_micros"] = timestamp.getTime() * 1e3;
       }
       const body = {
-        client_id: clientId,
+        client_id,
         events: [{ name: event, params }]
       };
       if (userId) {
@@ -80,6 +161,9 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
     }
   }
   async identify({ userId, traits }) {
+    if (this.isBrowser) {
+      return this.identifyBrowser({ userId, traits });
+    }
     try {
       const body = {
         client_id: userId,
@@ -108,6 +192,9 @@ var GoogleAnalyticsProvider = class extends BaseProvider {
     }
   }
   async page({ name, url, referrer, userId, anonymousId }) {
+    if (this.isBrowser) {
+      return this.pageBrowser({ name, url, referrer, userId, anonymousId });
+    }
     return this.track({
       event: "page_view",
       properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mytart",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "description": "Multi-Yield Tracking & Analytics Relay Tool — framework-agnostic analytics for any project",
   "keywords": [
     "analytics",