@npaw/forge-react-native-video 9.7.5 → 10.7.5

package/android/src/rnv6/java/com/npaw/forge/reactnative/video/NPAWForgeVideoModule.java

@@ -1,341 +0,0 @@
-/**
- * Copyright (C) NPAW - All Rights Reserved
- *
- * This source code is protected under international copyright law. All rights
- * reserved and protected by the copyright holders.
- * This file is confidential and only available to authorized individuals with the
- * permission of the copyright holders. If you encounter this file and do not have
- * permission, please contact the copyright holders and delete this file.
- *
- *
- * @author: Victor Soto <victor.soto@nicepeopleatwork.com>
- * @description: react-native-video glue TurboModule for Android. Implements RNVExoplayerPlugin, smuggles the X-NPAW-Forge header token into the MediaItem tag via overrideMediaItemBuilder, caches player facts on the main thread, and delegates policy to RNVideoAttachCoordinator to bind Forge's Media3PlayerAdapter.
- */
-
-package com.npaw.forge.reactnative.video;
-
-import androidx.annotation.Nullable;
-import android.os.Handler;
-import android.os.Looper;
-import androidx.media3.common.MediaItem;
-import androidx.media3.datasource.DataSource;
-import androidx.media3.exoplayer.ExoPlayer;
-import androidx.media3.exoplayer.drm.DrmSessionManager;
-import androidx.media3.exoplayer.source.MediaSource;
-import com.brentvatne.common.api.Source;
-import com.brentvatne.exoplayer.DRMManagerSpec;
-import com.brentvatne.exoplayer.RNVExoplayerPlugin;
-import com.brentvatne.react.ReactNativeVideoManager;
-import com.facebook.react.bridge.Arguments;
-import com.facebook.react.bridge.Promise;
-import com.facebook.react.bridge.ReactApplicationContext;
-import com.facebook.react.bridge.ReadableMap;
-import com.facebook.react.bridge.UiThreadUtil;
-import com.facebook.react.bridge.WritableMap;
-import com.npaw.forge.android.NPAWForge;
-import com.npaw.forge.android.adapters.media3.Media3PlayerAdapter;
-import com.npaw.forge.android.video.VideoAdapter;
-import com.npaw.forge.reactnative.ForgeInstanceRegistry;
-import java.util.HashMap;
-import java.util.Locale;
-import java.util.Map;
-import java.util.concurrent.ConcurrentHashMap;
-
-public class NPAWForgeVideoModule extends NativeNPAWForgeVideoSpec
-    implements RNVExoplayerPlugin {
-
-  public static final String NAME = "NPAWForgeVideoRN";
-  /** Header customers set on source.requestHeaders for multi-player matching. */
-  public static final String TOKEN_HEADER = "x-npaw-forge";
-  private static final String TAG_PREFIX = "npaw-forge:";
-  private static final String E_UNKNOWN_INSTANCE = "E_FORGE_UNKNOWN_INSTANCE";
-
-  private static final class PlayerFacts {
-    @Nullable volatile String token;
-    @Nullable volatile String uri;
-  }
-
-  private final ConcurrentHashMap<String, PlayerFacts> facts = new ConcurrentHashMap<>();
-  private final ConcurrentHashMap<String, ExoPlayer> playersById = new ConcurrentHashMap<>();
-  private final ConcurrentHashMap<String, Media3PlayerAdapter> adaptersByPlayerId =
-      new ConcurrentHashMap<>();
-  private final Handler mainHandler = new Handler(Looper.getMainLooper());
-
-  private final RNVideoAttachCoordinator<ExoPlayer> coordinator =
-      new RNVideoAttachCoordinator<>(
-          new RNVideoAttachCoordinator.PlayerIntrospection() {
-            @Nullable
-            @Override
-            public String currentToken(String playerId) {
-              PlayerFacts f = facts.get(playerId);
-              return f == null ? null : f.token;
-            }
-
-            @Nullable
-            @Override
-            public String currentUri(String playerId) {
-              PlayerFacts f = facts.get(playerId);
-              return f == null ? null : f.uri;
-            }
-          },
-          new RNVideoAttachCoordinator.Binder<ExoPlayer>() {
-            @Override
-            public void bind(String instanceId, String identifier, String playerId, ExoPlayer player) {
-              bindOnMain(instanceId, identifier, playerId, player);
-            }
-
-            @Override
-            public void unbind(
-                String instanceId, String identifier, String playerId, boolean fireStop) {
-              unbindOnMain(instanceId, identifier, playerId, fireStop);
-            }
-          });
-
-  public NPAWForgeVideoModule(ReactApplicationContext reactContext) {
-    super(reactContext);
-    ReactNativeVideoManager.Companion.getInstance().registerPlugin(this);
-  }
-
-  @Override
-  public String getName() {
-    return NAME;
-  }
-
-  // ---- spec surface ----
-
-  @Override
-  public void attach(String instanceId, String identifier, @Nullable ReadableMap options, Promise promise) {
-    NPAWForge forge = ForgeInstanceRegistry.resolve(instanceId);
-    if (forge == null) {
-      promise.reject(E_UNKNOWN_INSTANCE, "No NPAWForge instance '" + instanceId + "'");
-      return;
-    }
-    ensureVideo(forge, identifier);
-
-    Map<String, Object> map = options == null ? new HashMap<>() : options.toHashMap();
-    String headerToken = stringOrNull(map.get("headerToken"));
-    String sourceUri = stringOrNull(map.get("sourceUri"));
-    String policy = stringOrNull(map.get("policy"));
-    if (policy == null) {
-      policy = (headerToken != null || sourceUri != null) ? "match" : "auto";
-    }
-    boolean stopOnPlayerRemoved =
-        !(map.get("stopOnPlayerRemoved") instanceof Boolean)
-            || (Boolean) map.get("stopOnPlayerRemoved");
-
-    RNVideoAttachCoordinator.AttachOutcome outcome =
-        coordinator.attach(
-            new RNVideoAttachCoordinator.AttachRequest(
-                instanceId, identifier, policy, headerToken, sourceUri, stopOnPlayerRemoved));
-    scheduleFactRefreshes();
-    promise.resolve(attachResult(outcome));
-  }
-
-  @Override
-  public void detach(String instanceId, String identifier, Promise promise) {
-    boolean removed = coordinator.detach(instanceId, identifier, true);
-    WritableMap result = Arguments.createMap();
-    result.putString("code", removed ? "accepted" : "ignored_invalid_state");
-    result.putBoolean("isAccepted", removed);
-    result.putString("attachment", "pending");
-    promise.resolve(result);
-  }
-
-  @Override
-  public void invalidate() {
-    ReactNativeVideoManager.Companion.getInstance().unregisterPlugin(this);
-    coordinator.clear();
-    facts.clear();
-    playersById.clear();
-    adaptersByPlayerId.clear();
-    super.invalidate();
-  }
-
-  // ---- RNVExoplayerPlugin ----
-
-  @Override
-  public void onInstanceCreated(String id, ExoPlayer player) {
-    facts.putIfAbsent(id, new PlayerFacts());
-    playersById.put(id, player);
-    UiThreadUtil.runOnUiThread(
-        () -> {
-          refreshFacts(id, player);
-          coordinator.playerCreated(id, player);
-        });
-    scheduleFactRefreshes();
-  }
-
-  @Override
-  public void onInstanceRemoved(String id, ExoPlayer player) {
-    playersById.remove(id);
-    facts.remove(id);
-    coordinator.playerRemoved(id);
-  }
-
-  // ---- RNVExoplayerPlugin optional hooks ----
-
-  @Nullable
-  @Override
-  public DRMManagerSpec getDRMManager() {
-    return null;
-  }
-
-  @Nullable
-  @Override
-  public DrmSessionManager overrideDrmSessionManager(Source source, DrmSessionManager drmSessionManager) {
-    return null;
-  }
-
-  @Nullable
-  @Override
-  public DataSource.Factory overrideMediaDataSourceFactory(
-      Source source, DataSource.Factory mediaDataSourceFactory) {
-    return null;
-  }
-
-  @Nullable
-  @Override
-  public MediaSource.Factory overrideMediaSourceFactory(
-      Source source, MediaSource.Factory mediaSourceFactory, DataSource.Factory mediaDataSourceFactory) {
-    return null;
-  }
-
-  @Nullable
-  @Override
-  public MediaItem.Builder overrideMediaItemBuilder(Source source, MediaItem.Builder mediaItemBuilder) {
-    String token = tokenFromHeaders(source.getHeaders());
-    if (token == null) {
-      return null;
-    }
-    // The tag rides the MediaItem so introspection can read it back from
-    // player.currentMediaItem on the main thread - deterministic multi-player
-    // correlation without joining override->create call ordering.
-    return mediaItemBuilder.setTag(TAG_PREFIX + token);
-  }
-
-  @Override
-  public boolean shouldDisableCache(Source source) {
-    return false;
-  }
-
-  @Override
-  public void onInstanceCreated(String id, Object player) {
-    if (player instanceof ExoPlayer) {
-      onInstanceCreated(id, (ExoPlayer) player);
-    }
-  }
-
-  @Override
-  public void onInstanceRemoved(String id, Object player) {
-    if (player instanceof ExoPlayer) {
-      onInstanceRemoved(id, (ExoPlayer) player);
-    }
-  }
-
-  // ---- internals ----
-
-  private void ensureVideo(NPAWForge forge, String identifier) {
-    if (forge.getVideoAdapter(identifier) == null) {
-      forge.videoBuilder().setIdentifier(identifier).build();
-    }
-  }
-
-  /**
-   * Sources settle after player creation; instead of a media3 Player.Listener
-   * (whose default-method desugaring is fragile across media3 versions), a
-   * few delayed main-thread refreshes converge token/URI facts and re-run the
-   * pending-match evaluation.
-   */
-  private void scheduleFactRefreshes() {
-    for (long delayMs : new long[] {0L, 500L, 1500L, 3000L}) {
-      mainHandler.postDelayed(
-          () -> {
-            for (Map.Entry<String, ExoPlayer> entry : playersById.entrySet()) {
-              refreshFacts(entry.getKey(), entry.getValue());
-            }
-            coordinator.playerSourceSettled();
-          },
-          delayMs);
-    }
-  }
-
-  /** Main thread only. */
-  private void refreshFacts(String playerId, ExoPlayer player) {
-    PlayerFacts f = facts.computeIfAbsent(playerId, key -> new PlayerFacts());
-    MediaItem item = player.getCurrentMediaItem();
-    if (item != null && item.localConfiguration != null) {
-      Object tag = item.localConfiguration.tag;
-      f.token =
-          tag instanceof String && ((String) tag).startsWith(TAG_PREFIX)
-              ? ((String) tag).substring(TAG_PREFIX.length())
-              : null;
-      f.uri = item.localConfiguration.uri.toString();
-    }
-  }
-
-  private void bindOnMain(String instanceId, String identifier, String playerId, ExoPlayer player) {
-    UiThreadUtil.runOnUiThread(
-        () -> {
-          NPAWForge forge = ForgeInstanceRegistry.resolve(instanceId);
-          if (forge == null || player == null) {
-            return;
-          }
-          ensureVideo(forge, identifier);
-          VideoAdapter video = forge.getVideoAdapter(identifier);
-          if (video == null) {
-            return;
-          }
-          Media3PlayerAdapter adapter = new Media3PlayerAdapter(player);
-          video.setPlayerAdapter(adapter);
-          adaptersByPlayerId.put(playerId, adapter);
-        });
-  }
-
-  private void unbindOnMain(String instanceId, String identifier, String playerId, boolean fireStop) {
-    UiThreadUtil.runOnUiThread(
-        () -> {
-          adaptersByPlayerId.remove(playerId);
-          VideoAdapter video = ForgeInstanceRegistry.resolveVideoAdapter(instanceId, identifier);
-          if (video == null) {
-            return;
-          }
-          if (fireStop) {
-            video.fireStop();
-          }
-          video.setPlayerAdapter(null);
-        });
-  }
-
-  @Nullable
-  private static String tokenFromHeaders(@Nullable Map<String, String> headers) {
-    if (headers == null) {
-      return null;
-    }
-    for (Map.Entry<String, String> entry : headers.entrySet()) {
-      if (entry.getKey() != null
-          && TOKEN_HEADER.equals(entry.getKey().toLowerCase(Locale.ROOT))) {
-        return entry.getValue();
-      }
-    }
-    return null;
-  }
-
-  @Nullable
-  private static String stringOrNull(@Nullable Object value) {
-    if (value instanceof String && !((String) value).isEmpty()) {
-      return (String) value;
-    }
-    return null;
-  }
-
-  private static WritableMap attachResult(RNVideoAttachCoordinator.AttachOutcome outcome) {
-    WritableMap result = Arguments.createMap();
-    result.putString("code", outcome.code);
-    result.putBoolean("isAccepted", outcome.accepted);
-    result.putString("attachment", outcome.attachment);
-    if (outcome.reason != null) {
-      result.putString("reason", outcome.reason);
-    }
-    return result;
-  }
-}

package/ios/rnv6/ForgeRNVPlayerPlugin.swift

@@ -1,122 +0,0 @@
-/**
- * Copyright (C) NPAW - All Rights Reserved
- *
- * This source code is protected under international copyright law. All rights
- * reserved and protected by the copyright holders.
- * This file is confidential and only available to authorized individuals with the
- * permission of the copyright holders. If you encounter this file and do not have
- * permission, please contact the copyright holders and delete this file.
- *
- *
- * @author: Victor Soto <victor.soto@nicepeopleatwork.com>
- * @description: Mandatory RNVAVPlayerPlugin subclass (split object from the TurboModule); forwards react-native-video player lifecycle and source/asset sightings to the Forge attach coordinator.
- */
-
-import AVFoundation
-import Foundation
-#if canImport(react_native_video)
-import react_native_video
-#endif
-
-/// react-native-video stores plugins in an unordered Set and RCTVideo has two
-/// onInstanceCreated call sites, so this object registers exactly once and the
-/// coordinator dedupes repeated deliveries of the same player.
-final class ForgeRNVPlayerPlugin: RNVAVPlayerPlugin {
-
-    static let shared = ForgeRNVPlayerPlugin()
-    private static var registered = false
-    private static let registrationLock = NSLock()
-
-    static func registerOnce() {
-        registrationLock.lock()
-        defer { registrationLock.unlock() }
-        guard !registered else { return }
-        registered = true
-        ReactNativeVideoManager.shared.registerPlugin(plugin: shared)
-    }
-
-    override func onInstanceCreated(id: String, player: AVPlayer) {
-        NSLog("[NPAWForgeRNV] player created id=%@", id)
-        ForgeVideoModuleImpl.shared.playerCreated(id: id, player: player)
-    }
-
-    override func onInstanceRemoved(id: String, player: AVPlayer) {
-        ForgeVideoModuleImpl.shared.playerRemoved(id: id, player: player)
-    }
-
-    /// Called for every AVPlayerItem creation; we never override the asset,
-    /// but we record (asset identity -> token/uri) so the coordinator can
-    /// correlate players with sources deterministically.
-    ///
-    /// VideoSource's fields are `internal` to react-native-video, so the
-    /// token/uri are read via Mirror reflection (read-only), with the
-    /// AVURLAsset URL as the fallback. Follow-up filed to propose public
-    /// accessors upstream.
-    override func overridePlayerAsset(source: VideoSource, asset: AVAsset) async -> OverridePlayerAssetResult? {
-        var token: String?
-        var uri: String?
-        var sawUriLabel = false
-        var sawHeadersLabel = false
-        let mirror = Mirror(reflecting: source)
-        for child in mirror.children {
-            switch child.label {
-            case "uri":
-                sawUriLabel = true
-                uri = child.value as? String ?? (child.value as? String?) ?? nil
-            case "requestHeaders":
-                sawHeadersLabel = true
-                let headers = (child.value as? [String: Any]) ?? (child.value as? [String: Any]?) ?? nil
-                if let headers {
-                    for (key, value) in headers where key.lowercased() == ForgeVideoModuleImpl.tokenHeader {
-                        token = value as? String
-                    }
-                }
-            default:
-                break
-            }
-        }
-        // Reflection has no compile-time contract, so a renamed field would
-        // otherwise degrade in silence: `uri` falls back to the asset URL below
-        // and playback still reports, while token correlation quietly stops.
-        // Say so once, loudly enough to be found in a device log. The CI-side
-        // guard is __tests__/rn-video-source-contract.test.ts.
-        if !sawUriLabel || !sawHeadersLabel {
-            ForgeRNVPlayerPlugin.reportReflectionDrift(sawUri: sawUriLabel, sawHeaders: sawHeadersLabel)
-        }
-        if uri == nil, let urlAsset = asset as? AVURLAsset {
-            uri = urlAsset.url.absoluteString
-        }
-        ForgeVideoModuleImpl.shared.sourceSeen(asset: asset, token: token, uri: uri)
-        return nil
-    }
-
-    /// One-shot notice that `VideoSource`'s shape no longer matches what the
-    /// reflection expects.
-    ///
-    /// Reported once per process: this runs for every player item, and a
-    /// per-item log on a list screen would bury the very message it exists to
-    /// surface. Reuses the same static-lock pattern as `registerOnce`.
-    private static var reflectionDriftReported = false
-
-    private static func reportReflectionDrift(sawUri: Bool, sawHeaders: Bool) {
-        registrationLock.lock()
-        if reflectionDriftReported {
-            registrationLock.unlock()
-            return
-        }
-        reflectionDriftReported = true
-        registrationLock.unlock()
-
-        let missing = [sawUri ? nil : "uri", sawHeaders ? nil : "requestHeaders"]
-            .compactMap { $0 }
-            .joined(separator: ", ")
-        NSLog(
-            "[NPAWForge] react-native-video VideoSource no longer exposes: %@. "
-                + "Forge reads these by reflection because they are internal upstream. "
-                + "Playback reporting continues, but token correlation is degraded. "
-                + "Check the installed react-native-video version against the "
-                + "supported range (>=6.11.0 <7).",
-            missing
-        )
-    }
-}