@hifilabs/pixel 0.7.0 → 0.7.1

package/dist/index.esm.d.ts

@@ -53,7 +53,12 @@ export interface BalanceContextValue {
   setConsent: (preferences: ConsentPreferences) => void;
   getConsent: () => ConsentPreferences | null;
   hasConsent: (type: 'analytics' | 'marketing' | 'personalization') => boolean;
+  /** True when the pixel script has loaded successfully */
   isReady: boolean;
+  /** True if the pixel script failed to load */
+  isError: boolean;
+  /** Error object if script loading failed */
+  error: Error | null;
   artistId: string;
   projectId?: string;
   endpoint?: string;

package/dist/index.js

@@ -100,6 +100,8 @@ var defaultContextValue = {
   hasConsent: () => false,
   // State - SSR-safe defaults
   isReady: false,
+  isError: false,
+  error: null,
   artistId: "",
   projectId: void 0,
   endpoint: void 0,
@@ -284,6 +286,8 @@ function BalanceProvider({
   children
 }) {
   const [isReady, setIsReady] = (0, import_react4.useState)(false);
+  const [isError, setIsError] = (0, import_react4.useState)(false);
+  const [error, setError] = (0, import_react4.useState)(null);
   const [shouldLoadScript, setShouldLoadScript] = (0, import_react4.useState)(false);
   (0, import_react4.useEffect)(() => {
     ensureGlobalStub();
@@ -390,6 +394,8 @@ function BalanceProvider({
     hasConsent: hasConsent2,
     // State
     isReady,
+    isError,
+    error,
     artistId,
     projectId,
     endpoint,
@@ -406,6 +412,8 @@ function BalanceProvider({
     getConsent2,
     hasConsent2,
     isReady,
+    isError,
+    error,
     artistId,
     projectId,
     endpoint,
@@ -419,8 +427,17 @@ function BalanceProvider({
   }, [debug]);
   const handleScriptError = (0, import_react4.useCallback)((e) => {
     console.error("[BalanceProvider] Failed to load pixel script:", e);
+    setIsError(true);
+    setError(e);
   }, []);
   const resolvedScriptUrl = scriptUrl ?? DEFAULT_SCRIPT_URL;
+  (0, import_react4.useEffect)(() => {
+    if (debug && !scriptUrl) {
+      console.warn(
+        '[BalanceProvider] Using default CDN URL. For production, consider hosting the pixel script locally:\n1. Copy index.js from artist-os-distro/apps/web/public/scripts/\n2. Place it in your public/scripts/index.js\n3. Set scriptUrl="/scripts/index.js"\n\nThis avoids external dependencies and CSP issues.'
+      );
+    }
+  }, [debug, scriptUrl]);
   const content = /* @__PURE__ */ import_react4.default.createElement(BalanceContext.Provider, { value: contextValue }, shouldLoadScript && /* @__PURE__ */ import_react4.default.createElement(
     import_script2.default,
     {

package/dist/index.mjs

@@ -31,6 +31,8 @@ var defaultContextValue = {
   hasConsent: () => false,
   // State - SSR-safe defaults
   isReady: false,
+  isError: false,
+  error: null,
   artistId: "",
   projectId: void 0,
   endpoint: void 0,
@@ -215,6 +217,8 @@ function BalanceProvider({
   children
 }) {
   const [isReady, setIsReady] = useState(false);
+  const [isError, setIsError] = useState(false);
+  const [error, setError] = useState(null);
   const [shouldLoadScript, setShouldLoadScript] = useState(false);
   useEffect2(() => {
     ensureGlobalStub();
@@ -321,6 +325,8 @@ function BalanceProvider({
     hasConsent: hasConsent2,
     // State
     isReady,
+    isError,
+    error,
     artistId,
     projectId,
     endpoint,
@@ -337,6 +343,8 @@ function BalanceProvider({
     getConsent2,
     hasConsent2,
     isReady,
+    isError,
+    error,
     artistId,
     projectId,
     endpoint,
@@ -350,8 +358,17 @@ function BalanceProvider({
   }, [debug]);
   const handleScriptError = useCallback2((e) => {
     console.error("[BalanceProvider] Failed to load pixel script:", e);
+    setIsError(true);
+    setError(e);
   }, []);
   const resolvedScriptUrl = scriptUrl ?? DEFAULT_SCRIPT_URL;
+  useEffect2(() => {
+    if (debug && !scriptUrl) {
+      console.warn(
+        '[BalanceProvider] Using default CDN URL. For production, consider hosting the pixel script locally:\n1. Copy index.js from artist-os-distro/apps/web/public/scripts/\n2. Place it in your public/scripts/index.js\n3. Set scriptUrl="/scripts/index.js"\n\nThis avoids external dependencies and CSP issues.'
+      );
+    }
+  }, [debug, scriptUrl]);
   const content = /* @__PURE__ */ React3.createElement(BalanceContext.Provider, { value: contextValue }, shouldLoadScript && /* @__PURE__ */ React3.createElement(
     Script2,
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hifilabs/pixel",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "BALANCE Pixel - Lightweight browser tracking script for artist fan analytics",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",