@vercel/analytics 0.1.6-beta.1 → 0.1.7-beta.1

package/dist/index.cjs

@@ -20,7 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/generic.ts
 var generic_exports = {};
 __export(generic_exports, {
-  inject: () => inject
+  inject: () => inject,
+  track: () => track
 });
 module.exports = __toCommonJS(generic_exports);
 
@@ -37,20 +38,62 @@ var initQueue = () => {
 function isBrowser() {
   return typeof window !== "undefined";
 }
-function isDevelopment() {
+function detectEnvironment() {
   if (typeof process === "undefined")
-    return false;
-  return process.env.NODE_ENV === "development" || process.env.NODE_ENV === "test";
+    return "production";
+  if (process.env.NODE_ENV === "development" || process.env.NODE_ENV === "test")
+    return "development";
+  return "production";
+}
+function setMode(mode = "auto") {
+  if (mode === "auto") {
+    window.vam = detectEnvironment();
+  }
+  window.vam = mode;
+}
+function getMode() {
+  return window.vam || "production";
+}
+function isProduction() {
+  return getMode() === "production";
+}
+function isDevelopment() {
+  return getMode() === "development";
+}
+var removeKey = (key, { [key]: _, ...rest }) => rest;
+function parseProperties(properties, options) {
+  let props = properties;
+  const errorProperties = [];
+  for (const [key, value] of Object.entries(properties)) {
+    if (typeof value === "object" && value !== null) {
+      if (options.strip) {
+        props = removeKey(key, props);
+      } else {
+        errorProperties.push(key);
+      }
+    }
+  }
+  if (errorProperties.length > 0 && !options.strip) {
+    throw Error(
+      `The following properties are not valid: ${errorProperties.join(
+        ", "
+      )}. Only strings, numbers, booleans, and null are allowed.`
+    );
+  }
+  return props;
 }
 
 // src/generic.ts
-var inject = ({ beforeSend, debug } = { debug: isDevelopment() }) => {
+var inject = (props = {
+  debug: true
+}) => {
   var _a;
   if (!isBrowser())
     return;
+  setMode(props.mode);
   initQueue();
-  if (beforeSend) {
-    (_a = window.va) == null ? void 0 : _a.call(window, "beforeSend", beforeSend);
+  if (props.beforeSend) {
+    (_a = window.va) == null ? void 0 : _a.call(window, "beforeSend", props.beforeSend);
   }
   const src = isDevelopment() ? "https://cdn.vercel-insights.com/v1/script.debug.js" : "/_vercel/insights/script.js";
   if (document.head.querySelector(`script[src*="${src}"]`))
@@ -58,13 +101,34 @@ var inject = ({ beforeSend, debug } = { debug: isDevelopment() }) => {
   const script = document.createElement("script");
   script.src = src;
   script.defer = true;
-  if (isDevelopment() && debug === false) {
+  if (isDevelopment() && props.debug === false) {
     script.setAttribute("data-debug", "false");
   }
   document.head.appendChild(script);
 };
+var track = (name, properties) => {
+  var _a, _b;
+  if (!properties) {
+    (_a = window.va) == null ? void 0 : _a.call(window, "track", { name });
+    return;
+  }
+  try {
+    const props = parseProperties(properties, {
+      strip: isProduction()
+    });
+    (_b = window.va) == null ? void 0 : _b.call(window, "track", {
+      name,
+      data: props
+    });
+  } catch (err) {
+    if (err instanceof Error && isDevelopment()) {
+      console.error(err);
+    }
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  inject
+  inject,
+  track
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/generic.ts","../src/queue.ts","../src/utils.ts"],"sourcesContent":["import { initQueue } from './queue';\nimport type { AnalyticsProps } from './types';\nimport { isBrowser, isDevelopment } from './utils';\n\nexport const inject = (\n  { beforeSend, debug }: AnalyticsProps = { debug: isDevelopment() },\n): void => {\n  if (!isBrowser()) return;\n  initQueue();\n\n  if (beforeSend) {\n    window.va?.('beforeSend', beforeSend);\n  }\n  const src = isDevelopment()\n    ? 'https://cdn.vercel-insights.com/v1/script.debug.js'\n    : '/_vercel/insights/script.js';\n\n  if (document.head.querySelector(`script[src*=\"${src}\"]`)) return;\n\n  const script = document.createElement('script');\n  script.src = src;\n  script.defer = true;\n\n  if (isDevelopment() && debug === false) {\n    script.setAttribute('data-debug', 'false');\n  }\n\n  document.head.appendChild(script);\n};\n","export const initQueue = (): void => {\n  // initialise va until script is loaded\n  if (window.va) return;\n\n  window.va = function a(...params): void {\n    (window.vaq = window.vaq || []).push(params);\n  };\n};\n","export function isBrowser(): boolean {\n  return typeof window !== 'undefined';\n}\n\nexport function isDevelopment(): boolean {\n  if (typeof process === 'undefined') return false;\n  return (\n    process.env.NODE_ENV === 'development' || process.env.NODE_ENV === 'test'\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,YAAY,MAAY;AAEnC,MAAI,OAAO;AAAI;AAEf,SAAO,KAAK,SAAS,KAAK,QAAc;AACtC,KAAC,OAAO,MAAM,OAAO,OAAO,CAAC,GAAG,KAAK,MAAM;AAAA,EAC7C;AACF;;;ACPO,SAAS,YAAqB;AACnC,SAAO,OAAO,WAAW;AAC3B;AAEO,SAAS,gBAAyB;AACvC,MAAI,OAAO,YAAY;AAAa,WAAO;AAC3C,SACE,QAAQ,IAAI,aAAa,iBAAiB,QAAQ,IAAI,aAAa;AAEvE;;;AFLO,IAAM,SAAS,CACpB,EAAE,YAAY,MAAM,IAAoB,EAAE,OAAO,cAAc,EAAE,MACxD;AANX;AAOE,MAAI,CAAC,UAAU;AAAG;AAClB,YAAU;AAEV,MAAI,YAAY;AACd,iBAAO,OAAP,gCAAY,cAAc;AAAA,EAC5B;AACA,QAAM,MAAM,cAAc,IACtB,uDACA;AAEJ,MAAI,SAAS,KAAK,cAAc,gBAAgB,OAAO;AAAG;AAE1D,QAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,SAAO,MAAM;AACb,SAAO,QAAQ;AAEf,MAAI,cAAc,KAAK,UAAU,OAAO;AACtC,WAAO,aAAa,cAAc,OAAO;AAAA,EAC3C;AAEA,WAAS,KAAK,YAAY,MAAM;AAClC;","names":[]}
+{"version":3,"sources":["../src/generic.ts","../src/queue.ts","../src/utils.ts"],"sourcesContent":["import { initQueue } from './queue';\nimport type { AllowedPropertyValues, AnalyticsProps } from './types';\nimport {\n  isBrowser,\n  parseProperties,\n  setMode,\n  isDevelopment,\n  isProduction,\n} from './utils';\n\nexport const inject = (\n  props: AnalyticsProps = {\n    debug: true,\n  },\n): void => {\n  if (!isBrowser()) return;\n\n  setMode(props.mode);\n\n  initQueue();\n\n  if (props.beforeSend) {\n    window.va?.('beforeSend', props.beforeSend);\n  }\n\n  const src = isDevelopment()\n    ? 'https://cdn.vercel-insights.com/v1/script.debug.js'\n    : '/_vercel/insights/script.js';\n\n  if (document.head.querySelector(`script[src*=\"${src}\"]`)) return;\n\n  const script = document.createElement('script');\n  script.src = src;\n  script.defer = true;\n\n  if (isDevelopment() && props.debug === false) {\n    script.setAttribute('data-debug', 'false');\n  }\n\n  document.head.appendChild(script);\n};\n\nexport const track = (\n  name: string,\n  properties?: Record<string, AllowedPropertyValues>,\n): void => {\n  if (!properties) {\n    window.va?.('track', { name });\n    return;\n  }\n\n  try {\n    const props = parseProperties(properties, {\n      strip: isProduction(),\n    });\n\n    window.va?.('track', {\n      name,\n      data: props,\n    });\n  } catch (err) {\n    if (err instanceof Error && isDevelopment()) {\n      // eslint-disable-next-line no-console\n      console.error(err);\n    }\n  }\n};\n","export const initQueue = (): void => {\n  // initialize va until script is loaded\n  if (window.va) return;\n\n  window.va = function a(...params): void {\n    (window.vaq = window.vaq || []).push(params);\n  };\n};\n","import type { AllowedPropertyValues, Mode } from './types';\n\nexport function isBrowser(): boolean {\n  return typeof window !== 'undefined';\n}\n\nfunction detectEnvironment(): 'development' | 'production' {\n  if (typeof process === 'undefined') return 'production';\n\n  if (process.env.NODE_ENV === 'development' || process.env.NODE_ENV === 'test')\n    return 'development';\n\n  return 'production';\n}\n\nexport function setMode(mode: Mode = 'auto'): void {\n  if (mode === 'auto') {\n    window.vam = detectEnvironment();\n  }\n\n  window.vam = mode;\n}\n\nexport function getMode(): Mode {\n  return window.vam || 'production';\n}\n\nexport function isProduction(): boolean {\n  return getMode() === 'production';\n}\n\nexport function isDevelopment(): boolean {\n  return getMode() === 'development';\n}\n\nconst removeKey = (key: string, { [key]: _, ...rest }): Record<string, any> =>\n  rest;\n\nexport function parseProperties(\n  properties: Record<string, unknown>,\n  options: {\n    strip?: boolean;\n  },\n): Error | Record<string, AllowedPropertyValues> | undefined {\n  let props = properties;\n  const errorProperties: string[] = [];\n  for (const [key, value] of Object.entries(properties)) {\n    if (typeof value === 'object' && value !== null) {\n      if (options.strip) {\n        props = removeKey(key, props);\n      } else {\n        errorProperties.push(key);\n      }\n    }\n  }\n\n  if (errorProperties.length > 0 && !options.strip) {\n    throw Error(\n      `The following properties are not valid: ${errorProperties.join(\n        ', ',\n      )}. Only strings, numbers, booleans, and null are allowed.`,\n    );\n  }\n  return props as Record<string, AllowedPropertyValues>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,YAAY,MAAY;AAEnC,MAAI,OAAO;AAAI;AAEf,SAAO,KAAK,SAAS,KAAK,QAAc;AACtC,KAAC,OAAO,MAAM,OAAO,OAAO,CAAC,GAAG,KAAK,MAAM;AAAA,EAC7C;AACF;;;ACLO,SAAS,YAAqB;AACnC,SAAO,OAAO,WAAW;AAC3B;AAEA,SAAS,oBAAkD;AACzD,MAAI,OAAO,YAAY;AAAa,WAAO;AAE3C,MAAI,QAAQ,IAAI,aAAa,iBAAiB,QAAQ,IAAI,aAAa;AACrE,WAAO;AAET,SAAO;AACT;AAEO,SAAS,QAAQ,OAAa,QAAc;AACjD,MAAI,SAAS,QAAQ;AACnB,WAAO,MAAM,kBAAkB;AAAA,EACjC;AAEA,SAAO,MAAM;AACf;AAEO,SAAS,UAAgB;AAC9B,SAAO,OAAO,OAAO;AACvB;AAEO,SAAS,eAAwB;AACtC,SAAO,QAAQ,MAAM;AACvB;AAEO,SAAS,gBAAyB;AACvC,SAAO,QAAQ,MAAM;AACvB;AAEA,IAAM,YAAY,CAAC,KAAa,GAAG,MAAM,MAAM,KAAK,MAClD;AAEK,SAAS,gBACd,YACA,SAG2D;AAC3D,MAAI,QAAQ;AACZ,QAAM,kBAA4B,CAAC;AACnC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,UAAU,GAAG;AACrD,QAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,UAAI,QAAQ,OAAO;AACjB,gBAAQ,UAAU,KAAK,KAAK;AAAA,MAC9B,OAAO;AACL,wBAAgB,KAAK,GAAG;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AAEA,MAAI,gBAAgB,SAAS,KAAK,CAAC,QAAQ,OAAO;AAChD,UAAM;AAAA,MACJ,2CAA2C,gBAAgB;AAAA,QACzD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;;;AFtDO,IAAM,SAAS,CACpB,QAAwB;AAAA,EACtB,OAAO;AACT,MACS;AAdX;AAeE,MAAI,CAAC,UAAU;AAAG;AAElB,UAAQ,MAAM,IAAI;AAElB,YAAU;AAEV,MAAI,MAAM,YAAY;AACpB,iBAAO,OAAP,gCAAY,cAAc,MAAM;AAAA,EAClC;AAEA,QAAM,MAAM,cAAc,IACtB,uDACA;AAEJ,MAAI,SAAS,KAAK,cAAc,gBAAgB,OAAO;AAAG;AAE1D,QAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,SAAO,MAAM;AACb,SAAO,QAAQ;AAEf,MAAI,cAAc,KAAK,MAAM,UAAU,OAAO;AAC5C,WAAO,aAAa,cAAc,OAAO;AAAA,EAC3C;AAEA,WAAS,KAAK,YAAY,MAAM;AAClC;AAEO,IAAM,QAAQ,CACnB,MACA,eACS;AA7CX;AA8CE,MAAI,CAAC,YAAY;AACf,iBAAO,OAAP,gCAAY,SAAS,EAAE,KAAK;AAC5B;AAAA,EACF;AAEA,MAAI;AACF,UAAM,QAAQ,gBAAgB,YAAY;AAAA,MACxC,OAAO,aAAa;AAAA,IACtB,CAAC;AAED,iBAAO,OAAP,gCAAY,SAAS;AAAA,MACnB;AAAA,MACA,MAAM;AAAA,IACR;AAAA,EACF,SAAS,KAAP;AACA,QAAI,eAAe,SAAS,cAAc,GAAG;AAE3C,cAAQ,MAAM,GAAG;AAAA,IACnB;AAAA,EACF;AACF;","names":[]}

package/dist/index.d.ts

@@ -2,20 +2,25 @@ interface PageViewEvent {
     type: 'pageview';
     url: string;
 }
-declare type IEvent = PageViewEvent;
-declare type BeforeSend = (event: IEvent) => IEvent | null;
+declare type Event = PageViewEvent;
+declare type Mode = 'auto' | 'development' | 'production';
+declare type AllowedPropertyValues = string | number | boolean | null;
+declare type BeforeSend = (event: Event) => Event | null;
 interface AnalyticsProps {
     beforeSend?: BeforeSend;
     debug?: boolean;
+    mode?: Mode;
 }
 declare global {
     interface Window {
         va?: (event: string, properties?: unknown) => void;
         vaq?: [string, unknown?][];
         vai?: boolean;
+        vam?: Mode;
     }
 }
 
-declare const inject: ({ beforeSend, debug }?: AnalyticsProps) => void;
+declare const inject: (props?: AnalyticsProps) => void;
+declare const track: (name: string, properties?: Record<string, AllowedPropertyValues>) => void;
 
-export { inject };
+export { inject, track };

package/dist/index.js

@@ -11,20 +11,62 @@ var initQueue = () => {
 function isBrowser() {
   return typeof window !== "undefined";
 }
-function isDevelopment() {
+function detectEnvironment() {
   if (typeof process === "undefined")
-    return false;
-  return process.env.NODE_ENV === "development" || process.env.NODE_ENV === "test";
+    return "production";
+  if (process.env.NODE_ENV === "development" || process.env.NODE_ENV === "test")
+    return "development";
+  return "production";
+}
+function setMode(mode = "auto") {
+  if (mode === "auto") {
+    window.vam = detectEnvironment();
+  }
+  window.vam = mode;
+}
+function getMode() {
+  return window.vam || "production";
+}
+function isProduction() {
+  return getMode() === "production";
+}
+function isDevelopment() {
+  return getMode() === "development";
+}
+var removeKey = (key, { [key]: _, ...rest }) => rest;
+function parseProperties(properties, options) {
+  let props = properties;
+  const errorProperties = [];
+  for (const [key, value] of Object.entries(properties)) {
+    if (typeof value === "object" && value !== null) {
+      if (options.strip) {
+        props = removeKey(key, props);
+      } else {
+        errorProperties.push(key);
+      }
+    }
+  }
+  if (errorProperties.length > 0 && !options.strip) {
+    throw Error(
+      `The following properties are not valid: ${errorProperties.join(
+        ", "
+      )}. Only strings, numbers, booleans, and null are allowed.`
+    );
+  }
+  return props;
 }
 
 // src/generic.ts
-var inject = ({ beforeSend, debug } = { debug: isDevelopment() }) => {
+var inject = (props = {
+  debug: true
+}) => {
   var _a;
   if (!isBrowser())
     return;
+  setMode(props.mode);
   initQueue();
-  if (beforeSend) {
-    (_a = window.va) == null ? void 0 : _a.call(window, "beforeSend", beforeSend);
+  if (props.beforeSend) {
+    (_a = window.va) == null ? void 0 : _a.call(window, "beforeSend", props.beforeSend);
   }
   const src = isDevelopment() ? "https://cdn.vercel-insights.com/v1/script.debug.js" : "/_vercel/insights/script.js";
   if (document.head.querySelector(`script[src*="${src}"]`))
@@ -32,12 +74,33 @@ var inject = ({ beforeSend, debug } = { debug: isDevelopment() }) => {
   const script = document.createElement("script");
   script.src = src;
   script.defer = true;
-  if (isDevelopment() && debug === false) {
+  if (isDevelopment() && props.debug === false) {
     script.setAttribute("data-debug", "false");
   }
   document.head.appendChild(script);
 };
+var track = (name, properties) => {
+  var _a, _b;
+  if (!properties) {
+    (_a = window.va) == null ? void 0 : _a.call(window, "track", { name });
+    return;
+  }
+  try {
+    const props = parseProperties(properties, {
+      strip: isProduction()
+    });
+    (_b = window.va) == null ? void 0 : _b.call(window, "track", {
+      name,
+      data: props
+    });
+  } catch (err) {
+    if (err instanceof Error && isDevelopment()) {
+      console.error(err);
+    }
+  }
+};
 export {
-  inject
+  inject,
+  track
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/queue.ts","../src/utils.ts","../src/generic.ts"],"sourcesContent":["export const initQueue = (): void => {\n  // initialise va until script is loaded\n  if (window.va) return;\n\n  window.va = function a(...params): void {\n    (window.vaq = window.vaq || []).push(params);\n  };\n};\n","export function isBrowser(): boolean {\n  return typeof window !== 'undefined';\n}\n\nexport function isDevelopment(): boolean {\n  if (typeof process === 'undefined') return false;\n  return (\n    process.env.NODE_ENV === 'development' || process.env.NODE_ENV === 'test'\n  );\n}\n","import { initQueue } from './queue';\nimport type { AnalyticsProps } from './types';\nimport { isBrowser, isDevelopment } from './utils';\n\nexport const inject = (\n  { beforeSend, debug }: AnalyticsProps = { debug: isDevelopment() },\n): void => {\n  if (!isBrowser()) return;\n  initQueue();\n\n  if (beforeSend) {\n    window.va?.('beforeSend', beforeSend);\n  }\n  const src = isDevelopment()\n    ? 'https://cdn.vercel-insights.com/v1/script.debug.js'\n    : '/_vercel/insights/script.js';\n\n  if (document.head.querySelector(`script[src*=\"${src}\"]`)) return;\n\n  const script = document.createElement('script');\n  script.src = src;\n  script.defer = true;\n\n  if (isDevelopment() && debug === false) {\n    script.setAttribute('data-debug', 'false');\n  }\n\n  document.head.appendChild(script);\n};\n"],"mappings":";AAAO,IAAM,YAAY,MAAY;AAEnC,MAAI,OAAO;AAAI;AAEf,SAAO,KAAK,SAAS,KAAK,QAAc;AACtC,KAAC,OAAO,MAAM,OAAO,OAAO,CAAC,GAAG,KAAK,MAAM;AAAA,EAC7C;AACF;;;ACPO,SAAS,YAAqB;AACnC,SAAO,OAAO,WAAW;AAC3B;AAEO,SAAS,gBAAyB;AACvC,MAAI,OAAO,YAAY;AAAa,WAAO;AAC3C,SACE,QAAQ,IAAI,aAAa,iBAAiB,QAAQ,IAAI,aAAa;AAEvE;;;ACLO,IAAM,SAAS,CACpB,EAAE,YAAY,MAAM,IAAoB,EAAE,OAAO,cAAc,EAAE,MACxD;AANX;AAOE,MAAI,CAAC,UAAU;AAAG;AAClB,YAAU;AAEV,MAAI,YAAY;AACd,iBAAO,OAAP,gCAAY,cAAc;AAAA,EAC5B;AACA,QAAM,MAAM,cAAc,IACtB,uDACA;AAEJ,MAAI,SAAS,KAAK,cAAc,gBAAgB,OAAO;AAAG;AAE1D,QAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,SAAO,MAAM;AACb,SAAO,QAAQ;AAEf,MAAI,cAAc,KAAK,UAAU,OAAO;AACtC,WAAO,aAAa,cAAc,OAAO;AAAA,EAC3C;AAEA,WAAS,KAAK,YAAY,MAAM;AAClC;","names":[]}
+{"version":3,"sources":["../src/queue.ts","../src/utils.ts","../src/generic.ts"],"sourcesContent":["export const initQueue = (): void => {\n  // initialize va until script is loaded\n  if (window.va) return;\n\n  window.va = function a(...params): void {\n    (window.vaq = window.vaq || []).push(params);\n  };\n};\n","import type { AllowedPropertyValues, Mode } from './types';\n\nexport function isBrowser(): boolean {\n  return typeof window !== 'undefined';\n}\n\nfunction detectEnvironment(): 'development' | 'production' {\n  if (typeof process === 'undefined') return 'production';\n\n  if (process.env.NODE_ENV === 'development' || process.env.NODE_ENV === 'test')\n    return 'development';\n\n  return 'production';\n}\n\nexport function setMode(mode: Mode = 'auto'): void {\n  if (mode === 'auto') {\n    window.vam = detectEnvironment();\n  }\n\n  window.vam = mode;\n}\n\nexport function getMode(): Mode {\n  return window.vam || 'production';\n}\n\nexport function isProduction(): boolean {\n  return getMode() === 'production';\n}\n\nexport function isDevelopment(): boolean {\n  return getMode() === 'development';\n}\n\nconst removeKey = (key: string, { [key]: _, ...rest }): Record<string, any> =>\n  rest;\n\nexport function parseProperties(\n  properties: Record<string, unknown>,\n  options: {\n    strip?: boolean;\n  },\n): Error | Record<string, AllowedPropertyValues> | undefined {\n  let props = properties;\n  const errorProperties: string[] = [];\n  for (const [key, value] of Object.entries(properties)) {\n    if (typeof value === 'object' && value !== null) {\n      if (options.strip) {\n        props = removeKey(key, props);\n      } else {\n        errorProperties.push(key);\n      }\n    }\n  }\n\n  if (errorProperties.length > 0 && !options.strip) {\n    throw Error(\n      `The following properties are not valid: ${errorProperties.join(\n        ', ',\n      )}. Only strings, numbers, booleans, and null are allowed.`,\n    );\n  }\n  return props as Record<string, AllowedPropertyValues>;\n}\n","import { initQueue } from './queue';\nimport type { AllowedPropertyValues, AnalyticsProps } from './types';\nimport {\n  isBrowser,\n  parseProperties,\n  setMode,\n  isDevelopment,\n  isProduction,\n} from './utils';\n\nexport const inject = (\n  props: AnalyticsProps = {\n    debug: true,\n  },\n): void => {\n  if (!isBrowser()) return;\n\n  setMode(props.mode);\n\n  initQueue();\n\n  if (props.beforeSend) {\n    window.va?.('beforeSend', props.beforeSend);\n  }\n\n  const src = isDevelopment()\n    ? 'https://cdn.vercel-insights.com/v1/script.debug.js'\n    : '/_vercel/insights/script.js';\n\n  if (document.head.querySelector(`script[src*=\"${src}\"]`)) return;\n\n  const script = document.createElement('script');\n  script.src = src;\n  script.defer = true;\n\n  if (isDevelopment() && props.debug === false) {\n    script.setAttribute('data-debug', 'false');\n  }\n\n  document.head.appendChild(script);\n};\n\nexport const track = (\n  name: string,\n  properties?: Record<string, AllowedPropertyValues>,\n): void => {\n  if (!properties) {\n    window.va?.('track', { name });\n    return;\n  }\n\n  try {\n    const props = parseProperties(properties, {\n      strip: isProduction(),\n    });\n\n    window.va?.('track', {\n      name,\n      data: props,\n    });\n  } catch (err) {\n    if (err instanceof Error && isDevelopment()) {\n      // eslint-disable-next-line no-console\n      console.error(err);\n    }\n  }\n};\n"],"mappings":";AAAO,IAAM,YAAY,MAAY;AAEnC,MAAI,OAAO;AAAI;AAEf,SAAO,KAAK,SAAS,KAAK,QAAc;AACtC,KAAC,OAAO,MAAM,OAAO,OAAO,CAAC,GAAG,KAAK,MAAM;AAAA,EAC7C;AACF;;;ACLO,SAAS,YAAqB;AACnC,SAAO,OAAO,WAAW;AAC3B;AAEA,SAAS,oBAAkD;AACzD,MAAI,OAAO,YAAY;AAAa,WAAO;AAE3C,MAAI,QAAQ,IAAI,aAAa,iBAAiB,QAAQ,IAAI,aAAa;AACrE,WAAO;AAET,SAAO;AACT;AAEO,SAAS,QAAQ,OAAa,QAAc;AACjD,MAAI,SAAS,QAAQ;AACnB,WAAO,MAAM,kBAAkB;AAAA,EACjC;AAEA,SAAO,MAAM;AACf;AAEO,SAAS,UAAgB;AAC9B,SAAO,OAAO,OAAO;AACvB;AAEO,SAAS,eAAwB;AACtC,SAAO,QAAQ,MAAM;AACvB;AAEO,SAAS,gBAAyB;AACvC,SAAO,QAAQ,MAAM;AACvB;AAEA,IAAM,YAAY,CAAC,KAAa,GAAG,MAAM,MAAM,KAAK,MAClD;AAEK,SAAS,gBACd,YACA,SAG2D;AAC3D,MAAI,QAAQ;AACZ,QAAM,kBAA4B,CAAC;AACnC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,UAAU,GAAG;AACrD,QAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,UAAI,QAAQ,OAAO;AACjB,gBAAQ,UAAU,KAAK,KAAK;AAAA,MAC9B,OAAO;AACL,wBAAgB,KAAK,GAAG;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AAEA,MAAI,gBAAgB,SAAS,KAAK,CAAC,QAAQ,OAAO;AAChD,UAAM;AAAA,MACJ,2CAA2C,gBAAgB;AAAA,QACzD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;;;ACtDO,IAAM,SAAS,CACpB,QAAwB;AAAA,EACtB,OAAO;AACT,MACS;AAdX;AAeE,MAAI,CAAC,UAAU;AAAG;AAElB,UAAQ,MAAM,IAAI;AAElB,YAAU;AAEV,MAAI,MAAM,YAAY;AACpB,iBAAO,OAAP,gCAAY,cAAc,MAAM;AAAA,EAClC;AAEA,QAAM,MAAM,cAAc,IACtB,uDACA;AAEJ,MAAI,SAAS,KAAK,cAAc,gBAAgB,OAAO;AAAG;AAE1D,QAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,SAAO,MAAM;AACb,SAAO,QAAQ;AAEf,MAAI,cAAc,KAAK,MAAM,UAAU,OAAO;AAC5C,WAAO,aAAa,cAAc,OAAO;AAAA,EAC3C;AAEA,WAAS,KAAK,YAAY,MAAM;AAClC;AAEO,IAAM,QAAQ,CACnB,MACA,eACS;AA7CX;AA8CE,MAAI,CAAC,YAAY;AACf,iBAAO,OAAP,gCAAY,SAAS,EAAE,KAAK;AAC5B;AAAA,EACF;AAEA,MAAI;AACF,UAAM,QAAQ,gBAAgB,YAAY;AAAA,MACxC,OAAO,aAAa;AAAA,IACtB,CAAC;AAED,iBAAO,OAAP,gCAAY,SAAS;AAAA,MACnB;AAAA,MACA,MAAM;AAAA,IACR;AAAA,EACF,SAAS,KAAP;AACA,QAAI,eAAe,SAAS,cAAc,GAAG;AAE3C,cAAQ,MAAM,GAAG;AAAA,IACnB;AAAA,EACF;AACF;","names":[]}

package/dist/react/index.cjs

@@ -20,7 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/react.tsx
 var react_exports = {};
 __export(react_exports, {
-  Analytics: () => Analytics
+  Analytics: () => Analytics,
+  track: () => track
 });
 module.exports = __toCommonJS(react_exports);
 var import_react = require("react");
@@ -38,20 +39,62 @@ var initQueue = () => {
 function isBrowser() {
   return typeof window !== "undefined";
 }
-function isDevelopment() {
+function detectEnvironment() {
   if (typeof process === "undefined")
-    return false;
-  return process.env.NODE_ENV === "development" || process.env.NODE_ENV === "test";
+    return "production";
+  if (process.env.NODE_ENV === "development" || process.env.NODE_ENV === "test")
+    return "development";
+  return "production";
+}
+function setMode(mode = "auto") {
+  if (mode === "auto") {
+    window.vam = detectEnvironment();
+  }
+  window.vam = mode;
+}
+function getMode() {
+  return window.vam || "production";
+}
+function isProduction() {
+  return getMode() === "production";
+}
+function isDevelopment() {
+  return getMode() === "development";
+}
+var removeKey = (key, { [key]: _, ...rest }) => rest;
+function parseProperties(properties, options) {
+  let props = properties;
+  const errorProperties = [];
+  for (const [key, value] of Object.entries(properties)) {
+    if (typeof value === "object" && value !== null) {
+      if (options.strip) {
+        props = removeKey(key, props);
+      } else {
+        errorProperties.push(key);
+      }
+    }
+  }
+  if (errorProperties.length > 0 && !options.strip) {
+    throw Error(
+      `The following properties are not valid: ${errorProperties.join(
+        ", "
+      )}. Only strings, numbers, booleans, and null are allowed.`
+    );
+  }
+  return props;
 }
 
 // src/generic.ts
-var inject = ({ beforeSend, debug } = { debug: isDevelopment() }) => {
+var inject = (props = {
+  debug: true
+}) => {
   var _a;
   if (!isBrowser())
     return;
+  setMode(props.mode);
   initQueue();
-  if (beforeSend) {
-    (_a = window.va) == null ? void 0 : _a.call(window, "beforeSend", beforeSend);
+  if (props.beforeSend) {
+    (_a = window.va) == null ? void 0 : _a.call(window, "beforeSend", props.beforeSend);
   }
   const src = isDevelopment() ? "https://cdn.vercel-insights.com/v1/script.debug.js" : "/_vercel/insights/script.js";
   if (document.head.querySelector(`script[src*="${src}"]`))
@@ -59,24 +102,46 @@ var inject = ({ beforeSend, debug } = { debug: isDevelopment() }) => {
   const script = document.createElement("script");
   script.src = src;
   script.defer = true;
-  if (isDevelopment() && debug === false) {
+  if (isDevelopment() && props.debug === false) {
     script.setAttribute("data-debug", "false");
   }
   document.head.appendChild(script);
 };
+var track = (name, properties) => {
+  var _a, _b;
+  if (!properties) {
+    (_a = window.va) == null ? void 0 : _a.call(window, "track", { name });
+    return;
+  }
+  try {
+    const props = parseProperties(properties, {
+      strip: isProduction()
+    });
+    (_b = window.va) == null ? void 0 : _b.call(window, "track", {
+      name,
+      data: props
+    });
+  } catch (err) {
+    if (err instanceof Error && isDevelopment()) {
+      console.error(err);
+    }
+  }
+};
 
 // src/react.tsx
 function Analytics({
   beforeSend,
-  debug = isDevelopment()
+  debug = true,
+  mode = "auto"
 }) {
   (0, import_react.useEffect)(() => {
-    inject({ beforeSend, debug });
-  }, [beforeSend, debug]);
+    inject({ beforeSend, debug, mode });
+  }, [beforeSend, debug, mode]);
   return null;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  Analytics
+  Analytics,
+  track
 });
 //# sourceMappingURL=index.cjs.map

package/dist/react/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/react.tsx","../../src/queue.ts","../../src/utils.ts","../../src/generic.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport { inject } from './generic';\nimport type { AnalyticsProps } from './types';\nimport { isDevelopment } from './utils';\n\nexport function Analytics({\n  beforeSend,\n  debug = isDevelopment(),\n}: AnalyticsProps): null {\n  useEffect(() => {\n    inject({ beforeSend, debug });\n  }, [beforeSend, debug]);\n\n  return null;\n}\n","export const initQueue = (): void => {\n  // initialise va until script is loaded\n  if (window.va) return;\n\n  window.va = function a(...params): void {\n    (window.vaq = window.vaq || []).push(params);\n  };\n};\n","export function isBrowser(): boolean {\n  return typeof window !== 'undefined';\n}\n\nexport function isDevelopment(): boolean {\n  if (typeof process === 'undefined') return false;\n  return (\n    process.env.NODE_ENV === 'development' || process.env.NODE_ENV === 'test'\n  );\n}\n","import { initQueue } from './queue';\nimport type { AnalyticsProps } from './types';\nimport { isBrowser, isDevelopment } from './utils';\n\nexport const inject = (\n  { beforeSend, debug }: AnalyticsProps = { debug: isDevelopment() },\n): void => {\n  if (!isBrowser()) return;\n  initQueue();\n\n  if (beforeSend) {\n    window.va?.('beforeSend', beforeSend);\n  }\n  const src = isDevelopment()\n    ? 'https://cdn.vercel-insights.com/v1/script.debug.js'\n    : '/_vercel/insights/script.js';\n\n  if (document.head.querySelector(`script[src*=\"${src}\"]`)) return;\n\n  const script = document.createElement('script');\n  script.src = src;\n  script.defer = true;\n\n  if (isDevelopment() && debug === false) {\n    script.setAttribute('data-debug', 'false');\n  }\n\n  document.head.appendChild(script);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA0B;;;ACAnB,IAAM,YAAY,MAAY;AAEnC,MAAI,OAAO;AAAI;AAEf,SAAO,KAAK,SAAS,KAAK,QAAc;AACtC,KAAC,OAAO,MAAM,OAAO,OAAO,CAAC,GAAG,KAAK,MAAM;AAAA,EAC7C;AACF;;;ACPO,SAAS,YAAqB;AACnC,SAAO,OAAO,WAAW;AAC3B;AAEO,SAAS,gBAAyB;AACvC,MAAI,OAAO,YAAY;AAAa,WAAO;AAC3C,SACE,QAAQ,IAAI,aAAa,iBAAiB,QAAQ,IAAI,aAAa;AAEvE;;;ACLO,IAAM,SAAS,CACpB,EAAE,YAAY,MAAM,IAAoB,EAAE,OAAO,cAAc,EAAE,MACxD;AANX;AAOE,MAAI,CAAC,UAAU;AAAG;AAClB,YAAU;AAEV,MAAI,YAAY;AACd,iBAAO,OAAP,gCAAY,cAAc;AAAA,EAC5B;AACA,QAAM,MAAM,cAAc,IACtB,uDACA;AAEJ,MAAI,SAAS,KAAK,cAAc,gBAAgB,OAAO;AAAG;AAE1D,QAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,SAAO,MAAM;AACb,SAAO,QAAQ;AAEf,MAAI,cAAc,KAAK,UAAU,OAAO;AACtC,WAAO,aAAa,cAAc,OAAO;AAAA,EAC3C;AAEA,WAAS,KAAK,YAAY,MAAM;AAClC;;;AHvBO,SAAS,UAAU;AAAA,EACxB;AAAA,EACA,QAAQ,cAAc;AACxB,GAAyB;AACvB,8BAAU,MAAM;AACd,WAAO,EAAE,YAAY,MAAM,CAAC;AAAA,EAC9B,GAAG,CAAC,YAAY,KAAK,CAAC;AAEtB,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/react.tsx","../../src/queue.ts","../../src/utils.ts","../../src/generic.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport { inject } from './generic';\nimport type { AnalyticsProps } from './types';\n\nexport type { AnalyticsProps } from './types';\n\nexport function Analytics({\n  beforeSend,\n  debug = true,\n  mode = 'auto',\n}: AnalyticsProps): null {\n  useEffect(() => {\n    inject({ beforeSend, debug, mode });\n  }, [beforeSend, debug, mode]);\n\n  return null;\n}\n\nexport { track } from './generic';\n","export const initQueue = (): void => {\n  // initialize va until script is loaded\n  if (window.va) return;\n\n  window.va = function a(...params): void {\n    (window.vaq = window.vaq || []).push(params);\n  };\n};\n","import type { AllowedPropertyValues, Mode } from './types';\n\nexport function isBrowser(): boolean {\n  return typeof window !== 'undefined';\n}\n\nfunction detectEnvironment(): 'development' | 'production' {\n  if (typeof process === 'undefined') return 'production';\n\n  if (process.env.NODE_ENV === 'development' || process.env.NODE_ENV === 'test')\n    return 'development';\n\n  return 'production';\n}\n\nexport function setMode(mode: Mode = 'auto'): void {\n  if (mode === 'auto') {\n    window.vam = detectEnvironment();\n  }\n\n  window.vam = mode;\n}\n\nexport function getMode(): Mode {\n  return window.vam || 'production';\n}\n\nexport function isProduction(): boolean {\n  return getMode() === 'production';\n}\n\nexport function isDevelopment(): boolean {\n  return getMode() === 'development';\n}\n\nconst removeKey = (key: string, { [key]: _, ...rest }): Record<string, any> =>\n  rest;\n\nexport function parseProperties(\n  properties: Record<string, unknown>,\n  options: {\n    strip?: boolean;\n  },\n): Error | Record<string, AllowedPropertyValues> | undefined {\n  let props = properties;\n  const errorProperties: string[] = [];\n  for (const [key, value] of Object.entries(properties)) {\n    if (typeof value === 'object' && value !== null) {\n      if (options.strip) {\n        props = removeKey(key, props);\n      } else {\n        errorProperties.push(key);\n      }\n    }\n  }\n\n  if (errorProperties.length > 0 && !options.strip) {\n    throw Error(\n      `The following properties are not valid: ${errorProperties.join(\n        ', ',\n      )}. Only strings, numbers, booleans, and null are allowed.`,\n    );\n  }\n  return props as Record<string, AllowedPropertyValues>;\n}\n","import { initQueue } from './queue';\nimport type { AllowedPropertyValues, AnalyticsProps } from './types';\nimport {\n  isBrowser,\n  parseProperties,\n  setMode,\n  isDevelopment,\n  isProduction,\n} from './utils';\n\nexport const inject = (\n  props: AnalyticsProps = {\n    debug: true,\n  },\n): void => {\n  if (!isBrowser()) return;\n\n  setMode(props.mode);\n\n  initQueue();\n\n  if (props.beforeSend) {\n    window.va?.('beforeSend', props.beforeSend);\n  }\n\n  const src = isDevelopment()\n    ? 'https://cdn.vercel-insights.com/v1/script.debug.js'\n    : '/_vercel/insights/script.js';\n\n  if (document.head.querySelector(`script[src*=\"${src}\"]`)) return;\n\n  const script = document.createElement('script');\n  script.src = src;\n  script.defer = true;\n\n  if (isDevelopment() && props.debug === false) {\n    script.setAttribute('data-debug', 'false');\n  }\n\n  document.head.appendChild(script);\n};\n\nexport const track = (\n  name: string,\n  properties?: Record<string, AllowedPropertyValues>,\n): void => {\n  if (!properties) {\n    window.va?.('track', { name });\n    return;\n  }\n\n  try {\n    const props = parseProperties(properties, {\n      strip: isProduction(),\n    });\n\n    window.va?.('track', {\n      name,\n      data: props,\n    });\n  } catch (err) {\n    if (err instanceof Error && isDevelopment()) {\n      // eslint-disable-next-line no-console\n      console.error(err);\n    }\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA0B;;;ACAnB,IAAM,YAAY,MAAY;AAEnC,MAAI,OAAO;AAAI;AAEf,SAAO,KAAK,SAAS,KAAK,QAAc;AACtC,KAAC,OAAO,MAAM,OAAO,OAAO,CAAC,GAAG,KAAK,MAAM;AAAA,EAC7C;AACF;;;ACLO,SAAS,YAAqB;AACnC,SAAO,OAAO,WAAW;AAC3B;AAEA,SAAS,oBAAkD;AACzD,MAAI,OAAO,YAAY;AAAa,WAAO;AAE3C,MAAI,QAAQ,IAAI,aAAa,iBAAiB,QAAQ,IAAI,aAAa;AACrE,WAAO;AAET,SAAO;AACT;AAEO,SAAS,QAAQ,OAAa,QAAc;AACjD,MAAI,SAAS,QAAQ;AACnB,WAAO,MAAM,kBAAkB;AAAA,EACjC;AAEA,SAAO,MAAM;AACf;AAEO,SAAS,UAAgB;AAC9B,SAAO,OAAO,OAAO;AACvB;AAEO,SAAS,eAAwB;AACtC,SAAO,QAAQ,MAAM;AACvB;AAEO,SAAS,gBAAyB;AACvC,SAAO,QAAQ,MAAM;AACvB;AAEA,IAAM,YAAY,CAAC,KAAa,GAAG,MAAM,MAAM,KAAK,MAClD;AAEK,SAAS,gBACd,YACA,SAG2D;AAC3D,MAAI,QAAQ;AACZ,QAAM,kBAA4B,CAAC;AACnC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,UAAU,GAAG;AACrD,QAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,UAAI,QAAQ,OAAO;AACjB,gBAAQ,UAAU,KAAK,KAAK;AAAA,MAC9B,OAAO;AACL,wBAAgB,KAAK,GAAG;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AAEA,MAAI,gBAAgB,SAAS,KAAK,CAAC,QAAQ,OAAO;AAChD,UAAM;AAAA,MACJ,2CAA2C,gBAAgB;AAAA,QACzD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;;;ACtDO,IAAM,SAAS,CACpB,QAAwB;AAAA,EACtB,OAAO;AACT,MACS;AAdX;AAeE,MAAI,CAAC,UAAU;AAAG;AAElB,UAAQ,MAAM,IAAI;AAElB,YAAU;AAEV,MAAI,MAAM,YAAY;AACpB,iBAAO,OAAP,gCAAY,cAAc,MAAM;AAAA,EAClC;AAEA,QAAM,MAAM,cAAc,IACtB,uDACA;AAEJ,MAAI,SAAS,KAAK,cAAc,gBAAgB,OAAO;AAAG;AAE1D,QAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,SAAO,MAAM;AACb,SAAO,QAAQ;AAEf,MAAI,cAAc,KAAK,MAAM,UAAU,OAAO;AAC5C,WAAO,aAAa,cAAc,OAAO;AAAA,EAC3C;AAEA,WAAS,KAAK,YAAY,MAAM;AAClC;AAEO,IAAM,QAAQ,CACnB,MACA,eACS;AA7CX;AA8CE,MAAI,CAAC,YAAY;AACf,iBAAO,OAAP,gCAAY,SAAS,EAAE,KAAK;AAC5B;AAAA,EACF;AAEA,MAAI;AACF,UAAM,QAAQ,gBAAgB,YAAY;AAAA,MACxC,OAAO,aAAa;AAAA,IACtB,CAAC;AAED,iBAAO,OAAP,gCAAY,SAAS;AAAA,MACnB;AAAA,MACA,MAAM;AAAA,IACR;AAAA,EACF,SAAS,KAAP;AACA,QAAI,eAAe,SAAS,cAAc,GAAG;AAE3C,cAAQ,MAAM,GAAG;AAAA,IACnB;AAAA,EACF;AACF;;;AH5DO,SAAS,UAAU;AAAA,EACxB;AAAA,EACA,QAAQ;AAAA,EACR,OAAO;AACT,GAAyB;AACvB,8BAAU,MAAM;AACd,WAAO,EAAE,YAAY,OAAO,KAAK,CAAC;AAAA,EACpC,GAAG,CAAC,YAAY,OAAO,IAAI,CAAC;AAE5B,SAAO;AACT;","names":[]}

package/dist/react/index.d.ts

@@ -2,20 +2,26 @@ interface PageViewEvent {
     type: 'pageview';
     url: string;
 }
-declare type IEvent = PageViewEvent;
-declare type BeforeSend = (event: IEvent) => IEvent | null;
+declare type Event = PageViewEvent;
+declare type Mode = 'auto' | 'development' | 'production';
+declare type AllowedPropertyValues = string | number | boolean | null;
+declare type BeforeSend = (event: Event) => Event | null;
 interface AnalyticsProps {
     beforeSend?: BeforeSend;
     debug?: boolean;
+    mode?: Mode;
 }
 declare global {
     interface Window {
         va?: (event: string, properties?: unknown) => void;
         vaq?: [string, unknown?][];
         vai?: boolean;
+        vam?: Mode;
     }
 }
 
-declare function Analytics({ beforeSend, debug, }: AnalyticsProps): null;
+declare const track: (name: string, properties?: Record<string, AllowedPropertyValues>) => void;
 
-export { Analytics };
+declare function Analytics({ beforeSend, debug, mode, }: AnalyticsProps): null;
+
+export { Analytics, AnalyticsProps, track };

package/dist/react/index.js

@@ -14,20 +14,62 @@ var initQueue = () => {
 function isBrowser() {
   return typeof window !== "undefined";
 }
-function isDevelopment() {
+function detectEnvironment() {
   if (typeof process === "undefined")
-    return false;
-  return process.env.NODE_ENV === "development" || process.env.NODE_ENV === "test";
+    return "production";
+  if (process.env.NODE_ENV === "development" || process.env.NODE_ENV === "test")
+    return "development";
+  return "production";
+}
+function setMode(mode = "auto") {
+  if (mode === "auto") {
+    window.vam = detectEnvironment();
+  }
+  window.vam = mode;
+}
+function getMode() {
+  return window.vam || "production";
+}
+function isProduction() {
+  return getMode() === "production";
+}
+function isDevelopment() {
+  return getMode() === "development";
+}
+var removeKey = (key, { [key]: _, ...rest }) => rest;
+function parseProperties(properties, options) {
+  let props = properties;
+  const errorProperties = [];
+  for (const [key, value] of Object.entries(properties)) {
+    if (typeof value === "object" && value !== null) {
+      if (options.strip) {
+        props = removeKey(key, props);
+      } else {
+        errorProperties.push(key);
+      }
+    }
+  }
+  if (errorProperties.length > 0 && !options.strip) {
+    throw Error(
+      `The following properties are not valid: ${errorProperties.join(
+        ", "
+      )}. Only strings, numbers, booleans, and null are allowed.`
+    );
+  }
+  return props;
 }
 
 // src/generic.ts
-var inject = ({ beforeSend, debug } = { debug: isDevelopment() }) => {
+var inject = (props = {
+  debug: true
+}) => {
   var _a;
   if (!isBrowser())
     return;
+  setMode(props.mode);
   initQueue();
-  if (beforeSend) {
-    (_a = window.va) == null ? void 0 : _a.call(window, "beforeSend", beforeSend);
+  if (props.beforeSend) {
+    (_a = window.va) == null ? void 0 : _a.call(window, "beforeSend", props.beforeSend);
   }
   const src = isDevelopment() ? "https://cdn.vercel-insights.com/v1/script.debug.js" : "/_vercel/insights/script.js";
   if (document.head.querySelector(`script[src*="${src}"]`))
@@ -35,23 +77,45 @@ var inject = ({ beforeSend, debug } = { debug: isDevelopment() }) => {
   const script = document.createElement("script");
   script.src = src;
   script.defer = true;
-  if (isDevelopment() && debug === false) {
+  if (isDevelopment() && props.debug === false) {
     script.setAttribute("data-debug", "false");
   }
   document.head.appendChild(script);
 };
+var track = (name, properties) => {
+  var _a, _b;
+  if (!properties) {
+    (_a = window.va) == null ? void 0 : _a.call(window, "track", { name });
+    return;
+  }
+  try {
+    const props = parseProperties(properties, {
+      strip: isProduction()
+    });
+    (_b = window.va) == null ? void 0 : _b.call(window, "track", {
+      name,
+      data: props
+    });
+  } catch (err) {
+    if (err instanceof Error && isDevelopment()) {
+      console.error(err);
+    }
+  }
+};
 
 // src/react.tsx
 function Analytics({
   beforeSend,
-  debug = isDevelopment()
+  debug = true,
+  mode = "auto"
 }) {
   useEffect(() => {
-    inject({ beforeSend, debug });
-  }, [beforeSend, debug]);
+    inject({ beforeSend, debug, mode });
+  }, [beforeSend, debug, mode]);
   return null;
 }
 export {
-  Analytics
+  Analytics,
+  track
 };
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/react.tsx","../../src/queue.ts","../../src/utils.ts","../../src/generic.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport { inject } from './generic';\nimport type { AnalyticsProps } from './types';\nimport { isDevelopment } from './utils';\n\nexport function Analytics({\n  beforeSend,\n  debug = isDevelopment(),\n}: AnalyticsProps): null {\n  useEffect(() => {\n    inject({ beforeSend, debug });\n  }, [beforeSend, debug]);\n\n  return null;\n}\n","export const initQueue = (): void => {\n  // initialise va until script is loaded\n  if (window.va) return;\n\n  window.va = function a(...params): void {\n    (window.vaq = window.vaq || []).push(params);\n  };\n};\n","export function isBrowser(): boolean {\n  return typeof window !== 'undefined';\n}\n\nexport function isDevelopment(): boolean {\n  if (typeof process === 'undefined') return false;\n  return (\n    process.env.NODE_ENV === 'development' || process.env.NODE_ENV === 'test'\n  );\n}\n","import { initQueue } from './queue';\nimport type { AnalyticsProps } from './types';\nimport { isBrowser, isDevelopment } from './utils';\n\nexport const inject = (\n  { beforeSend, debug }: AnalyticsProps = { debug: isDevelopment() },\n): void => {\n  if (!isBrowser()) return;\n  initQueue();\n\n  if (beforeSend) {\n    window.va?.('beforeSend', beforeSend);\n  }\n  const src = isDevelopment()\n    ? 'https://cdn.vercel-insights.com/v1/script.debug.js'\n    : '/_vercel/insights/script.js';\n\n  if (document.head.querySelector(`script[src*=\"${src}\"]`)) return;\n\n  const script = document.createElement('script');\n  script.src = src;\n  script.defer = true;\n\n  if (isDevelopment() && debug === false) {\n    script.setAttribute('data-debug', 'false');\n  }\n\n  document.head.appendChild(script);\n};\n"],"mappings":";AAAA,SAAS,iBAAiB;;;ACAnB,IAAM,YAAY,MAAY;AAEnC,MAAI,OAAO;AAAI;AAEf,SAAO,KAAK,SAAS,KAAK,QAAc;AACtC,KAAC,OAAO,MAAM,OAAO,OAAO,CAAC,GAAG,KAAK,MAAM;AAAA,EAC7C;AACF;;;ACPO,SAAS,YAAqB;AACnC,SAAO,OAAO,WAAW;AAC3B;AAEO,SAAS,gBAAyB;AACvC,MAAI,OAAO,YAAY;AAAa,WAAO;AAC3C,SACE,QAAQ,IAAI,aAAa,iBAAiB,QAAQ,IAAI,aAAa;AAEvE;;;ACLO,IAAM,SAAS,CACpB,EAAE,YAAY,MAAM,IAAoB,EAAE,OAAO,cAAc,EAAE,MACxD;AANX;AAOE,MAAI,CAAC,UAAU;AAAG;AAClB,YAAU;AAEV,MAAI,YAAY;AACd,iBAAO,OAAP,gCAAY,cAAc;AAAA,EAC5B;AACA,QAAM,MAAM,cAAc,IACtB,uDACA;AAEJ,MAAI,SAAS,KAAK,cAAc,gBAAgB,OAAO;AAAG;AAE1D,QAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,SAAO,MAAM;AACb,SAAO,QAAQ;AAEf,MAAI,cAAc,KAAK,UAAU,OAAO;AACtC,WAAO,aAAa,cAAc,OAAO;AAAA,EAC3C;AAEA,WAAS,KAAK,YAAY,MAAM;AAClC;;;AHvBO,SAAS,UAAU;AAAA,EACxB;AAAA,EACA,QAAQ,cAAc;AACxB,GAAyB;AACvB,YAAU,MAAM;AACd,WAAO,EAAE,YAAY,MAAM,CAAC;AAAA,EAC9B,GAAG,CAAC,YAAY,KAAK,CAAC;AAEtB,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/react.tsx","../../src/queue.ts","../../src/utils.ts","../../src/generic.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport { inject } from './generic';\nimport type { AnalyticsProps } from './types';\n\nexport type { AnalyticsProps } from './types';\n\nexport function Analytics({\n  beforeSend,\n  debug = true,\n  mode = 'auto',\n}: AnalyticsProps): null {\n  useEffect(() => {\n    inject({ beforeSend, debug, mode });\n  }, [beforeSend, debug, mode]);\n\n  return null;\n}\n\nexport { track } from './generic';\n","export const initQueue = (): void => {\n  // initialize va until script is loaded\n  if (window.va) return;\n\n  window.va = function a(...params): void {\n    (window.vaq = window.vaq || []).push(params);\n  };\n};\n","import type { AllowedPropertyValues, Mode } from './types';\n\nexport function isBrowser(): boolean {\n  return typeof window !== 'undefined';\n}\n\nfunction detectEnvironment(): 'development' | 'production' {\n  if (typeof process === 'undefined') return 'production';\n\n  if (process.env.NODE_ENV === 'development' || process.env.NODE_ENV === 'test')\n    return 'development';\n\n  return 'production';\n}\n\nexport function setMode(mode: Mode = 'auto'): void {\n  if (mode === 'auto') {\n    window.vam = detectEnvironment();\n  }\n\n  window.vam = mode;\n}\n\nexport function getMode(): Mode {\n  return window.vam || 'production';\n}\n\nexport function isProduction(): boolean {\n  return getMode() === 'production';\n}\n\nexport function isDevelopment(): boolean {\n  return getMode() === 'development';\n}\n\nconst removeKey = (key: string, { [key]: _, ...rest }): Record<string, any> =>\n  rest;\n\nexport function parseProperties(\n  properties: Record<string, unknown>,\n  options: {\n    strip?: boolean;\n  },\n): Error | Record<string, AllowedPropertyValues> | undefined {\n  let props = properties;\n  const errorProperties: string[] = [];\n  for (const [key, value] of Object.entries(properties)) {\n    if (typeof value === 'object' && value !== null) {\n      if (options.strip) {\n        props = removeKey(key, props);\n      } else {\n        errorProperties.push(key);\n      }\n    }\n  }\n\n  if (errorProperties.length > 0 && !options.strip) {\n    throw Error(\n      `The following properties are not valid: ${errorProperties.join(\n        ', ',\n      )}. Only strings, numbers, booleans, and null are allowed.`,\n    );\n  }\n  return props as Record<string, AllowedPropertyValues>;\n}\n","import { initQueue } from './queue';\nimport type { AllowedPropertyValues, AnalyticsProps } from './types';\nimport {\n  isBrowser,\n  parseProperties,\n  setMode,\n  isDevelopment,\n  isProduction,\n} from './utils';\n\nexport const inject = (\n  props: AnalyticsProps = {\n    debug: true,\n  },\n): void => {\n  if (!isBrowser()) return;\n\n  setMode(props.mode);\n\n  initQueue();\n\n  if (props.beforeSend) {\n    window.va?.('beforeSend', props.beforeSend);\n  }\n\n  const src = isDevelopment()\n    ? 'https://cdn.vercel-insights.com/v1/script.debug.js'\n    : '/_vercel/insights/script.js';\n\n  if (document.head.querySelector(`script[src*=\"${src}\"]`)) return;\n\n  const script = document.createElement('script');\n  script.src = src;\n  script.defer = true;\n\n  if (isDevelopment() && props.debug === false) {\n    script.setAttribute('data-debug', 'false');\n  }\n\n  document.head.appendChild(script);\n};\n\nexport const track = (\n  name: string,\n  properties?: Record<string, AllowedPropertyValues>,\n): void => {\n  if (!properties) {\n    window.va?.('track', { name });\n    return;\n  }\n\n  try {\n    const props = parseProperties(properties, {\n      strip: isProduction(),\n    });\n\n    window.va?.('track', {\n      name,\n      data: props,\n    });\n  } catch (err) {\n    if (err instanceof Error && isDevelopment()) {\n      // eslint-disable-next-line no-console\n      console.error(err);\n    }\n  }\n};\n"],"mappings":";AAAA,SAAS,iBAAiB;;;ACAnB,IAAM,YAAY,MAAY;AAEnC,MAAI,OAAO;AAAI;AAEf,SAAO,KAAK,SAAS,KAAK,QAAc;AACtC,KAAC,OAAO,MAAM,OAAO,OAAO,CAAC,GAAG,KAAK,MAAM;AAAA,EAC7C;AACF;;;ACLO,SAAS,YAAqB;AACnC,SAAO,OAAO,WAAW;AAC3B;AAEA,SAAS,oBAAkD;AACzD,MAAI,OAAO,YAAY;AAAa,WAAO;AAE3C,MAAI,QAAQ,IAAI,aAAa,iBAAiB,QAAQ,IAAI,aAAa;AACrE,WAAO;AAET,SAAO;AACT;AAEO,SAAS,QAAQ,OAAa,QAAc;AACjD,MAAI,SAAS,QAAQ;AACnB,WAAO,MAAM,kBAAkB;AAAA,EACjC;AAEA,SAAO,MAAM;AACf;AAEO,SAAS,UAAgB;AAC9B,SAAO,OAAO,OAAO;AACvB;AAEO,SAAS,eAAwB;AACtC,SAAO,QAAQ,MAAM;AACvB;AAEO,SAAS,gBAAyB;AACvC,SAAO,QAAQ,MAAM;AACvB;AAEA,IAAM,YAAY,CAAC,KAAa,GAAG,MAAM,MAAM,KAAK,MAClD;AAEK,SAAS,gBACd,YACA,SAG2D;AAC3D,MAAI,QAAQ;AACZ,QAAM,kBAA4B,CAAC;AACnC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,UAAU,GAAG;AACrD,QAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,UAAI,QAAQ,OAAO;AACjB,gBAAQ,UAAU,KAAK,KAAK;AAAA,MAC9B,OAAO;AACL,wBAAgB,KAAK,GAAG;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AAEA,MAAI,gBAAgB,SAAS,KAAK,CAAC,QAAQ,OAAO;AAChD,UAAM;AAAA,MACJ,2CAA2C,gBAAgB;AAAA,QACzD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;;;ACtDO,IAAM,SAAS,CACpB,QAAwB;AAAA,EACtB,OAAO;AACT,MACS;AAdX;AAeE,MAAI,CAAC,UAAU;AAAG;AAElB,UAAQ,MAAM,IAAI;AAElB,YAAU;AAEV,MAAI,MAAM,YAAY;AACpB,iBAAO,OAAP,gCAAY,cAAc,MAAM;AAAA,EAClC;AAEA,QAAM,MAAM,cAAc,IACtB,uDACA;AAEJ,MAAI,SAAS,KAAK,cAAc,gBAAgB,OAAO;AAAG;AAE1D,QAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,SAAO,MAAM;AACb,SAAO,QAAQ;AAEf,MAAI,cAAc,KAAK,MAAM,UAAU,OAAO;AAC5C,WAAO,aAAa,cAAc,OAAO;AAAA,EAC3C;AAEA,WAAS,KAAK,YAAY,MAAM;AAClC;AAEO,IAAM,QAAQ,CACnB,MACA,eACS;AA7CX;AA8CE,MAAI,CAAC,YAAY;AACf,iBAAO,OAAP,gCAAY,SAAS,EAAE,KAAK;AAC5B;AAAA,EACF;AAEA,MAAI;AACF,UAAM,QAAQ,gBAAgB,YAAY;AAAA,MACxC,OAAO,aAAa;AAAA,IACtB,CAAC;AAED,iBAAO,OAAP,gCAAY,SAAS;AAAA,MACnB;AAAA,MACA,MAAM;AAAA,IACR;AAAA,EACF,SAAS,KAAP;AACA,QAAI,eAAe,SAAS,cAAc,GAAG;AAE3C,cAAQ,MAAM,GAAG;AAAA,IACnB;AAAA,EACF;AACF;;;AH5DO,SAAS,UAAU;AAAA,EACxB;AAAA,EACA,QAAQ;AAAA,EACR,OAAO;AACT,GAAyB;AACvB,YAAU,MAAM;AACd,WAAO,EAAE,YAAY,OAAO,KAAK,CAAC;AAAA,EACpC,GAAG,CAAC,YAAY,OAAO,IAAI,CAAC;AAE5B,SAAO;AACT;","names":[]}

package/jest.config.js

@@ -0,0 +1,9 @@
+export default {
+  testEnvironment: 'jsdom',
+  transform: {
+    '^.+\\.(t|j)sx?$': '@swc/jest',
+  },
+  coverageReporters: ['text', 'html'],
+  setupFilesAfterEnv: ['<rootDir>/jest.setup.ts'],
+  reporters: ['default', 'github-actions'],
+};

package/jest.setup.ts

@@ -0,0 +1,9 @@
+import '@testing-library/jest-dom';
+
+// Adds helpers like `.toHaveAttribute`
+import '@testing-library/jest-dom/extend-expect';
+
+beforeEach(() => {
+  // reset dom before each test
+  document.getElementsByTagName('html')[0].innerHTML = '';
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/analytics",
-  "version": "0.1.6-beta.1",
+  "version": "0.1.7-beta.1",
   "keywords": [
     "analytics",
     "vercel"
@@ -33,12 +33,25 @@
   "eslintConfig": {
     "extends": [
       "@vercel/eslint-config"
+    ],
+    "ignorePatterns": [
+      "jest.setup.ts"
     ]
   },
   "devDependencies": {
+    "@swc/core": "^1.3.20",
+    "@swc/jest": "^0.2.23",
+    "@testing-library/jest-dom": "^5.16.5",
+    "@testing-library/react": "^13.4.0",
+    "@types/jest": "^29.2.3",
     "@types/node": "^18.11.2",
     "@types/react": "^16.8||^17||^18",
+    "@types/testing-library__jest-dom": "^5.14.5",
     "@vercel/eslint-config": "0.0.0",
+    "jest": "^29.3.1",
+    "jest-environment-jsdom": "^29.3.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
     "tsup": "^6.3.0"
   },
   "peerDependencies": {
@@ -49,6 +62,7 @@
     "dev": "tsup --watch",
     "lint": "eslint .",
     "lint-fix": "eslint . --fix",
+    "test": "jest",
     "type-check": "tsc --noEmit"
   }
 }