@chipmobilesdk/rn-ads 0.6.0 → 0.8.0

package/lib/module/react/AdsBanner.js

@@ -0,0 +1,312 @@
+"use strict";
+
+/**
+ * Adaptive banner host (FR-038 – FR-042).
+ *
+ * The app puts this where it wants a banner. The component never inserts itself
+ * into the tree, never overlays app content, and ships no placeholder — the
+ * surrounding layout, and any loading or fallback presentation, belong to the
+ * app and its theme (FR-040, UX-001).
+ *
+ * When ads are disabled or unavailable it renders `null` rather than a
+ * zero-height view. That is not a micro-optimization: a rendered empty view
+ * still sits in the accessibility tree and can take screen-reader focus ahead of
+ * real content. `null` leaves the tree entirely (UX-003).
+ *
+ * The provider owns the banner's whole lifecycle through its own component, so
+ * this adapts those callbacks into the normalized event model instead of routing
+ * a banner through the load/show handle model, which does not fit it.
+ */
+
+import React, { useCallback, useEffect, useId, useMemo, useRef, useState } from 'react';
+import { View } from 'react-native';
+import { normalizeProviderError } from "../diagnostics/errors.js";
+import { useAds } from "./AdsProvider.js";
+import { getInternals } from "../core/adsInstance.js";
+import { useAdsStatus } from "./hooks.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+export function AdsBanner({
+  placementKey,
+  onStateChange,
+  style
+}) {
+  const ads = useAds();
+  // The instance's banner wiring (ADS-13). An instance the app wrote by hand has
+  // none, and is treated like a missing one.
+  const internals = useMemo(() => ads ? getInternals(ads) : null, [ads]);
+  // The throttle token for this mount: stable across renders and minted by React
+  // rather than by a counter, so a render that runs twice charges one slot.
+  const mountToken = useId();
+  // The reported state lives in a ref rather than in component state: the host
+  // itself renders the same tree for every state, so storing it would only
+  // force re-renders the PERF-002 budget does not need to spend. The instance
+  // holds the authoritative value; `onStateChange` tells the app.
+  const stateRef = useRef('idle');
+  const [containerWidth, setContainerWidth] = useState(0);
+  // A new cycle id remounts the provider component, which is how a width change
+  // produces a genuinely re-adapted banner rather than a stretched old one.
+  const [cycle, setCycle] = useState(0);
+  const correlationRef = useRef(null);
+  // Whether the current correlation already reported `loaded`. The provider
+  // auto-refreshes a banner inside one mount; each refresh is a new cycle.
+  const loadedInCycleRef = useRef(false);
+  const startedAtRef = useRef(0);
+  // Whether this mount has already taken a throttle slot, and the refusal if it
+  // was refused. Resets with the mount, which is exactly the granularity FR-140
+  // needs.
+  const throttleRef = useRef({
+    decided: false,
+    refusal: null
+  });
+  // Which attempt this mount is on. A refused mount asks again once the window
+  // passes (ADS-06), and each attempt needs its own token: the throttle replays
+  // the stored verdict for a token it has seen.
+  const throttleAttemptRef = useRef(0);
+
+  // The engine's banner component (ADS-12): the host never names the provider.
+  const banner = useMemo(() => internals?.banner() ?? null, [internals]);
+  // Initialization is asynchronous and a banner is almost always mounted before
+  // it finishes. Without this the resolution below would be computed once, while
+  // the instance was still `not_started`, be refused, and never be retried — the
+  // banner would sit at `unavailable` forever on a perfectly healthy app.
+  const status = useAdsStatus();
+
+  // Keyed on `cycle` so a genuine width change starts a new, separately traceable
+  // load (FR-038, FR-052), and on `status` so the banner recovers the moment the
+  // instance becomes able to request. Pure: the cycle's correlation id is minted
+  // in the effect that starts it, not here (ADS-20).
+  const resolved = useMemo(() => internals && status === 'ready' ? {
+    cycle,
+    value: internals.resolveBanner(placementKey)
+  } : null, [internals, placementKey, cycle, status]);
+  const resolution = resolved?.value ?? null;
+  const move = useCallback(next => {
+    if (stateRef.current === next) {
+      return;
+    }
+    stateRef.current = next;
+    internals?.setPlacementState(placementKey, next);
+    onStateChange?.(next);
+  }, [internals, onStateChange, placementKey]);
+
+  // FR-140. Decided **during render**, not in the effect below, because the
+  // provider component requests an ad as part of this very render — an effect
+  // would refuse a request that had already gone out.
+  //
+  // Charged once per mount, guarded by the ref. That granularity is the whole
+  // distinction the throttle turns on: a fresh mount is the navigation burst it
+  // exists to stop (swiping between days, switching tabs, a row scrolling in and
+  // out), while a later cycle in the *same* mount is a width re-adaptation —
+  // rotation — which must not be refused or a rotated screen loses its banner
+  // for up to a minute.
+  if (internals && resolution?.ok && containerWidth > 0 && !throttleRef.current.decided) {
+    throttleRef.current = {
+      decided: true,
+      refusal: internals.commitBannerRequest(placementKey, `${mountToken}:${throttleAttemptRef.current}`)
+    };
+  }
+  const throttleRefusal = throttleRef.current.refusal;
+  const usable = Boolean(internals && banner && resolution?.ok && containerWidth > 0 && !throttleRefusal);
+  useEffect(() => {
+    if (!internals || !banner) {
+      move('unavailable');
+      return;
+    }
+    // `not_started` and `initializing` are transient: the app is still on its
+    // way and the banner will resolve shortly, so report `idle` rather than
+    // `unavailable` and let the app keep its layout decision open. Every other
+    // non-ready status — disabled, blocked, failed, unsupported — means there
+    // will be no ad, and the app should reclaim the space (FR-039, FR-042).
+    //
+    // `undecided` is the exception added in 0.2.0, and it is the entire reason
+    // the third state exists. It is reported as itself rather than folded into
+    // either neighbour: `idle` would say "an ad is coming", which is not known
+    // yet, and `unavailable` would say "there will be none", which is also not
+    // known. Only by reporting it honestly can the app decide whether to hold
+    // the space — the choice that keeps a paying user from watching an ad
+    // flash in and out (FR-116).
+    if (status !== 'ready') {
+      move(status === 'undecided' ? 'undecided' : status === 'not_started' || status === 'initializing' ? 'idle' : 'unavailable');
+      return;
+    }
+    if (!resolution?.ok) {
+      move('unavailable');
+      return;
+    }
+    if (containerWidth <= 0) {
+      // FR-039: a zero-width container is reported rather than turned into a
+      // request for an ad at a nonsensical size.
+      move('idle');
+      return;
+    }
+    // The slot was taken during render; here is where the refusal becomes
+    // observable. Reported as `throttled` rather than folded into
+    // `unavailable`: that would say "there will be no ad here", when in fact
+    // this placement asked too recently and will work again shortly. Most apps
+    // collapse the space for both, but only one is worth investigating.
+    if (throttleRefusal) {
+      move('throttled');
+      internals.emit({
+        type: 'request_throttled',
+        timestamp: internals.now(),
+        placementKey,
+        format: 'banner',
+        retryAfterMs: throttleRefusal.retryAfterMs,
+        minRequestIntervalMs: internals.throttleFloorFor(placementKey)
+      });
+      // ADS-06: ask again in this same mount once the window has passed. Until
+      // 0.7.0 a refused banner stayed empty until it was remounted, so a banner
+      // pinned to a screen the user returned to within a minute never filled.
+      return internals.schedule(throttleRefusal.retryAfterMs, () => {
+        throttleRef.current = {
+          decided: false,
+          refusal: null
+        };
+        throttleAttemptRef.current += 1;
+        setCycle(value => value + 1);
+      });
+    }
+    const correlationId = internals.nextCorrelationId();
+    correlationRef.current = correlationId;
+    loadedInCycleRef.current = false;
+    startedAtRef.current = internals.now();
+    move('loading');
+    internals.emit({
+      type: 'load_started',
+      timestamp: startedAtRef.current,
+      placementKey,
+      format: 'banner',
+      correlationId
+    });
+    // Deliberately keyed on `cycle`, not on every render: FR-041 forbids a
+    // re-render from producing a second uncontrolled request.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [internals, banner, status, resolution, containerWidth, cycle]);
+  const onLayout = useCallback(event => {
+    const width = Math.round(event.nativeEvent.layout.width);
+    setContainerWidth(previous => {
+      if (previous === width) {
+        return previous;
+      }
+      // FR-038: a genuine width or orientation change re-adapts. The
+      // rounding above stops sub-pixel layout jitter from doing so.
+      if (previous > 0 && width > 0) {
+        setCycle(value => value + 1);
+      }
+      return width;
+    });
+  }, []);
+  const emit = useCallback(event => {
+    internals?.emit(event);
+  }, [internals]);
+  const clock = useCallback(() => internals?.now() ?? Date.now(), [internals]);
+  const handleLoaded = useCallback(() => {
+    // A second load in one correlation is the provider's auto-refresh: a new
+    // ad, so a new cycle. Under the old correlation its `loaded` and
+    // `impression` were deduplicated away and revenue went uncounted (ADS-05).
+    // For a refresh, `durationMs` is the time since the previous load.
+    if (loadedInCycleRef.current && internals) {
+      correlationRef.current = internals.nextCorrelationId();
+    }
+    loadedInCycleRef.current = true;
+    const loadedAt = clock();
+    move('ready');
+    emit({
+      type: 'loaded',
+      timestamp: loadedAt,
+      placementKey,
+      format: 'banner',
+      correlationId: correlationRef.current ?? undefined,
+      durationMs: loadedAt - startedAtRef.current
+    });
+    startedAtRef.current = loadedAt;
+  }, [internals, clock, emit, move, placementKey]);
+  const handleFailed = useCallback((error, kind) => {
+    const normalized = normalizeProviderError(error, {
+      operation: 'load',
+      placementKey,
+      format: 'banner'
+    }, kind);
+    move('failed');
+    emit({
+      type: 'load_failed',
+      timestamp: clock(),
+      placementKey,
+      format: 'banner',
+      correlationId: correlationRef.current ?? undefined,
+      error: normalized
+    });
+  }, [clock, emit, move, placementKey]);
+  const handleImpression = useCallback(() => {
+    emit({
+      type: 'impression',
+      timestamp: clock(),
+      placementKey,
+      format: 'banner',
+      correlationId: correlationRef.current ?? undefined,
+      // A real provider impression, unlike the derived one full-screen
+      // formats get. The distinction is load-bearing for revenue
+      // reconciliation, so it is recorded rather than flattened (R5).
+      source: 'provider'
+    });
+  }, [clock, emit, placementKey]);
+  const handleClicked = useCallback(() => {
+    emit({
+      type: 'click',
+      timestamp: clock(),
+      placementKey,
+      format: 'banner',
+      correlationId: correlationRef.current ?? undefined
+    });
+  }, [clock, emit, placementKey]);
+
+  // FR-041: nothing survives unmount. No retained native view, no dangling
+  // correlation, no state written into a disposed instance.
+  useEffect(() => {
+    return () => {
+      correlationRef.current = null;
+    };
+  }, []);
+  if (!internals || !banner) {
+    // FR-042, UX-003 — out of the tree entirely, blocking no touch.
+    return null;
+  }
+
+  // A terminal non-ready status means there will be no ad at all, so leave the
+  // tree rather than render an empty host. `not_started` and `initializing` are
+  // excluded on purpose: the host must stay mounted through them, because it is
+  // what measures the container and starts the load once the instance is ready.
+  //
+  // `undecided` is excluded for the same reason: the app may still resolve it to
+  // enabled, and a host that unmounted would have to re-measure the container
+  // from scratch when it did. It renders no ad meanwhile — it renders the same
+  // empty measuring host it renders while initializing — and it reports
+  // `undecided` so the app can size the space it decided to keep.
+  if (status === 'disabled' || status === 'unavailable' || status === 'failed') {
+    return null;
+  }
+  if (resolution && !resolution.ok) {
+    const refusal = resolution.result;
+    // `undecided` deliberately absent: unlike `disabled`, it is not a settled
+    // no, so the host stays mounted (FR-116).
+    if (refusal.status === 'disabled' || refusal.status === 'unavailable') {
+      return null;
+    }
+  }
+  const BannerComponent = banner.Component;
+  const adUnitId = resolution?.ok ? resolution.adUnitId : null;
+  return /*#__PURE__*/_jsx(View, {
+    style: style,
+    onLayout: onLayout,
+    testID: `ads-banner-${placementKey}`,
+    children: usable && adUnitId && resolution?.ok ? /*#__PURE__*/_jsx(BannerComponent, {
+      adUnitId: adUnitId,
+      personalizedAds: resolution.personalizedAds,
+      onLoaded: handleLoaded,
+      onFailed: handleFailed,
+      onImpression: handleImpression,
+      onClicked: handleClicked
+    }, `${placementKey}-${cycle}`) : null
+  });
+}
+//# sourceMappingURL=AdsBanner.js.map

package/lib/module/react/AdsBanner.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","useCallback","useEffect","useId","useMemo","useRef","useState","View","normalizeProviderError","useAds","getInternals","useAdsStatus","jsx","_jsx","AdsBanner","placementKey","onStateChange","style","ads","internals","mountToken","stateRef","containerWidth","setContainerWidth","cycle","setCycle","correlationRef","loadedInCycleRef","startedAtRef","throttleRef","decided","refusal","throttleAttemptRef","banner","status","resolved","value","resolveBanner","resolution","move","next","current","setPlacementState","ok","commitBannerRequest","throttleRefusal","usable","Boolean","emit","type","timestamp","now","format","retryAfterMs","minRequestIntervalMs","throttleFloorFor","schedule","correlationId","nextCorrelationId","onLayout","event","width","Math","round","nativeEvent","layout","previous","clock","Date","handleLoaded","loadedAt","undefined","durationMs","handleFailed","error","kind","normalized","operation","handleImpression","source","handleClicked","result","BannerComponent","Component","adUnitId","testID","children","personalizedAds","onLoaded","onFailed","onImpression","onClicked"],"sourceRoot":"../../../src","sources":["react/AdsBanner.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/react/AdsProvider.js

@@ -0,0 +1,48 @@
+"use strict";
+
+/**
+ * Instance context (US1).
+ *
+ * Supplies one `AdsInstance` to the tree so `AdsBanner` and the hooks can reach
+ * it without every screen threading it through props.
+ *
+ * The provider does not create the instance. The app does, and passes it in —
+ * because `createAds` throws on a misconfigured catalog (FR-008, FR-012), and a
+ * throw during render is a far worse place to discover that than a throw at
+ * startup where the app can decide what to do about it.
+ */
+
+import { appLifecycle } from '@chipmobilesdk/rn-core';
+import React, { createContext, useContext, useEffect } from 'react';
+import { jsx as _jsx } from "react/jsx-runtime";
+const AdsContext = /*#__PURE__*/createContext(null);
+export function AdsProvider({
+  instance,
+  trackAppState = true,
+  children
+}) {
+  useEffect(() => {
+    if (!trackAppState) {
+      return;
+    }
+    return appLifecycle().subscribe(state => {
+      instance.setAppActive(state === 'active');
+    });
+  }, [instance, trackAppState]);
+  return /*#__PURE__*/_jsx(AdsContext.Provider, {
+    value: instance,
+    children: children
+  });
+}
+
+/**
+ * Returns the instance, or null outside a provider.
+ *
+ * Null rather than a throw on purpose: a screen that renders a banner should
+ * degrade to rendering nothing when ads are not wired up, not take the screen
+ * down with it (NFR-005).
+ */
+export function useAds() {
+  return useContext(AdsContext);
+}
+//# sourceMappingURL=AdsProvider.js.map

package/lib/module/react/AdsProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["appLifecycle","React","createContext","useContext","useEffect","jsx","_jsx","AdsContext","AdsProvider","instance","trackAppState","children","subscribe","state","setAppActive","Provider","value","useAds"],"sourceRoot":"../../../src","sources":["react/AdsProvider.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,YAAY,QAAQ,wBAAwB;AACrD,OAAOC,KAAK,IAAIC,aAAa,EAAEC,UAAU,EAAEC,SAAS,QAAwB,OAAO;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAIpF,MAAMC,UAAU,gBAAGL,aAAa,CAAqB,IAAI,CAAC;AAgB1D,OAAO,SAASM,WAAWA,CAAC;EAAEC,QAAQ;EAAEC,aAAa,GAAG,IAAI;EAAEC;AAA2B,CAAC,EAAE;EAC3FP,SAAS,CAAC,MAAM;IACf,IAAI,CAACM,aAAa,EAAE;MACnB;IACD;IACA,OAAOV,YAAY,CAAC,CAAC,CAACY,SAAS,CAACC,KAAK,IAAI;MACxCJ,QAAQ,CAACK,YAAY,CAACD,KAAK,KAAK,QAAQ,CAAC;IAC1C,CAAC,CAAC;EACH,CAAC,EAAE,CAACJ,QAAQ,EAAEC,aAAa,CAAC,CAAC;EAE7B,oBAAOJ,IAAA,CAACC,UAAU,CAACQ,QAAQ;IAACC,KAAK,EAAEP,QAAS;IAAAE,QAAA,EAAEA;EAAQ,CAAsB,CAAC;AAC9E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASM,MAAMA,CAAA,EAAuB;EAC5C,OAAOd,UAAU,CAACI,UAAU,CAAC;AAC9B","ignoreList":[]}

package/lib/module/react/hooks.js

@@ -0,0 +1,58 @@
+"use strict";
+
+/**
+ * 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 { useExternalStore, useLatestCallback } from '@chipmobilesdk/rn-core/react';
+import { useCallback, useEffect } from 'react';
+import { useAds } from "./AdsProvider.js";
+
+/** Live state for one placement. `unavailable` outside a provider. */
+export function usePlacementState(placementKey) {
+  const ads = useAds();
+  const subscribe = useCallback(listener => ads ? ads.subscribePlacement(placementKey, listener) : NO_SUBSCRIPTION, [ads, placementKey]);
+  const getSnapshot = useCallback(() => ads ? ads.getPlacementState(placementKey) : 'unavailable', [ads, placementKey]);
+  // useSyncExternalStore: tear-free, and no transition lost between render and
+  // subscription, which the useState copy had to re-read to avoid.
+  return useExternalStore(subscribe, getSnapshot);
+}
+
+/** Live initialization status. `unavailable` outside a provider. */
+export function useAdsStatus() {
+  const ads = useAds();
+  const subscribe = useCallback(listener => ads ? ads.subscribeStatus(listener) : NO_SUBSCRIPTION, [ads]);
+  const getSnapshot = useCallback(() => ads ? ads.getStatus() : 'unavailable', [ads]);
+  return useExternalStore(subscribe, getSnapshot);
+}
+const NO_SUBSCRIPTION = () => undefined;
+
+/**
+ * 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) {
+  const ads = useAds();
+  // An inline listener is a new function every render; subscribing through the
+  // latest one keeps a single subscription per instance (PERF-13).
+  const latest = useLatestCallback(listener);
+  useEffect(() => {
+    if (!ads) {
+      return;
+    }
+    return ads.subscribeEvents(latest);
+  }, [ads, latest]);
+}
+//# sourceMappingURL=hooks.js.map

package/lib/module/react/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useExternalStore","useLatestCallback","useCallback","useEffect","useAds","usePlacementState","placementKey","ads","subscribe","listener","subscribePlacement","NO_SUBSCRIPTION","getSnapshot","getPlacementState","useAdsStatus","subscribeStatus","getStatus","undefined","useAdsEvents","latest","subscribeEvents"],"sourceRoot":"../../../src","sources":["react/hooks.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,gBAAgB,EAAEC,iBAAiB,QAAQ,8BAA8B;AAClF,SAASC,WAAW,EAAEC,SAAS,QAAQ,OAAO;AAI9C,SAASC,MAAM,QAAQ,kBAAe;;AAEtC;AACA,OAAO,SAASC,iBAAiBA,CAACC,YAAoB,EAAkB;EACvE,MAAMC,GAAG,GAAGH,MAAM,CAAC,CAAC;EACpB,MAAMI,SAAS,GAAGN,WAAW,CAC3BO,QAAoB,IACpBF,GAAG,GAAGA,GAAG,CAACG,kBAAkB,CAACJ,YAAY,EAAEG,QAAQ,CAAC,GAAGE,eAAe,EACvE,CAACJ,GAAG,EAAED,YAAY,CACnB,CAAC;EACD,MAAMM,WAAW,GAAGV,WAAW,CAC9B,MAAuBK,GAAG,GAAGA,GAAG,CAACM,iBAAiB,CAACP,YAAY,CAAC,GAAG,aAAc,EACjF,CAACC,GAAG,EAAED,YAAY,CACnB,CAAC;EACD;EACA;EACA,OAAON,gBAAgB,CAACQ,SAAS,EAAEI,WAAW,CAAC;AAChD;;AAEA;AACA,OAAO,SAASE,YAAYA,CAAA,EAAe;EAC1C,MAAMP,GAAG,GAAGH,MAAM,CAAC,CAAC;EACpB,MAAMI,SAAS,GAAGN,WAAW,CAC3BO,QAAoB,IAAMF,GAAG,GAAGA,GAAG,CAACQ,eAAe,CAACN,QAAQ,CAAC,GAAGE,eAAgB,EACjF,CAACJ,GAAG,CACL,CAAC;EACD,MAAMK,WAAW,GAAGV,WAAW,CAAC,MAAmBK,GAAG,GAAGA,GAAG,CAACS,SAAS,CAAC,CAAC,GAAG,aAAc,EAAE,CAACT,GAAG,CAAC,CAAC;EACjG,OAAOP,gBAAgB,CAACQ,SAAS,EAAEI,WAAW,CAAC;AAChD;AAEA,MAAMD,eAAe,GAAGA,CAAA,KAAYM,SAAS;;AAE7C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAACT,QAAyB,EAAQ;EAC7D,MAAMF,GAAG,GAAGH,MAAM,CAAC,CAAC;EACpB;EACA;EACA,MAAMe,MAAM,GAAGlB,iBAAiB,CAACQ,QAAQ,CAAC;EAE1CN,SAAS,CAAC,MAAM;IACf,IAAI,CAACI,GAAG,EAAE;MACT;IACD;IACA,OAAOA,GAAG,CAACa,eAAe,CAACD,MAAM,CAAC;EACnC,CAAC,EAAE,CAACZ,GAAG,EAAEY,MAAM,CAAC,CAAC;AAClB","ignoreList":[]}

package/lib/module/testing/clock.js

@@ -0,0 +1,72 @@
+"use strict";
+
+/**
+ * A clock the test drives (ADS-11).
+ *
+ * Every bounded wait in this package — retry backoff, the request throttle, a
+ * consent form that never answers — is measured against a clock. Injecting this
+ * one is what lets a suite assert the behaviour at the boundary instead of
+ * sleeping and hoping.
+ */
+
+/**
+ * A clock a test can move by hand.
+ *
+ * Retry backoff, app-open expiry, the undecided-state warning, and the
+ * ad-originated-return windows are all time-dependent, and all four must be
+ * assertable exactly rather than approximately. Advancing a clock makes "two
+ * retries, 2s then 4s" a precise assertion; sleeping would make it a flaky one.
+ *
+ * Callbacks fire in due order, and a callback scheduled *during* an advance is
+ * honored within the same advance if its deadline has also passed — matching how
+ * real timers behave when work chains.
+ */
+
+export function createTestClock(startMs = 1_000_000) {
+  let current = startMs;
+  let sequence = 0;
+  const timers = new Map();
+  const scheduler = {
+    setTimeout(callback, ms) {
+      sequence += 1;
+      timers.set(sequence, {
+        at: current + ms,
+        callback
+      });
+      return sequence;
+    },
+    clearTimeout(handle) {
+      timers.delete(handle);
+    }
+  };
+  return {
+    now: () => current,
+    advance(ms) {
+      const target = current + ms;
+      // Loop rather than iterate once: a fired callback may schedule another
+      // timer that is also due before `target`, which is exactly what a retry
+      // chain does.
+      for (;;) {
+        let nextId = null;
+        let nextAt = Number.POSITIVE_INFINITY;
+        for (const [id, timer] of timers) {
+          if (timer.at <= target && timer.at < nextAt) {
+            nextAt = timer.at;
+            nextId = id;
+          }
+        }
+        if (nextId === null) {
+          break;
+        }
+        const timer = timers.get(nextId);
+        timers.delete(nextId);
+        current = timer.at;
+        timer.callback();
+      }
+      current = target;
+    },
+    scheduler,
+    pending: () => timers.size
+  };
+}
+//# sourceMappingURL=clock.js.map

package/lib/module/testing/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createTestClock","startMs","current","sequence","timers","Map","scheduler","setTimeout","callback","ms","set","at","clearTimeout","handle","delete","now","advance","target","nextId","nextAt","Number","POSITIVE_INFINITY","id","timer","get","pending","size"],"sourceRoot":"../../../src","sources":["testing/clock.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA,OAAO,SAASA,eAAeA,CAACC,OAAO,GAAG,SAAS,EAAa;EAC/D,IAAIC,OAAO,GAAGD,OAAO;EACrB,IAAIE,QAAQ,GAAG,CAAC;EAChB,MAAMC,MAAM,GAAG,IAAIC,GAAG,CAA+C,CAAC;EAEtE,MAAMC,SAAoB,GAAG;IAC5BC,UAAUA,CAACC,QAAQ,EAAEC,EAAE,EAAE;MACxBN,QAAQ,IAAI,CAAC;MACbC,MAAM,CAACM,GAAG,CAACP,QAAQ,EAAE;QAAEQ,EAAE,EAAET,OAAO,GAAGO,EAAE;QAAED;MAAS,CAAC,CAAC;MACpD,OAAOL,QAAQ;IAChB,CAAC;IACDS,YAAYA,CAACC,MAAM,EAAE;MACpBT,MAAM,CAACU,MAAM,CAACD,MAAgB,CAAC;IAChC;EACD,CAAC;EAED,OAAO;IACNE,GAAG,EAAEA,CAAA,KAAMb,OAAO;IAClBc,OAAOA,CAACP,EAAE,EAAE;MACX,MAAMQ,MAAM,GAAGf,OAAO,GAAGO,EAAE;MAC3B;MACA;MACA;MACA,SAAS;QACR,IAAIS,MAAqB,GAAG,IAAI;QAChC,IAAIC,MAAM,GAAGC,MAAM,CAACC,iBAAiB;QACrC,KAAK,MAAM,CAACC,EAAE,EAAEC,KAAK,CAAC,IAAInB,MAAM,EAAE;UACjC,IAAImB,KAAK,CAACZ,EAAE,IAAIM,MAAM,IAAIM,KAAK,CAACZ,EAAE,GAAGQ,MAAM,EAAE;YAC5CA,MAAM,GAAGI,KAAK,CAACZ,EAAE;YACjBO,MAAM,GAAGI,EAAE;UACZ;QACD;QACA,IAAIJ,MAAM,KAAK,IAAI,EAAE;UACpB;QACD;QACA,MAAMK,KAAK,GAAGnB,MAAM,CAACoB,GAAG,CAACN,MAAM,CAAE;QACjCd,MAAM,CAACU,MAAM,CAACI,MAAM,CAAC;QACrBhB,OAAO,GAAGqB,KAAK,CAACZ,EAAE;QAClBY,KAAK,CAACf,QAAQ,CAAC,CAAC;MACjB;MACAN,OAAO,GAAGe,MAAM;IACjB,CAAC;IACDX,SAAS;IACTmB,OAAO,EAAEA,CAAA,KAAMrB,MAAM,CAACsB;EACvB,CAAC;AACF","ignoreList":[]}

package/lib/module/testing/conformance.js

@@ -0,0 +1,93 @@
+"use strict";
+
+/**
+ * What any `AdsEngine` must do (IOS-12, ADS-13).
+ *
+ * The same checks run against the fake engine and against the AdMob adapter over
+ * the provider mock (or the real provider, from a demo screen on a device), so a
+ * test that drives the fake proves something about the device path. The subject
+ * says how the provider delivers its callbacks; the checks only use the port.
+ */
+import { ensure, runChecks } from '@chipmobilesdk/rn-core/testing';
+/** Lets callbacks a provider delivers on a later microtask arrive. */
+async function settle() {
+  for (let turn = 0; turn < 3; turn += 1) {
+    await Promise.resolve();
+  }
+}
+export const adsEngineChecks = [{
+  name: 'is available, and initializes with privacy applied',
+  async run(harness) {
+    const {
+      engine
+    } = harness.create();
+    ensure(engine.isAvailable(), 'reported unavailable');
+    await engine.initialize({
+      childDirected: true,
+      maxAdContentRating: 'G'
+    });
+  }
+}, {
+  name: 'delivers loaded to a subscriber of an interstitial, and nothing after unsubscribing',
+  async run(harness) {
+    const subject = harness.create();
+    const handle = await subject.engine.createFullScreen('interstitial', 'conformance/1');
+    ensure(typeof handle.id === 'string' && handle.id !== '', 'handle has no id');
+    const seen = [];
+    const stop = subject.engine.subscribe(handle, event => seen.push(event.type));
+    subject.deliverLoad(handle);
+    await settle();
+    ensure(seen.join(',') === 'loaded', `subscriber saw ${seen.join(',') || 'nothing'}`);
+    stop();
+    stop();
+    subject.deliverDismiss(handle);
+    await settle();
+    ensure(seen.length === 1, `notified after unsubscribing: ${seen.join(',')}`);
+  }
+}, {
+  name: 'delivers the reward and the dismissal of a rewarded ad',
+  async run(harness) {
+    const subject = harness.create();
+    const handle = await subject.engine.createFullScreen('rewarded', 'conformance/2', {
+      personalizedAds: false
+    });
+    const seen = [];
+    subject.engine.subscribe(handle, event => seen.push(event));
+    subject.deliverLoad(handle);
+    await settle();
+    subject.deliverReward(handle, {
+      type: 'coins',
+      amount: 5
+    });
+    subject.deliverDismiss(handle);
+    await settle();
+    const reward = seen.find(event => event.type === 'rewarded');
+    ensure(reward?.type === 'rewarded', `no reward among ${seen.map(e => e.type).join(',')}`);
+    ensure(reward.reward.type === 'coins' && reward.reward.amount === 5, `reward ${JSON.stringify(reward.reward)}`);
+    ensure(seen.at(-1)?.type === 'dismissed', `last event ${seen.at(-1)?.type}`);
+  }
+}, {
+  name: 'gives every ad its own handle',
+  async run(harness) {
+    const {
+      engine
+    } = harness.create();
+    const first = await engine.createFullScreen('interstitial', 'conformance/1');
+    const second = await engine.createFullScreen('interstitial', 'conformance/1');
+    ensure(first.id !== second.id, 'two ads share a handle');
+  }
+}, {
+  name: 'disposes safely twice',
+  async run(harness) {
+    const {
+      engine
+    } = harness.create();
+    const handle = await engine.createFullScreen('interstitial', 'conformance/1');
+    engine.dispose(handle);
+    engine.dispose(handle);
+  }
+}];
+export function runAdsEngineConformance(harness) {
+  return runChecks(() => harness, adsEngineChecks);
+}
+//# sourceMappingURL=conformance.js.map

package/lib/module/testing/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ensure","runChecks","settle","turn","Promise","resolve","adsEngineChecks","name","run","harness","engine","create","isAvailable","initialize","childDirected","maxAdContentRating","subject","handle","createFullScreen","id","seen","stop","subscribe","event","push","type","deliverLoad","join","deliverDismiss","length","personalizedAds","deliverReward","amount","reward","find","map","e","JSON","stringify","at","first","second","dispose","runAdsEngineConformance"],"sourceRoot":"../../../src","sources":["testing/conformance.ts"],"mappings":"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","ignoreList":[]}