@hifilabs/pixel 0.0.2 → 0.0.4

package/dist/index.esm.d.ts

@@ -0,0 +1 @@
+export declare function BalanceAnalytics(): null;

package/dist/index.esm.js

@@ -0,0 +1,19 @@
+'use client';
+// src/react/BalanceAnalytics.tsx
+import { useEffect } from "react";
+import { usePathname, useSearchParams } from "next/navigation";
+function BalanceAnalytics() {
+  const pathname = usePathname();
+  const searchParams = useSearchParams();
+  useEffect(() => {
+    if (typeof window !== "undefined" && window.balance) {
+      const url = window.location.href;
+      const title = document.title;
+      window.balance.page({ url, title });
+    }
+  }, [pathname, searchParams]);
+  return null;
+}
+export {
+  BalanceAnalytics
+};

package/dist/index.js

@@ -1,8 +1,56 @@
 var BalancePixel = (() => {
+  var __defProp = Object.defineProperty;
+  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+  var __getOwnPropNames = Object.getOwnPropertyNames;
+  var __hasOwnProp = Object.prototype.hasOwnProperty;
+  var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+    get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+  }) : x)(function(x) {
+    if (typeof require !== "undefined")
+      return require.apply(this, arguments);
+    throw Error('Dynamic require of "' + x + '" is not supported');
+  });
+  var __export = (target, all) => {
+    for (var name in all)
+      __defProp(target, name, { get: all[name], enumerable: true });
+  };
+  var __copyProps = (to, from, except, desc) => {
+    if (from && typeof from === "object" || typeof from === "function") {
+      for (let key of __getOwnPropNames(from))
+        if (!__hasOwnProp.call(to, key) && key !== except)
+          __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+    }
+    return to;
+  };
+  var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+  // src/index.ts
+  var src_exports = {};
+  __export(src_exports, {
+    BalanceAnalytics: () => BalanceAnalytics
+  });
+
+  // src/react/BalanceAnalytics.tsx
+  var import_react = __require("react");
+  var import_navigation = __require("next/navigation");
+  function BalanceAnalytics() {
+    const pathname = (0, import_navigation.usePathname)();
+    const searchParams = (0, import_navigation.useSearchParams)();
+    (0, import_react.useEffect)(() => {
+      if (typeof window !== "undefined" && window.balance) {
+        const url = window.location.href;
+        const title = document.title;
+        window.balance.page({ url, title });
+      }
+    }, [pathname, searchParams]);
+    return null;
+  }
+
   // src/index.ts
   (function() {
     const currentScript = document.currentScript;
     const artistId = currentScript?.dataset.artistId;
+    const projectId = currentScript?.dataset.projectId;
     const useEmulator = currentScript?.dataset.emulator === "true";
     const debug = currentScript?.dataset.debug === "true";
     if (!artistId) {
@@ -14,7 +62,7 @@ var BalancePixel = (() => {
     const ATTRIBUTION_KEY = "balance_attribution";
     const FAN_ID_KEY = "balance_fan_id_hash";
     const CONSENT_STORAGE_KEY = "balance_consent";
-    const SESSION_DURATION = 30 * 60 * 1e3;
+    const SESSION_DURATION = 60 * 60 * 1e3;
     const API_ENDPOINT = useEmulator ? `http://localhost:5001/artist-os-distro/us-central1/pixelEndpoint` : `https://us-central1-artist-os-distro.cloudfunctions.net/pixelEndpoint`;
     let sessionId = null;
     let fanIdHash = null;
@@ -138,7 +186,7 @@ var BalancePixel = (() => {
       return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
     }
     function buildEvent(partial) {
-      return {
+      const base = {
         artist_id: artistId,
         fan_session_id: sessionId,
         fan_id_hash: fanIdHash || void 0,
@@ -149,6 +197,10 @@ var BalancePixel = (() => {
         ...partial,
         ...attribution
       };
+      if (projectId && !partial.projectId) {
+        base.projectId = projectId;
+      }
+      return base;
     }
     function enqueueEvent(event) {
       const essentialEvents = ["identify", "consent_updated"];
@@ -218,7 +270,14 @@ var BalancePixel = (() => {
       try {
         fanIdHash = await hashEmail(email);
         localStorage.setItem(FAN_ID_KEY, fanIdHash);
-        log("Fan identified:", fanIdHash);
+        const emailParts = email.split("@");
+        const maskedEmail = emailParts[0].charAt(0) + "***@" + (emailParts[1] || "");
+        log("Fan identified:", {
+          name: traits.name || "(no name)",
+          email: maskedEmail,
+          hash: fanIdHash.substring(0, 16) + "...",
+          traits
+        });
         const event = buildEvent({
           event_name: "identify",
           fan_id_hash: fanIdHash,
@@ -248,10 +307,20 @@ var BalancePixel = (() => {
       sessionId = getOrCreateSession();
       loadFanId();
       loadConsent();
+      if (!consent) {
+        consent = {
+          analytics: true,
+          marketing: false,
+          personalization: false,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        log("Using default consent (dev mode):", consent);
+      }
       captureAttribution();
       startFlushTimer();
       log("Initialized", {
         artistId,
+        projectId: projectId || "(none - will track to all projects)",
         sessionId,
         fanIdHash,
         consent,
@@ -287,4 +356,5 @@ var BalancePixel = (() => {
     }
     log("Pixel script loaded");
   })();
+  return __toCommonJS(src_exports);
 })();

package/dist/index.min.js

@@ -1 +1 @@
-var BalancePixel=(()=>{(function(){let f=document.currentScript,m=f?.dataset.artistId,_=f?.dataset.emulator==="true",C=f?.dataset.debug==="true";if(!m){console.error("[BALANCE Pixel] Error: data-artist-id attribute is required");return}let v="balance_session_id",p="balance_session_timestamp",x="balance_attribution",S="balance_fan_id_hash",I="balance_consent",P=30*60*1e3,h=_?"http://localhost:5001/artist-os-distro/us-central1/pixelEndpoint":"https://us-central1-artist-os-distro.cloudfunctions.net/pixelEndpoint",u=null,s=null,i=null,c={},a=[],y=null,r=(...e)=>{C&&console.log("[BALANCE Pixel]",...e)};function E(){return crypto&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let t=Math.random()*16|0;return(e==="x"?t:t&3|8).toString(16)})}function N(){try{let e=localStorage.getItem(v),t=localStorage.getItem(p);if(e&&t&&Date.now()-parseInt(t,10)<P)return localStorage.setItem(p,Date.now().toString()),e;let n=E();return localStorage.setItem(v,n),localStorage.setItem(p,Date.now().toString()),n}catch{return E()}}function O(){let e=new URLSearchParams(window.location.search),t={};return["source","medium","campaign","content","term"].forEach(n=>{let o=e.get(`utm_${n}`);o&&(t[`utm_${n}`]=o)}),t}function T(){try{let e=localStorage.getItem(x);if(e){c=JSON.parse(e),r("Loaded attribution:",c);return}let t=O();Object.keys(t).length>0&&(c=t,localStorage.setItem(x,JSON.stringify(t)),r("Captured attribution:",c))}catch{}}function L(){try{s=localStorage.getItem(S)}catch{}}function R(){try{let e=localStorage.getItem(I);e&&(i=JSON.parse(e).preferences||null,r("Loaded consent:",i))}catch{}}function D(e){let t=i;i=e;try{let o={preferences:e,method:"explicit",version:1};localStorage.setItem(I,JSON.stringify(o)),r("Consent saved:",e)}catch(o){console.error("[BALANCE Pixel] Could not save consent:",o)}let n=l({event_name:"consent_updated",metadata:{consent_preferences:e,consent_method:"explicit",previous_consent:t||void 0}});d(n)}function U(){return i}function b(e){return i?.[e]===!0}async function k(e){let t=e.toLowerCase().trim(),o=new TextEncoder().encode(t),z=await crypto.subtle.digest("SHA-256",o);return Array.from(new Uint8Array(z)).map(J=>J.toString(16).padStart(2,"0")).join("")}function l(e){return{artist_id:m,fan_session_id:u,fan_id_hash:s||void 0,timestamp:new Date().toISOString(),source_url:window.location.href,referrer_url:document.referrer||void 0,user_agent:navigator.userAgent,...e,...c}}function d(e){if(!["identify","consent_updated"].includes(e.event_name)&&!b("analytics")){r(`Event '${e.event_name}' blocked - no analytics consent`);return}a.push(e),r("Event queued:",e.event_name,"(queue:",a.length,")"),a.length>=10&&g()}async function g(){if(a.length===0)return;let e=[...a];a=[],r("Flushing",e.length,"events to",h);try{let t=await fetch(h,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({events:e}),keepalive:!0});if(!t.ok)throw new Error(`HTTP ${t.status}`);r("Events sent successfully")}catch(t){console.error("[BALANCE Pixel] Failed to send events:",t),a.length<50&&a.push(...e)}}function B(){y&&clearInterval(y),y=window.setInterval(()=>{a.length>0&&g()},5e3)}function w(e={}){let t=l({event_name:"pageview",page_title:e.title||document.title,source_url:e.url||window.location.href});d(t)}function F(e,t={}){let n=l({event_name:"custom",metadata:{event_type:e,...t}});d(n)}async function H(e,t={}){try{s=await k(e),localStorage.setItem(S,s),r("Fan identified:",s);let n=l({event_name:"identify",fan_id_hash:s,metadata:{email_sha256:s,traits:t,consent_preferences:i||void 0}});d(n)}catch(n){console.error("[BALANCE Pixel] Failed to identify:",n)}}function M(e,t="USD",n={}){let o=l({event_name:"purchase",metadata:{revenue:e,currency:t,...n}});d(o)}function A(){u=N(),L(),R(),T(),B(),r("Initialized",{artistId:m,sessionId:u,fanIdHash:s,consent:i,useEmulator:_,endpoint:h}),w(),window.addEventListener("beforeunload",()=>{g()}),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&g()})}window.balance={track:F,identify:H,page:w,purchase:M,getSessionId:()=>u,getFanIdHash:()=>s,getAttribution:()=>c,setConsent:D,getConsent:U,hasConsent:b},document.readyState==="loading"?document.addEventListener("DOMContentLoaded",A):A(),r("Pixel script loaded")})();})();
+var BalancePixel=(()=>{var E=Object.defineProperty;var Q=Object.getOwnPropertyDescriptor;var V=Object.getOwnPropertyNames;var W=Object.prototype.hasOwnProperty;var L=(n=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(n,{get:(r,s)=>(typeof require<"u"?require:r)[s]}):n)(function(n){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+n+'" is not supported')});var X=(n,r)=>{for(var s in r)E(n,s,{get:r[s],enumerable:!0})},Z=(n,r,s,u)=>{if(r&&typeof r=="object"||typeof r=="function")for(let g of V(r))!W.call(n,g)&&g!==s&&E(n,g,{get:()=>r[g],enumerable:!(u=Q(r,g))||u.enumerable});return n};var ee=n=>Z(E({},"__esModule",{value:!0}),n);var te={};X(te,{BalanceAnalytics:()=>k});var R=L("react"),_=L("next/navigation");function k(){let n=(0,_.usePathname)(),r=(0,_.useSearchParams)();return(0,R.useEffect)(()=>{if(typeof window<"u"&&window.balance){let s=window.location.href,u=document.title;window.balance.page({url:s,title:u})}},[n,r]),null}(function(){let n=document.currentScript,r=n?.dataset.artistId,s=n?.dataset.projectId,u=n?.dataset.emulator==="true",g=n?.dataset.debug==="true";if(!r){console.error("[BALANCE Pixel] Error: data-artist-id attribute is required");return}let w="balance_session_id",x="balance_session_timestamp",b="balance_attribution",A="balance_fan_id_hash",P="balance_consent",D=60*60*1e3,S=u?"http://localhost:5001/artist-os-distro/us-central1/pixelEndpoint":"https://us-central1-artist-os-distro.cloudfunctions.net/pixelEndpoint",h=null,l=null,c=null,f={},d=[],v=null,i=(...e)=>{g&&console.log("[BALANCE Pixel]",...e)};function C(){return crypto&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{let t=Math.random()*16|0;return(e==="x"?t:t&3|8).toString(16)})}function U(){try{let e=localStorage.getItem(w),t=localStorage.getItem(x);if(e&&t&&Date.now()-parseInt(t,10)<D)return localStorage.setItem(x,Date.now().toString()),e;let o=C();return localStorage.setItem(w,o),localStorage.setItem(x,Date.now().toString()),o}catch{return C()}}function B(){let e=new URLSearchParams(window.location.search),t={};return["source","medium","campaign","content","term"].forEach(o=>{let a=e.get(`utm_${o}`);a&&(t[`utm_${o}`]=a)}),t}function j(){try{let e=localStorage.getItem(b);if(e){f=JSON.parse(e),i("Loaded attribution:",f);return}let t=B();Object.keys(t).length>0&&(f=t,localStorage.setItem(b,JSON.stringify(t)),i("Captured attribution:",f))}catch{}}function F(){try{l=localStorage.getItem(A)}catch{}}function z(){try{let e=localStorage.getItem(P);e&&(c=JSON.parse(e).preferences||null,i("Loaded consent:",c))}catch{}}function H(e){let t=c;c=e;try{let a={preferences:e,method:"explicit",version:1};localStorage.setItem(P,JSON.stringify(a)),i("Consent saved:",e)}catch(a){console.error("[BALANCE Pixel] Could not save consent:",a)}let o=m({event_name:"consent_updated",metadata:{consent_preferences:e,consent_method:"explicit",previous_consent:t||void 0}});p(o)}function M(){return c}function N(e){return c?.[e]===!0}async function J(e){let t=e.toLowerCase().trim(),a=new TextEncoder().encode(t),I=await crypto.subtle.digest("SHA-256",a);return Array.from(new Uint8Array(I)).map(G=>G.toString(16).padStart(2,"0")).join("")}function m(e){let t={artist_id:r,fan_session_id:h,fan_id_hash:l||void 0,timestamp:new Date().toISOString(),source_url:window.location.href,referrer_url:document.referrer||void 0,user_agent:navigator.userAgent,...e,...f};return s&&!e.projectId&&(t.projectId=s),t}function p(e){if(!["identify","consent_updated"].includes(e.event_name)&&!N("analytics")){i(`Event '${e.event_name}' blocked - no analytics consent`);return}d.push(e),i("Event queued:",e.event_name,"(queue:",d.length,")"),d.length>=10&&y()}async function y(){if(d.length===0)return;let e=[...d];d=[],i("Flushing",e.length,"events to",S);try{let t=await fetch(S,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({events:e}),keepalive:!0});if(!t.ok)throw new Error(`HTTP ${t.status}`);i("Events sent successfully")}catch(t){console.error("[BALANCE Pixel] Failed to send events:",t),d.length<50&&d.push(...e)}}function K(){v&&clearInterval(v),v=window.setInterval(()=>{d.length>0&&y()},5e3)}function O(e={}){let t=m({event_name:"pageview",page_title:e.title||document.title,source_url:e.url||window.location.href});p(t)}function Y(e,t={}){let o=m({event_name:"custom",metadata:{event_type:e,...t}});p(o)}async function q(e,t={}){try{l=await J(e),localStorage.setItem(A,l);let o=e.split("@"),a=o[0].charAt(0)+"***@"+(o[1]||"");i("Fan identified:",{name:t.name||"(no name)",email:a,hash:l.substring(0,16)+"...",traits:t});let I=m({event_name:"identify",fan_id_hash:l,metadata:{email_sha256:l,traits:t,consent_preferences:c||void 0}});p(I)}catch(o){console.error("[BALANCE Pixel] Failed to identify:",o)}}function $(e,t="USD",o={}){let a=m({event_name:"purchase",metadata:{revenue:e,currency:t,...o}});p(a)}function T(){h=U(),F(),z(),c||(c={analytics:!0,marketing:!1,personalization:!1,timestamp:new Date().toISOString()},i("Using default consent (dev mode):",c)),j(),K(),i("Initialized",{artistId:r,projectId:s||"(none - will track to all projects)",sessionId:h,fanIdHash:l,consent:c,useEmulator:u,endpoint:S}),O(),window.addEventListener("beforeunload",()=>{y()}),document.addEventListener("visibilitychange",()=>{document.visibilityState==="hidden"&&y()})}window.balance={track:Y,identify:q,page:O,purchase:$,getSessionId:()=>h,getFanIdHash:()=>l,getAttribution:()=>f,setConsent:H,getConsent:M,hasConsent:N},document.readyState==="loading"?document.addEventListener("DOMContentLoaded",T):T(),i("Pixel script loaded")})();return ee(te);})();

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@hifilabs/pixel",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "BALANCE Pixel - Lightweight browser tracking script for artist fan analytics",
   "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "module": "./dist/index.esm.js",
+  "types": "./dist/index.esm.d.ts",
   "publishConfig": {
-    "access": "restricted"
+    "access": "public"
   },
   "files": [
     "dist"
@@ -31,6 +32,11 @@
     "url": "https://github.com/hifilabs/artist-os-distro"
   },
   "homepage": "https://github.com/hifilabs/artist-os-distro#readme",
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "next": "^13.0.0 || ^14.0.0 || ^15.0.0"
+  },
   "devDependencies": {
     "esbuild": "^0.19.0",
     "typescript": "^5.4.5"