@chipmobilesdk/rn-ads 0.4.0 → 0.5.1

package/src/react/hooks.ts

@@ -1,75 +1,75 @@
-/**
- * React bindings (US1, FR-027).
- *
- * Each hook subscribes to exactly what it reads. `usePlacementState` subscribes
- * to one placement rather than to the whole event stream, which is what keeps a
- * banner from re-rendering because an unrelated interstitial was clicked —
- * PERF-002's bounded re-render assertion depends on it.
- *
- * None of these hand back an ad object. A consumer queries and subscribes to
- * state; it never holds provider-owned memory (FR-027).
- */
-
-import { useEffect, useState } from 'react';
-
-import type { InitStatus, PlacementState } from '../config/types';
-import type { AdEventListener } from '../diagnostics/events';
-import { useAds } from './AdsProvider';
-
-/** Live state for one placement. `unavailable` outside a provider. */
-export function usePlacementState(placementKey: string): PlacementState {
-	const ads = useAds();
-	const [state, setState] = useState<PlacementState>(() =>
-		ads ? ads.getPlacementState(placementKey) : 'unavailable',
-	);
-
-	useEffect(() => {
-		if (!ads) {
-			setState('unavailable');
-			return;
-		}
-		// Re-read on subscribe: the state may have moved between the initial
-		// render and this effect, and dropping that transition would leave the
-		// UI showing a state the instance has already left.
-		setState(ads.getPlacementState(placementKey));
-		return ads.subscribePlacement(placementKey, setState);
-	}, [ads, placementKey]);
-
-	return state;
-}
-
-/** Live initialization status. `unavailable` outside a provider. */
-export function useAdsStatus(): InitStatus {
-	const ads = useAds();
-	const [status, setStatus] = useState<InitStatus>(() => (ads ? ads.getStatus() : 'unavailable'));
-
-	useEffect(() => {
-		if (!ads) {
-			setStatus('unavailable');
-			return;
-		}
-		setStatus(ads.getStatus());
-		return ads.subscribeStatus(setStatus);
-	}, [ads]);
-
-	return status;
-}
-
-/**
- * Forwards every event to a listener without causing a render.
- *
- * Deliberately does not accumulate events into state: a package that kept an
- * event log would be persisting exactly the kind of history it promises not to
- * (FR-021), and re-rendering on every impression would defeat PERF-002. A screen
- * that wants a visible log keeps its own.
- */
-export function useAdsEvents(listener: AdEventListener): void {
-	const ads = useAds();
-
-	useEffect(() => {
-		if (!ads) {
-			return;
-		}
-		return ads.subscribeEvents(listener);
-	}, [ads, listener]);
-}
+/**
+ * React bindings (US1, FR-027).
+ *
+ * Each hook subscribes to exactly what it reads. `usePlacementState` subscribes
+ * to one placement rather than to the whole event stream, which is what keeps a
+ * banner from re-rendering because an unrelated interstitial was clicked —
+ * PERF-002's bounded re-render assertion depends on it.
+ *
+ * None of these hand back an ad object. A consumer queries and subscribes to
+ * state; it never holds provider-owned memory (FR-027).
+ */
+
+import { useEffect, useState } from 'react';
+
+import type { InitStatus, PlacementState } from '../config/types';
+import type { AdEventListener } from '../diagnostics/events';
+import { useAds } from './AdsProvider';
+
+/** Live state for one placement. `unavailable` outside a provider. */
+export function usePlacementState(placementKey: string): PlacementState {
+	const ads = useAds();
+	const [state, setState] = useState<PlacementState>(() =>
+		ads ? ads.getPlacementState(placementKey) : 'unavailable',
+	);
+
+	useEffect(() => {
+		if (!ads) {
+			setState('unavailable');
+			return;
+		}
+		// Re-read on subscribe: the state may have moved between the initial
+		// render and this effect, and dropping that transition would leave the
+		// UI showing a state the instance has already left.
+		setState(ads.getPlacementState(placementKey));
+		return ads.subscribePlacement(placementKey, setState);
+	}, [ads, placementKey]);
+
+	return state;
+}
+
+/** Live initialization status. `unavailable` outside a provider. */
+export function useAdsStatus(): InitStatus {
+	const ads = useAds();
+	const [status, setStatus] = useState<InitStatus>(() => (ads ? ads.getStatus() : 'unavailable'));
+
+	useEffect(() => {
+		if (!ads) {
+			setStatus('unavailable');
+			return;
+		}
+		setStatus(ads.getStatus());
+		return ads.subscribeStatus(setStatus);
+	}, [ads]);
+
+	return status;
+}
+
+/**
+ * Forwards every event to a listener without causing a render.
+ *
+ * Deliberately does not accumulate events into state: a package that kept an
+ * event log would be persisting exactly the kind of history it promises not to
+ * (FR-021), and re-rendering on every impression would defeat PERF-002. A screen
+ * that wants a visible log keeps its own.
+ */
+export function useAdsEvents(listener: AdEventListener): void {
+	const ads = useAds();
+
+	useEffect(() => {
+		if (!ads) {
+			return;
+		}
+		return ads.subscribeEvents(listener);
+	}, [ads, listener]);
+}