@chipmobilesdk/rn-ads 0.6.0 → 0.8.0

package/lib/commonjs/core/initMachine.js

@@ -0,0 +1,159 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.canRequest = canRequest;
+exports.canStart = canStart;
+exports.initReducer = initReducer;
+exports.initialInit = void 0;
+/**
+ * Initialization state machine (FR-022 – FR-025).
+ *
+ * Pure and synchronous: it decides what a transition means; the instance
+ * performs the I/O. That split is what makes every rule in data-model.md §3.1
+ * testable without a provider.
+ *
+ * The load-bearing invariant is idempotence. Three consumers calling
+ * `initialize()` at once must produce exactly one native initialization and
+ * three identical results (SC-005) — the instance holds one in-flight promise,
+ * and this machine refuses to leave `initializing` for anything but a terminal
+ * outcome.
+ */
+
+const initialInit = exports.initialInit = {
+  status: 'not_started',
+  blockReason: null,
+  unavailableReason: null,
+  error: null,
+  resumeTo: null
+};
+function at(status, patch = {}) {
+  return {
+    ...initialInit,
+    status,
+    ...patch
+  };
+}
+
+/**
+ * States that behave as "switched off" for everything downstream.
+ *
+ * `undecided` is grouped with `disabled` for request handling — neither may
+ * reach the provider — while staying a distinct reported status, which is the
+ * only reason the third state is worth having (FR-115, FR-116).
+ */
+function isSwitchedOff(status) {
+  return status === 'disabled' || status === 'undecided';
+}
+
+/**
+ * States a fresh start may leave from.
+ *
+ * `blocked` is included because resolving consent and trying again is the
+ * documented, expected flow (FR-019). `initializing` is excluded because that is
+ * exactly the race idempotence exists to prevent. `ready` is excluded because
+ * re-initializing an initialized provider is what FR-022 forbids.
+ */
+const STARTABLE = new Set(['not_started', 'blocked', 'failed']);
+function canStart(status) {
+  return STARTABLE.has(status);
+}
+
+/** Only `ready` may issue requests. Everything else is a refusal with a reason. */
+function canRequest(status) {
+  return status === 'ready';
+}
+
+/**
+ * What to remember when switching off.
+ *
+ * Only a completed initialization is worth keeping. A `blocked` or `failed`
+ * instance has nothing to resume to, and remembering `initializing` would mean
+ * resuming into a state whose in-flight operation was already abandoned.
+ */
+function rememberFor(state) {
+  if (state.status === 'ready') {
+    return 'ready';
+  }
+  // Preserve an earlier memory across an off -> off transition, so
+  // disable -> undecided -> enable still resumes.
+  return isSwitchedOff(state.status) ? state.resumeTo : null;
+}
+function initReducer(state, event) {
+  switch (event.type) {
+    case 'START':
+      // `disabled`, `undecided`, and `unavailable` all refuse a start:
+      // nothing may reach the provider while any of them holds.
+      if (isSwitchedOff(state.status) || state.status === 'unavailable') {
+        return state;
+      }
+      return canStart(state.status) ? at('initializing') : state;
+    case 'BLOCK':
+      // Consent is the weakest of the three gates, so it never overwrites a
+      // stronger one. This guard is the 0.1.0 behavior that settled the
+      // precedence question: availability and enablement already outranked
+      // consent, and FR-140 makes that explicit rather than inventing it.
+      if (isSwitchedOff(state.status) || state.status === 'unavailable') {
+        return state;
+      }
+      // A gate withdrawn after initialization does not un-initialize the
+      // provider — it stops requests. Reporting `blocked` is what the app
+      // acts on; the native SDK stays as it is.
+      return at('blocked', {
+        blockReason: event.reason
+      });
+    case 'UNAVAILABLE':
+      return at('unavailable', {
+        unavailableReason: event.reason
+      });
+    case 'DISABLE':
+      // Availability outranks enablement (FR-140a). 0.1.0 left these two
+      // unguarded against each other, so whichever arrived last won and the
+      // reported reason depended on timing — exactly the incidental ordering
+      // FR-140 forbids. Availability winning is deterministic and is the
+      // more useful answer: an unsupported platform cannot be fixed by
+      // turning ads back on.
+      if (state.status === 'unavailable') {
+        return state;
+      }
+      return at('disabled', {
+        resumeTo: rememberFor(state)
+      });
+    case 'UNDECIDE':
+      if (state.status === 'unavailable') {
+        return state;
+      }
+      return at('undecided', {
+        resumeTo: rememberFor(state)
+      });
+    case 'ENABLE':
+      {
+        if (!isSwitchedOff(state.status)) {
+          return state;
+        }
+        // Resume only from a completed initialization. Anything else has no
+        // ready state to return to, and claiming one would put the instance in
+        // a state it never actually reached — so the caller is told to
+        // initialize instead, explicitly (FR-121).
+        return state.resumeTo === 'ready' ? at('ready') : at('not_started');
+      }
+    case 'SUCCEED':
+      // Only a transition out of `initializing` counts. A `SUCCEED` arriving
+      // after a disable or a block is a late callback, and honoring it would
+      // resurrect a state the app deliberately left.
+      return state.status === 'initializing' ? at('ready') : state;
+    case 'RESUME':
+      // Same guard as START, for the same reason: `disabled`, `undecided` and
+      // `unavailable` are not left by a gate reopening. `canStart` excludes
+      // them, and `initializing`, whose own outcome is still on its way.
+      return canStart(state.status) ? at('ready') : state;
+    case 'FAIL':
+      return state.status === 'initializing' ? at('failed', {
+        error: event.error
+      }) : state;
+    default:
+      return state;
+  }
+}
+//# sourceMappingURL=initMachine.js.map

package/lib/commonjs/core/initMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["initialInit","exports","status","blockReason","unavailableReason","error","resumeTo","at","patch","isSwitchedOff","STARTABLE","Set","canStart","has","canRequest","rememberFor","state","initReducer","event","type","reason"],"sourceRoot":"../../../src","sources":["core/initMachine.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/core/instance/consent.js

@@ -0,0 +1,155 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createConsentApi = createConsentApi;
+var _consentFlow = require("../consentFlow.js");
+/**
+ * The optional consent capability (FR-101 – FR-113, FR-150 – FR-157).
+ *
+ * Every outcome feeds the gate through `reevaluate`, so the app never wires
+ * consent to requests by hand (FR-105), and a failure is never a grant
+ * (FR-106).
+ */
+
+function createConsentApi(context, reevaluate) {
+  const {
+    state,
+    engine,
+    resolved
+  } = context;
+
+  /** Applies an outcome unless the instance went away while it was pending. */
+  async function settle(next) {
+    if (state.disposed) {
+      return state.consent;
+    }
+    context.setConsent(next);
+    await reevaluate();
+    return next;
+  }
+  return {
+    async requestInfoUpdate() {
+      if (state.disposed) {
+        return state.consent;
+      }
+      // Marks the flow as in use. Until this is called the gate sees no consent
+      // input at all, which is how an app that supplies its own gate keeps
+      // 0.1.0 behavior without opting out of anything (FR-102).
+      state.consentStarted = true;
+      if (resolved.consentTesting?.resetOnStart) {
+        try {
+          engine.consent.reset();
+        } catch {
+          // A failed reset must not abort the update; the flow continues
+          // against whatever state is stored.
+        }
+      }
+      const next = await (0, _consentFlow.runConsentStep)(() => engine.consent.requestInfoUpdate((0, _consentFlow.buildConsentOptions)(resolved.consentTesting, state.currentPrivacy?.underAgeOfConsent, resolved.testDeviceIds)), 'consent information update failed');
+      return settle(next);
+    },
+    async showFormIfRequired() {
+      if (state.disposed) {
+        return state.consent;
+      }
+      state.consentStarted = true;
+      // Nothing to present is not an error: a region that does not require
+      // consent is the normal case (FR-107). Nor is a privacy options form
+      // already on screen — one provider form at a time.
+      if (!(0, _consentFlow.needsForm)(state.consent) || state.privacyOptionsFormOpen) {
+        return state.consent;
+      }
+      state.consentFormsOpen += 1;
+      let next;
+      try {
+        next = await (0, _consentFlow.runConsentStep)(() => engine.consent.showFormIfRequired(), 'consent form failed');
+      } finally {
+        state.consentFormsOpen -= 1;
+      }
+      return settle(next);
+    },
+    async showPrivacyOptionsForm() {
+      // The refusals, most immovable first — the same reading order as the
+      // request gates, so the answer is the most useful one.
+      if (state.disposed) {
+        return {
+          status: 'unavailable',
+          reason: 'provider_missing'
+        };
+      }
+      if (!engine.isAvailable()) {
+        return {
+          status: 'unavailable',
+          reason: 'unsupported_platform'
+        };
+      }
+      if (state.privacyOptionsFormOpen || state.consentFormsOpen > 0) {
+        return {
+          status: 'busy'
+        };
+      }
+      if (state.consent.privacyOptionsRequirement === 'unknown') {
+        return {
+          status: 'info_update_required'
+        };
+      }
+      if (state.consent.privacyOptionsRequirement !== 'required') {
+        // The provider's verdict, not a region guess of ours (FR-150).
+        return {
+          status: 'not_required'
+        };
+      }
+      state.privacyOptionsFormOpen = true;
+      let next;
+      let failure = null;
+      try {
+        next = (0, _consentFlow.normalizeConsent)(await engine.consent.showPrivacyOptionsForm());
+      } catch (cause) {
+        failure = (0, _consentFlow.toConsentError)(cause, 'privacy options form failed');
+        // The form did not complete, so the stored decision is the provider's
+        // to report — ask rather than assume. Collapsing to `error` the way a
+        // failed first-time form does would revoke a consent the user never
+        // changed. If the provider cannot answer either, the gate closes: a
+        // failure is never consent (FR-106).
+        next = state.disposed ? state.consent : await (0, _consentFlow.runConsentStep)(() => engine.consent.getInfo(), 'consent information could not be read after the privacy options form failed');
+      } finally {
+        state.privacyOptionsFormOpen = false;
+      }
+      // dispose() during the form: the form stays until the user closes it, but
+      // its outcome reaches nobody (FR-157).
+      if (state.disposed) {
+        return {
+          status: 'unavailable',
+          reason: 'provider_missing'
+        };
+      }
+      await settle(next);
+      return failure ? {
+        status: 'failed',
+        error: failure
+      } : {
+        status: 'shown',
+        consent: next
+      };
+    },
+    getState() {
+      return state.consent;
+    },
+    subscribe: listener => context.consentListeners.add(listener),
+    async reset() {
+      // Config validation strips the testing tools in production, so this is
+      // inert there without a check here (FR-113).
+      if (state.disposed || !resolved.consentTesting) {
+        return;
+      }
+      try {
+        engine.consent.reset();
+      } catch {
+        // The stored state is the provider's; a failed reset leaves it as it was.
+      }
+      context.setConsent(_consentFlow.INITIAL_CONSENT);
+    }
+  };
+}
+//# sourceMappingURL=consent.js.map

package/lib/commonjs/core/instance/consent.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_consentFlow","require","createConsentApi","context","reevaluate","state","engine","resolved","settle","next","disposed","consent","setConsent","requestInfoUpdate","consentStarted","consentTesting","resetOnStart","reset","runConsentStep","buildConsentOptions","currentPrivacy","underAgeOfConsent","testDeviceIds","showFormIfRequired","needsForm","privacyOptionsFormOpen","consentFormsOpen","showPrivacyOptionsForm","status","reason","isAvailable","privacyOptionsRequirement","failure","normalizeConsent","cause","toConsentError","getInfo","error","getState","subscribe","listener","consentListeners","add","INITIAL_CONSENT"],"sourceRoot":"../../../../src","sources":["core/instance/consent.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/core/instance/context.js

@@ -0,0 +1,217 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createInstanceContext = createInstanceContext;
+exports.validityFor = validityFor;
+var _rnCore = require("@chipmobilesdk/rn-core");
+var _validate = require("../../config/validate.js");
+var _correlation = require("../../diagnostics/correlation.js");
+var _errors = require("../../diagnostics/errors.js");
+var _events = require("../../diagnostics/events.js");
+var _adOriginatedReturn = require("../adOriginatedReturn.js");
+var _consentFlow = require("../consentFlow.js");
+var _fullScreenLock = require("../fullScreenLock.js");
+var _initMachine = require("../initMachine.js");
+var _placementMachine = require("../placementMachine.js");
+var _requestThrottle = require("../requestThrottle.js");
+var _timers = require("../timers.js");
+/**
+ * What every part of an ads instance shares (ADS-10).
+ *
+ * 0.5.0 kept all of this as `let` bindings inside one 1,500-line closure, and
+ * each path that closed a gate re-implemented its own teardown — which is how
+ * ADS-01, ADS-02 and ADS-04 happened. Here the state is one object, the
+ * placement runtimes are one map, and the helpers that change them are defined
+ * once. The controllers (gate, init, load, show, consent, banner) each take this
+ * context and nothing else.
+ */
+
+/** Everything about the instance that changes after creation. */
+
+function createInstanceContext(config, options, defaultEngine) {
+  const isDevBuild = options.isDevBuild ?? (0, _rnCore.isDevBuild)();
+  const now = options.now ?? (() => Date.now());
+
+  // Throws on a structural fault or the FR-012 fail-closed case. Deliberately
+  // before anything else: a misconfigured instance should not exist at all.
+  const resolved = (0, _validate.validateConfig)(config, {
+    isDevBuild
+  });
+  const engine = options.engine ?? defaultEngine();
+  const events = (0, _events.createEventEmitter)();
+
+  /**
+   * Status, consent and placement listeners are consumer code. A failure is
+   * isolated from the rest and reported the way an event listener's is: as an
+   * `internal_error` event (FR-056).
+   */
+  const listenerOptions = {
+    onListenerError(error) {
+      events.emit({
+        type: 'internal_error',
+        timestamp: now(),
+        error: new _errors.AdsError('internal_error', {
+          message: 'consumer listener threw',
+          cause: error
+        })
+      });
+    }
+  };
+  const placements = new Map();
+  for (const key of resolved.placements.keys()) {
+    placements.set(key, {
+      snapshot: _placementMachine.initialPlacement,
+      correlationId: null,
+      dismissed: false,
+      handle: null,
+      unsubscribeEngine: null,
+      inFlightLoad: null,
+      abortLoad: null,
+      cancelLoadTimer: null,
+      cancelShowTimer: null,
+      rewarded: null,
+      listeners: (0, _rnCore.createListenerSet)(listenerOptions),
+      retryAttempts: 0,
+      cancelRetry: null
+    });
+  }
+  const state = {
+    /**
+     * An instance told it is `undecided` says so from the moment it exists, or
+     * it would report `not_started` until `initialize()` runs — which looks like
+     * a disabled instance at exactly the point an app decides whether to reserve
+     * the banner's space (FR-116). `disabled` keeps 0.1.0's `not_started`
+     * (BC-004).
+     */
+    init: resolved.enablement === 'undecided' ? (0, _initMachine.initReducer)(_initMachine.initialInit, {
+      type: 'UNDECIDE'
+    }) : _initMachine.initialInit,
+    enablement: resolved.enablement,
+    appActive: true,
+    consent: _consentFlow.INITIAL_CONSENT,
+    consentStarted: false,
+    consentFormsOpen: 0,
+    privacyOptionsFormOpen: false,
+    providerInitialized: false,
+    undecidedWarned: false,
+    cancelUndecidedTimer: null,
+    appliedPrivacy: null,
+    currentPrivacy: null,
+    inFlightInit: null,
+    disposed: false,
+    warnedSubstitution: false
+  };
+  const statusListeners = (0, _rnCore.createListenerSet)(listenerOptions);
+  const consentListeners = (0, _rnCore.createListenerSet)(listenerOptions);
+  const context = {
+    resolved,
+    engine,
+    now,
+    events,
+    correlation: (0, _correlation.createCorrelationIssuer)(),
+    requestThrottle: (0, _requestThrottle.createRequestThrottle)(now),
+    timers: (0, _timers.createTimerSet)(options.scheduler),
+    lock: (0, _fullScreenLock.createFullScreenLock)(),
+    adReturn: (0, _adOriginatedReturn.createAdOriginatedTracker)(),
+    state,
+    placements,
+    statusListeners,
+    consentListeners,
+    placement(key) {
+      const runtime = placements.get(key);
+      const definition = resolved.placements.get(key);
+      return runtime && definition ? {
+        runtime,
+        definition
+      } : null;
+    },
+    setInit(next) {
+      const previous = state.init;
+      state.init = next;
+      if (next === previous || next.status === previous.status) {
+        return;
+      }
+      events.emit({
+        type: 'initialization',
+        timestamp: now(),
+        status: next.status,
+        retryable: next.error?.retryable
+      });
+      statusListeners.notify(next.status);
+    },
+    setPlacement(key, next) {
+      const runtime = placements.get(key);
+      if (!runtime) {
+        return;
+      }
+      const changed = runtime.snapshot.state !== next.state;
+      runtime.snapshot = next;
+      if (changed) {
+        runtime.listeners.notify(next.state);
+      }
+    },
+    dispatchPlacement(key, event) {
+      const found = context.placement(key);
+      if (found) {
+        context.setPlacement(key, (0, _placementMachine.placementReducer)(found.runtime.snapshot, event, found.definition.format));
+      }
+    },
+    setConsent(next) {
+      state.consent = next;
+      consentListeners.notify(next);
+    },
+    releasePlacementResources(key) {
+      const runtime = placements.get(key);
+      if (!runtime) {
+        return;
+      }
+      runtime.cancelLoadTimer?.();
+      runtime.cancelLoadTimer = null;
+      runtime.cancelShowTimer?.();
+      runtime.cancelShowTimer = null;
+      runtime.unsubscribeEngine?.();
+      runtime.unsubscribeEngine = null;
+      if (runtime.handle) {
+        engine.dispose(runtime.handle);
+        runtime.handle = null;
+      }
+      runtime.inFlightLoad = null;
+      runtime.abortLoad = null;
+      runtime.rewarded = null;
+      runtime.cancelRetry?.();
+      runtime.cancelRetry = null;
+    },
+    emitRefusal(operation, result, placementKey, format) {
+      if (result.status === 'disabled' || result.status === 'undecided') {
+        // `undecided` reuses the `disabled` event: for an observer of the
+        // stream the fact is the same — no request was made — and the
+        // distinction is carried by the typed result and the init status.
+        events.emit({
+          type: 'disabled',
+          timestamp: now(),
+          operation,
+          placementKey,
+          format
+        });
+        return;
+      }
+      events.emit({
+        type: 'unavailable',
+        timestamp: now(),
+        operation,
+        placementKey,
+        format,
+        reason: result.reason
+      });
+    }
+  };
+  return context;
+}
+
+/** App-open expires on its own, shorter window (FR-130). */
+function validityFor(context, format) {
+  return format === 'app_open' ? context.resolved.timeouts.appOpenValidity : context.resolved.timeouts.adValidity;
+}
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_rnCore","require","_validate","_correlation","_errors","_events","_adOriginatedReturn","_consentFlow","_fullScreenLock","_initMachine","_placementMachine","_requestThrottle","_timers","createInstanceContext","config","options","defaultEngine","isDevBuild","detectDevBuild","now","Date","resolved","validateConfig","engine","events","createEventEmitter","listenerOptions","onListenerError","error","emit","type","timestamp","AdsError","message","cause","placements","Map","key","keys","set","snapshot","initialPlacement","correlationId","dismissed","handle","unsubscribeEngine","inFlightLoad","abortLoad","cancelLoadTimer","cancelShowTimer","rewarded","listeners","createListenerSet","retryAttempts","cancelRetry","state","init","enablement","initReducer","initialInit","appActive","consent","INITIAL_CONSENT","consentStarted","consentFormsOpen","privacyOptionsFormOpen","providerInitialized","undecidedWarned","cancelUndecidedTimer","appliedPrivacy","currentPrivacy","inFlightInit","disposed","warnedSubstitution","statusListeners","consentListeners","context","correlation","createCorrelationIssuer","requestThrottle","createRequestThrottle","timers","createTimerSet","scheduler","lock","createFullScreenLock","adReturn","createAdOriginatedTracker","placement","runtime","get","definition","setInit","next","previous","status","retryable","notify","setPlacement","changed","dispatchPlacement","event","found","placementReducer","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":[]}