@01.software/sdk 0.51.0 → 0.65.0

package/dist/analytics.d.cts

@@ -1,39 +0,0 @@
-/**
- * @01.software/sdk — Analytics Helper
- */
-interface AnalyticsConfig {
-    publishableKey: string;
-    /** Override the collect endpoint URL. Defaults to {SDK_BASE_URL}/api/analytics/collect */
-    endpoint?: string;
-    /** Auto-patch history.pushState/replaceState and listen to popstate. Default: true */
-    autoTrack?: boolean;
-    /** Respect navigator.doNotTrack and navigator.globalPrivacyControl. Default: true */
-    respectDnt?: boolean;
-    /**
-     * Send mode. 'auto' (default) skips all sends on local hosts
-     * (localhost / 127.0.0.1 / *.local). 'production' always sends, even
-     * locally. 'development' never sends, on any host. See INVARIANT 9.
-     */
-    mode?: 'auto' | 'production' | 'development';
-}
-type AnalyticsEventProps = Record<string, string | number | boolean>;
-type AnalyticsEventMap = Record<string, AnalyticsEventProps | undefined>;
-/**
- * Argument tuple for `track`. The default open map keeps `props` optional
- * (back-compat). A developer-declared closed map makes `props` required when
- * the event declares props, and omittable when the event value is `undefined`.
- */
-type TrackArgs<TEvents extends AnalyticsEventMap, K extends keyof TEvents & string> = string extends keyof TEvents ? [props?: AnalyticsEventProps] : undefined extends TEvents[K] ? [props?: Exclude<TEvents[K], undefined>] : [props: TEvents[K]];
-interface Analytics<TEvents extends AnalyticsEventMap = AnalyticsEventMap> {
-    pageview(path?: string): void;
-    track<K extends keyof TEvents & string>(name: K, ...args: TrackArgs<TEvents, K>): void;
-    destroy(): void;
-}
-declare function createAnalytics<TEvents extends AnalyticsEventMap = AnalyticsEventMap>(config: AnalyticsConfig): Analytics<TEvents>;
-/**
- * Bind a typed event map once, then create instances without repeating the
- * generic. Equivalent to `createAnalytics<TEvents>(config)`.
- */
-declare function defineAnalyticsEvents<TEvents extends AnalyticsEventMap>(): (config: AnalyticsConfig) => Analytics<TEvents>;
-
-export { type Analytics, type AnalyticsConfig, type AnalyticsEventMap, type AnalyticsEventProps, type TrackArgs, createAnalytics, defineAnalyticsEvents };

package/dist/analytics.d.ts

@@ -1,39 +0,0 @@
-/**
- * @01.software/sdk — Analytics Helper
- */
-interface AnalyticsConfig {
-    publishableKey: string;
-    /** Override the collect endpoint URL. Defaults to {SDK_BASE_URL}/api/analytics/collect */
-    endpoint?: string;
-    /** Auto-patch history.pushState/replaceState and listen to popstate. Default: true */
-    autoTrack?: boolean;
-    /** Respect navigator.doNotTrack and navigator.globalPrivacyControl. Default: true */
-    respectDnt?: boolean;
-    /**
-     * Send mode. 'auto' (default) skips all sends on local hosts
-     * (localhost / 127.0.0.1 / *.local). 'production' always sends, even
-     * locally. 'development' never sends, on any host. See INVARIANT 9.
-     */
-    mode?: 'auto' | 'production' | 'development';
-}
-type AnalyticsEventProps = Record<string, string | number | boolean>;
-type AnalyticsEventMap = Record<string, AnalyticsEventProps | undefined>;
-/**
- * Argument tuple for `track`. The default open map keeps `props` optional
- * (back-compat). A developer-declared closed map makes `props` required when
- * the event declares props, and omittable when the event value is `undefined`.
- */
-type TrackArgs<TEvents extends AnalyticsEventMap, K extends keyof TEvents & string> = string extends keyof TEvents ? [props?: AnalyticsEventProps] : undefined extends TEvents[K] ? [props?: Exclude<TEvents[K], undefined>] : [props: TEvents[K]];
-interface Analytics<TEvents extends AnalyticsEventMap = AnalyticsEventMap> {
-    pageview(path?: string): void;
-    track<K extends keyof TEvents & string>(name: K, ...args: TrackArgs<TEvents, K>): void;
-    destroy(): void;
-}
-declare function createAnalytics<TEvents extends AnalyticsEventMap = AnalyticsEventMap>(config: AnalyticsConfig): Analytics<TEvents>;
-/**
- * Bind a typed event map once, then create instances without repeating the
- * generic. Equivalent to `createAnalytics<TEvents>(config)`.
- */
-declare function defineAnalyticsEvents<TEvents extends AnalyticsEventMap>(): (config: AnalyticsConfig) => Analytics<TEvents>;
-
-export { type Analytics, type AnalyticsConfig, type AnalyticsEventMap, type AnalyticsEventProps, type TrackArgs, createAnalytics, defineAnalyticsEvents };

package/dist/analytics.js

@@ -1,215 +0,0 @@
-// src/core/internal/utils/api-url.ts
-function resolveApiUrl(apiUrl) {
-  if (apiUrl) {
-    return apiUrl.replace(/\/$/, "");
-  }
-  if (typeof process !== "undefined" && process.env) {
-    const envUrl = process.env.SOFTWARE_API_URL || process.env.NEXT_PUBLIC_SOFTWARE_API_URL;
-    if (envUrl) {
-      return envUrl.replace(/\/$/, "");
-    }
-  }
-  return "https://api.01.software";
-}
-
-// src/analytics.ts
-function createAnalytics(config) {
-  if (typeof window === "undefined") {
-    return { pageview() {
-    }, track() {
-    }, destroy() {
-    } };
-  }
-  const endpoint = config.endpoint ?? `${resolveApiUrl()}/api/analytics/collect`;
-  const respectDnt = config.respectDnt !== false;
-  function isDntActive() {
-    if (!respectDnt) return false;
-    const nav = navigator;
-    return nav.doNotTrack === "1" || nav.globalPrivacyControl === true;
-  }
-  const isLocalHost = (() => {
-    try {
-      const h = location.hostname;
-      return h === "localhost" || h === "127.0.0.1" || h.endsWith(".local");
-    } catch {
-      return false;
-    }
-  })();
-  const mode = config.mode ?? "auto";
-  const sendSuppressed = mode === "development" || mode === "auto" && isLocalHost;
-  let suppressNoticeShown = false;
-  function devSuppressNotice() {
-    if (suppressNoticeShown) return;
-    suppressNoticeShown = true;
-    try {
-      console.info(
-        `[01 analytics] events disabled on local host (mode: '${mode}'). Pass mode: 'production' to send while developing.`
-      );
-    } catch {
-    }
-  }
-  let lastPath = null;
-  let lastAt = 0;
-  const autoTrack = config.autoTrack !== false;
-  const originalPushState = history.pushState;
-  const originalReplaceState = history.replaceState;
-  let destroyed = false;
-  function newEventId() {
-    return typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : String(Date.now()) + String(Math.random());
-  }
-  function sendBeaconOrFetch(body) {
-    try {
-      if (typeof navigator.sendBeacon === "function") {
-        const blob = new Blob([body], { type: "text/plain" });
-        const sent = navigator.sendBeacon(endpoint, blob);
-        if (sent) return;
-      }
-      fetch(endpoint, {
-        method: "POST",
-        keepalive: true,
-        headers: { "Content-Type": "application/json" },
-        body
-      }).catch(() => {
-      });
-    } catch {
-    }
-  }
-  function sendPageview(pathname) {
-    if (isDntActive()) return;
-    const doc = document;
-    if (doc.prerendering === true || document.visibilityState === "prerender") return;
-    if (sendSuppressed) {
-      devSuppressNotice();
-      return;
-    }
-    const now = Date.now();
-    if (pathname === lastPath && now - lastAt < 500) return;
-    lastPath = pathname;
-    lastAt = now;
-    const body = JSON.stringify({
-      publishableKey: config.publishableKey,
-      pathname,
-      referrer: document.referrer || "",
-      eventId: newEventId(),
-      eventTs: Date.now()
-    });
-    sendBeaconOrFetch(body);
-  }
-  function trackCurrentPath() {
-    if (destroyed) return;
-    sendPageview(location.pathname);
-  }
-  function patchedPushState(data, unused, url) {
-    originalPushState.apply(this, [data, unused, url]);
-    if (!destroyed) setTimeout(trackCurrentPath, 0);
-  }
-  function patchedReplaceState(data, unused, url) {
-    originalReplaceState.apply(this, [data, unused, url]);
-    if (!destroyed) setTimeout(trackCurrentPath, 0);
-  }
-  if (autoTrack) {
-    history.pushState = patchedPushState;
-    history.replaceState = patchedReplaceState;
-    window.addEventListener("popstate", trackCurrentPath);
-    if (document.readyState === "complete") {
-      trackCurrentPath();
-    } else {
-      window.addEventListener("load", trackCurrentPath, { once: true });
-    }
-  }
-  const isProduction = !isLocalHost;
-  const warnedReasons = /* @__PURE__ */ new Set();
-  function devWarn(name, reason) {
-    if (isProduction) return;
-    if (warnedReasons.has(reason)) return;
-    warnedReasons.add(reason);
-    console.warn(`[01 analytics] dropped event ${name}: ${reason}`);
-  }
-  const EVENT_NAME_RE = /^[a-zA-Z][a-zA-Z0-9_:-]{0,49}$/;
-  const RESERVED_PREFIXES = ["__", "_pv_"];
-  function validateEventName(name) {
-    if (!name || typeof name !== "string") return "name-empty";
-    for (const prefix of RESERVED_PREFIXES) {
-      if (name.startsWith(prefix)) return "name-reserved";
-    }
-    if (!EVENT_NAME_RE.test(name)) return "name-regex";
-    return null;
-  }
-  const PROP_KEY_RE = /^[a-zA-Z_][a-zA-Z0-9_]{0,31}$/;
-  function validateEventProps(props) {
-    if (props === void 0 || props === null) return null;
-    if (typeof props !== "object" || Array.isArray(props)) return "props-value-type";
-    const keys = Object.keys(props);
-    if (keys.length > 10) return "props-too-many-keys";
-    for (const k of keys) {
-      const v = props[k];
-      if (!PROP_KEY_RE.test(k)) return "props-key-regex";
-      if (typeof v === "string") {
-        if (v.length > 80) return "props-value-too-long";
-      } else if (typeof v === "number") {
-        if (!isFinite(v)) return "props-value-not-finite";
-      } else if (typeof v === "boolean") {
-      } else {
-        return "props-value-type";
-      }
-    }
-    return null;
-  }
-  return {
-    pageview(path) {
-      if (destroyed) return;
-      sendPageview(path ?? location.pathname);
-    },
-    track(name, props) {
-      if (destroyed) return;
-      if (isDntActive()) return;
-      const doc = document;
-      if (doc.prerendering === true || document.visibilityState === "prerender") return;
-      const nameErr = validateEventName(name);
-      if (nameErr) {
-        devWarn(name, nameErr);
-        return;
-      }
-      if (props !== void 0) {
-        const propsErr = validateEventProps(props);
-        if (propsErr) {
-          devWarn(name, propsErr);
-          return;
-        }
-      }
-      if (sendSuppressed) {
-        devSuppressNotice();
-        return;
-      }
-      const body = JSON.stringify({
-        publishableKey: config.publishableKey,
-        pathname: location.pathname,
-        referrer: document.referrer || "",
-        eventId: newEventId(),
-        eventName: name,
-        eventProps: props,
-        eventTs: Date.now()
-      });
-      sendBeaconOrFetch(body);
-    },
-    destroy() {
-      if (destroyed) return;
-      destroyed = true;
-      if (autoTrack) {
-        history.pushState = originalPushState;
-        history.replaceState = originalReplaceState;
-        window.removeEventListener("popstate", trackCurrentPath);
-      }
-      lastPath = null;
-      lastAt = 0;
-    }
-  };
-}
-function defineAnalyticsEvents() {
-  return (config) => createAnalytics(config);
-}
-export {
-  createAnalytics,
-  defineAnalyticsEvents
-};
-//# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/internal/utils/api-url.ts","../src/analytics.ts"],"sourcesContent":["declare const __DEFAULT_API_URL__: string\n\nexport function resolveApiUrl(apiUrl?: string): string {\n  if (apiUrl) {\n    return apiUrl.replace(/\\/$/, '')\n  }\n\n  if (typeof process !== 'undefined' && process.env) {\n    const envUrl =\n      process.env.SOFTWARE_API_URL || process.env.NEXT_PUBLIC_SOFTWARE_API_URL\n    if (envUrl) {\n      return envUrl.replace(/\\/$/, '')\n    }\n  }\n  return __DEFAULT_API_URL__\n}\n","/**\n * @01.software/sdk — Analytics Helper\n */\n\n/* ANALYTICS INVARIANTS START\n * @01.software/sdk — Analytics Helper\n *\n * ANALYTICS INVARIANTS\n * ====================\n * These invariants are the single source of truth for observable behavior.\n * They are mirrored verbatim in apps/console/src/app/api/analytics/script.js/route.ts.\n * Any change here MUST be reflected there, and vice versa.\n *\n * 1. DNT/GPC respect: when config.respectDnt !== false (default true) AND\n *    (navigator.doNotTrack === '1' OR navigator.globalPrivacyControl === true),\n *    all methods become no-ops. Zero network requests are made.\n *\n * 2. Prerender skip: when document.prerendering === true OR\n *    document.visibilityState === 'prerender', pageview() sends zero requests.\n *\n * 3. 500ms same-path dedup: a pageview for the same pathname within 500ms of\n *    the previous send is silently dropped. After 500ms the next call sends.\n *\n * 4. Transport: sendBeacon → fetch keepalive fallback.\n *    Primary: navigator.sendBeacon(endpoint, new Blob([json], { type: 'text/plain' })).\n *    Fallback (sendBeacon unavailable OR returns false):\n *      fetch(endpoint, { method: 'POST', keepalive: true,\n *        headers: { 'Content-Type': 'application/json' }, body: json }).catch(() => {})\n *\n * 5. Body-only publishableKey: publishableKey is always in the request body,\n *    never in any HTTP header.\n *\n * 6. SSR no-op: when typeof window === 'undefined', createAnalytics() returns\n *    a stub where all methods are no-ops. No side effects occur.\n *\n * 7. Error swallowing: all transport errors are caught and swallowed.\n *    createAnalytics() and all returned methods never throw into the caller.\n *\n * 8. Client timestamp: every send carries eventTs (milliseconds since epoch)\n *    captured with Date.now() immediately before transport. The collect\n *    endpoint uses eventTs (a) to bucket the event into the client's\n *    tenant-local day and (b) to enforce the late-arrival cutoff; events\n *    submitted after the local-day-end grace window are dropped with\n *    reason \"late\".\n *\n * 9. Dev / local-host send skip: in 'auto' mode (the default) all send paths\n *    become no-ops when the page runs on a local host — location.hostname is\n *    'localhost', '127.0.0.1', or ends with '.local'. Validation and dev\n *    warnings still run; only the network send is suppressed, and a one-time\n *    console notice is emitted. SSR (6), DNT/GPC (1), and prerender (2) skips\n *    are evaluated first. Overrides: both the SDK and the mirrored hosted\n *    snippet accept mode 'production' (always send, even locally) and\n *    'development' (never send, on any host); 'auto' is the default. The\n *    snippet reads mode from window.__01_analytics__.mode or the script's\n *    data-mode attribute. For backward compatibility the snippet also accepts\n *    captureOnLocalhost === true (via window.__01_analytics__.captureOnLocalhost\n *    or data-capture-localhost), equivalent to mode 'production' when mode is\n *    unset; an explicit mode wins.\n * ANALYTICS INVARIANTS END */\n\nimport { resolveApiUrl } from './core/internal/utils/api-url'\n\n// ============================================================================\n// Public Types\n// ============================================================================\n\nexport interface AnalyticsConfig {\n  publishableKey: string\n  /** Override the collect endpoint URL. Defaults to {SDK_BASE_URL}/api/analytics/collect */\n  endpoint?: string\n  /** Auto-patch history.pushState/replaceState and listen to popstate. Default: true */\n  autoTrack?: boolean\n  /** Respect navigator.doNotTrack and navigator.globalPrivacyControl. Default: true */\n  respectDnt?: boolean\n  /**\n   * Send mode. 'auto' (default) skips all sends on local hosts\n   * (localhost / 127.0.0.1 / *.local). 'production' always sends, even\n   * locally. 'development' never sends, on any host. See INVARIANT 9.\n   */\n  mode?: 'auto' | 'production' | 'development'\n}\n\nexport type AnalyticsEventProps = Record<string, string | number | boolean>\n\nexport type AnalyticsEventMap = Record<string, AnalyticsEventProps | undefined>\n\n/**\n * Argument tuple for `track`. The default open map keeps `props` optional\n * (back-compat). A developer-declared closed map makes `props` required when\n * the event declares props, and omittable when the event value is `undefined`.\n */\nexport type TrackArgs<\n  TEvents extends AnalyticsEventMap,\n  K extends keyof TEvents & string,\n> = string extends keyof TEvents\n  ? [props?: AnalyticsEventProps]\n  : undefined extends TEvents[K]\n    ? [props?: Exclude<TEvents[K], undefined>]\n    : [props: TEvents[K]]\n\nexport interface Analytics<\n  TEvents extends AnalyticsEventMap = AnalyticsEventMap,\n> {\n  pageview(path?: string): void\n  track<K extends keyof TEvents & string>(\n    name: K,\n    ...args: TrackArgs<TEvents, K>\n  ): void\n  destroy(): void\n}\n\n// ============================================================================\n// Implementation\n// ============================================================================\n\nexport function createAnalytics<\n  TEvents extends AnalyticsEventMap = AnalyticsEventMap,\n>(config: AnalyticsConfig): Analytics<TEvents> {\n  // INVARIANT 6: SSR no-op\n  if (typeof window === 'undefined') {\n    return { pageview() {}, track() {}, destroy() {} } as Analytics<TEvents>\n  }\n\n  const endpoint =\n    config.endpoint ?? `${resolveApiUrl()}/api/analytics/collect`\n\n  // INVARIANT 1: DNT/GPC check (evaluated once at init; stays as closure)\n  const respectDnt = config.respectDnt !== false\n  function isDntActive(): boolean {\n    if (!respectDnt) return false\n    const nav = navigator as Navigator & { globalPrivacyControl?: boolean }\n    return nav.doNotTrack === '1' || nav.globalPrivacyControl === true\n  }\n\n  // INVARIANT 9: local-host detection drives both dev warnings and the\n  // auto send-skip. Hostname is the one signal shared with the hosted snippet.\n  const isLocalHost: boolean = (() => {\n    try {\n      const h = location.hostname\n      return h === 'localhost' || h === '127.0.0.1' || h.endsWith('.local')\n    } catch {\n      return false\n    }\n  })()\n\n  const mode = config.mode ?? 'auto'\n  const sendSuppressed =\n    mode === 'development' || (mode === 'auto' && isLocalHost)\n\n  let suppressNoticeShown = false\n  function devSuppressNotice(): void {\n    if (suppressNoticeShown) return\n    suppressNoticeShown = true\n    try {\n      console.info(\n        `[01 analytics] events disabled on local host (mode: '${mode}'). ` +\n          `Pass mode: 'production' to send while developing.`,\n      )\n    } catch {\n      // INVARIANT 7: swallow\n    }\n  }\n\n  // INVARIANT 3: 500ms same-path dedup state\n  let lastPath: string | null = null\n  let lastAt = 0\n\n  // autoTrack state — save originals for destroy()\n  const autoTrack = config.autoTrack !== false\n  const originalPushState = history.pushState\n  const originalReplaceState = history.replaceState\n  let destroyed = false\n\n  // -------------------------------------------------------------------------\n  // Core send logic\n  // -------------------------------------------------------------------------\n\n  // Generate a unique event ID (crypto.randomUUID when available, Date+Math.random fallback)\n  function newEventId(): string {\n    return typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'\n      ? crypto.randomUUID()\n      : String(Date.now()) + String(Math.random())\n  }\n\n  // INVARIANT 4: sendBeacon → fetch keepalive fallback\n  // INVARIANT 5: publishableKey in body only\n  function sendBeaconOrFetch(body: string): void {\n    try {\n      if (typeof navigator.sendBeacon === 'function') {\n        const blob = new Blob([body], { type: 'text/plain' })\n        const sent = navigator.sendBeacon(endpoint, blob)\n        if (sent) return\n        // sent === false → fall through to fetch\n      }\n      // Fetch fallback\n      fetch(endpoint, {\n        method: 'POST',\n        keepalive: true,\n        headers: { 'Content-Type': 'application/json' },\n        body,\n      }).catch(() => {})\n    } catch {\n      // INVARIANT 7: swallow all errors\n    }\n  }\n\n  function sendPageview(pathname: string): void {\n    // INVARIANT 1: DNT/GPC\n    if (isDntActive()) return\n\n    // INVARIANT 2: prerender skip\n    const doc = document as Document & { prerendering?: boolean }\n    // visibilityState cast to string to accommodate non-standard 'prerender' value\n    if (doc.prerendering === true || (document.visibilityState as string) === 'prerender') return\n\n    // INVARIANT 9: skip sends on local hosts in auto mode\n    if (sendSuppressed) {\n      devSuppressNotice()\n      return\n    }\n\n    // INVARIANT 3: 500ms same-path dedup\n    const now = Date.now()\n    if (pathname === lastPath && now - lastAt < 500) return\n    lastPath = pathname\n    lastAt = now\n\n    const body = JSON.stringify({\n      publishableKey: config.publishableKey,\n      pathname,\n      referrer: document.referrer || '',\n      eventId: newEventId(),\n      eventTs: Date.now(),\n    })\n\n    sendBeaconOrFetch(body)\n  }\n\n  // -------------------------------------------------------------------------\n  // autoTrack: patch history methods + listen to popstate\n  // -------------------------------------------------------------------------\n  function trackCurrentPath(): void {\n    if (destroyed) return\n    sendPageview(location.pathname)\n  }\n\n  function patchedPushState(\n    this: History,\n    data: unknown,\n    unused: string,\n    url?: string | URL | null,\n  ): void {\n    originalPushState.apply(this, [data, unused, url] as Parameters<typeof history.pushState>)\n    if (!destroyed) setTimeout(trackCurrentPath, 0)\n  }\n\n  function patchedReplaceState(\n    this: History,\n    data: unknown,\n    unused: string,\n    url?: string | URL | null,\n  ): void {\n    originalReplaceState.apply(this, [data, unused, url] as Parameters<typeof history.replaceState>)\n    if (!destroyed) setTimeout(trackCurrentPath, 0)\n  }\n\n  if (autoTrack) {\n    history.pushState = patchedPushState\n    history.replaceState = patchedReplaceState\n    window.addEventListener('popstate', trackCurrentPath)\n\n    // Initial pageview\n    if (document.readyState === 'complete') {\n      trackCurrentPath()\n    } else {\n      window.addEventListener('load', trackCurrentPath, { once: true })\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // track() — client-side validation + send\n  // -------------------------------------------------------------------------\n\n  // Dev-mode detection for warnings: warn in dev, silent in production.\n  // Reuses the same local-host signal as the send-skip (INVARIANT 9).\n  const isProduction = !isLocalHost\n\n  // One-shot warn dedup per reason per page load (keyed by reason only)\n  const warnedReasons = new Set<string>()\n\n  function devWarn(name: string, reason: string): void {\n    if (isProduction) return\n    if (warnedReasons.has(reason)) return\n    warnedReasons.add(reason)\n    console.warn(`[01 analytics] dropped event ${name}: ${reason}`)\n  }\n\n  const EVENT_NAME_RE = /^[a-zA-Z][a-zA-Z0-9_:-]{0,49}$/\n  const RESERVED_PREFIXES = ['__', '_pv_']\n\n  function validateEventName(name: string): string | null {\n    if (!name || typeof name !== 'string') return 'name-empty'\n    for (const prefix of RESERVED_PREFIXES) {\n      if (name.startsWith(prefix)) return 'name-reserved'\n    }\n    if (!EVENT_NAME_RE.test(name)) return 'name-regex'\n    return null\n  }\n\n  const PROP_KEY_RE = /^[a-zA-Z_][a-zA-Z0-9_]{0,31}$/\n\n  function validateEventProps(\n    props: Record<string, string | number | boolean> | undefined,\n  ): string | null {\n    if (props === undefined || props === null) return null\n    if (typeof props !== 'object' || Array.isArray(props)) return 'props-value-type'\n    const keys = Object.keys(props)\n    if (keys.length > 10) return 'props-too-many-keys'\n    for (const k of keys) {\n      const v = props[k]\n      if (!PROP_KEY_RE.test(k)) return 'props-key-regex'\n      if (typeof v === 'string') {\n        if (v.length > 80) return 'props-value-too-long'\n      } else if (typeof v === 'number') {\n        if (!isFinite(v)) return 'props-value-not-finite'\n      } else if (typeof v === 'boolean') {\n        // ok\n      } else {\n        return 'props-value-type'\n      }\n    }\n    return null\n  }\n\n  // -------------------------------------------------------------------------\n  // Public API\n  // -------------------------------------------------------------------------\n  return {\n    pageview(path?: string): void {\n      if (destroyed) return\n      sendPageview(path ?? location.pathname)\n    },\n\n    track(name: string, props?: Record<string, string | number | boolean>): void {\n      if (destroyed) return\n\n      // INVARIANT 1: DNT/GPC (same as pageview)\n      if (isDntActive()) return\n\n      // INVARIANT 2: prerender skip\n      const doc = document as Document & { prerendering?: boolean }\n      if (doc.prerendering === true || (document.visibilityState as string) === 'prerender') return\n\n      // Client-side validation\n      const nameErr = validateEventName(name)\n      if (nameErr) {\n        devWarn(name, nameErr)\n        return\n      }\n\n      if (props !== undefined) {\n        const propsErr = validateEventProps(props)\n        if (propsErr) {\n          devWarn(name, propsErr)\n          return\n        }\n      }\n\n      // INVARIANT 9: skip sends on local hosts in auto mode (validation above\n      // still runs so dev warnings fire)\n      if (sendSuppressed) {\n        devSuppressNotice()\n        return\n      }\n\n      // Build body — no dedup for track() events\n      const body = JSON.stringify({\n        publishableKey: config.publishableKey,\n        pathname: location.pathname,\n        referrer: document.referrer || '',\n        eventId: newEventId(),\n        eventName: name,\n        eventProps: props,\n        eventTs: Date.now(),\n      })\n\n      sendBeaconOrFetch(body)\n    },\n\n    destroy(): void {\n      if (destroyed) return\n      destroyed = true\n\n      if (autoTrack) {\n        // Restore original history methods\n        history.pushState = originalPushState\n        history.replaceState = originalReplaceState\n        window.removeEventListener('popstate', trackCurrentPath)\n      }\n\n      // Null out dedup state\n      lastPath = null\n      lastAt = 0\n    },\n  } as Analytics<TEvents>\n}\n\n/**\n * Bind a typed event map once, then create instances without repeating the\n * generic. Equivalent to `createAnalytics<TEvents>(config)`.\n */\nexport function defineAnalyticsEvents<\n  TEvents extends AnalyticsEventMap,\n>(): (config: AnalyticsConfig) => Analytics<TEvents> {\n  return (config) => createAnalytics<TEvents>(config)\n}\n"],"mappings":";AAEO,SAAS,cAAc,QAAyB;AACrD,MAAI,QAAQ;AACV,WAAO,OAAO,QAAQ,OAAO,EAAE;AAAA,EACjC;AAEA,MAAI,OAAO,YAAY,eAAe,QAAQ,KAAK;AACjD,UAAM,SACJ,QAAQ,IAAI,oBAAoB,QAAQ,IAAI;AAC9C,QAAI,QAAQ;AACV,aAAO,OAAO,QAAQ,OAAO,EAAE;AAAA,IACjC;AAAA,EACF;AACA,SAAO;AACT;;;ACoGO,SAAS,gBAEd,QAA6C;AAE7C,MAAI,OAAO,WAAW,aAAa;AACjC,WAAO,EAAE,WAAW;AAAA,IAAC,GAAG,QAAQ;AAAA,IAAC,GAAG,UAAU;AAAA,IAAC,EAAE;AAAA,EACnD;AAEA,QAAM,WACJ,OAAO,YAAY,GAAG,cAAc,CAAC;AAGvC,QAAM,aAAa,OAAO,eAAe;AACzC,WAAS,cAAuB;AAC9B,QAAI,CAAC,WAAY,QAAO;AACxB,UAAM,MAAM;AACZ,WAAO,IAAI,eAAe,OAAO,IAAI,yBAAyB;AAAA,EAChE;AAIA,QAAM,eAAwB,MAAM;AAClC,QAAI;AACF,YAAM,IAAI,SAAS;AACnB,aAAO,MAAM,eAAe,MAAM,eAAe,EAAE,SAAS,QAAQ;AAAA,IACtE,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF,GAAG;AAEH,QAAM,OAAO,OAAO,QAAQ;AAC5B,QAAM,iBACJ,SAAS,iBAAkB,SAAS,UAAU;AAEhD,MAAI,sBAAsB;AAC1B,WAAS,oBAA0B;AACjC,QAAI,oBAAqB;AACzB,0BAAsB;AACtB,QAAI;AACF,cAAQ;AAAA,QACN,wDAAwD,IAAI;AAAA,MAE9D;AAAA,IACF,QAAQ;AAAA,IAER;AAAA,EACF;AAGA,MAAI,WAA0B;AAC9B,MAAI,SAAS;AAGb,QAAM,YAAY,OAAO,cAAc;AACvC,QAAM,oBAAoB,QAAQ;AAClC,QAAM,uBAAuB,QAAQ;AACrC,MAAI,YAAY;AAOhB,WAAS,aAAqB;AAC5B,WAAO,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,aACjE,OAAO,WAAW,IAClB,OAAO,KAAK,IAAI,CAAC,IAAI,OAAO,KAAK,OAAO,CAAC;AAAA,EAC/C;AAIA,WAAS,kBAAkB,MAAoB;AAC7C,QAAI;AACF,UAAI,OAAO,UAAU,eAAe,YAAY;AAC9C,cAAM,OAAO,IAAI,KAAK,CAAC,IAAI,GAAG,EAAE,MAAM,aAAa,CAAC;AACpD,cAAM,OAAO,UAAU,WAAW,UAAU,IAAI;AAChD,YAAI,KAAM;AAAA,MAEZ;AAEA,YAAM,UAAU;AAAA,QACd,QAAQ;AAAA,QACR,WAAW;AAAA,QACX,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,QAC9C;AAAA,MACF,CAAC,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAAA,IACnB,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,WAAS,aAAa,UAAwB;AAE5C,QAAI,YAAY,EAAG;AAGnB,UAAM,MAAM;AAEZ,QAAI,IAAI,iBAAiB,QAAS,SAAS,oBAA+B,YAAa;AAGvF,QAAI,gBAAgB;AAClB,wBAAkB;AAClB;AAAA,IACF;AAGA,UAAM,MAAM,KAAK,IAAI;AACrB,QAAI,aAAa,YAAY,MAAM,SAAS,IAAK;AACjD,eAAW;AACX,aAAS;AAET,UAAM,OAAO,KAAK,UAAU;AAAA,MAC1B,gBAAgB,OAAO;AAAA,MACvB;AAAA,MACA,UAAU,SAAS,YAAY;AAAA,MAC/B,SAAS,WAAW;AAAA,MACpB,SAAS,KAAK,IAAI;AAAA,IACpB,CAAC;AAED,sBAAkB,IAAI;AAAA,EACxB;AAKA,WAAS,mBAAyB;AAChC,QAAI,UAAW;AACf,iBAAa,SAAS,QAAQ;AAAA,EAChC;AAEA,WAAS,iBAEP,MACA,QACA,KACM;AACN,sBAAkB,MAAM,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAyC;AACzF,QAAI,CAAC,UAAW,YAAW,kBAAkB,CAAC;AAAA,EAChD;AAEA,WAAS,oBAEP,MACA,QACA,KACM;AACN,yBAAqB,MAAM,MAAM,CAAC,MAAM,QAAQ,GAAG,CAA4C;AAC/F,QAAI,CAAC,UAAW,YAAW,kBAAkB,CAAC;AAAA,EAChD;AAEA,MAAI,WAAW;AACb,YAAQ,YAAY;AACpB,YAAQ,eAAe;AACvB,WAAO,iBAAiB,YAAY,gBAAgB;AAGpD,QAAI,SAAS,eAAe,YAAY;AACtC,uBAAiB;AAAA,IACnB,OAAO;AACL,aAAO,iBAAiB,QAAQ,kBAAkB,EAAE,MAAM,KAAK,CAAC;AAAA,IAClE;AAAA,EACF;AAQA,QAAM,eAAe,CAAC;AAGtB,QAAM,gBAAgB,oBAAI,IAAY;AAEtC,WAAS,QAAQ,MAAc,QAAsB;AACnD,QAAI,aAAc;AAClB,QAAI,cAAc,IAAI,MAAM,EAAG;AAC/B,kBAAc,IAAI,MAAM;AACxB,YAAQ,KAAK,gCAAgC,IAAI,KAAK,MAAM,EAAE;AAAA,EAChE;AAEA,QAAM,gBAAgB;AACtB,QAAM,oBAAoB,CAAC,MAAM,MAAM;AAEvC,WAAS,kBAAkB,MAA6B;AACtD,QAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,eAAW,UAAU,mBAAmB;AACtC,UAAI,KAAK,WAAW,MAAM,EAAG,QAAO;AAAA,IACtC;AACA,QAAI,CAAC,cAAc,KAAK,IAAI,EAAG,QAAO;AACtC,WAAO;AAAA,EACT;AAEA,QAAM,cAAc;AAEpB,WAAS,mBACP,OACe;AACf,QAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,QAAI,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,QAAO;AAC9D,UAAM,OAAO,OAAO,KAAK,KAAK;AAC9B,QAAI,KAAK,SAAS,GAAI,QAAO;AAC7B,eAAW,KAAK,MAAM;AACpB,YAAM,IAAI,MAAM,CAAC;AACjB,UAAI,CAAC,YAAY,KAAK,CAAC,EAAG,QAAO;AACjC,UAAI,OAAO,MAAM,UAAU;AACzB,YAAI,EAAE,SAAS,GAAI,QAAO;AAAA,MAC5B,WAAW,OAAO,MAAM,UAAU;AAChC,YAAI,CAAC,SAAS,CAAC,EAAG,QAAO;AAAA,MAC3B,WAAW,OAAO,MAAM,WAAW;AAAA,MAEnC,OAAO;AACL,eAAO;AAAA,MACT;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAKA,SAAO;AAAA,IACL,SAAS,MAAqB;AAC5B,UAAI,UAAW;AACf,mBAAa,QAAQ,SAAS,QAAQ;AAAA,IACxC;AAAA,IAEA,MAAM,MAAc,OAAyD;AAC3E,UAAI,UAAW;AAGf,UAAI,YAAY,EAAG;AAGnB,YAAM,MAAM;AACZ,UAAI,IAAI,iBAAiB,QAAS,SAAS,oBAA+B,YAAa;AAGvF,YAAM,UAAU,kBAAkB,IAAI;AACtC,UAAI,SAAS;AACX,gBAAQ,MAAM,OAAO;AACrB;AAAA,MACF;AAEA,UAAI,UAAU,QAAW;AACvB,cAAM,WAAW,mBAAmB,KAAK;AACzC,YAAI,UAAU;AACZ,kBAAQ,MAAM,QAAQ;AACtB;AAAA,QACF;AAAA,MACF;AAIA,UAAI,gBAAgB;AAClB,0BAAkB;AAClB;AAAA,MACF;AAGA,YAAM,OAAO,KAAK,UAAU;AAAA,QAC1B,gBAAgB,OAAO;AAAA,QACvB,UAAU,SAAS;AAAA,QACnB,UAAU,SAAS,YAAY;AAAA,QAC/B,SAAS,WAAW;AAAA,QACpB,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,SAAS,KAAK,IAAI;AAAA,MACpB,CAAC;AAED,wBAAkB,IAAI;AAAA,IACxB;AAAA,IAEA,UAAgB;AACd,UAAI,UAAW;AACf,kBAAY;AAEZ,UAAI,WAAW;AAEb,gBAAQ,YAAY;AACpB,gBAAQ,eAAe;AACvB,eAAO,oBAAoB,YAAY,gBAAgB;AAAA,MACzD;AAGA,iBAAW;AACX,eAAS;AAAA,IACX;AAAA,EACF;AACF;AAMO,SAAS,wBAEqC;AACnD,SAAO,CAAC,WAAW,gBAAyB,MAAM;AACpD;","names":[]}