@granite-js/video 1.0.0

package/dist/typescript/types.d.ts

@@ -0,0 +1,328 @@
+import type { StyleProp, ViewStyle, ImageSourcePropType } from 'react-native';
+import type { OnVideoLoadStartEvent, OnVideoLoadEvent, OnVideoProgressEvent, OnVideoSeekEvent, OnVideoBufferEvent, OnVideoBandwidthUpdateEvent, OnVideoPlaybackStateChangedEvent, OnVideoPlaybackRateChangeEvent, OnVideoVolumeChangeEvent, OnVideoAudioFocusChangedEvent, OnVideoPictureInPictureStatusChangedEvent, OnVideoControlsVisibilityChangeEvent, OnVideoExternalPlaybackChangeEvent, OnVideoAspectRatioEvent, OnVideoErrorEvent } from './GraniteVideoNativeComponent';
+export interface VideoSourceHeaders {
+    [key: string]: string;
+}
+export interface DrmConfig {
+    type: 'widevine' | 'playready' | 'clearkey' | 'fairplay';
+    licenseServer?: string;
+    headers?: VideoSourceHeaders;
+    contentId?: string;
+    certificateUrl?: string;
+    base64Certificate?: boolean;
+    multiDrm?: boolean;
+}
+export interface TextTrack {
+    title: string;
+    language: string;
+    type: 'application/x-subrip' | 'text/vtt' | 'application/ttml+xml';
+    uri: string;
+}
+export interface BufferConfig {
+    minBufferMs?: number;
+    maxBufferMs?: number;
+    bufferForPlaybackMs?: number;
+    bufferForPlaybackAfterRebufferMs?: number;
+    backBufferDurationMs?: number;
+    cacheSizeMB?: number;
+    live?: {
+        maxPlaybackSpeed?: number;
+        minPlaybackSpeed?: number;
+        maxOffsetMs?: number;
+        minOffsetMs?: number;
+        targetOffsetMs?: number;
+    };
+}
+export interface VideoSource {
+    uri?: string;
+    type?: string;
+    mainVer?: number;
+    patchVer?: number;
+    headers?: VideoSourceHeaders;
+    startPosition?: number;
+    cropStart?: number;
+    cropEnd?: number;
+    drm?: DrmConfig;
+    textTracks?: TextTrack[];
+    metadata?: VideoMetadata;
+}
+export interface VideoMetadata {
+    title?: string;
+    subtitle?: string;
+    description?: string;
+    artist?: string;
+    imageUri?: string;
+}
+export type SelectedTrackType = 'system' | 'disabled' | 'title' | 'language' | 'index';
+export type SelectedVideoTrackType = 'auto' | 'disabled' | 'resolution' | 'index';
+export interface SelectedTrack {
+    type: SelectedTrackType;
+    value?: string | number;
+}
+export interface SelectedVideoTrack {
+    type: SelectedVideoTrackType;
+    value?: number;
+}
+export type ResizeMode = 'contain' | 'cover' | 'stretch' | 'none';
+export type ViewType = 'surface' | 'texture';
+export interface PosterSource {
+    uri?: string;
+}
+export type Poster = ImageSourcePropType | PosterSource;
+export type OnLoadData = OnVideoLoadEvent & {
+    naturalSize: OnVideoLoadEvent['naturalSize'] & {
+        orientation: 'portrait' | 'landscape';
+    };
+    audioTracks: AudioTrack[];
+    textTracks: TextTrackInfo[];
+    videoTracks: VideoTrackInfo[];
+};
+export interface AudioTrack {
+    index: number;
+    title?: string;
+    language?: string;
+    bitrate?: number;
+    type?: string;
+    selected?: boolean;
+}
+export interface TextTrackInfo {
+    index: number;
+    title?: string;
+    language?: string;
+    type?: string;
+    selected?: boolean;
+}
+export interface VideoTrackInfo {
+    index: number;
+    trackId?: string;
+    codecs?: string;
+    width?: number;
+    height?: number;
+    bitrate?: number;
+    selected?: boolean;
+}
+export type OnSeekData = OnVideoSeekEvent & {
+    target?: number;
+};
+export interface OnTimedMetadataData {
+    metadata: Array<{
+        value: string;
+        identifier: string;
+    }>;
+}
+export interface OnAudioTracksData {
+    audioTracks: AudioTrack[];
+}
+export interface OnTextTracksData {
+    textTracks: TextTrackInfo[];
+}
+export interface OnTextTrackDataChangedData {
+    subtitleTracks: string;
+}
+export interface OnVideoTracksData {
+    videoTracks: VideoTrackInfo[];
+}
+export interface OnReceiveAdEventData {
+    event: string;
+    data?: {
+        [key: string]: string | number | boolean;
+    };
+}
+export interface OnTransferEndData {
+    uri: string;
+    bytesTransferred: number;
+}
+export interface VideoRef {
+    seek: (time: number, tolerance?: number) => void;
+    pause: () => void;
+    resume: () => void;
+    setVolume: (volume: number) => void;
+    setFullScreen: (fullscreen: boolean) => void;
+    presentFullscreenPlayer: () => void;
+    dismissFullscreenPlayer: () => void;
+    enterPictureInPicture: () => void;
+    exitPictureInPicture: () => void;
+    setSource: (source: VideoSource) => void;
+    getCurrentPosition: () => Promise<number>;
+    save: (options?: {
+        type?: string;
+    }) => Promise<{
+        uri: string;
+    }>;
+    restoreUserInterfaceForPictureInPictureStopCompleted: (restored: boolean) => void;
+}
+export interface VideoProps {
+    testID?: string;
+    style?: StyleProp<ViewStyle>;
+    progressUpdateInterval?: number;
+    source: VideoSource | number;
+    /**
+     * **NOTE**
+     *
+     * Value: string with a URL for the poster is deprecated, use poster as an object instead.
+     */
+    poster?: Poster | string;
+    posterResizeMode?: ResizeMode;
+    paused?: boolean;
+    muted?: boolean;
+    volume?: number;
+    rate?: number;
+    repeat?: boolean;
+    playInBackground?: boolean;
+    playWhenInactive?: boolean;
+    automaticallyWaitsToMinimizeStalling?: boolean;
+    shutterColor?: string;
+    resizeMode?: ResizeMode;
+    viewType?: ViewType;
+    useTextureView?: boolean;
+    useSecureView?: boolean;
+    bufferConfig?: BufferConfig;
+    minLoadRetryCount?: number;
+    maxBitRate?: number;
+    preferredForwardBufferDuration?: number;
+    selectedAudioTrack?: SelectedTrack;
+    selectedTextTrack?: SelectedTrack;
+    selectedVideoTrack?: SelectedVideoTrack;
+    textTracks?: TextTrack[];
+    drm?: DrmConfig;
+    localSourceEncryptionKeyScheme?: string;
+    adTagUrl?: string;
+    adLanguage?: string;
+    controls?: boolean;
+    showNotificationControls?: boolean;
+    disableFocus?: boolean;
+    disableDisconnectError?: boolean;
+    focusable?: boolean;
+    hideShutterView?: boolean;
+    preventsDisplaySleepDuringVideoPlayback?: boolean;
+    fullscreen?: boolean;
+    fullscreenAutorotate?: boolean;
+    fullscreenOrientation?: 'all' | 'landscape' | 'portrait';
+    pictureInPicture?: boolean;
+    contentStartTime?: number;
+    allowsExternalPlayback?: boolean;
+    audioOutput?: 'speaker' | 'earpiece';
+    ignoreSilentSwitch?: 'inherit' | 'ignore' | 'obey';
+    mixWithOthers?: 'inherit' | 'mix' | 'duck';
+    debug?: {
+        enable?: boolean;
+        thread?: boolean;
+    };
+    /**
+     * Callback when video starts loading
+     */
+    onLoadStart?: (data: OnVideoLoadStartEvent) => void;
+    /**
+     * Callback when video is loaded
+     */
+    onLoad?: (data: OnLoadData) => void;
+    /**
+     * Callback when video fails to load
+     */
+    onError?: (data: OnVideoErrorEvent) => void;
+    /**
+     * Callback during video playback progress
+     */
+    onProgress?: (data: OnVideoProgressEvent) => void;
+    /**
+     * Callback when video seek completes
+     */
+    onSeek?: (data: OnSeekData) => void;
+    /**
+     * Callback when video ends
+     */
+    onEnd?: () => void;
+    /**
+     * Callback when video buffering state changes
+     */
+    onBuffer?: (data: OnVideoBufferEvent) => void;
+    /**
+     * Callback when video bandwidth updates
+     */
+    onBandwidthUpdate?: (data: OnVideoBandwidthUpdateEvent) => void;
+    /**
+     * Callback when playback state changes
+     */
+    onPlaybackStateChanged?: (data: OnVideoPlaybackStateChangedEvent) => void;
+    /**
+     * Callback when playback rate changes
+     */
+    onPlaybackRateChange?: (data: OnVideoPlaybackRateChangeEvent) => void;
+    /**
+     * Callback when volume changes
+     */
+    onVolumeChange?: (data: OnVideoVolumeChangeEvent) => void;
+    /**
+     * Callback when video becomes idle
+     */
+    onIdle?: () => void;
+    /**
+     * Callback when video is ready for display
+     */
+    onReadyForDisplay?: () => void;
+    onPlaybackResume?: () => void;
+    onPlaybackStalled?: () => void;
+    onAudioTracks?: (data: OnAudioTracksData) => void;
+    onTextTracks?: (data: OnTextTracksData) => void;
+    onTextTrackDataChanged?: (data: OnTextTrackDataChangedData) => void;
+    onVideoTracks?: (data: OnVideoTracksData) => void;
+    onTimedMetadata?: (data: OnTimedMetadataData) => void;
+    /**
+     * Callback when video aspect ratio changes
+     */
+    onAspectRatio?: (data: OnVideoAspectRatioEvent) => void;
+    /**
+     * Callback when audio focus changes
+     */
+    onAudioFocusChanged?: (data: OnVideoAudioFocusChangedEvent) => void;
+    /**
+     * Callback when audio becomes noisy
+     */
+    onAudioBecomingNoisy?: () => void;
+    /**
+     * Callback before fullscreen player presents
+     */
+    onFullscreenPlayerWillPresent?: () => void;
+    /**
+     * Callback after fullscreen player presents
+     */
+    onFullscreenPlayerDidPresent?: () => void;
+    /**
+     * Callback before fullscreen player dismisses
+     */
+    onFullscreenPlayerWillDismiss?: () => void;
+    /**
+     * Callback after fullscreen player dismisses
+     */
+    onFullscreenPlayerDidDismiss?: () => void;
+    /**
+     * Callback when picture-in-picture status changes
+     */
+    onPictureInPictureStatusChanged?: (data: OnVideoPictureInPictureStatusChangedEvent) => void;
+    /**
+     * Callback to restore user interface for picture-in-picture stop
+     */
+    onRestoreUserInterfaceForPictureInPictureStop?: () => void;
+    /**
+     * Callback when controls visibility changes
+     */
+    onControlsVisibilityChange?: (data: OnVideoControlsVisibilityChangeEvent) => void;
+    /**
+     * Callback when external playback changes
+     */
+    onExternalPlaybackChange?: (data: OnVideoExternalPlaybackChangeEvent) => void;
+    /**
+     * Callback when receive ad event occurs
+     */
+    onReceiveAdEvent?: (data: OnReceiveAdEventData) => void;
+    /**
+     * Callback when transfer end event occurs
+     */
+    onTransferEnd?: (data: OnTransferEndData) => void;
+}
+export interface VideoStatic {
+    clearCache: () => Promise<void>;
+    getWidevineLevel: () => Promise<number>;
+    isCodecSupported: (mimeType: string, width: number, height: number) => Promise<boolean>;
+    isHEVCSupported: () => Promise<boolean>;
+}

package/ios/GraniteVideoComponentsProvider.h

@@ -0,0 +1,10 @@
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+// Forward declaration to avoid pulling in React C++ headers
+// The actual implementation is in the .mm file
+@protocol RCTComponentViewProtocol;
+Class<RCTComponentViewProtocol> GraniteVideoViewCls(void) __attribute__((used));
+
+NS_ASSUME_NONNULL_END

package/ios/GraniteVideoProvider.swift

@@ -0,0 +1,280 @@
+import UIKit
+import AVFoundation
+
+// ============================================================
+// MARK: - Enums
+// ============================================================
+
+@objc public enum GraniteVideoResizeMode: Int {
+    case contain = 0
+    case cover = 1
+    case stretch = 2
+    case none = 3
+}
+
+@objc public enum GraniteVideoDrmType: Int {
+    case none = 0
+    case fairplay = 1
+    case widevine = 2
+    case playready = 3
+    case clearkey = 4
+}
+
+@objc public enum GraniteVideoAudioOutput: Int {
+    case speaker = 0
+    case earpiece = 1
+}
+
+@objc public enum GraniteVideoIgnoreSilentSwitch: Int {
+    case inherit = 0
+    case ignore = 1
+    case obey = 2
+}
+
+@objc public enum GraniteVideoMixWithOthers: Int {
+    case inherit = 0
+    case mix = 1
+    case duck = 2
+}
+
+// ============================================================
+// MARK: - Data Types
+// ============================================================
+
+@objc public class GraniteVideoDrmConfig: NSObject {
+    @objc public var type: GraniteVideoDrmType = .none
+    @objc public var licenseServer: String?
+    @objc public var headers: [String: String]?
+    @objc public var contentID: String?
+    @objc public var certificateURL: String?
+    @objc public var base64Certificate: Bool = false
+}
+
+@objc public class GraniteVideoSource: NSObject {
+    @objc public var uri: String?
+    @objc public var type: String?
+    @objc public var startPosition: Double = 0
+    @objc public var cropStart: Double = 0
+    @objc public var cropEnd: Double = 0
+    @objc public var headers: [String: String]?
+    @objc public var drm: GraniteVideoDrmConfig?
+
+    @objc public override init() {
+        super.init()
+    }
+
+    @objc public convenience init(uri: String) {
+        self.init()
+        self.uri = uri
+    }
+}
+
+@objc public class GraniteVideoBufferConfig: NSObject {
+    @objc public var minBufferMs: Int = 15000
+    @objc public var maxBufferMs: Int = 50000
+    @objc public var bufferForPlaybackMs: Int = 2500
+    @objc public var bufferForPlaybackAfterRebufferMs: Int = 5000
+    @objc public var cacheSizeMB: Int = 0
+}
+
+@objc public class GraniteVideoSelectedTrack: NSObject {
+    @objc public var type: String = "system"
+    @objc public var value: String?
+}
+
+// ============================================================
+// MARK: - Event Data Types
+// ============================================================
+
+@objc public class GraniteVideoLoadData: NSObject {
+    @objc public var currentTime: Double = 0
+    @objc public var duration: Double = 0
+    @objc public var naturalWidth: Double = 0
+    @objc public var naturalHeight: Double = 0
+    @objc public var orientation: String = "landscape"
+}
+
+@objc public class GraniteVideoProgressData: NSObject {
+    @objc public var currentTime: Double = 0
+    @objc public var playableDuration: Double = 0
+    @objc public var seekableDuration: Double = 0
+}
+
+@objc public class GraniteVideoErrorData: NSObject {
+    @objc public var code: Int = 0
+    @objc public var domain: String = ""
+    @objc public var localizedDescription_: String = ""
+    @objc public var localizedFailureReason_: String = ""
+    @objc public var localizedRecoverySuggestion_: String = ""
+
+    @objc public override init() {
+        super.init()
+    }
+
+    @objc public convenience init(error: Error) {
+        self.init()
+        let nsError = error as NSError
+        self.code = nsError.code
+        self.domain = nsError.domain
+        self.localizedDescription_ = nsError.localizedDescription
+        self.localizedFailureReason_ = nsError.localizedFailureReason ?? ""
+        self.localizedRecoverySuggestion_ = nsError.localizedRecoverySuggestion ?? ""
+    }
+}
+
+// ============================================================
+// MARK: - Delegate Protocol
+// ============================================================
+
+@objc public protocol GraniteVideoDelegate: AnyObject {
+    @objc optional func videoDidLoadStart(isNetwork: Bool, type: String, uri: String)
+    @objc optional func videoDidLoad(data: GraniteVideoLoadData)
+    @objc optional func videoDidFail(error: GraniteVideoErrorData)
+    @objc optional func videoDidUpdateProgress(data: GraniteVideoProgressData)
+    @objc optional func videoDidSeek(currentTime: Double, seekTime: Double)
+    @objc optional func videoDidEnd()
+    @objc optional func videoBufferingStateChanged(isBuffering: Bool)
+    @objc optional func videoBandwidthDidUpdate(bitrate: Double, width: Int, height: Int)
+    @objc optional func videoPlaybackStateChanged(isPlaying: Bool, isSeeking: Bool, isLooping: Bool)
+    @objc optional func videoPlaybackRateChanged(rate: Float)
+    @objc optional func videoVolumeChanged(volume: Float)
+    @objc optional func videoDidBecomeIdle()
+    @objc optional func videoReadyForDisplay()
+    @objc optional func videoAudioBecomingNoisy()
+    @objc optional func videoFullscreenPlayerWillPresent()
+    @objc optional func videoFullscreenPlayerDidPresent()
+    @objc optional func videoFullscreenPlayerWillDismiss()
+    @objc optional func videoFullscreenPlayerDidDismiss()
+    @objc optional func videoPictureInPictureStatusChanged(isActive: Bool)
+    @objc optional func videoRestoreUserInterfaceForPictureInPictureStop()
+    @objc optional func videoControlsVisibilityChanged(isVisible: Bool)
+    @objc optional func videoExternalPlaybackChanged(isActive: Bool)
+    @objc optional func videoAspectRatioChanged(width: Double, height: Double)
+    @objc optional func videoTransferEnd(uri: String, bytesTransferred: Double)
+}
+
+// ============================================================
+// MARK: - Provider Protocol
+// ============================================================
+
+@objc public protocol GraniteVideoProvidable: NSObjectProtocol {
+    // Required - View Creation
+    @objc func createPlayerView() -> UIView
+
+    // Required - Source Loading
+    @objc func loadSource(_ source: GraniteVideoSource)
+    @objc func unload()
+
+    // Required - Playback Control
+    @objc func play()
+    @objc func pause()
+    @objc func seek(to time: Double, toleranceBefore: Double, toleranceAfter: Double)
+
+    // Required - Properties
+    @objc weak var delegate: GraniteVideoDelegate? { get set }
+    @objc var currentTime: Double { get }
+    @objc var duration: Double { get }
+    @objc var isPlaying: Bool { get }
+
+    // Optional - Volume
+    @objc optional func setVolume(_ volume: Float)
+    @objc optional func setMuted(_ muted: Bool)
+
+    // Optional - Rate
+    @objc optional func setRate(_ rate: Float)
+
+    // Optional - Repeat
+    @objc optional func setRepeat(_ shouldRepeat: Bool)
+
+    // Optional - Resize Mode
+    @objc optional func setResizeMode(_ mode: GraniteVideoResizeMode)
+
+    // Optional - Background Playback
+    @objc optional func setPlayInBackground(_ enabled: Bool)
+    @objc optional func setPlayWhenInactive(_ enabled: Bool)
+
+    // Optional - Audio Session
+    @objc optional func setAudioOutput(_ output: GraniteVideoAudioOutput)
+    @objc optional func setIgnoreSilentSwitch(_ mode: GraniteVideoIgnoreSilentSwitch)
+    @objc optional func setMixWithOthers(_ mode: GraniteVideoMixWithOthers)
+
+    // Optional - Fullscreen
+    @objc optional func setFullscreen(_ fullscreen: Bool, animated: Bool)
+    @objc optional func setFullscreenAutorotate(_ autorotate: Bool)
+    @objc optional func setFullscreenOrientation(_ orientation: String)
+
+    // Optional - Picture in Picture
+    @objc optional func setPictureInPictureEnabled(_ enabled: Bool)
+    @objc optional func enterPictureInPicture()
+    @objc optional func exitPictureInPicture()
+
+    // Optional - Controls
+    @objc optional func setControlsEnabled(_ enabled: Bool)
+    @objc optional func setPreventsDisplaySleepDuringVideoPlayback(_ prevents: Bool)
+
+    // Optional - Buffer Config
+    @objc optional func setBufferConfig(_ config: GraniteVideoBufferConfig)
+    @objc optional func setMaxBitRate(_ bitRate: Int)
+    @objc optional func setPreferredForwardBufferDuration(_ duration: Double)
+    @objc optional func setAutomaticallyWaitsToMinimizeStalling(_ waits: Bool)
+
+    // Optional - Track Selection
+    @objc optional func setSelectedAudioTrack(_ track: GraniteVideoSelectedTrack)
+    @objc optional func setSelectedTextTrack(_ track: GraniteVideoSelectedTrack)
+    @objc optional func setSelectedVideoTrack(type: String, value: Int)
+
+    // Optional - External Playback
+    @objc optional func setAllowsExternalPlayback(_ allows: Bool)
+
+    // Optional - DRM
+    @objc optional func setDrmConfig(_ config: GraniteVideoDrmConfig)
+
+    // Optional - Poster
+    @objc optional func setPoster(_ url: String, resizeMode: GraniteVideoResizeMode)
+
+    // Optional - Save
+    @objc optional func save(type: String, completion: @escaping (String?, Error?) -> Void)
+
+    // Optional - Cache Management
+    @objc optional func clearCache()
+}
+
+// ============================================================
+// MARK: - Registry
+// ============================================================
+
+public typealias GraniteVideoProviderFactory = () -> GraniteVideoProvidable
+
+@objc public class GraniteVideoRegistry: NSObject {
+    @objc public static let shared = GraniteVideoRegistry()
+
+    private var internalProvider: GraniteVideoProvidable?
+    private var providerFactory: GraniteVideoProviderFactory?
+
+    private override init() {
+        super.init()
+    }
+
+    @objc public var provider: GraniteVideoProvidable? {
+        return internalProvider
+    }
+
+    @objc public func register(provider: GraniteVideoProvidable) {
+        internalProvider = provider
+    }
+
+    @objc public func register(factory: @escaping GraniteVideoProviderFactory) {
+        providerFactory = factory
+    }
+
+    @objc public func createProvider() -> GraniteVideoProvidable? {
+        if let factory = providerFactory {
+            return factory()
+        }
+        return internalProvider
+    }
+
+    @objc public func hasProvider() -> Bool {
+        return internalProvider != nil || providerFactory != nil
+    }
+}

package/ios/GraniteVideoView.h

@@ -0,0 +1,15 @@
+#import <UIKit/UIKit.h>
+
+#ifndef GraniteVideoViewNativeComponent_h
+#define GraniteVideoViewNativeComponent_h
+
+NS_ASSUME_NONNULL_BEGIN
+
+// Forward declare to avoid pulling in C++ headers
+// RCTViewComponentView import is in the .mm file
+@interface GraniteVideoView : UIView
+@end
+
+NS_ASSUME_NONNULL_END
+
+#endif /* GraniteVideoViewNativeComponent_h */