novvy-ads-react-native 1.0.0-beta.1

package/lib/module/NovvyAds.js

@@ -0,0 +1,83 @@
+"use strict";
+
+import { sha256 } from 'js-sha256';
+import { Native } from './eventBus';
+/**
+ * SDK entry point for Novvy Ads.
+ *
+ * A **thin** surface — it only wraps the native SDK's top-level entry (init +
+ * user/content context + email hashing). Ads themselves are created and driven
+ * directly through their classes ({@link NovvyInterstitialAd},
+ * {@link NovvyRewardedAd}, {@link NovvyMidAd}, {@link NovvyEndAd},
+ * {@link NovvyScrollAd}, {@link NovvyPauseAd}); the host owns each instance and
+ * wires its per-ad callbacks. Mirrors the Flutter plugin's `NovvyAds`.
+ *
+ * ```ts
+ * // 1. Initialize once at app startup (optionally with a user profile).
+ * const ok = await NovvyAds.initialize({
+ *   appId: '...', endpoint: '...', apiKey: '...',
+ *   userContext: { userId: '...', isPaidUser: true },
+ * });
+ *
+ * // 2. Set / refresh content context (and user profile if not set above).
+ * NovvyAds.setContentContext({ seriesName: '...', episodeNumber: 1 });
+ *
+ * // 3. Create an ad, wire callbacks, load & show.
+ * const ad = new NovvyRewardedAd('...');
+ * let earned = false;
+ * ad.onAdLoaded = () => ad.show();
+ * ad.onUserEarnedReward = () => { earned = true; };
+ * ad.onAdDismissed = () => { if (earned) grantReward(); };
+ * ad.onAdFailedToLoad = () => {};
+ * ad.load();
+ * ```
+ */
+export const NovvyAds = {
+  /**
+   * Initialize the Novvy SDK. Must be called before creating any ads.
+   *
+   * Resolves with the native init-complete signal — `true` on success, `false`
+   * if initialization failed. May be called again (e.g. after login/logout);
+   * the native SDK handles re-initialization idempotently.
+   *
+   * @param userContext optional user-targeting context applied at init time
+   * (equivalent to calling {@link setUserContext} right after).
+   */
+  async initialize(options) {
+    try {
+      return await Native.initialize(options.appId, options.endpoint, options.apiKey, options.userContext ?? null);
+    } catch {
+      return false;
+    }
+  },
+  /**
+   * Hashes an email address using SHA-256 for privacy compliance. Use before
+   * passing an email to {@link NovvyUserContext.hashedEmail}. Pure JS — mirrors
+   * the native SDK's `helperHashEmail()`.
+   */
+  helperHashEmail(email) {
+    return sha256(email.trim().toLowerCase());
+  },
+  /** Replaces the entire user context (null fields clear existing values). */
+  setUserContext(context) {
+    Native.setUserContext(context);
+  },
+  /** Incrementally merges user context fields (null fields preserve existing values). */
+  updateUserContext(partial) {
+    Native.updateUserContext(partial);
+  },
+  /**
+   * Replaces the entire content context (null fields clear existing values).
+   *
+   * Call before each `load()` / `attach()` in drama scenarios — the backend
+   * needs the current series/episode or it returns no fill.
+   */
+  setContentContext(context) {
+    Native.setContentContext(context);
+  },
+  /** Incrementally merges content context fields (null fields preserve existing values). */
+  updateContentContext(partial) {
+    Native.updateContentContext(partial);
+  }
+};
+//# sourceMappingURL=NovvyAds.js.map

package/lib/module/NovvyAds.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["sha256","Native","NovvyAds","initialize","options","appId","endpoint","apiKey","userContext","helperHashEmail","email","trim","toLowerCase","setUserContext","context","updateUserContext","partial","setContentContext","updateContentContext"],"sourceRoot":"../../src","sources":["NovvyAds.ts"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,WAAW;AAElC,SAASC,MAAM,QAAQ,YAAY;AAGnC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,QAAQ,GAAG;EACtB;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,UAAUA,CAACC,OAKhB,EAAoB;IACnB,IAAI;MACF,OAAO,MAAMH,MAAM,CAACE,UAAU,CAC5BC,OAAO,CAACC,KAAK,EACbD,OAAO,CAACE,QAAQ,EAChBF,OAAO,CAACG,MAAM,EACdH,OAAO,CAACI,WAAW,IAAI,IACzB,CAAC;IACH,CAAC,CAAC,MAAM;MACN,OAAO,KAAK;IACd;EACF,CAAC;EAED;AACF;AACA;AACA;AACA;EACEC,eAAeA,CAACC,KAAa,EAAU;IACrC,OAAOV,MAAM,CAACU,KAAK,CAACC,IAAI,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC,CAAC;EAC3C,CAAC;EAED;EACAC,cAAcA,CAACC,OAAyB,EAAQ;IAC9Cb,MAAM,CAACY,cAAc,CAACC,OAAO,CAAC;EAChC,CAAC;EAED;EACAC,iBAAiBA,CAACC,OAAyB,EAAQ;IACjDf,MAAM,CAACc,iBAAiB,CAACC,OAAO,CAAC;EACnC,CAAC;EAED;AACF;AACA;AACA;AACA;AACA;EACEC,iBAAiBA,CAACH,OAA4B,EAAQ;IACpDb,MAAM,CAACgB,iBAAiB,CAACH,OAAO,CAAC;EACnC,CAAC;EAED;EACAI,oBAAoBA,CAACF,OAA4B,EAAQ;IACvDf,MAAM,CAACiB,oBAAoB,CAACF,OAAO,CAAC;EACtC;AACF,CAAC","ignoreList":[]}

package/lib/module/ads/NovvyAd.js

@@ -0,0 +1,117 @@
+"use strict";
+
+import { Native, subscribe } from '../eventBus';
+import { NovvyAdEvent } from '../types';
+
+/**
+ * Base class for all Novvy ad types.
+ *
+ * Mirrors the Flutter plugin's `NovvyAd` (lib/novvy_ads_plugin.dart).
+ * Instances are owned by the host: keep a reference alive until the ad
+ * completes (`onAdDismissed` / `onAdHidden`) and then call {@link destroy}.
+ */
+export class NovvyAd {
+  _isReady = false;
+  _disposed = false;
+  _unsubscribe = null;
+
+  /** Called when the ad has loaded successfully. */
+
+  /** Called when the ad fails to load / request. */
+
+  constructor(adUnitId) {
+    this.adUnitId = adUnitId;
+    this._adObjectId = NovvyAd._generateUniqueId();
+  }
+
+  /** The unique object ID for this ad instance. */
+  get adObjectId() {
+    return this._adObjectId;
+  }
+
+  /** Whether the ad is loaded and ready to show. */
+  get isReady() {
+    return this._isReady;
+  }
+
+  /**
+   * Subscribes to this ad's native event stream (filtered by object ID).
+   * Idempotent.
+   */
+  _subscribe() {
+    if (this._unsubscribe) {
+      return;
+    }
+    this._unsubscribe = subscribe(this._adObjectId, event => this._handleInternalEvent(event));
+  }
+
+  /**
+   * Loads the ad. Not used by {@link NovvyPauseAd} (realtime, no load step).
+   *
+   * Callback-driven: the outcome is delivered via {@link onAdLoaded} /
+   * {@link onAdFailedToLoad}.
+   */
+  load() {
+    if (this._isReady || this._disposed) {
+      return;
+    }
+    this._subscribe();
+    try {
+      this._loadNative();
+    } catch (e) {
+      this.onAdFailedToLoad?.(String(e));
+      this.destroy();
+    }
+  }
+
+  /** Releases the ad resources. Idempotent. */
+  destroy() {
+    if (this._disposed) {
+      return;
+    }
+    this._disposed = true;
+    this._unsubscribe?.();
+    this._unsubscribe = null;
+    Native.disposeAd(this._adObjectId);
+  }
+
+  // Abstract members
+
+  /**
+   * Shared handling of the common load / fail transitions.
+   * Returns true if the event was consumed here.
+   */
+  _handleCommonLoad(event) {
+    switch (event.event) {
+      case NovvyAdEvent.Loaded:
+        this._isReady = true;
+        this.onAdLoaded?.();
+        return true;
+      case NovvyAdEvent.FailedToLoad:
+        this._isReady = false;
+        this.onAdFailedToLoad?.(event.error ?? 'Unknown error');
+        this.destroy();
+        return true;
+      default:
+        return false;
+    }
+  }
+
+  /**
+   * Monotonically increasing per-process counter guaranteeing `adObjectId`
+   * uniqueness even when many ads are constructed within the same millisecond
+   * (e.g. batch-preloading feed items in a synchronous loop). `Date.now()` has
+   * only millisecond resolution, so timestamp + random alone left a real
+   * (~1/10000 per pair) collision window; a colliding id would cross-wire two
+   * ads' event streams. The counter closes that window; the timestamp/random
+   * still disambiguate ids across separate app launches.
+   */
+  static _counter = 0;
+  static _generateUniqueId() {
+    const timestamp = Date.now();
+    const random = Math.floor(Math.random() * 10000);
+    const seq = NovvyAd._counter++;
+    return `ad_${timestamp}_${random}_${seq}`;
+  }
+}
+//# sourceMappingURL=NovvyAd.js.map

package/lib/module/ads/NovvyAd.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Native","subscribe","NovvyAdEvent","NovvyAd","_isReady","_disposed","_unsubscribe","constructor","adUnitId","_adObjectId","_generateUniqueId","adObjectId","isReady","_subscribe","event","_handleInternalEvent","load","_loadNative","e","onAdFailedToLoad","String","destroy","disposeAd","_handleCommonLoad","Loaded","onAdLoaded","FailedToLoad","error","_counter","timestamp","Date","now","random","Math","floor","seq"],"sourceRoot":"../../../src","sources":["ads/NovvyAd.ts"],"mappings":";;AAAA,SAASA,MAAM,EAAEC,SAAS,QAAQ,aAAa;AAE/C,SAASC,YAAY,QAAQ,UAAU;;AAEvC;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAeC,OAAO,CAAC;EAIlBC,QAAQ,GAAG,KAAK;EAChBC,SAAS,GAAG,KAAK;EAEnBC,YAAY,GAAwB,IAAI;;EAEhD;;EAEA;;EAGAC,WAAWA,CAACC,QAAgB,EAAE;IAC5B,IAAI,CAACA,QAAQ,GAAGA,QAAQ;IACxB,IAAI,CAACC,WAAW,GAAGN,OAAO,CAACO,iBAAiB,CAAC,CAAC;EAChD;;EAEA;EACA,IAAIC,UAAUA,CAAA,EAAW;IACvB,OAAO,IAAI,CAACF,WAAW;EACzB;;EAEA;EACA,IAAIG,OAAOA,CAAA,EAAY;IACrB,OAAO,IAAI,CAACR,QAAQ;EACtB;;EAEA;AACF;AACA;AACA;EACYS,UAAUA,CAAA,EAAS;IAC3B,IAAI,IAAI,CAACP,YAAY,EAAE;MACrB;IACF;IACA,IAAI,CAACA,YAAY,GAAGL,SAAS,CAAC,IAAI,CAACQ,WAAW,EAAGK,KAAK,IACpD,IAAI,CAACC,oBAAoB,CAACD,KAAK,CACjC,CAAC;EACH;;EAEA;AACF;AACA;AACA;AACA;AACA;EACEE,IAAIA,CAAA,EAAS;IACX,IAAI,IAAI,CAACZ,QAAQ,IAAI,IAAI,CAACC,SAAS,EAAE;MACnC;IACF;IACA,IAAI,CAACQ,UAAU,CAAC,CAAC;IACjB,IAAI;MACF,IAAI,CAACI,WAAW,CAAC,CAAC;IACpB,CAAC,CAAC,OAAOC,CAAC,EAAE;MACV,IAAI,CAACC,gBAAgB,GAAGC,MAAM,CAACF,CAAC,CAAC,CAAC;MAClC,IAAI,CAACG,OAAO,CAAC,CAAC;IAChB;EACF;;EAEA;EACAA,OAAOA,CAAA,EAAS;IACd,IAAI,IAAI,CAAChB,SAAS,EAAE;MAClB;IACF;IACA,IAAI,CAACA,SAAS,GAAG,IAAI;IACrB,IAAI,CAACC,YAAY,GAAG,CAAC;IACrB,IAAI,CAACA,YAAY,GAAG,IAAI;IACxBN,MAAM,CAACsB,SAAS,CAAC,IAAI,CAACb,WAAW,CAAC;EACpC;;EAEA;;EAIA;AACF;AACA;AACA;EACYc,iBAAiBA,CAACT,KAAoB,EAAW;IACzD,QAAQA,KAAK,CAACA,KAAK;MACjB,KAAKZ,YAAY,CAACsB,MAAM;QACtB,IAAI,CAACpB,QAAQ,GAAG,IAAI;QACpB,IAAI,CAACqB,UAAU,GAAG,CAAC;QACnB,OAAO,IAAI;MACb,KAAKvB,YAAY,CAACwB,YAAY;QAC5B,IAAI,CAACtB,QAAQ,GAAG,KAAK;QACrB,IAAI,CAACe,gBAAgB,GAAGL,KAAK,CAACa,KAAK,IAAI,eAAe,CAAC;QACvD,IAAI,CAACN,OAAO,CAAC,CAAC;QACd,OAAO,IAAI;MACb;QACE,OAAO,KAAK;IAChB;EACF;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,OAAeO,QAAQ,GAAG,CAAC;EAE3B,OAAelB,iBAAiBA,CAAA,EAAW;IACzC,MAAMmB,SAAS,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC;IAC5B,MAAMC,MAAM,GAAGC,IAAI,CAACC,KAAK,CAACD,IAAI,CAACD,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC;IAChD,MAAMG,GAAG,GAAGhC,OAAO,CAACyB,QAAQ,EAAE;IAC9B,OAAO,MAAMC,SAAS,IAAIG,MAAM,IAAIG,GAAG,EAAE;EAC3C;AACF","ignoreList":[]}

package/lib/module/ads/NovvyEndAd.js

@@ -0,0 +1,15 @@
+"use strict";
+
+import { NovvyFullScreenAd } from './NovvyFullScreenAd';
+
+/** An end-roll (full-screen) ad, shown after an episode finishes. */
+export class NovvyEndAd extends NovvyFullScreenAd {
+  _loadNative() {
+    this.native.loadEndAd(this.adUnitId, this.adObjectId);
+  }
+  show() {
+    this._assertReady();
+    this.native.showEndAd(this.adObjectId);
+  }
+}
+//# sourceMappingURL=NovvyEndAd.js.map

package/lib/module/ads/NovvyEndAd.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NovvyFullScreenAd","NovvyEndAd","_loadNative","native","loadEndAd","adUnitId","adObjectId","show","_assertReady","showEndAd"],"sourceRoot":"../../../src","sources":["ads/NovvyEndAd.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,qBAAqB;;AAEvD;AACA,OAAO,MAAMC,UAAU,SAASD,iBAAiB,CAAC;EACtCE,WAAWA,CAAA,EAAS;IAC5B,IAAI,CAACC,MAAM,CAACC,SAAS,CAAC,IAAI,CAACC,QAAQ,EAAE,IAAI,CAACC,UAAU,CAAC;EACvD;EAEAC,IAAIA,CAAA,EAAS;IACX,IAAI,CAACC,YAAY,CAAC,CAAC;IACnB,IAAI,CAACL,MAAM,CAACM,SAAS,CAAC,IAAI,CAACH,UAAU,CAAC;EACxC;AACF","ignoreList":[]}

package/lib/module/ads/NovvyFullScreenAd.js

@@ -0,0 +1,45 @@
+"use strict";
+
+import { Native } from '../eventBus';
+import { NovvyAdEvent } from '../types';
+import { NovvyAd } from './NovvyAd';
+
+/**
+ * Base for full-screen ads that follow load → show → dismissed.
+ * Mirrors the Flutter plugin's `_NovvyFullScreenAd`.
+ */
+export class NovvyFullScreenAd extends NovvyAd {
+  /** Called when the ad is displayed. */
+
+  /** Called when the ad is dismissed (closed) by the user. */
+
+  /** Shows the ad. Must be called after it has loaded. */
+
+  _handleInternalEvent(event) {
+    if (this._handleCommonLoad(event)) {
+      return;
+    }
+    switch (event.event) {
+      case NovvyAdEvent.Showed:
+        this.onAdShowed?.();
+        break;
+      case NovvyAdEvent.Dismissed:
+        this.onAdDismissed?.();
+        this.destroy();
+        break;
+      default:
+        break;
+    }
+  }
+  _assertReady() {
+    if (!this._isReady) {
+      throw new Error('Ad must be loaded before showing.');
+    }
+  }
+
+  /** Uses the module accessor in subclasses. */
+  get native() {
+    return Native;
+  }
+}
+//# sourceMappingURL=NovvyFullScreenAd.js.map

package/lib/module/ads/NovvyFullScreenAd.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Native","NovvyAdEvent","NovvyAd","NovvyFullScreenAd","_handleInternalEvent","event","_handleCommonLoad","Showed","onAdShowed","Dismissed","onAdDismissed","destroy","_assertReady","_isReady","Error","native"],"sourceRoot":"../../../src","sources":["ads/NovvyFullScreenAd.ts"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,aAAa;AAEpC,SAASC,YAAY,QAAQ,UAAU;AACvC,SAASC,OAAO,QAAQ,WAAW;;AAEnC;AACA;AACA;AACA;AACA,OAAO,MAAeC,iBAAiB,SAASD,OAAO,CAAC;EACtD;;EAEA;;EAGA;;EAGUE,oBAAoBA,CAACC,KAAoB,EAAQ;IACzD,IAAI,IAAI,CAACC,iBAAiB,CAACD,KAAK,CAAC,EAAE;MACjC;IACF;IACA,QAAQA,KAAK,CAACA,KAAK;MACjB,KAAKJ,YAAY,CAACM,MAAM;QACtB,IAAI,CAACC,UAAU,GAAG,CAAC;QACnB;MACF,KAAKP,YAAY,CAACQ,SAAS;QACzB,IAAI,CAACC,aAAa,GAAG,CAAC;QACtB,IAAI,CAACC,OAAO,CAAC,CAAC;QACd;MACF;QACE;IACJ;EACF;EAEUC,YAAYA,CAAA,EAAS;IAC7B,IAAI,CAAC,IAAI,CAACC,QAAQ,EAAE;MAClB,MAAM,IAAIC,KAAK,CAAC,mCAAmC,CAAC;IACtD;EACF;;EAEA;EACA,IAAcC,MAAMA,CAAA,EAAG;IACrB,OAAOf,MAAM;EACf;AACF","ignoreList":[]}

package/lib/module/ads/NovvyInterstitialAd.js

@@ -0,0 +1,15 @@
+"use strict";
+
+import { NovvyFullScreenAd } from './NovvyFullScreenAd';
+
+/** An interstitial (full-screen) ad. */
+export class NovvyInterstitialAd extends NovvyFullScreenAd {
+  _loadNative() {
+    this.native.loadInterstitialAd(this.adUnitId, this.adObjectId);
+  }
+  show() {
+    this._assertReady();
+    this.native.showInterstitialAd(this.adObjectId);
+  }
+}
+//# sourceMappingURL=NovvyInterstitialAd.js.map

package/lib/module/ads/NovvyInterstitialAd.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NovvyFullScreenAd","NovvyInterstitialAd","_loadNative","native","loadInterstitialAd","adUnitId","adObjectId","show","_assertReady","showInterstitialAd"],"sourceRoot":"../../../src","sources":["ads/NovvyInterstitialAd.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,qBAAqB;;AAEvD;AACA,OAAO,MAAMC,mBAAmB,SAASD,iBAAiB,CAAC;EAC/CE,WAAWA,CAAA,EAAS;IAC5B,IAAI,CAACC,MAAM,CAACC,kBAAkB,CAAC,IAAI,CAACC,QAAQ,EAAE,IAAI,CAACC,UAAU,CAAC;EAChE;EAEAC,IAAIA,CAAA,EAAS;IACX,IAAI,CAACC,YAAY,CAAC,CAAC;IACnB,IAAI,CAACL,MAAM,CAACM,kBAAkB,CAAC,IAAI,CAACH,UAAU,CAAC;EACjD;AACF","ignoreList":[]}

package/lib/module/ads/NovvyMidAd.js

@@ -0,0 +1,15 @@
+"use strict";
+
+import { NovvyFullScreenAd } from './NovvyFullScreenAd';
+
+/** A mid-roll (full-screen) ad, shown at an in-episode break. */
+export class NovvyMidAd extends NovvyFullScreenAd {
+  _loadNative() {
+    this.native.loadMidAd(this.adUnitId, this.adObjectId);
+  }
+  show() {
+    this._assertReady();
+    this.native.showMidAd(this.adObjectId);
+  }
+}
+//# sourceMappingURL=NovvyMidAd.js.map

package/lib/module/ads/NovvyMidAd.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NovvyFullScreenAd","NovvyMidAd","_loadNative","native","loadMidAd","adUnitId","adObjectId","show","_assertReady","showMidAd"],"sourceRoot":"../../../src","sources":["ads/NovvyMidAd.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,qBAAqB;;AAEvD;AACA,OAAO,MAAMC,UAAU,SAASD,iBAAiB,CAAC;EACtCE,WAAWA,CAAA,EAAS;IAC5B,IAAI,CAACC,MAAM,CAACC,SAAS,CAAC,IAAI,CAACC,QAAQ,EAAE,IAAI,CAACC,UAAU,CAAC;EACvD;EAEAC,IAAIA,CAAA,EAAS;IACX,IAAI,CAACC,YAAY,CAAC,CAAC;IACnB,IAAI,CAACL,MAAM,CAACM,SAAS,CAAC,IAAI,CAACH,UAAU,CAAC;EACxC;AACF","ignoreList":[]}

package/lib/module/ads/NovvyPauseAd.js

@@ -0,0 +1,112 @@
+"use strict";
+
+import { Native } from '../eventBus';
+import { NovvyAdEvent } from '../types';
+import { NovvyAd } from './NovvyAd';
+
+/** Interval at which player state is pushed to native (mirrors Flutter's 500ms Timer). */
+const PLAYER_PUSH_INTERVAL_MS = 500;
+
+/**
+ * A realtime pause card (fixed 260×90) shown while the player is paused.
+ *
+ * Unlike other ads there is **no** {@link load} step: embedding
+ * `<NovvyPauseAdView>` issues the request immediately via {@link attach}.
+ * Show it the moment playback is paused and {@link destroy} on resume
+ * ({@link onAdHidden}). Mirrors the Flutter plugin's `NovvyPauseAd`.
+ */
+export class NovvyPauseAd extends NovvyAd {
+  /** The Fabric component name used by `<NovvyPauseAdView>`. */
+  static viewType = 'NovvyPauseAdView';
+  /** Pause card width in logical pixels (matches native SDK). */
+  static cardWidth = 260;
+  /** Pause card height in logical pixels (matches native SDK). */
+  static cardHeight = 90;
+
+  /** Called when the pause card is shown. */
+
+  /** Called when the card is hidden (playback resumed). */
+
+  /**
+   * Called when the native card's shown state changes, so a view can toggle
+   * touch passthrough / opacity (mirrors Flutter's `shownNotifier`).
+   */
+
+  _player = null;
+  _timer = null;
+  _loadNative() {
+    throw new Error('NovvyPauseAd has no load step; use attach().');
+  }
+
+  /**
+   * Attach the pause ad and issue the request in realtime.
+   *
+   * The player's current state is read once and sent with the request; a
+   * 500ms timer then keeps pushing state so the SDK can detect resumption.
+   */
+  attach(player) {
+    if (this._disposed) {
+      return;
+    }
+    this._player = player;
+    this._subscribe();
+    Native.attachPauseAd(this.adUnitId, this.adObjectId, player.currentPositionMs, player.isPlaying);
+    this._startPlayerTimer();
+  }
+
+  /** Detach the pause ad and stop pushing player state. */
+  detach() {
+    this._stopPlayerTimer();
+    this._player = null;
+    Native.detachPauseAd(this.adObjectId);
+  }
+  destroy() {
+    if (this._disposed) {
+      return;
+    }
+    this._stopPlayerTimer();
+    this._player = null;
+    super.destroy();
+  }
+  _startPlayerTimer() {
+    this._stopPlayerTimer();
+    this._timer = setInterval(() => {
+      const player = this._player;
+      if (!player) {
+        return;
+      }
+      Native.updatePauseAdPlayerState(this.adObjectId, player.currentPositionMs, player.isPlaying);
+    }, PLAYER_PUSH_INTERVAL_MS);
+  }
+  _stopPlayerTimer() {
+    if (this._timer) {
+      clearInterval(this._timer);
+      this._timer = null;
+    }
+  }
+  _handleInternalEvent(event) {
+    switch (event.event) {
+      case NovvyAdEvent.FailedToLoad:
+        this.onAdFailedToLoad?.(event.error ?? 'Unknown error');
+        // Stops the player timer + unsubscribes before releasing native —
+        // avoids a leaked 500ms push loop on failure.
+        this.destroy();
+        break;
+      case NovvyAdEvent.Showed:
+        if (!this._disposed) {
+          this.onShownChanged?.(true);
+        }
+        this.onAdShowed?.();
+        break;
+      case NovvyAdEvent.Hidden:
+        if (!this._disposed) {
+          this.onShownChanged?.(false);
+        }
+        this.onAdHidden?.();
+        break;
+      default:
+        break;
+    }
+  }
+}
+//# sourceMappingURL=NovvyPauseAd.js.map

package/lib/module/ads/NovvyPauseAd.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Native","NovvyAdEvent","NovvyAd","PLAYER_PUSH_INTERVAL_MS","NovvyPauseAd","viewType","cardWidth","cardHeight","_player","_timer","_loadNative","Error","attach","player","_disposed","_subscribe","attachPauseAd","adUnitId","adObjectId","currentPositionMs","isPlaying","_startPlayerTimer","detach","_stopPlayerTimer","detachPauseAd","destroy","setInterval","updatePauseAdPlayerState","clearInterval","_handleInternalEvent","event","FailedToLoad","onAdFailedToLoad","error","Showed","onShownChanged","onAdShowed","Hidden","onAdHidden"],"sourceRoot":"../../../src","sources":["ads/NovvyPauseAd.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/ads/NovvyRewardedAd.js

@@ -0,0 +1,49 @@
+"use strict";
+
+import { Native } from '../eventBus';
+import { NovvyAdEvent } from '../types';
+import { NovvyAd } from './NovvyAd';
+
+/** A rewarded video ad. */
+export class NovvyRewardedAd extends NovvyAd {
+  /** Called when the ad is displayed. */
+
+  /** Called when the ad is dismissed by the user. */
+
+  /**
+   * Called once when the user earns the reward. No reward payload — the native
+   * SDKs deliver a parameterless signal (grant the host's own reward).
+   */
+
+  _loadNative() {
+    Native.loadRewardedAd(this.adUnitId, this.adObjectId);
+  }
+
+  /** Shows the rewarded video ad. Must be called after it has loaded. */
+  show() {
+    if (!this._isReady) {
+      throw new Error('Ad must be loaded before showing.');
+    }
+    Native.showRewardedAd(this.adObjectId);
+  }
+  _handleInternalEvent(event) {
+    if (this._handleCommonLoad(event)) {
+      return;
+    }
+    switch (event.event) {
+      case NovvyAdEvent.Showed:
+        this.onAdShowed?.();
+        break;
+      case NovvyAdEvent.EarnedReward:
+        this.onUserEarnedReward?.();
+        break;
+      case NovvyAdEvent.Dismissed:
+        this.onAdDismissed?.();
+        this.destroy();
+        break;
+      default:
+        break;
+    }
+  }
+}
+//# sourceMappingURL=NovvyRewardedAd.js.map

package/lib/module/ads/NovvyRewardedAd.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Native","NovvyAdEvent","NovvyAd","NovvyRewardedAd","_loadNative","loadRewardedAd","adUnitId","adObjectId","show","_isReady","Error","showRewardedAd","_handleInternalEvent","event","_handleCommonLoad","Showed","onAdShowed","EarnedReward","onUserEarnedReward","Dismissed","onAdDismissed","destroy"],"sourceRoot":"../../../src","sources":["ads/NovvyRewardedAd.ts"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,aAAa;AAEpC,SAASC,YAAY,QAAQ,UAAU;AACvC,SAASC,OAAO,QAAQ,WAAW;;AAEnC;AACA,OAAO,MAAMC,eAAe,SAASD,OAAO,CAAC;EAC3C;;EAEA;;EAEA;AACF;AACA;AACA;;EAGYE,WAAWA,CAAA,EAAS;IAC5BJ,MAAM,CAACK,cAAc,CAAC,IAAI,CAACC,QAAQ,EAAE,IAAI,CAACC,UAAU,CAAC;EACvD;;EAEA;EACAC,IAAIA,CAAA,EAAS;IACX,IAAI,CAAC,IAAI,CAACC,QAAQ,EAAE;MAClB,MAAM,IAAIC,KAAK,CAAC,mCAAmC,CAAC;IACtD;IACAV,MAAM,CAACW,cAAc,CAAC,IAAI,CAACJ,UAAU,CAAC;EACxC;EAEUK,oBAAoBA,CAACC,KAAoB,EAAQ;IACzD,IAAI,IAAI,CAACC,iBAAiB,CAACD,KAAK,CAAC,EAAE;MACjC;IACF;IACA,QAAQA,KAAK,CAACA,KAAK;MACjB,KAAKZ,YAAY,CAACc,MAAM;QACtB,IAAI,CAACC,UAAU,GAAG,CAAC;QACnB;MACF,KAAKf,YAAY,CAACgB,YAAY;QAC5B,IAAI,CAACC,kBAAkB,GAAG,CAAC;QAC3B;MACF,KAAKjB,YAAY,CAACkB,SAAS;QACzB,IAAI,CAACC,aAAa,GAAG,CAAC;QACtB,IAAI,CAACC,OAAO,CAAC,CAAC;QACd;MACF;QACE;IACJ;EACF;AACF","ignoreList":[]}

package/lib/module/ads/NovvyScrollAd.js

@@ -0,0 +1,132 @@
+"use strict";
+
+import { Native } from '../eventBus';
+import { NovvyAdEvent } from '../types';
+import { NovvyAd } from './NovvyAd';
+
+/**
+ * A scroll ad that renders as a native view inserted into a scrollable list.
+ *
+ * Lifecycle: {@link load} → embed `<NovvyScrollAdView>` → {@link setPlaying} as
+ * it enters / leaves the viewport → {@link destroy}. Attach/detach are driven
+ * by the `<NovvyScrollAdView>` component's mount lifecycle.
+ */
+export class NovvyScrollAd extends NovvyAd {
+  /** The Fabric component name used by `<NovvyScrollAdView>`. */
+  static viewType = 'NovvyScrollAdView';
+
+  /**
+   * Optional override for the episode number used in the bid request. When
+   * non-null, takes precedence over the value set via
+   * {@link NovvyAds.setContentContext}.
+   */
+
+  /** Called when the ad becomes visible in the viewport. */
+
+  /** Called when the ad is hidden / removed from the viewport. */
+
+  /**
+   * Called every second during playback with the remaining seconds
+   * (0 = user can swipe past the ad).
+   */
+
+  constructor(adUnitId, episodeNumber) {
+    super(adUnitId);
+    this.episodeNumber = episodeNumber;
+  }
+
+  // ── Attach coordination ────────────────────────────────────────────────
+  //
+  // The native SCROLL contract is strictly two-stage: `load()` must resolve the
+  // creative BEFORE `attach()` — the native engine drops an early attach with a
+  // "not ready" log and never retries (see NovvyPlacementAd.attach). But the two
+  // triggers here are independent: `load()` is host-driven and network-bound,
+  // while the native container becomes available on the view's `onViewReady`
+  // (local, fast). View-ready therefore almost always beats `loaded`, so a naive
+  // "attach on view-ready" fires too early, silently no-ops, and the slot stays
+  // on its black placeholder for every creative type.
+  //
+  // We instead attach only once BOTH signals have arrived (whichever is last),
+  // and buffer the host's play intent so it survives being set before attach and
+  // is re-applied across detach/re-attach (scroll off- and back on-screen).
+  _viewReady = false;
+  _attached = false;
+  /** Last play intent from the host; (re)applied on each attach. */
+  _playing = false;
+  _durationSeconds = null;
+  _useDefaultSwipeOverlay = true;
+  _loadNative() {
+    Native.loadScrollAd(this.adUnitId, this.adObjectId, this.episodeNumber ?? null);
+  }
+
+  /**
+   * Signals that the native container is ready (fired automatically by
+   * `<NovvyScrollAdView>` on `onViewReady`). Records the attach params and
+   * mounts the ad once it has also finished loading.
+   */
+  attach(durationSeconds, useDefaultSwipeOverlay = true) {
+    this._durationSeconds = durationSeconds ?? null;
+    this._useDefaultSwipeOverlay = useDefaultSwipeOverlay;
+    this._viewReady = true;
+    this._maybeAttach();
+  }
+
+  /** Detach the scroll ad from its container. */
+  detach() {
+    this._viewReady = false;
+    this._attached = false;
+    Native.detachScrollAd(this.adObjectId);
+  }
+
+  /**
+   * Set the playing state. Call `setPlaying(true)` when the item scrolls into
+   * the viewport and `setPlaying(false)` when it scrolls out. Safe to call
+   * before the ad has attached — the intent is buffered and applied on attach.
+   */
+  setPlaying(playing) {
+    this._playing = playing;
+    if (this._attached) {
+      Native.setScrollAdPlaying(this.adObjectId, playing);
+    }
+  }
+
+  /**
+   * Attach once the ad is loaded AND the native view is ready — the native
+   * engine requires load-before-attach and does not retry, so we gate on both.
+   */
+  _maybeAttach() {
+    if (this._attached || this._disposed || !this._isReady || !this._viewReady) {
+      return;
+    }
+    Native.attachScrollAd(this.adObjectId, this._durationSeconds, this._useDefaultSwipeOverlay);
+    this._attached = true;
+    // Re-apply the buffered play intent now that a native host exists.
+    if (this._playing) {
+      Native.setScrollAdPlaying(this.adObjectId, true);
+    }
+  }
+  _handleInternalEvent(event) {
+    if (this._handleCommonLoad(event)) {
+      // `loaded` may arrive after the view is already ready; attach now that
+      // the native engine has the creative (after any onAdLoaded → setPlaying).
+      if (event.event === NovvyAdEvent.Loaded) {
+        this._maybeAttach();
+      }
+      return;
+    }
+    switch (event.event) {
+      case NovvyAdEvent.Showed:
+        this.onAdShowed?.();
+        break;
+      case NovvyAdEvent.Hidden:
+        this.onAdHidden?.();
+        break;
+      case NovvyAdEvent.PlaybackTick:
+        this.onAdPlaybackTick?.(event.remainingSeconds ?? 0);
+        break;
+      default:
+        break;
+    }
+  }
+}
+//# sourceMappingURL=NovvyScrollAd.js.map

package/lib/module/ads/NovvyScrollAd.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Native","NovvyAdEvent","NovvyAd","NovvyScrollAd","viewType","constructor","adUnitId","episodeNumber","_viewReady","_attached","_playing","_durationSeconds","_useDefaultSwipeOverlay","_loadNative","loadScrollAd","adObjectId","attach","durationSeconds","useDefaultSwipeOverlay","_maybeAttach","detach","detachScrollAd","setPlaying","playing","setScrollAdPlaying","_disposed","_isReady","attachScrollAd","_handleInternalEvent","event","_handleCommonLoad","Loaded","Showed","onAdShowed","Hidden","onAdHidden","PlaybackTick","onAdPlaybackTick","remainingSeconds"],"sourceRoot":"../../../src","sources":["ads/NovvyScrollAd.ts"],"mappings":"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","ignoreList":[]}