mytart 0.1.0 → 0.1.2

package/dist/index.d.mts

@@ -46,10 +46,11 @@ interface PostHogConfig extends BaseProviderConfig {
 interface VercelAnalyticsConfig extends BaseProviderConfig {
     provider: 'vercel-analytics';
     /**
-     * Your Vercel Analytics ID (the `VERCEL_ANALYTICS_ID` environment variable
-     * or the measurement ID shown in your Vercel project's Analytics settings).
+     * Your Vercel Analytics ID. If not provided, it will be automatically
+     * retrieved from `window.__VERCEL_ANALYTICS_ID__` when deployed on Vercel.
+     * Set `VERCEL_ANALYTICS_ID` in your Vercel project or provide it here.
      */
-    analyticsId: string;
+    analyticsId?: string;
     /**
      * Override the default Vercel vitals ingestion endpoint.
      * Defaults to `https://vitals.vercel-insights.com/v1/vitals`.
@@ -206,6 +207,10 @@ declare class VercelAnalyticsProvider extends BaseProvider {
     private readonly http;
     private readonly endpoint;
     constructor(config: VercelAnalyticsConfig);
+    /** Check if Vercel analytics can be used (running on Vercel or analytics ID available). */
+    isAvailable(): boolean;
+    /** Get the analytics ID, attempting to resolve from config or injected global. */
+    private resolveAnalyticsId;
     track({ event, properties, timestamp, context }: TrackOptions): Promise<TrackResult>;
     /**
      * Vercel Analytics is privacy-focused and does not support traditional user

package/dist/index.d.ts

@@ -46,10 +46,11 @@ interface PostHogConfig extends BaseProviderConfig {
 interface VercelAnalyticsConfig extends BaseProviderConfig {
     provider: 'vercel-analytics';
     /**
-     * Your Vercel Analytics ID (the `VERCEL_ANALYTICS_ID` environment variable
-     * or the measurement ID shown in your Vercel project's Analytics settings).
+     * Your Vercel Analytics ID. If not provided, it will be automatically
+     * retrieved from `window.__VERCEL_ANALYTICS_ID__` when deployed on Vercel.
+     * Set `VERCEL_ANALYTICS_ID` in your Vercel project or provide it here.
      */
-    analyticsId: string;
+    analyticsId?: string;
     /**
      * Override the default Vercel vitals ingestion endpoint.
      * Defaults to `https://vitals.vercel-insights.com/v1/vitals`.
@@ -206,6 +207,10 @@ declare class VercelAnalyticsProvider extends BaseProvider {
     private readonly http;
     private readonly endpoint;
     constructor(config: VercelAnalyticsConfig);
+    /** Check if Vercel analytics can be used (running on Vercel or analytics ID available). */
+    isAvailable(): boolean;
+    /** Get the analytics ID, attempting to resolve from config or injected global. */
+    private resolveAnalyticsId;
     track({ event, properties, timestamp, context }: TrackOptions): Promise<TrackResult>;
     /**
      * Vercel Analytics is privacy-focused and does not support traditional user

package/dist/index.js

@@ -596,6 +596,16 @@ var PostHogProvider = class extends BaseProvider {
 
 // src/providers/vercel-analytics.ts
 var VERCEL_ENDPOINT = "https://vitals.vercel-insights.com/v1/vitals";
+function isRunningOnVercel() {
+  return typeof process !== "undefined" && process.env?.VERCEL === "1";
+}
+function getInjectedAnalyticsId() {
+  if (typeof window !== "undefined") {
+    const w = window;
+    return w.__VERCEL_ANALYTICS_ID__;
+  }
+  return void 0;
+}
 function generateId() {
   return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 9)}`;
 }
@@ -618,11 +628,32 @@ var VercelAnalyticsProvider = class extends BaseProvider {
     this.http = createHttpClient();
     this.endpoint = config.apiUrl ?? VERCEL_ENDPOINT;
   }
+  /** Check if Vercel analytics can be used (running on Vercel or analytics ID available). */
+  isAvailable() {
+    if (!isRunningOnVercel()) {
+      return false;
+    }
+    if (this.config.analyticsId) {
+      return true;
+    }
+    return typeof getInjectedAnalyticsId() === "string";
+  }
+  /** Get the analytics ID, attempting to resolve from config or injected global. */
+  resolveAnalyticsId() {
+    return this.config.analyticsId ?? getInjectedAnalyticsId();
+  }
   async track({ event, properties, timestamp, context }) {
+    const analyticsId = this.resolveAnalyticsId();
+    if (!analyticsId) {
+      return this.buildError(
+        "Vercel Analytics ID not found. Set it in config or deploy on Vercel with Analytics enabled.",
+        "VERCEL_ANALYTICS_ID_MISSING"
+      );
+    }
     try {
       const url = context?.page?.url ?? "";
       const payload = {
-        dsn: this.config.analyticsId,
+        dsn: analyticsId,
         id: generateId(),
         type: "custom",
         name: event,
@@ -661,9 +692,16 @@ var VercelAnalyticsProvider = class extends BaseProvider {
     };
   }
   async page({ name, url, referrer, properties, timestamp }) {
+    const analyticsId = this.resolveAnalyticsId();
+    if (!analyticsId) {
+      return this.buildError(
+        "Vercel Analytics ID not found. Set it in config or deploy on Vercel with Analytics enabled.",
+        "VERCEL_ANALYTICS_ID_MISSING"
+      );
+    }
     try {
       const payload = {
-        dsn: this.config.analyticsId,
+        dsn: analyticsId,
         id: generateId(),
         type: "pageview",
         name: name ?? "pageview",
@@ -722,7 +760,12 @@ function createProvider(config) {
 var Mytart = class {
   constructor(config) {
     this.config = config;
-    this.providers = config.providers.filter((c) => c.enabled === true).map(createProvider);
+    this.providers = config.providers.filter((c) => c.enabled === true).map(createProvider).filter((p) => {
+      if (p.name === "vercel-analytics") {
+        return p.isAvailable();
+      }
+      return true;
+    });
   }
   async track(options) {
     const enriched = {

package/dist/index.mjs

@@ -552,6 +552,16 @@ var PostHogProvider = class extends BaseProvider {
 
 // src/providers/vercel-analytics.ts
 var VERCEL_ENDPOINT = "https://vitals.vercel-insights.com/v1/vitals";
+function isRunningOnVercel() {
+  return typeof process !== "undefined" && process.env?.VERCEL === "1";
+}
+function getInjectedAnalyticsId() {
+  if (typeof window !== "undefined") {
+    const w = window;
+    return w.__VERCEL_ANALYTICS_ID__;
+  }
+  return void 0;
+}
 function generateId() {
   return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 9)}`;
 }
@@ -574,11 +584,32 @@ var VercelAnalyticsProvider = class extends BaseProvider {
     this.http = createHttpClient();
     this.endpoint = config.apiUrl ?? VERCEL_ENDPOINT;
   }
+  /** Check if Vercel analytics can be used (running on Vercel or analytics ID available). */
+  isAvailable() {
+    if (!isRunningOnVercel()) {
+      return false;
+    }
+    if (this.config.analyticsId) {
+      return true;
+    }
+    return typeof getInjectedAnalyticsId() === "string";
+  }
+  /** Get the analytics ID, attempting to resolve from config or injected global. */
+  resolveAnalyticsId() {
+    return this.config.analyticsId ?? getInjectedAnalyticsId();
+  }
   async track({ event, properties, timestamp, context }) {
+    const analyticsId = this.resolveAnalyticsId();
+    if (!analyticsId) {
+      return this.buildError(
+        "Vercel Analytics ID not found. Set it in config or deploy on Vercel with Analytics enabled.",
+        "VERCEL_ANALYTICS_ID_MISSING"
+      );
+    }
     try {
       const url = context?.page?.url ?? "";
       const payload = {
-        dsn: this.config.analyticsId,
+        dsn: analyticsId,
         id: generateId(),
         type: "custom",
         name: event,
@@ -617,9 +648,16 @@ var VercelAnalyticsProvider = class extends BaseProvider {
     };
   }
   async page({ name, url, referrer, properties, timestamp }) {
+    const analyticsId = this.resolveAnalyticsId();
+    if (!analyticsId) {
+      return this.buildError(
+        "Vercel Analytics ID not found. Set it in config or deploy on Vercel with Analytics enabled.",
+        "VERCEL_ANALYTICS_ID_MISSING"
+      );
+    }
     try {
       const payload = {
-        dsn: this.config.analyticsId,
+        dsn: analyticsId,
         id: generateId(),
         type: "pageview",
         name: name ?? "pageview",
@@ -678,7 +716,12 @@ function createProvider(config) {
 var Mytart = class {
   constructor(config) {
     this.config = config;
-    this.providers = config.providers.filter((c) => c.enabled === true).map(createProvider);
+    this.providers = config.providers.filter((c) => c.enabled === true).map(createProvider).filter((p) => {
+      if (p.name === "vercel-analytics") {
+        return p.isAvailable();
+      }
+      return true;
+    });
   }
   async track(options) {
     const enriched = {

package/package.json

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