@npaw/forge-react-native-video 9.6.1

package/ios/NPAWForgeVideoTurboModule.mm

@@ -0,0 +1,89 @@
+/**
+ * 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: ObjC++ TurboModule shell for the NPAWForgeVideo module; forwards to the Swift ForgeVideoModuleImpl.
+ */
+
+#import <React/RCTBridgeModule.h>
+#import <React/RCTInvalidating.h>
+
+#ifdef RCT_NEW_ARCH_ENABLED
+#import <NPAWForgeVideoSpec/NPAWForgeVideoSpec.h>
+#endif
+
+#if __has_include("NPAWForgeReactNativeVideo-Swift.h")
+#import "NPAWForgeReactNativeVideo-Swift.h"
+#else
+#import <NPAWForgeReactNativeVideo/NPAWForgeReactNativeVideo-Swift.h>
+#endif
+
+#ifdef RCT_NEW_ARCH_ENABLED
+@interface NPAWForgeVideoReactNative : NSObject <NativeNPAWForgeVideoSpec, RCTInvalidating>
+@end
+#else
+@interface NPAWForgeVideoReactNative : NSObject <RCTBridgeModule, RCTInvalidating>
+@end
+#endif
+
+@implementation NPAWForgeVideoReactNative
+
+RCT_EXPORT_MODULE(NPAWForgeVideoRN)
+
++ (BOOL)requiresMainQueueSetup
+{
+  return NO;
+}
+
+// Swift closure typealiases are not exported to the generated header; the
+// Swift methods surface their reject parameters as plain ObjC blocks.
+typedef void (^ForgeVideoRejectBlockObjC)(NSString *code, NSString *message);
+
+static ForgeVideoRejectBlockObjC ForgeVideoMakeReject(RCTPromiseRejectBlock reject)
+{
+  return ^(NSString *code, NSString *message) {
+    reject(code, message, nil);
+  };
+}
+
+RCT_EXPORT_METHOD(attach : (NSString *)instanceId identifier : (NSString *)identifier options : (
+    NSDictionary *)options resolve : (RCTPromiseResolveBlock)resolve reject : (
+    RCTPromiseRejectBlock)reject)
+{
+  [ForgeVideoModuleImpl.shared attach:instanceId
+                           identifier:identifier
+                              options:options
+                              resolve:resolve
+                               reject:ForgeVideoMakeReject(reject)];
+}
+
+RCT_EXPORT_METHOD(detach : (NSString *)instanceId identifier : (NSString *)identifier resolve : (
+    RCTPromiseResolveBlock)resolve reject : (RCTPromiseRejectBlock)reject)
+{
+  [ForgeVideoModuleImpl.shared detach:instanceId
+                           identifier:identifier
+                              resolve:resolve
+                               reject:ForgeVideoMakeReject(reject)];
+}
+
+- (void)invalidate
+{
+  [ForgeVideoModuleImpl.shared invalidate];
+}
+
+#ifdef RCT_NEW_ARCH_ENABLED
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+  return std::make_shared<facebook::react::NativeNPAWForgeVideoSpecJSI>(params);
+}
+#endif
+
+@end

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@npaw/forge-react-native-video",
+  "version": "9.6.1",
+  "description": "react-native-video adapter glue for NPAW Forge: attaches the native Media3/AVPlayer Forge adapters to react-native-video's internal players via its native plugin API.",
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Victor Soto <victor.soto@nicepeopleatwork.com>",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "files": [
+    "LICENSE",
+    "NPAWForgeReactNativeVideo.podspec",
+    "README.md",
+    "android",
+    "ios",
+    "src"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@npaw/forge-react-native": "^9.6.1",
+    "react": "*",
+    "react-native": "*",
+    "react-native-video": ">=6.11.0 <7"
+  },
+  "codegenConfig": {
+    "name": "NPAWForgeVideoSpec",
+    "type": "modules",
+    "jsSrcsDir": "src/specs",
+    "android": {
+      "javaPackageName": "com.npaw.forge.reactnative.video"
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,79 @@
+/**
+ * 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: Public API for @npaw/forge-react-native-video - binds Forge's native player adapters to react-native-video with auto/token/uri correlation policies.
+ */
+
+import NativeNPAWForgeVideo from './specs/NativeNPAWForgeVideo';
+
+type ForgeLike = string | { instanceId: string };
+
+/**
+ * The request header used for deterministic multi-player matching. Set the
+ * same opaque value on the <Video> source and in attach options:
+ *
+ *   <Video source={{uri, headers: {[FORGE_VIDEO_TOKEN_HEADER]: 'main'}}} />
+ *   attachReactNativeVideo(forge, {headerToken: 'main'});
+ *
+ * Note: the header travels to the CDN with every media request; use a short
+ * opaque value.
+ */
+export const FORGE_VIDEO_TOKEN_HEADER = 'X-NPAW-Forge';
+
+export type AttachPolicy = 'auto' | 'match';
+
+export type AttachOptions = {
+  /** Forge video identifier; defaults to the native 'default'. */
+  identifier?: string;
+  /** 'auto' binds the single live unbound player; 'match' needs token/uri. */
+  policy?: AttachPolicy;
+  /** Matches the player whose source carries this X-NPAW-Forge header value. */
+  headerToken?: string;
+  /** Exact source-URI fallback matcher (breaks on duplicate URIs). */
+  sourceUri?: string;
+  /** Fire Stop + detach when react-native-video removes the player. Default true. */
+  stopOnPlayerRemoved?: boolean;
+};
+
+export type AttachResult = {
+  code: string;
+  isAccepted: boolean;
+  reason?: string;
+  attachment: 'bound' | 'pending';
+};
+
+function resolveInstanceId(forge: ForgeLike): string {
+  return typeof forge === 'string' ? forge : forge.instanceId;
+}
+
+/**
+ * Binds Forge's native player adapter (Media3 on Android, AVPlayer on iOS)
+ * to a react-native-video player. With no options: single-player auto-attach
+ * (ambiguity fails closed as unsupported_capability/ambiguous_auto_attach).
+ */
+export function attachReactNativeVideo(
+  forge: ForgeLike,
+  options: AttachOptions = {}
+): Promise<AttachResult> {
+  const { identifier = 'default', ...rest } = options;
+  return NativeNPAWForgeVideo.attach(
+    resolveInstanceId(forge),
+    identifier,
+    rest
+  ) as Promise<AttachResult>;
+}
+
+export function detachReactNativeVideo(
+  forge: ForgeLike,
+  identifier: string = 'default'
+): Promise<AttachResult> {
+  return NativeNPAWForgeVideo.detach(resolveInstanceId(forge), identifier) as Promise<AttachResult>;
+}

package/src/specs/NativeNPAWForgeVideo.ts

@@ -0,0 +1,30 @@
+/**
+ * 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: TurboModule codegen spec for the react-native-video Forge adapter glue (attach/detach with correlation policy options).
+ */
+
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+import type { UnsafeObject } from 'react-native/Libraries/Types/CodegenTypes';
+
+export interface Spec extends TurboModule {
+  /**
+   * Requests a native adapter bind for (instanceId, identifier). Options:
+   * policy 'auto' | 'match', headerToken, sourceUri, stopOnPlayerRemoved.
+   * Resolves a ForgeOutcome DTO plus { attachment: 'bound' | 'pending' }.
+   */
+  attach(instanceId: string, identifier: string, options: UnsafeObject): Promise<UnsafeObject>;
+  /** Unbinds the identifier's adapter from its player (fires Stop first). */
+  detach(instanceId: string, identifier: string): Promise<UnsafeObject>;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('NPAWForgeVideoRN');