@dcl/hooks 1.3.0 → 1.4.0

package/esm/hooks/usePageTracking.d.ts

@@ -1,2 +1,23 @@
-declare const usePageTracking: (path: string) => void;
+type PageTrackingProperties = Record<string, unknown>;
+/**
+ * Tracks a Segment `page()` event.
+ *
+ * Two call shapes:
+ *
+ * 1. `usePageTracking(path)` — fires `page(path)` whenever `path` changes.
+ *    Backwards-compatible with the original signature.
+ *
+ * 2. `usePageTracking(name, properties)` — fires `page(name, properties)` only
+ *    after analytics is initialized AND `name` is a non-empty string. Use this
+ *    shape when the page title is resolved asynchronously (e.g. from a CMS via
+ *    Helmet + RTK Query) so the event lands AFTER `document.title` updates,
+ *    avoiding the SPA race that lets Segment auto-capture the previous route's
+ *    title via `properties.title`.
+ *
+ * The hook is initialization-aware in both shapes: when `useAnalytics().page`
+ * is the no-op fallback (Segment not loaded yet), the call is skipped to avoid
+ * wasted work.
+ */
+declare function usePageTracking(path: string): void;
+declare function usePageTracking(name: string | undefined, properties?: PageTrackingProperties): void;
 export { usePageTracking };

package/esm/hooks/usePageTracking.js

@@ -1,10 +1,15 @@
-import { useEffect } from "react";
+import { useEffect, useRef } from "react";
 import { useAnalytics } from "./useAnalytics";
-const usePageTracking = (path) => {
-    const { page } = useAnalytics();
+function usePageTracking(name, properties) {
+    const { isInitialized, page } = useAnalytics();
+    const propertiesKey = properties ? JSON.stringify(properties) : "";
+    const propertiesRef = useRef(properties);
+    propertiesRef.current = properties;
     useEffect(() => {
-        page(path);
-    }, [page, path]);
-};
+        if (!isInitialized || !name)
+            return;
+        page(name, propertiesRef.current);
+    }, [isInitialized, name, propertiesKey, page]);
+}
 export { usePageTracking };
 //# sourceMappingURL=usePageTracking.js.map

package/esm/hooks/usePageTracking.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePageTracking.js","sourceRoot":"","sources":["../../src/hooks/usePageTracking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,EAAE;IACvC,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAA;IAE/B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,CAAC,CAAA;IACZ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;AAClB,CAAC,CAAA;AAED,OAAO,EAAE,eAAe,EAAE,CAAA"}
+{"version":3,"file":"usePageTracking.js","sourceRoot":"","sources":["../../src/hooks/usePageTracking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AA4B7C,SAAS,eAAe,CACtB,IAAwB,EACxB,UAAmC;IAEnC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAA;IAC9C,MAAM,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAClE,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,CAAA;IACxC,aAAa,CAAC,OAAO,GAAG,UAAU,CAAA;IAElC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI;YAAE,OAAM;QACnC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IACnC,CAAC,EAAE,CAAC,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC,CAAA;AAChD,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcl/hooks",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "type": "module",
   "main": "esm/index.js",
   "module": "esm/index.js",
@@ -80,5 +80,5 @@
       "<rootDir>/test/setup.ts"
     ]
   },
-  "commit": "f13404fa4a4a9988fcc805b9fe95ee583025eec5"
+  "commit": "f4045d834438209730ba9ffdafe2d1f80bff29bb"
 }