react-native-theoplayer 11.6.0 → 11.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (193) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +69 -0
  3. package/android/build.gradle +1 -0
  4. package/android/src/main/java/com/theoplayer/PlayerConfigAdapter.kt +6 -0
  5. package/android/src/main/java/com/theoplayer/PlayerEventEmitter.kt +2 -2
  6. package/android/src/main/java/com/theoplayer/ReactTHEOplayerContext.kt +37 -8
  7. package/android/src/main/java/com/theoplayer/ReactTHEOplayerPackage.kt +3 -0
  8. package/android/src/main/java/com/theoplayer/ReactTHEOplayerView.kt +51 -3
  9. package/android/src/main/java/com/theoplayer/ads/AdEventAdapter.kt +4 -0
  10. package/android/src/main/java/com/theoplayer/ads/AdsModule.kt +6 -6
  11. package/android/src/main/java/com/theoplayer/integration/Integration.kt +72 -0
  12. package/android/src/main/java/com/theoplayer/integration/IntegrationRegistration.kt +68 -0
  13. package/android/src/main/java/com/theoplayer/integration/PlayerFacade.kt +187 -0
  14. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeAdState.kt +19 -0
  15. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeAds.kt +73 -0
  16. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeAdsBridge.kt +112 -0
  17. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeEventSubscription.kt +11 -0
  18. package/android/src/main/java/com/theoplayer/integration/PlayerFacadeEvents.kt +139 -0
  19. package/android/src/main/java/com/theoplayer/metrics/MetricsModule.kt +37 -0
  20. package/android/src/main/java/com/theoplayer/theoads/THEOadsModule.kt +1 -1
  21. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeAdsBridgeTest.kt +250 -0
  22. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeConfigurationTest.kt +30 -0
  23. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeTest.kt +507 -0
  24. package/android/src/test/java/com/theoplayer/integration/PlayerFacadeTestHost.kt +104 -0
  25. package/ios/THEOplayerRCTBridge.m +19 -0
  26. package/ios/THEOplayerRCTPlayerAPI.swift +31 -0
  27. package/ios/Theoplayer-Bridging-Header.h +0 -1
  28. package/ios/metrics/THEOplayerRCTMetricsAPI.swift +31 -0
  29. package/lib/commonjs/api/barrel.js +31 -20
  30. package/lib/commonjs/api/barrel.js.map +1 -1
  31. package/lib/commonjs/api/metrics/MetricsAPI.js +2 -0
  32. package/lib/commonjs/api/metrics/MetricsAPI.js.map +1 -0
  33. package/lib/commonjs/api/metrics/barrel.js +17 -0
  34. package/lib/commonjs/api/metrics/barrel.js.map +1 -0
  35. package/lib/commonjs/api/player/Integration.js +2 -0
  36. package/lib/commonjs/api/player/Integration.js.map +1 -0
  37. package/lib/commonjs/api/player/THEOplayer.js.map +1 -1
  38. package/lib/commonjs/api/player/barrel.js +11 -0
  39. package/lib/commonjs/api/player/barrel.js.map +1 -1
  40. package/lib/commonjs/api/track/MediaTrack.js +16 -0
  41. package/lib/commonjs/api/track/MediaTrack.js.map +1 -1
  42. package/lib/commonjs/internal/THEOplayerView.js +2 -0
  43. package/lib/commonjs/internal/THEOplayerView.js.map +1 -1
  44. package/lib/commonjs/internal/THEOplayerView.web.js +3 -1
  45. package/lib/commonjs/internal/THEOplayerView.web.js.map +1 -1
  46. package/lib/commonjs/internal/adapter/DefaultNativePlayerState.js +1 -0
  47. package/lib/commonjs/internal/adapter/DefaultNativePlayerState.js.map +1 -1
  48. package/lib/commonjs/internal/adapter/THEOplayerAdapter.js +18 -0
  49. package/lib/commonjs/internal/adapter/THEOplayerAdapter.js.map +1 -1
  50. package/lib/commonjs/internal/adapter/THEOplayerWebAdapter.js +21 -4
  51. package/lib/commonjs/internal/adapter/THEOplayerWebAdapter.js.map +1 -1
  52. package/lib/commonjs/internal/adapter/WebEventForwarder.js +1 -1
  53. package/lib/commonjs/internal/adapter/WebEventForwarder.js.map +1 -1
  54. package/lib/commonjs/internal/adapter/metrics/MetricsNativeAdapter.js +18 -0
  55. package/lib/commonjs/internal/adapter/metrics/MetricsNativeAdapter.js.map +1 -0
  56. package/lib/commonjs/internal/adapter/metrics/MetricsWebAdapter.js +16 -0
  57. package/lib/commonjs/internal/adapter/metrics/MetricsWebAdapter.js.map +1 -0
  58. package/lib/commonjs/internal/adapter/web/IntegrationRegistration.js +6 -0
  59. package/lib/commonjs/internal/adapter/web/IntegrationRegistration.js.map +1 -0
  60. package/lib/commonjs/internal/adapter/web/PlayerFacade.js +258 -0
  61. package/lib/commonjs/internal/adapter/web/PlayerFacade.js.map +1 -0
  62. package/lib/commonjs/internal/adapter/web/PlayerFacadeAPI.js +6 -0
  63. package/lib/commonjs/internal/adapter/web/PlayerFacadeAPI.js.map +1 -0
  64. package/lib/commonjs/internal/adapter/web/PlayerFacadeAdsEvents.js +114 -0
  65. package/lib/commonjs/internal/adapter/web/PlayerFacadeAdsEvents.js.map +1 -0
  66. package/lib/commonjs/internal/adapter/web/PlayerFacadeIntegration.js +6 -0
  67. package/lib/commonjs/internal/adapter/web/PlayerFacadeIntegration.js.map +1 -0
  68. package/lib/commonjs/internal/adapter/web/PlayerFacadeTypes.js +6 -0
  69. package/lib/commonjs/internal/adapter/web/PlayerFacadeTypes.js.map +1 -0
  70. package/lib/commonjs/manifest.json +1 -1
  71. package/lib/module/api/barrel.js +1 -0
  72. package/lib/module/api/barrel.js.map +1 -1
  73. package/lib/module/api/metrics/MetricsAPI.js +2 -0
  74. package/lib/module/api/metrics/MetricsAPI.js.map +1 -0
  75. package/lib/module/api/metrics/barrel.js +4 -0
  76. package/lib/module/api/metrics/barrel.js.map +1 -0
  77. package/lib/module/api/player/Integration.js +2 -0
  78. package/lib/module/api/player/Integration.js.map +1 -0
  79. package/lib/module/api/player/THEOplayer.js.map +1 -1
  80. package/lib/module/api/player/barrel.js +1 -0
  81. package/lib/module/api/player/barrel.js.map +1 -1
  82. package/lib/module/api/track/MediaTrack.js +16 -0
  83. package/lib/module/api/track/MediaTrack.js.map +1 -1
  84. package/lib/module/internal/THEOplayerView.js +2 -0
  85. package/lib/module/internal/THEOplayerView.js.map +1 -1
  86. package/lib/module/internal/THEOplayerView.web.js +3 -1
  87. package/lib/module/internal/THEOplayerView.web.js.map +1 -1
  88. package/lib/module/internal/adapter/DefaultNativePlayerState.js +1 -0
  89. package/lib/module/internal/adapter/DefaultNativePlayerState.js.map +1 -1
  90. package/lib/module/internal/adapter/THEOplayerAdapter.js +18 -0
  91. package/lib/module/internal/adapter/THEOplayerAdapter.js.map +1 -1
  92. package/lib/module/internal/adapter/THEOplayerWebAdapter.js +21 -4
  93. package/lib/module/internal/adapter/THEOplayerWebAdapter.js.map +1 -1
  94. package/lib/module/internal/adapter/WebEventForwarder.js +1 -1
  95. package/lib/module/internal/adapter/WebEventForwarder.js.map +1 -1
  96. package/lib/module/internal/adapter/metrics/MetricsNativeAdapter.js +13 -0
  97. package/lib/module/internal/adapter/metrics/MetricsNativeAdapter.js.map +1 -0
  98. package/lib/module/internal/adapter/metrics/MetricsWebAdapter.js +11 -0
  99. package/lib/module/internal/adapter/metrics/MetricsWebAdapter.js.map +1 -0
  100. package/lib/module/internal/adapter/web/IntegrationRegistration.js +4 -0
  101. package/lib/module/internal/adapter/web/IntegrationRegistration.js.map +1 -0
  102. package/lib/module/internal/adapter/web/PlayerFacade.js +253 -0
  103. package/lib/module/internal/adapter/web/PlayerFacade.js.map +1 -0
  104. package/lib/module/internal/adapter/web/PlayerFacadeAPI.js +4 -0
  105. package/lib/module/internal/adapter/web/PlayerFacadeAPI.js.map +1 -0
  106. package/lib/module/internal/adapter/web/PlayerFacadeAdsEvents.js +109 -0
  107. package/lib/module/internal/adapter/web/PlayerFacadeAdsEvents.js.map +1 -0
  108. package/lib/module/internal/adapter/web/PlayerFacadeIntegration.js +4 -0
  109. package/lib/module/internal/adapter/web/PlayerFacadeIntegration.js.map +1 -0
  110. package/lib/module/internal/adapter/web/PlayerFacadeTypes.js +4 -0
  111. package/lib/module/internal/adapter/web/PlayerFacadeTypes.js.map +1 -0
  112. package/lib/module/manifest.json +1 -1
  113. package/lib/typescript/__tests__/PlayerFacade.test.d.ts +2 -0
  114. package/lib/typescript/__tests__/PlayerFacade.test.d.ts.map +1 -0
  115. package/lib/typescript/__tests__/PlayerFacadeWebAdapter.test.d.ts +2 -0
  116. package/lib/typescript/__tests__/PlayerFacadeWebAdapter.test.d.ts.map +1 -0
  117. package/lib/typescript/__tests__/index.test.d.ts +13 -0
  118. package/lib/typescript/__tests__/index.test.d.ts.map +1 -1
  119. package/lib/typescript/api/THEOplayerView.d.ts +4 -0
  120. package/lib/typescript/api/THEOplayerView.d.ts.map +1 -1
  121. package/lib/typescript/api/barrel.d.ts +1 -0
  122. package/lib/typescript/api/barrel.d.ts.map +1 -1
  123. package/lib/typescript/api/config/PlayerConfiguration.d.ts +15 -0
  124. package/lib/typescript/api/config/PlayerConfiguration.d.ts.map +1 -1
  125. package/lib/typescript/api/event/AdEvent.d.ts +1 -1
  126. package/lib/typescript/api/metrics/MetricsAPI.d.ts +21 -0
  127. package/lib/typescript/api/metrics/MetricsAPI.d.ts.map +1 -0
  128. package/lib/typescript/api/metrics/barrel.d.ts +2 -0
  129. package/lib/typescript/api/metrics/barrel.d.ts.map +1 -0
  130. package/lib/typescript/api/player/Integration.d.ts +88 -0
  131. package/lib/typescript/api/player/Integration.d.ts.map +1 -0
  132. package/lib/typescript/api/player/THEOplayer.d.ts +19 -0
  133. package/lib/typescript/api/player/THEOplayer.d.ts.map +1 -1
  134. package/lib/typescript/api/player/barrel.d.ts +1 -0
  135. package/lib/typescript/api/player/barrel.d.ts.map +1 -1
  136. package/lib/typescript/api/track/MediaTrack.d.ts +21 -4
  137. package/lib/typescript/api/track/MediaTrack.d.ts.map +1 -1
  138. package/lib/typescript/internal/adapter/DefaultNativePlayerState.d.ts +1 -0
  139. package/lib/typescript/internal/adapter/DefaultNativePlayerState.d.ts.map +1 -1
  140. package/lib/typescript/internal/adapter/NativePlayerState.d.ts +1 -0
  141. package/lib/typescript/internal/adapter/NativePlayerState.d.ts.map +1 -1
  142. package/lib/typescript/internal/adapter/THEOplayerAdapter.d.ts +6 -1
  143. package/lib/typescript/internal/adapter/THEOplayerAdapter.d.ts.map +1 -1
  144. package/lib/typescript/internal/adapter/THEOplayerWebAdapter.d.ts +6 -1
  145. package/lib/typescript/internal/adapter/THEOplayerWebAdapter.d.ts.map +1 -1
  146. package/lib/typescript/internal/adapter/WebEventForwarder.d.ts.map +1 -1
  147. package/lib/typescript/internal/adapter/metrics/MetricsNativeAdapter.d.ts +7 -0
  148. package/lib/typescript/internal/adapter/metrics/MetricsNativeAdapter.d.ts.map +1 -0
  149. package/lib/typescript/internal/adapter/metrics/MetricsWebAdapter.d.ts +8 -0
  150. package/lib/typescript/internal/adapter/metrics/MetricsWebAdapter.d.ts.map +1 -0
  151. package/lib/typescript/internal/adapter/web/IntegrationRegistration.d.ts +53 -0
  152. package/lib/typescript/internal/adapter/web/IntegrationRegistration.d.ts.map +1 -0
  153. package/lib/typescript/internal/adapter/web/PlayerFacade.d.ts +26 -0
  154. package/lib/typescript/internal/adapter/web/PlayerFacade.d.ts.map +1 -0
  155. package/lib/typescript/internal/adapter/web/PlayerFacadeAPI.d.ts +33 -0
  156. package/lib/typescript/internal/adapter/web/PlayerFacadeAPI.d.ts.map +1 -0
  157. package/lib/typescript/internal/adapter/web/PlayerFacadeAdsEvents.d.ts +21 -0
  158. package/lib/typescript/internal/adapter/web/PlayerFacadeAdsEvents.d.ts.map +1 -0
  159. package/lib/typescript/internal/adapter/web/PlayerFacadeIntegration.d.ts +43 -0
  160. package/lib/typescript/internal/adapter/web/PlayerFacadeIntegration.d.ts.map +1 -0
  161. package/lib/typescript/internal/adapter/web/PlayerFacadeTypes.d.ts +13 -0
  162. package/lib/typescript/internal/adapter/web/PlayerFacadeTypes.d.ts.map +1 -0
  163. package/package.json +1 -1
  164. package/react-native-theoplayer.podspec +7 -7
  165. package/src/__tests__/PlayerFacade.test.ts +579 -0
  166. package/src/__tests__/PlayerFacadeWebAdapter.test.ts +193 -0
  167. package/src/__tests__/index.test.tsx +15 -1
  168. package/src/api/THEOplayerView.ts +5 -0
  169. package/src/api/barrel.ts +1 -0
  170. package/src/api/config/PlayerConfiguration.ts +16 -0
  171. package/src/api/event/AdEvent.ts +1 -1
  172. package/src/api/metrics/MetricsAPI.ts +20 -0
  173. package/src/api/metrics/barrel.ts +1 -0
  174. package/src/api/player/Integration.ts +97 -0
  175. package/src/api/player/THEOplayer.ts +21 -0
  176. package/src/api/player/barrel.ts +1 -0
  177. package/src/api/track/MediaTrack.ts +21 -4
  178. package/src/internal/THEOplayerView.tsx +2 -2
  179. package/src/internal/THEOplayerView.web.tsx +2 -2
  180. package/src/internal/adapter/DefaultNativePlayerState.ts +1 -0
  181. package/src/internal/adapter/NativePlayerState.ts +1 -0
  182. package/src/internal/adapter/THEOplayerAdapter.ts +24 -0
  183. package/src/internal/adapter/THEOplayerWebAdapter.ts +27 -4
  184. package/src/internal/adapter/WebEventForwarder.ts +5 -3
  185. package/src/internal/adapter/metrics/MetricsNativeAdapter.ts +12 -0
  186. package/src/internal/adapter/metrics/MetricsWebAdapter.ts +14 -0
  187. package/src/internal/adapter/web/IntegrationRegistration.ts +57 -0
  188. package/src/internal/adapter/web/PlayerFacade.ts +281 -0
  189. package/src/internal/adapter/web/PlayerFacadeAPI.ts +35 -0
  190. package/src/internal/adapter/web/PlayerFacadeAdsEvents.ts +119 -0
  191. package/src/internal/adapter/web/PlayerFacadeIntegration.ts +45 -0
  192. package/src/internal/adapter/web/PlayerFacadeTypes.ts +14 -0
  193. package/src/manifest.json +1 -1
@@ -0,0 +1,45 @@
1
+ import type { Ads } from 'theoplayer';
2
+ import type { Integration } from '../../../api/player/Integration';
3
+ import type { PlayerFacadeAds, PlayerFacadeAdsEventMap } from './PlayerFacadeTypes';
4
+
5
+ /**
6
+ * Describes Web-specific advertising overrides for a player facade integration.
7
+ * Optional overrides leave playback ownership and synchronization policy with the integration.
8
+ *
9
+ * @category Player
10
+ * @platform web
11
+ * @internal
12
+ */
13
+ export interface PlayerFacadeIntegration extends Integration {
14
+ /**
15
+ * Supplies the Ads API and event source behind the stable public `player.ads` object.
16
+ *
17
+ * @remarks
18
+ * Keep this object stable until the registration closes. Existing listeners migrate on registration and close.
19
+ * Omit it to retain the content player's Ads API and optionally override only its state through {@link getAdState}.
20
+ */
21
+ readonly ads?: PlayerFacadeAds;
22
+
23
+ /**
24
+ * Returns the advertising state for integrations that do not supply an Ads object.
25
+ *
26
+ * @remarks
27
+ * Legacy state override for integrations that do not supply an Ads object.
28
+ * The facade never derives state from dispatched events. Update state before dispatching corresponding events.
29
+ * An explicitly absent current ad break does not fall back to the content player's ad break.
30
+ *
31
+ * @returns The integration's ad state. Ignored when {@link ads} is supplied.
32
+ */
33
+ getAdState?(): Pick<Ads, 'playing' | 'currentAds' | 'currentAdBreak'>;
34
+
35
+ /**
36
+ * Consumes backing Ads events only; integration-generated events bypass this hook.
37
+ *
38
+ * @param event - The content player's advertising event.
39
+ * @returns `true` to hide the event from all facade Ads listeners, or `false` to forward it.
40
+ *
41
+ * @remarks
42
+ * Called once per subscribed event, not once per listener. Events from {@link ads} bypass this hook.
43
+ */
44
+ shouldConsumeAdEvent?(event: PlayerFacadeAdsEventMap[keyof PlayerFacadeAdsEventMap]): boolean;
45
+ }
@@ -0,0 +1,14 @@
1
+ import type { AdEvent, Ads, AdsEventMap, EventDispatcher, PlayerEventMap } from 'theoplayer';
2
+
3
+ export type { IntegrationRegistration } from './IntegrationRegistration';
4
+ export type { PlayerFacadeAPI as PlayerFacade } from './PlayerFacadeAPI';
5
+ export type { PlayerFacadeIntegration } from './PlayerFacadeIntegration';
6
+
7
+ /** Advertising events supported by the facade, including integration-generated clicks. */
8
+ export type PlayerFacadeAdsEventMap = AdsEventMap & { adclicked: AdEvent<'adclicked'> };
9
+
10
+ /** The Web Ads API with event subscriptions extended to support facade advertising events. */
11
+ export type PlayerFacadeAds = Omit<Ads, 'addEventListener' | 'removeEventListener'> & EventDispatcher<PlayerFacadeAdsEventMap>;
12
+
13
+ /** A native Web player or advertising event that an integration can dispatch through its registration. */
14
+ export type PlayerFacadeEvent = PlayerEventMap[keyof PlayerEventMap] | PlayerFacadeAdsEventMap[keyof PlayerFacadeAdsEventMap];
package/src/manifest.json CHANGED
@@ -1 +1 @@
1
- {"version":"11.6.0","buildDate":"2026-08-06T10:39:32.999Z"}
1
+ {"version":"11.7.0","buildDate":"2026-09-19T14:43:33.039Z"}