@chipmobilesdk/rn-ads 0.7.0 → 0.8.0

package/lib/module/core/instance/context.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createListenerSet","isDevBuild","detectDevBuild","validateConfig","createCorrelationIssuer","AdsError","createEventEmitter","createAdOriginatedTracker","INITIAL_CONSENT","createFullScreenLock","initialInit","initReducer","initialPlacement","placementReducer","createRequestThrottle","createTimerSet","createInstanceContext","config","options","defaultEngine","now","Date","resolved","engine","events","listenerOptions","onListenerError","error","emit","type","timestamp","message","cause","placements","Map","key","keys","set","snapshot","correlationId","dismissed","handle","unsubscribeEngine","inFlightLoad","abortLoad","cancelLoadTimer","cancelShowTimer","rewarded","listeners","retryAttempts","cancelRetry","state","init","enablement","appActive","consent","consentStarted","consentFormsOpen","privacyOptionsFormOpen","providerInitialized","undecidedWarned","cancelUndecidedTimer","appliedPrivacy","currentPrivacy","inFlightInit","disposed","warnedSubstitution","statusListeners","consentListeners","context","correlation","requestThrottle","timers","scheduler","lock","adReturn","placement","runtime","get","definition","setInit","next","previous","status","retryable","notify","setPlacement","changed","dispatchPlacement","event","found","format","setConsent","releasePlacementResources","dispose","emitRefusal","operation","result","placementKey","reason","validityFor","timeouts","appOpenValidity","adValidity"],"sourceRoot":"../../../../src","sources":["core/instance/context.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/instance/gate.js

@@ -0,0 +1,183 @@
+"use strict";
+
+/**
+ * The request gate, evaluated in one place, and closed in one place (FR-140,
+ * ADS-10).
+ *
+ * Every path that closes the gate — ads turned off or undecided, the app's
+ * privacy input withdrawn, the consent flow withdrawn — goes through
+ * `closeGate`. In 0.5.0 each of those paths wrote its own teardown, and the one
+ * that forgot to cancel retries let a request reach the provider after consent
+ * was withdrawn (ADS-02).
+ */
+import { toGateInput } from "../consentFlow.js";
+import { evaluateGates } from "../gates.js";
+import { initReducer } from "../initMachine.js";
+import { evaluateGate } from "../privacyGate.js";
+/**
+ * Assembles the gate's inputs and defers the precedence entirely to
+ * `evaluateGates`: availability, then enablement, then the app's privacy input,
+ * then the consent flow. Nothing else compares gate state.
+ *
+ * The consent flow contributes `null` until the app opts into it, which is what
+ * makes FR-102 structural: with no flow started the gate sees only the app's
+ * own input and behaves exactly as 0.1.0 did.
+ */
+export function currentGate(context) {
+  const {
+    engine,
+    state
+  } = context;
+  const appGate = evaluateGate(state.currentPrivacy);
+  return evaluateGates({
+    available: engine.isAvailable() ? {
+      ok: true
+    } : {
+      ok: false,
+      reason: 'unsupported_platform'
+    },
+    enablement: state.enablement,
+    appGate: appGate.allowed ? {
+      permitted: true
+    } : {
+      permitted: false,
+      reason: appGate.reason
+    },
+    consentGate: state.consentStarted ? toGateInput(state.consent) : null
+  });
+}
+
+/** Maps a closed gate onto the refusal shape load, show, and the banner share. */
+export function refusalFor(decision) {
+  switch (decision.kind) {
+    case 'unavailable':
+      return {
+        status: 'unavailable',
+        reason: decision.reason
+      };
+    case 'disabled':
+      return {
+        status: 'disabled'
+      };
+    case 'undecided':
+      return {
+        status: 'undecided'
+      };
+    default:
+      return {
+        status: 'blocked',
+        reason: decision.reason
+      };
+  }
+}
+
+/** The refusal that applies now, or null when a request may go ahead. */
+export function gateRefusal(context) {
+  const decision = currentGate(context);
+  return decision.allowed ? null : refusalFor(decision);
+}
+
+/** Cancels every pending retry, everywhere (FR-137). */
+export function cancelAllRetries(context) {
+  for (const runtime of context.placements.values()) {
+    runtime.cancelRetry?.();
+    runtime.cancelRetry = null;
+  }
+}
+
+/**
+ * Stops every request a gate that just closed forbids (FR-125, FR-153, FR-159).
+ *
+ * In-flight loads are abandoned and their resources released, a loaded ad that
+ * may no longer be shown is released with them, and an ad already on screen is
+ * left alone — the provider offers no safe way to close it.
+ *
+ * An abandoned load *settles*: its caller gets `refusal`, the same answer a load
+ * started now would get, and a handle the provider hands back afterwards is
+ * disposed rather than adopted.
+ */
+function haltPlacements(context, refusal) {
+  for (const [key, runtime] of context.placements) {
+    if (runtime.snapshot.state === 'showing') {
+      continue;
+    }
+    const abort = runtime.abortLoad;
+    context.releasePlacementResources(key);
+    context.dispatchPlacement(key, {
+      type: 'RESET'
+    });
+    if (abort) {
+      context.emitRefusal('load', refusal, key, context.resolved.placements.get(key)?.format);
+      abort(refusal);
+    }
+  }
+}
+
+/**
+ * The one teardown for a gate that closed to `refusal`: retries cancelled,
+ * placements halted, and the init status moved to match.
+ */
+export function closeGate(context, refusal) {
+  cancelAllRetries(context);
+  haltPlacements(context, refusal);
+  const {
+    init
+  } = context.state;
+  switch (refusal.status) {
+    case 'disabled':
+      context.setInit(initReducer(init, {
+        type: 'DISABLE'
+      }));
+      return;
+    case 'undecided':
+      context.setInit(initReducer(init, {
+        type: 'UNDECIDE'
+      }));
+      return;
+    default:
+      context.setInit(initReducer(init, {
+        type: 'BLOCK',
+        reason: refusal.reason
+      }));
+  }
+}
+
+/**
+ * Warns once if the app leaves `undecided` unresolved (FR-119).
+ *
+ * Once, not repeatedly: a warning that fires every ten seconds becomes noise.
+ * And it only warns — resolving the state would mean guessing the business
+ * decision FR-120 forbids the package from knowing.
+ */
+export function armUndecidedWarning(context) {
+  const {
+    state,
+    timers,
+    resolved,
+    events,
+    now
+  } = context;
+  if (state.enablement !== 'undecided' || state.undecidedWarned || state.cancelUndecidedTimer) {
+    return;
+  }
+  const armedAt = now();
+  state.cancelUndecidedTimer = timers.after(resolved.timeouts.undecidedWarning, () => {
+    state.cancelUndecidedTimer = null;
+    if (state.disposed || state.enablement !== 'undecided' || state.undecidedWarned) {
+      return;
+    }
+    state.undecidedWarned = true;
+    events.emit({
+      type: 'config_warning',
+      timestamp: now(),
+      warning: 'enablement_undecided_timeout',
+      placementKeys: [],
+      elapsedMs: now() - armedAt
+    });
+  });
+}
+export function disarmUndecidedWarning(context) {
+  context.state.cancelUndecidedTimer?.();
+  context.state.cancelUndecidedTimer = null;
+}
+//# sourceMappingURL=gate.js.map

package/lib/module/core/instance/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["toGateInput","evaluateGates","initReducer","evaluateGate","currentGate","context","engine","state","appGate","currentPrivacy","available","isAvailable","ok","reason","enablement","allowed","permitted","consentGate","consentStarted","consent","refusalFor","decision","kind","status","gateRefusal","cancelAllRetries","runtime","placements","values","cancelRetry","haltPlacements","refusal","key","snapshot","abort","abortLoad","releasePlacementResources","dispatchPlacement","type","emitRefusal","resolved","get","format","closeGate","init","setInit","armUndecidedWarning","timers","events","now","undecidedWarned","cancelUndecidedTimer","armedAt","after","timeouts","undecidedWarning","disposed","emit","timestamp","warning","placementKeys","elapsedMs","disarmUndecidedWarning"],"sourceRoot":"../../../../src","sources":["core/instance/gate.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/instance/init.js

@@ -0,0 +1,321 @@
+"use strict";
+
+/**
+ * Initialization, privacy updates and enablement (FR-017 – FR-022, FR-115 –
+ * FR-125).
+ *
+ * One native initialization however many callers race (FR-022), none before
+ * the whole gate permits it (FR-017), and a gate that closes and reopens
+ * resumes instead of initializing again (FR-154).
+ */
+import { normalizeProviderError } from "../../diagnostics/errors.js";
+import { canResume } from "../enablement.js";
+import { canStart, initReducer } from "../initMachine.js";
+import { requiresReinitialization, evaluateGate, toEnginePrivacy } from "../privacyGate.js";
+import { armUndecidedWarning, cancelAllRetries, closeGate, currentGate, disarmUndecidedWarning, refusalFor } from "./gate.js";
+export function createInitController(context) {
+  const {
+    state,
+    engine,
+    events,
+    resolved,
+    now
+  } = context;
+  function warnSubstitutionOnce() {
+    if (state.warnedSubstitution || resolved.catalog.substitutedKeys.length === 0) {
+      return;
+    }
+    state.warnedSubstitution = true;
+    events.emit({
+      type: 'config_warning',
+      timestamp: now(),
+      warning: 'test_ad_unit_substituted',
+      placementKeys: resolved.catalog.substitutedKeys
+    });
+  }
+  async function doInitialize(privacy) {
+    try {
+      // The adapter applies privacy configuration before initializing the
+      // provider; that ordering is the whole reason FR-017 is enforceable.
+      await engine.initialize(toEnginePrivacy(privacy, resolved.testDeviceIds));
+      // Recorded before the status moves, and whether or not it moves: a gate
+      // that closed while this was in flight leaves the status `blocked`, but
+      // the provider is initialized all the same and must not be again.
+      state.providerInitialized = true;
+      state.appliedPrivacy = privacy;
+      context.setInit(initReducer(state.init, {
+        type: 'SUCCEED'
+      }));
+      warnSubstitutionOnce();
+      return {
+        status: 'ready'
+      };
+    } catch (error) {
+      const normalized = normalizeProviderError(error, {
+        operation: 'initialize'
+      });
+      context.setInit(initReducer(state.init, {
+        type: 'FAIL',
+        error: normalized
+      }));
+      return {
+        status: 'failed',
+        error: normalized
+      };
+    } finally {
+      state.inFlightInit = null;
+    }
+  }
+
+  /**
+   * Answers `initialize` without a native call when the provider is already up
+   * (FR-022, FR-154), or returns `null` to let a real initialization proceed.
+   * Init-time-only flags that changed meanwhile fall through to a real
+   * initialization: it is the only way they can take effect.
+   */
+  function resumeInitialized(privacy) {
+    if (!state.providerInitialized || !canStart(state.init.status) || requiresReinitialization(state.appliedPrivacy, privacy)) {
+      return null;
+    }
+    context.setInit(initReducer(state.init, {
+      type: 'RESUME'
+    }));
+    return {
+      status: 'ready'
+    };
+  }
+  const controller = {
+    async initialize(privacy) {
+      if (state.disposed) {
+        return {
+          status: 'unavailable',
+          reason: 'provider_missing'
+        };
+      }
+      state.currentPrivacy = privacy;
+
+      // Availability, then enablement, then consent — the one order, evaluated
+      // in the one place (FR-140). Nothing provider-facing happens on any
+      // refusal: not a configuration call, not an initialization (FR-017,
+      // FR-158). The consent flow opening the gate later initializes, through
+      // `reevaluateAfterConsent`.
+      const decision = currentGate(context);
+      if (!decision.allowed) {
+        const refusal = refusalFor(decision);
+        switch (refusal.status) {
+          case 'unavailable':
+            context.setInit(initReducer(state.init, {
+              type: 'UNAVAILABLE',
+              reason: refusal.reason
+            }));
+            break;
+          case 'disabled':
+            context.setInit(initReducer(state.init, {
+              type: 'DISABLE'
+            }));
+            break;
+          case 'undecided':
+            // FR-115: the status says `undecided`, so a banner host can hold
+            // its space instead of reclaiming it.
+            context.setInit(initReducer(state.init, {
+              type: 'UNDECIDE'
+            }));
+            armUndecidedWarning(context);
+            break;
+          default:
+            context.setInit(initReducer(state.init, {
+              type: 'BLOCK',
+              reason: refusal.reason
+            }));
+        }
+        context.emitRefusal('initialize', refusal);
+        return refusal;
+      }
+      if (state.init.status === 'ready') {
+        return {
+          status: 'ready'
+        };
+      }
+      const resumed = resumeInitialized(privacy);
+      if (resumed) {
+        return resumed;
+      }
+      // FR-022, SC-005. Racing callers share one operation.
+      if (state.inFlightInit) {
+        return state.inFlightInit;
+      }
+      if (!canStart(state.init.status)) {
+        return {
+          status: 'ready'
+        };
+      }
+      context.setInit(initReducer(state.init, {
+        type: 'START'
+      }));
+      state.inFlightInit = doInitialize(privacy);
+      return state.inFlightInit;
+    },
+    async updatePrivacy(privacy) {
+      if (state.disposed) {
+        // The same answer initialize and load give a disposed instance.
+        return {
+          status: 'unavailable',
+          reason: 'provider_missing'
+        };
+      }
+      if (state.enablement === 'undecided') {
+        return {
+          status: 'undecided'
+        };
+      }
+      if (state.enablement === 'disabled') {
+        return {
+          status: 'disabled'
+        };
+      }
+      if (!engine.isAvailable()) {
+        return {
+          status: 'unavailable',
+          reason: 'unsupported_platform'
+        };
+      }
+      // FR-020: a flag the provider only honors at initialization cannot be
+      // applied now. Say so, rather than accepting it and running half-old.
+      if (requiresReinitialization(state.appliedPrivacy, privacy)) {
+        return {
+          status: 'requires_reinitialization'
+        };
+      }
+      state.currentPrivacy = privacy;
+      const gate = evaluateGate(privacy);
+      if (!gate.allowed) {
+        // FR-017, FR-137, FR-153: the same teardown as a consent withdrawal.
+        closeGate(context, {
+          status: 'blocked',
+          reason: gate.reason
+        });
+        return {
+          status: 'blocked',
+          reason: gate.reason
+        };
+      }
+      // FR-019: resolving consent after a block must not initialize twice.
+      if (state.init.status === 'ready') {
+        return {
+          status: 'applied'
+        };
+      }
+      // Exhaustive on purpose (ADS-04): a new InitResult member fails to
+      // compile here instead of falling through to `applied`.
+      const result = await controller.initialize(privacy);
+      switch (result.status) {
+        case 'ready':
+          return {
+            status: 'applied'
+          };
+        case 'blocked':
+        case 'disabled':
+        case 'undecided':
+        case 'unavailable':
+        case 'failed':
+          return result;
+        default:
+          {
+            const unreachable = result;
+            return unreachable;
+          }
+      }
+    },
+    setEnablement(next) {
+      if (state.disposed) {
+        return {
+          status: 'unavailable',
+          reason: 'provider_missing'
+        };
+      }
+      if (state.enablement === next) {
+        return {
+          status: 'unchanged'
+        };
+      }
+      const previous = state.enablement;
+      state.enablement = next;
+      if (next === 'disabled' || next === 'undecided') {
+        // FR-037, FR-125: new work stops and in-flight resources are released;
+        // an ad already on screen is left to finish.
+        closeGate(context, {
+          status: next
+        });
+        if (next === 'undecided') {
+          armUndecidedWarning(context);
+          return {
+            status: 'undecided'
+          };
+        }
+        disarmUndecidedWarning(context);
+        return {
+          status: 'disabled'
+        };
+      }
+
+      // Turning ads on. 0.1.0 dropped the status to `not_started` and returned
+      // nothing, so every later load was refused in silence (FR-121).
+      disarmUndecidedWarning(context);
+      const resumable = canResume(state.init.resumeTo);
+      context.setInit(initReducer(state.init, {
+        type: 'ENABLE'
+      }));
+      const {
+        init
+      } = state;
+      if (init.status === 'unavailable') {
+        return {
+          status: 'unavailable',
+          reason: init.unavailableReason ?? 'unsupported_platform'
+        };
+      }
+      // The provider was never un-initialized, and FR-022 forbids doing it twice.
+      if (init.status === 'ready' && (resumable || previous === 'undecided')) {
+        return {
+          status: 'resumed',
+          initStatus: init.status
+        };
+      }
+      // Said out loud: the package will not hide an asynchronous, billable
+      // initialization behind a setter the caller may not be awaiting.
+      return {
+        status: 'requires_initialization'
+      };
+    },
+    /**
+     * When consent opens the gate and the instance was blocked, it initializes —
+     * once, because `initialize` shares one in-flight operation (FR-022,
+     * SC-102). When consent closes it, requests stop, pending retries are
+     * cancelled (FR-137), and a `ready` instance moves to `blocked` so a banner
+     * host keyed on `ready` stops requesting (FR-153).
+     */
+    async reevaluateAfterConsent() {
+      if (state.disposed || !state.currentPrivacy) {
+        return;
+      }
+      const decision = currentGate(context);
+      if (!decision.allowed) {
+        if (decision.kind === 'blocked') {
+          closeGate(context, {
+            status: 'blocked',
+            reason: decision.reason
+          });
+        } else {
+          cancelAllRetries(context);
+        }
+        return;
+      }
+      if (state.init.status === 'ready' || state.init.status === 'initializing') {
+        return;
+      }
+      await controller.initialize(state.currentPrivacy);
+    }
+  };
+  return controller;
+}
+//# sourceMappingURL=init.js.map

package/lib/module/core/instance/init.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["normalizeProviderError","canResume","canStart","initReducer","requiresReinitialization","evaluateGate","toEnginePrivacy","armUndecidedWarning","cancelAllRetries","closeGate","currentGate","disarmUndecidedWarning","refusalFor","createInitController","context","state","engine","events","resolved","now","warnSubstitutionOnce","warnedSubstitution","catalog","substitutedKeys","length","emit","type","timestamp","warning","placementKeys","doInitialize","privacy","initialize","testDeviceIds","providerInitialized","appliedPrivacy","setInit","init","status","error","normalized","operation","inFlightInit","resumeInitialized","controller","disposed","reason","currentPrivacy","decision","allowed","refusal","emitRefusal","resumed","updatePrivacy","enablement","isAvailable","gate","result","unreachable","setEnablement","next","previous","resumable","resumeTo","unavailableReason","initStatus","reevaluateAfterConsent","kind"],"sourceRoot":"../../../../src","sources":["core/instance/init.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/instance/internals.js

@@ -0,0 +1,109 @@
+"use strict";
+
+/**
+ * What `AdsBanner` needs from an instance, held off the public type (ADS-13).
+ *
+ * 0.5.0 exposed this as `AdsInstance.internals`, so any consumer could emit an
+ * `impression` or a `reward_earned` into the stream used for revenue
+ * reconciliation, and every change here was a breaking type change. It now
+ * lives in a WeakMap keyed by the instance: the banner host looks it up, and an
+ * instance an app wrote by hand simply has none.
+ */
+
+import { AdsError } from "../../diagnostics/errors.js";
+import { permitsRequests } from "../enablement.js";
+import { canRequest } from "../initMachine.js";
+import { toEngineRequest } from "../privacyGate.js";
+import { gateRefusal } from "./gate.js";
+const registry = new WeakMap();
+
+/** The banner host's view of an instance `createAds` made; null for any other. */
+export function getInternals(instance) {
+  return registry.get(instance) ?? null;
+}
+export function attachInternals(instance, internals) {
+  registry.set(instance, internals);
+}
+export function createInternals(context) {
+  const {
+    state,
+    engine,
+    resolved,
+    events,
+    timers,
+    requestThrottle,
+    now
+  } = context;
+  return {
+    resolveBanner(placementKey) {
+      const definition = resolved.placements.get(placementKey);
+      if (!definition || definition.format !== 'banner') {
+        const code = definition ? 'format_mismatch' : 'placement_not_found';
+        return {
+          ok: false,
+          result: {
+            status: 'failed',
+            error: new AdsError(code, {
+              operation: 'load',
+              placementKey,
+              format: definition?.format,
+              message: definition ? `"${placementKey}" is not a banner placement` : `unknown placement "${placementKey}"`
+            })
+          }
+        };
+      }
+      const refusal = gateRefusal(context);
+      if (refusal) {
+        return {
+          ok: false,
+          result: refusal
+        };
+      }
+      if (!canRequest(state.init.status)) {
+        return {
+          ok: false,
+          result: {
+            status: 'blocked',
+            reason: 'consent_required'
+          }
+        };
+      }
+      // The throttle is deliberately not consulted here: a fresh mount must be
+      // throttled while a width re-adaptation of a mounted banner must not be,
+      // and only the host knows which it is (FR-140).
+      return {
+        ok: true,
+        adUnitId: resolved.catalog.byKey.get(placementKey) ?? '',
+        personalizedAds: toEngineRequest(state.currentPrivacy).personalizedAds
+      };
+    },
+    commitBannerRequest(placementKey, token) {
+      if (!resolved.placements.has(placementKey)) {
+        return null;
+      }
+      const decision = requestThrottle.tryAcquire(placementKey, resolved.minRequestIntervalByKey.get(placementKey) ?? 0, token);
+      return decision.allowed ? null : {
+        status: 'throttled',
+        retryAfterMs: decision.retryAfterMs
+      };
+    },
+    throttleFloorFor: placementKey => resolved.minRequestIntervalByKey.get(placementKey) ?? 0,
+    banner: () => engine.banner?.isAvailable() ? engine.banner : null,
+    emit: event => events.emit(event),
+    setPlacementState(key, next) {
+      const runtime = context.placements.get(key);
+      if (runtime) {
+        context.setPlacement(key, {
+          ...runtime.snapshot,
+          state: next
+        });
+      }
+    },
+    isReady: () => permitsRequests(state.enablement) && engine.isAvailable() && canRequest(state.init.status),
+    nextCorrelationId: () => context.correlation.next(),
+    now,
+    schedule: (delayMs, task) => timers.after(delayMs, task),
+    timerCount: () => timers.size()
+  };
+}
+//# sourceMappingURL=internals.js.map

package/lib/module/core/instance/internals.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["AdsError","permitsRequests","canRequest","toEngineRequest","gateRefusal","registry","WeakMap","getInternals","instance","get","attachInternals","internals","set","createInternals","context","state","engine","resolved","events","timers","requestThrottle","now","resolveBanner","placementKey","definition","placements","format","code","ok","result","status","error","operation","message","refusal","init","reason","adUnitId","catalog","byKey","personalizedAds","currentPrivacy","commitBannerRequest","token","has","decision","tryAcquire","minRequestIntervalByKey","allowed","retryAfterMs","throttleFloorFor","banner","isAvailable","emit","event","setPlacementState","key","next","runtime","setPlacement","snapshot","isReady","enablement","nextCorrelationId","correlation","schedule","delayMs","task","after","timerCount","size"],"sourceRoot":"../../../../src","sources":["core/instance/internals.ts"],"mappings":"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","ignoreList":[]}