@01.software/sdk 0.13.0 → 0.14.0

package/dist/index.cjs

@@ -60,6 +60,7 @@ __export(src_exports, {
   buildProductListingProjection: () => buildProductListingProjection,
   buildProductOptionMatrix: () => buildProductOptionMatrix,
   collectionKeys: () => collectionKeys,
+  createAnalytics: () => createAnalytics,
   createAuthError: () => createAuthError,
   createClient: () => createClient,
   createConflictError: () => createConflictError,
@@ -3126,4 +3127,174 @@ function getVideoStreamUrl(playbackId) {
 function getVideoMp4Url(playbackId, resolution = "high") {
   return `${MUX_STREAM_BASE}/${playbackId}/${resolution}.mp4`;
 }
+
+// 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;
+  }
+  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;
+    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()
+    });
+    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 = (() => {
+    try {
+      const hostname = location.hostname;
+      return hostname !== "localhost" && hostname !== "127.0.0.1" && !hostname.endsWith(".local");
+    } catch {
+      return true;
+    }
+  })();
+  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;
+        }
+      }
+      const body = JSON.stringify({
+        publishableKey: config.publishableKey,
+        pathname: location.pathname,
+        referrer: document.referrer || "",
+        eventId: newEventId(),
+        eventName: name,
+        eventProps: props
+      });
+      sendBeaconOrFetch(body);
+    },
+    destroy() {
+      if (destroyed) return;
+      destroyed = true;
+      if (autoTrack) {
+        history.pushState = originalPushState;
+        history.replaceState = originalReplaceState;
+        window.removeEventListener("popstate", trackCurrentPath);
+      }
+      lastPath = null;
+      lastAt = 0;
+    }
+  };
+}
 //# sourceMappingURL=index.cjs.map