@inspira-npm/events-react 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 
-import { AdClickProps, AdClickProps as AdClickProps$1, BrowserEventName, CLICK_ID_PARAM, CONSENT_CHANGE_EVENT, ConsentState, DEFAULT_CONSENT_COOKIE, EventName, EventProps, EventProps as EventProps$1, ImpressionEventName, ImpressionEventName as ImpressionEventName$1, ImpressionOptions, ImpressionOptions as ImpressionOptions$1, Tracker, Tracker as Tracker$1, TrackerConfig, cookieConsent, createNoopTracker, createTracker, isClickId, parseConsentValue, readClickIdFromUrl, withClickId } from "@inspira-npm/events";
+import { AdClickProps, AdClickProps as AdClickProps$1, BrowserEventName, CLICK_ID_PARAM, CONSENT_CHANGE_EVENT, ClickRecordOptions, ConsentState, DEFAULT_CONSENT_COOKIE, EventName, EventProps, EventProps as EventProps$1, ImpressionEventName, ImpressionEventName as ImpressionEventName$1, ImpressionOptions, ImpressionOptions as ImpressionOptions$1, OutboundClickProps, OutboundClickProps as OutboundClickProps$1, Tracker, Tracker as Tracker$1, TrackerConfig, cookieConsent, createNoopTracker, createTracker, isClickId, parseConsentValue, readClickIdFromUrl, withClickId, withTrackingParams } from "@inspira-npm/events";
 import { ReactElement, ReactNode } from "react";
 interface EventsProviderProps {
   /** Tracker creado con `createTracker` (a nivel de módulo, para que no cambie entre renders). */
@@ -41,4 +41,14 @@ export declare function useClickIdCapture(): void;
  * `props` y `options` pueden ser literales nuevos en cada render: se comparan por valor.
  */
 export declare function useImpression<N extends ImpressionEventName$1>(name: N, props: EventProps$1<N>, options?: ImpressionOptions$1): (el: Element | null) => void;
-export { type AdClickEvent, type AdClickHandlers, type AdClickProps, type BrowserEventName, CLICK_ID_PARAM, CONSENT_CHANGE_EVENT, type ConsentState, DEFAULT_CONSENT_COOKIE, type EventName, type EventProps, type EventsProviderProps, type ImpressionEventName, type ImpressionOptions, type Tracker, type TrackerConfig, cookieConsent, createNoopTracker, createTracker, isClickId, parseConsentValue, readClickIdFromUrl, withClickId };
+/** Mismo contrato que en `useAdClick`. */
+type OutboundClickEvent = AdClickEvent;
+type OutboundClickHandlers = AdClickHandlers;
+/**
+ * Props para el `<a>` de un link o CTA medido hacia otro sitio o página (p. ej. el CTA de una
+ * landing que lleva al sitio principal): `<a {...useOutboundClick(props, url)}>`. Igual que
+ * `useAdClick`: el `href` del render es la URL tal cual y al hacer click registra
+ * `outbound_click` y reescribe el `href` con `?ipc=` antes de que el navegador navegue.
+ */
+export declare function useOutboundClick(props: OutboundClickProps$1, url: string): OutboundClickHandlers;
+export { type AdClickEvent, type AdClickHandlers, type AdClickProps, type BrowserEventName, CLICK_ID_PARAM, CONSENT_CHANGE_EVENT, type ClickRecordOptions, type ConsentState, DEFAULT_CONSENT_COOKIE, type EventName, type EventProps, type EventsProviderProps, type ImpressionEventName, type ImpressionOptions, type OutboundClickEvent, type OutboundClickHandlers, type OutboundClickProps, type Tracker, type TrackerConfig, cookieConsent, createNoopTracker, createTracker, isClickId, parseConsentValue, readClickIdFromUrl, withClickId, withTrackingParams };

package/dist/index.js

@@ -1,5 +1,5 @@
 "use client";
-import { CLICK_ID_PARAM, CONSENT_CHANGE_EVENT, DEFAULT_CONSENT_COOKIE, cookieConsent, createNoopTracker, createNoopTracker as createNoopTracker$1, createTracker, isClickId, parseConsentValue, readClickIdFromUrl, withClickId } from "@inspira-npm/events";
+import { CLICK_ID_PARAM, CONSENT_CHANGE_EVENT, DEFAULT_CONSENT_COOKIE, cookieConsent, createNoopTracker, createNoopTracker as createNoopTracker$1, createTracker, isClickId, parseConsentValue, readClickIdFromUrl, withClickId, withTrackingParams } from "@inspira-npm/events";
 import { createContext, createElement, useCallback, useContext, useEffect, useMemo, useRef } from "react";
 // src/provider.ts
 const TrackerContext = createContext(null);
@@ -33,22 +33,24 @@ function useTrack() {
 	const tracker = useTracker();
 	return useCallback((name, props) => tracker.track(name, props), [tracker]);
 }
-// src/use-ad-click.ts
+// src/tracked-link.ts
 /**
-* Props para el `<a>` de un ad: `<a {...useAdClick(props, url)}>`. Al hacer click registra
-* `ad_click` y cambia el `href` del ancla a la URL con `?ipc=` antes de que el navegador navegue.
+* Base de `useAdClick` y `useOutboundClick`: en cada click llama a `trackClick` (que registra el
+* evento y devuelve la URL con `?ipc=`) y reescribe el `href` del `<a>` antes de que el navegador
+* navegue. `trackClick` debe ser estable (una función de módulo).
 */
-function useAdClick(props, url) {
+function useTrackedLink(props, url, trackClick) {
 	const tracker = useTracker();
 	const propsKey = JSON.stringify(props);
 	const onClick = useCallback((event) => {
-		const href = tracker.trackAdClick(JSON.parse(propsKey), url);
+		const href = trackClick(tracker, JSON.parse(propsKey), url);
 		const target = event.currentTarget;
 		if (typeof HTMLAnchorElement !== "undefined" && target instanceof HTMLAnchorElement) target.href = href;
 	}, [
 		tracker,
 		propsKey,
-		url
+		url,
+		trackClick
 	]);
 	const onAuxClick = useCallback((event) => {
 		if (event.button !== void 0 && event.button !== 1) return;
@@ -64,6 +66,15 @@ function useAdClick(props, url) {
 		onAuxClick
 	]);
 }
+// src/use-ad-click.ts
+const trackAdClick = (tracker, props, url) => tracker.trackAdClick(props, url);
+/**
+* Props para el `<a>` de un ad: `<a {...useAdClick(props, url)}>`. Al hacer click registra
+* `ad_click` y cambia el `href` del ancla a la URL con `?ipc=` antes de que el navegador navegue.
+*/
+function useAdClick(props, url) {
+	return useTrackedLink(props, url, trackAdClick);
+}
 // src/use-click-id-capture.ts
 /**
 * En el sitio destino de un ad: guarda el `?ipc=` de la URL para atribuir la conversión.
@@ -99,4 +110,15 @@ function useImpression(name, props, options) {
 		optionsKey
 	]);
 }
-export { CLICK_ID_PARAM, CONSENT_CHANGE_EVENT, DEFAULT_CONSENT_COOKIE, EventsProvider, cookieConsent, createNoopTracker, createTracker, isClickId, parseConsentValue, readClickIdFromUrl, useAdClick, useClickIdCapture, useImpression, useTrack, useTracker, withClickId };
+// src/use-outbound-click.ts
+const trackOutboundClick = (tracker, props, url) => tracker.trackOutboundClick(props, url);
+/**
+* Props para el `<a>` de un link o CTA medido hacia otro sitio o página (p. ej. el CTA de una
+* landing que lleva al sitio principal): `<a {...useOutboundClick(props, url)}>`. Igual que
+* `useAdClick`: el `href` del render es la URL tal cual y al hacer click registra
+* `outbound_click` y reescribe el `href` con `?ipc=` antes de que el navegador navegue.
+*/
+function useOutboundClick(props, url) {
+	return useTrackedLink(props, url, trackOutboundClick);
+}
+export { CLICK_ID_PARAM, CONSENT_CHANGE_EVENT, DEFAULT_CONSENT_COOKIE, EventsProvider, cookieConsent, createNoopTracker, createTracker, isClickId, parseConsentValue, readClickIdFromUrl, useAdClick, useClickIdCapture, useImpression, useOutboundClick, useTrack, useTracker, withClickId, withTrackingParams };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inspira-npm/events-react",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Provider y hooks de React para @inspira-npm/events.",
   "license": "UNLICENSED",
   "type": "module",
@@ -24,7 +24,7 @@
     "prepublishOnly": "npm run typecheck && npm run test && npm run build"
   },
   "dependencies": {
-    "@inspira-npm/events": "^0.1.0"
+    "@inspira-npm/events": "^0.3.0"
   },
   "peerDependencies": {
     "react": ">=18"