extended-vlc-player 0.1.0

package/build/ExtendedVlcPlayerView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtendedVlcPlayerView.d.ts","sourceRoot":"","sources":["../src/ExtendedVlcPlayerView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAI1D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,4FA6CjC,CAAC"}

package/build/ExtendedVlcPlayerView.js

@@ -0,0 +1,30 @@
+import { requireNativeViewManager } from 'expo-modules-core';
+import * as React from 'react';
+import { Platform } from 'react-native';
+const NativeView = requireNativeViewManager('ExtendedVlcPlayerView');
+/**
+ * Drop-in replacement for `expo-video`'s `VideoView`. Renders the VLC-backed
+ * native player and forwards events back to the JS callbacks.
+ */
+export const ExtendedVlcPlayerView = React.forwardRef(function ExtendedVlcPlayerView(props, ref) {
+    const { player, style, contentFit = 'contain', onLoad, onProgress, onPlaying, onPaused, onEnded, onError, onBuffering, onPictureInPictureStart, onPictureInPictureStop, } = props;
+    // The `player` object carries the nativeId internally (the hook bumps
+    // it on first render). The native view reads it via a getter so we
+    // don't have to thread the number through props.
+    const nativeId = player._nativeId ?? 0;
+    return (<NativeView ref={ref} style={style} player={nativeId} contentFit={contentFit} 
+    // Standard Fabric "bubbling event" props. They are passed as
+    // RCTBubblingEventBlock on the native side; the Swift
+    // PlayerSession fires the corresponding closures which the
+    // PlayerRegistryBridge forwards back to the view component,
+    // which then invokes the right block.
+    onLoad={onLoad} onProgress={onProgress} onPlaying={onPlaying} onPaused={onPaused} onEnded={onEnded} onError={onError} onBuffering={onBuffering} onPictureInPictureStart={onPictureInPictureStart} onPictureInPictureStop={onPictureInPictureStop}/>);
+});
+// Surface a helpful message on platforms where the view manager is not
+// registered (e.g. web). The real native view manager is registered by
+// the iOS / Android sides.
+if (Platform.OS !== 'ios' && Platform.OS !== 'android') {
+    // eslint-disable-next-line no-console
+    console.warn('[extended-vlc-player] ExtendedVlcPlayerView is only supported on iOS and Android.');
+}
+//# sourceMappingURL=ExtendedVlcPlayerView.js.map

package/build/ExtendedVlcPlayerView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtendedVlcPlayerView.js","sourceRoot":"","sources":["../src/ExtendedVlcPlayerView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAkB,MAAM,cAAc,CAAC;AAIxD,MAAM,UAAU,GAAG,wBAAwB,CAAC,uBAAuB,CAAC,CAAC;AAErE;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC,UAAU,CACnD,SAAS,qBAAqB,CAAC,KAAK,EAAE,GAAG;IACvC,MAAM,EACJ,MAAM,EACN,KAAK,EACL,UAAU,GAAG,SAAS,EACtB,MAAM,EACN,UAAU,EACV,SAAS,EACT,QAAQ,EACR,OAAO,EACP,OAAO,EACP,WAAW,EACX,uBAAuB,EACvB,sBAAsB,GACvB,GAAG,KAAK,CAAC;IAEV,sEAAsE;IACtE,mEAAmE;IACnE,iDAAiD;IACjD,MAAM,QAAQ,GAAI,MAA4C,CAAC,SAAS,IAAI,CAAC,CAAC;IAE9E,OAAO,CACL,CAAC,UAAU,CACT,GAAG,CAAC,CAAC,GAAG,CAAC,CACT,KAAK,CAAC,CAAC,KAAkB,CAAC,CAC1B,MAAM,CAAC,CAAC,QAAQ,CAAC,CACjB,UAAU,CAAC,CAAC,UAAU,CAAC;IACvB,6DAA6D;IAC7D,sDAAsD;IACtD,2DAA2D;IAC3D,4DAA4D;IAC5D,sCAAsC;IACtC,MAAM,CAAC,CAAC,MAAM,CAAC,CACf,UAAU,CAAC,CAAC,UAAU,CAAC,CACvB,SAAS,CAAC,CAAC,SAAS,CAAC,CACrB,QAAQ,CAAC,CAAC,QAAQ,CAAC,CACnB,OAAO,CAAC,CAAC,OAAO,CAAC,CACjB,OAAO,CAAC,CAAC,OAAO,CAAC,CACjB,WAAW,CAAC,CAAC,WAAW,CAAC,CACzB,uBAAuB,CAAC,CAAC,uBAAuB,CAAC,CACjD,sBAAsB,CAAC,CAAC,sBAAsB,CAAC,EAC/C,CACH,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,uEAAuE;AACvE,uEAAuE;AACvE,2BAA2B;AAC3B,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;IACvD,sCAAsC;IACtC,OAAO,CAAC,IAAI,CACV,mFAAmF,CACpF,CAAC;AACJ,CAAC","sourcesContent":["import { requireNativeViewManager } from 'expo-modules-core';\nimport * as React from 'react';\nimport { Platform, type ViewStyle } from 'react-native';\n\nimport type { ExtendedVlcPlayerViewProps } from './types';\n\nconst NativeView = requireNativeViewManager('ExtendedVlcPlayerView');\n\n/**\n * Drop-in replacement for `expo-video`'s `VideoView`. Renders the VLC-backed\n * native player and forwards events back to the JS callbacks.\n */\nexport const ExtendedVlcPlayerView = React.forwardRef<unknown, ExtendedVlcPlayerViewProps>(\n  function ExtendedVlcPlayerView(props, ref) {\n    const {\n      player,\n      style,\n      contentFit = 'contain',\n      onLoad,\n      onProgress,\n      onPlaying,\n      onPaused,\n      onEnded,\n      onError,\n      onBuffering,\n      onPictureInPictureStart,\n      onPictureInPictureStop,\n    } = props;\n\n    // The `player` object carries the nativeId internally (the hook bumps\n    // it on first render). The native view reads it via a getter so we\n    // don't have to thread the number through props.\n    const nativeId = (player as unknown as { _nativeId?: number })._nativeId ?? 0;\n\n    return (\n      <NativeView\n        ref={ref}\n        style={style as ViewStyle}\n        player={nativeId}\n        contentFit={contentFit}\n        // Standard Fabric \"bubbling event\" props. They are passed as\n        // RCTBubblingEventBlock on the native side; the Swift\n        // PlayerSession fires the corresponding closures which the\n        // PlayerRegistryBridge forwards back to the view component,\n        // which then invokes the right block.\n        onLoad={onLoad}\n        onProgress={onProgress}\n        onPlaying={onPlaying}\n        onPaused={onPaused}\n        onEnded={onEnded}\n        onError={onError}\n        onBuffering={onBuffering}\n        onPictureInPictureStart={onPictureInPictureStart}\n        onPictureInPictureStop={onPictureInPictureStop}\n      />\n    );\n  }\n);\n\n// Surface a helpful message on platforms where the view manager is not\n// registered (e.g. web). The real native view manager is registered by\n// the iOS / Android sides.\nif (Platform.OS !== 'ios' && Platform.OS !== 'android') {\n  // eslint-disable-next-line no-console\n  console.warn(\n    '[extended-vlc-player] ExtendedVlcPlayerView is only supported on iOS and Android.'\n  );\n}\n"]}

package/build/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `extended-vlc-player` public API.
+ *
+ * The default export is the native view component; named exports are the
+ * imperative player hook and the type contracts. Consumers normally use:
+ *
+ *   import { useExtendedVlcPlayer, ExtendedVlcPlayerView } from 'extended-vlc-player';
+ */
+export { ExtendedVlcPlayerView } from './ExtendedVlcPlayerView';
+export { useExtendedVlcPlayer } from './useExtendedVlcPlayer';
+export type { ContentFit, ExtendedVlcErrorEvent, ExtendedVlcLoadEvent, ExtendedVlcPlayer, ExtendedVlcPlayerViewProps, ExtendedVlcProgressEvent, ExtendedVlcSource, ExtendedVlcTrack, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,UAAU,EACV,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/build/index.js

@@ -0,0 +1,11 @@
+/**
+ * `extended-vlc-player` public API.
+ *
+ * The default export is the native view component; named exports are the
+ * imperative player hook and the type contracts. Consumers normally use:
+ *
+ *   import { useExtendedVlcPlayer, ExtendedVlcPlayerView } from 'extended-vlc-player';
+ */
+export { ExtendedVlcPlayerView } from './ExtendedVlcPlayerView';
+export { useExtendedVlcPlayer } from './useExtendedVlcPlayer';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC","sourcesContent":["/**\n * `extended-vlc-player` public API.\n *\n * The default export is the native view component; named exports are the\n * imperative player hook and the type contracts. Consumers normally use:\n *\n *   import { useExtendedVlcPlayer, ExtendedVlcPlayerView } from 'extended-vlc-player';\n */\nexport { ExtendedVlcPlayerView } from './ExtendedVlcPlayerView';\nexport { useExtendedVlcPlayer } from './useExtendedVlcPlayer';\nexport type {\n  ContentFit,\n  ExtendedVlcErrorEvent,\n  ExtendedVlcLoadEvent,\n  ExtendedVlcPlayer,\n  ExtendedVlcPlayerViewProps,\n  ExtendedVlcProgressEvent,\n  ExtendedVlcSource,\n  ExtendedVlcTrack,\n} from './types';\n"]}

package/build/types.d.ts

@@ -0,0 +1,97 @@
+import type { ViewStyle } from 'react-native';
+/**
+ * Source descriptor for the VLC player. Mirrors `expo-video`'s `VideoSource`
+ * surface so the existing call sites (a string URL or an object) keep
+ * working without change.
+ */
+export type ExtendedVlcSource = string | {
+    uri: string;
+    headers?: Record<string, string>;
+    /**
+     * Optional drm descriptor. NOTE: the new module does not decrypt
+     * Widevine/FairPlay streams (libVLC has no DRM path). The field is
+     * accepted for API parity with `expo-video`; if a DRM source reaches
+     * the player it will emit `onError` and the caller should fall back
+     * to `expo-video`.
+     */
+    drm?: unknown;
+};
+/** Audio / subtitle track entry exposed by VLC after a source loads. */
+export interface ExtendedVlcTrack {
+    index: number;
+    /** Localised label, e.g. "English", "Türkçe 5.1". */
+    label?: string;
+    /** RFC 5646 language code when VLC exposes one. */
+    language?: string;
+    /** Codec identifier reported by libVLC (e.g. "mp4a", "ac3", "subrip"). */
+    codec?: string;
+}
+export interface ExtendedVlcLoadEvent {
+    duration: number;
+    audioTracks: ExtendedVlcTrack[];
+    textTracks: ExtendedVlcTrack[];
+}
+export interface ExtendedVlcProgressEvent {
+    currentTime: number;
+    duration: number;
+    /** 0..1 position; mirrors the legacy VLC position field. */
+    position: number;
+}
+export interface ExtendedVlcErrorEvent {
+    code?: string;
+    message: string;
+    domain?: string;
+}
+export type ContentFit = 'contain' | 'cover' | 'fill';
+export interface ExtendedVlcPlayerViewProps {
+    /** The player object returned by `useExtendedVlcPlayer`. */
+    player: ExtendedVlcPlayer;
+    style?: ViewStyle;
+    contentFit?: ContentFit;
+    onLoad?: (e: ExtendedVlcLoadEvent) => void;
+    onProgress?: (e: ExtendedVlcProgressEvent) => void;
+    onPlaying?: (e: {
+        duration: number;
+    }) => void;
+    onPaused?: (e: {
+        target: number;
+    }) => void;
+    onEnded?: () => void;
+    onError?: (e: ExtendedVlcErrorEvent) => void;
+    onBuffering?: (e: {
+        isBuffering: boolean;
+    }) => void;
+    onPictureInPictureStart?: () => void;
+    onPictureInPictureStop?: () => void;
+}
+/**
+ * Imperative player object. Mirrors the surface of `BackgroundVideoPlayer`'s
+ * `videoRef.current` so consumers can swap the import without touching
+ * the rest of their UI.
+ */
+export interface ExtendedVlcPlayer {
+    play(): void;
+    pause(): void;
+    stop(): void;
+    /** `seconds` is a wall-clock position in seconds (matches expo-video). */
+    seek(seconds: number): void;
+    /** `rate` is a playback rate multiplier (0.5, 1, 1.5, 2). */
+    setRate(rate: number): void;
+    /** `volume` is 0..1 (matches the existing VLC contract). */
+    setVolume(volume: number): void;
+    /** `index` of the audio track in the most recent `onLoad` payload, or -1 to disable. */
+    setAudioTrack(index: number): void;
+    /** `index` of the subtitle track, or -1 to disable. */
+    setSubtitleTrack(index: number): void;
+    /** Replace the current source without remounting the view. */
+    replace(source: ExtendedVlcSource): void;
+    /** Start the system Picture-in-Picture overlay. Resolves true when entered. */
+    startPictureInPicture(): Promise<boolean>;
+    /** Exit PiP if it is active. Resolves true when the controller stopped. */
+    stopPictureInPicture(): Promise<boolean>;
+    /** True while PiP is active. Mirrors the native state. */
+    isPictureInPictureActive(): Promise<boolean>;
+    /** True when the device + iOS version support PiP. */
+    isPictureInPictureSupported(): Promise<boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ViewStyle } from 'react-native';\n\n/**\n * Source descriptor for the VLC player. Mirrors `expo-video`'s `VideoSource`\n * surface so the existing call sites (a string URL or an object) keep\n * working without change.\n */\nexport type ExtendedVlcSource =\n  | string\n  | {\n      uri: string;\n      headers?: Record<string, string>;\n      /**\n       * Optional drm descriptor. NOTE: the new module does not decrypt\n       * Widevine/FairPlay streams (libVLC has no DRM path). The field is\n       * accepted for API parity with `expo-video`; if a DRM source reaches\n       * the player it will emit `onError` and the caller should fall back\n       * to `expo-video`.\n       */\n      drm?: unknown;\n    };\n\n/** Audio / subtitle track entry exposed by VLC after a source loads. */\nexport interface ExtendedVlcTrack {\n  index: number;\n  /** Localised label, e.g. \"English\", \"Türkçe 5.1\". */\n  label?: string;\n  /** RFC 5646 language code when VLC exposes one. */\n  language?: string;\n  /** Codec identifier reported by libVLC (e.g. \"mp4a\", \"ac3\", \"subrip\"). */\n  codec?: string;\n}\n\nexport interface ExtendedVlcLoadEvent {\n  duration: number;       // seconds\n  audioTracks: ExtendedVlcTrack[];\n  textTracks: ExtendedVlcTrack[];\n}\n\nexport interface ExtendedVlcProgressEvent {\n  currentTime: number;    // seconds\n  duration: number;       // seconds\n  /** 0..1 position; mirrors the legacy VLC position field. */\n  position: number;\n}\n\nexport interface ExtendedVlcErrorEvent {\n  code?: string;\n  message: string;\n  domain?: string;\n}\n\nexport type ContentFit = 'contain' | 'cover' | 'fill';\n\nexport interface ExtendedVlcPlayerViewProps {\n  /** The player object returned by `useExtendedVlcPlayer`. */\n  player: ExtendedVlcPlayer;\n  style?: ViewStyle;\n  contentFit?: ContentFit;\n  onLoad?: (e: ExtendedVlcLoadEvent) => void;\n  onProgress?: (e: ExtendedVlcProgressEvent) => void;\n  onPlaying?: (e: { duration: number }) => void;\n  onPaused?: (e: { target: number }) => void;\n  onEnded?: () => void;\n  onError?: (e: ExtendedVlcErrorEvent) => void;\n  onBuffering?: (e: { isBuffering: boolean }) => void;\n  onPictureInPictureStart?: () => void;\n  onPictureInPictureStop?: () => void;\n}\n\n/**\n * Imperative player object. Mirrors the surface of `BackgroundVideoPlayer`'s\n * `videoRef.current` so consumers can swap the import without touching\n * the rest of their UI.\n */\nexport interface ExtendedVlcPlayer {\n  play(): void;\n  pause(): void;\n  stop(): void;\n  /** `seconds` is a wall-clock position in seconds (matches expo-video). */\n  seek(seconds: number): void;\n  /** `rate` is a playback rate multiplier (0.5, 1, 1.5, 2). */\n  setRate(rate: number): void;\n  /** `volume` is 0..1 (matches the existing VLC contract). */\n  setVolume(volume: number): void;\n  /** `index` of the audio track in the most recent `onLoad` payload, or -1 to disable. */\n  setAudioTrack(index: number): void;\n  /** `index` of the subtitle track, or -1 to disable. */\n  setSubtitleTrack(index: number): void;\n  /** Replace the current source without remounting the view. */\n  replace(source: ExtendedVlcSource): void;\n  /** Start the system Picture-in-Picture overlay. Resolves true when entered. */\n  startPictureInPicture(): Promise<boolean>;\n  /** Exit PiP if it is active. Resolves true when the controller stopped. */\n  stopPictureInPicture(): Promise<boolean>;\n  /** True while PiP is active. Mirrors the native state. */\n  isPictureInPictureActive(): Promise<boolean>;\n  /** True when the device + iOS version support PiP. */\n  isPictureInPictureSupported(): Promise<boolean>;\n}\n"]}

package/build/useExtendedVlcPlayer.d.ts

@@ -0,0 +1,12 @@
+import type { ExtendedVlcPlayer, ExtendedVlcSource } from './types';
+export interface UseExtendedVlcPlayerOptions {
+    /** Called once after the player is constructed. Useful for attaching PiP handlers. */
+    onReady?: (player: ExtendedVlcPlayer) => void;
+}
+/**
+ * Returns a stable player object for the given source. The native player
+ * is created once (lazy on first method call) and replaced in place when
+ * `source` changes via the same `replace` API used by `expo-video`.
+ */
+export declare function useExtendedVlcPlayer(source: ExtendedVlcSource, options?: UseExtendedVlcPlayerOptions): ExtendedVlcPlayer;
+//# sourceMappingURL=useExtendedVlcPlayer.d.ts.map

package/build/useExtendedVlcPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExtendedVlcPlayer.d.ts","sourceRoot":"","sources":["../src/useExtendedVlcPlayer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,iBAAiB,EAEjB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAqCjB,MAAM,WAAW,2BAA2B;IAC1C,sFAAsF;IACtF,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC/C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,2BAAgC,GACxC,iBAAiB,CAqGnB"}

package/build/useExtendedVlcPlayer.js

@@ -0,0 +1,137 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { requireNativeModule } from 'expo-modules-core';
+// Native module is registered by the platform-specific module under the
+// JS module name "ExtendedVlcPlayer". The requireNativeModule helper resolves
+// it at runtime; if the native side is missing, accessing the module throws
+// — we surface a clear error so the consumer knows what failed instead of
+// silently producing a no-op player.
+let nativeModule = null;
+try {
+    nativeModule = requireNativeModule('ExtendedVlcPlayer');
+}
+catch (error) {
+    // Allow JS-side import of the module to succeed even when the native side
+    // is not yet built (e.g. in a Jest test environment). We throw a helpful
+    // error only when the consumer actually calls a method.
+    nativeModule = null;
+}
+function getModule() {
+    if (!nativeModule) {
+        throw new Error('[extended-vlc-player] Native module is not available. ' +
+            'Run `npx expo prebuild --clean` and rebuild the app, ' +
+            'or check that the plugin ran successfully.');
+    }
+    return nativeModule;
+}
+function normalizeSource(source) {
+    if (typeof source === 'string')
+        return { uri: source };
+    const { uri } = source;
+    if (!uri) {
+        throw new Error('[extended-vlc-player] source.uri is required');
+    }
+    return { uri, headers: source.headers ?? null, drm: source.drm ?? null };
+}
+/**
+ * Returns a stable player object for the given source. The native player
+ * is created once (lazy on first method call) and replaced in place when
+ * `source` changes via the same `replace` API used by `expo-video`.
+ */
+export function useExtendedVlcPlayer(source, options = {}) {
+    const normalized = useMemo(() => normalizeSource(source), [source]);
+    // We hold a numeric id of the "current native source" so we can detect
+    // when the JS source prop has changed and tell the native module to swap.
+    const [nativeId, setNativeId] = useState(0);
+    const isMountedRef = useRef(true);
+    // Event subscription is wired through the Fabric view component, not the
+    // module — events flow back into the JS player object via the
+    // ExtendedVlcPlayerView's callbacks. We keep the module call surface
+    // (play/pause/seek/PiP) here.
+    useEffect(() => {
+        isMountedRef.current = true;
+        return () => {
+            isMountedRef.current = false;
+        };
+    }, []);
+    useEffect(() => {
+        // When the source prop changes, ask the native module to swap in place
+        // instead of remounting the view (which would reset audio session, PiP
+        // delegate wiring, etc.).
+        try {
+            getModule().replace(normalized);
+        }
+        catch (error) {
+            // Surface as console error; the player view will also emit onError
+            // once the Fabric event dispatcher picks it up.
+            // eslint-disable-next-line no-console
+            console.warn('[extended-vlc-player] replace failed:', error);
+        }
+    }, [normalized]);
+    // The player object is intentionally stable across renders. Methods are
+    // closures over `nativeId` so the latest normalized source is always
+    // referenced, but the object identity does not change — consumers can
+    // safely put it in dependency arrays.
+    const player = useMemo(() => {
+        const p = {
+            _nativeId: nativeId,
+            play: () => getModule().play(nativeId),
+            pause: () => getModule().pause(nativeId),
+            stop: () => getModule().stop(nativeId),
+            seek: (seconds) => getModule().seek(nativeId, seconds),
+            setRate: (rate) => getModule().setRate(nativeId, rate),
+            setVolume: (volume) => getModule().setVolume(nativeId, volume),
+            setAudioTrack: (index) => getModule().setAudioTrack(nativeId, index),
+            setSubtitleTrack: (index) => getModule().setSubtitleTrack(nativeId, index),
+            replace: (next) => {
+                const nextNormalized = normalizeSource(next);
+                try {
+                    getModule().replace({
+                        ...nextNormalized,
+                        // Tag the replace with the current nativeId so the existing
+                        // instance is updated rather than a new one allocated.
+                        instanceId: nativeId,
+                    });
+                }
+                catch (error) {
+                    // eslint-disable-next-line no-console
+                    console.warn('[extended-vlc-player] replace failed:', error);
+                }
+            },
+            startPictureInPicture: () => getModule().startPictureInPicture(nativeId),
+            stopPictureInPicture: () => getModule().stopPictureInPicture(nativeId),
+            isPictureInPictureActive: () => getModule().isPictureInPictureActive(nativeId),
+            isPictureInPictureSupported: () => getModule().isPictureInPictureSupported(),
+        };
+        return p;
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [nativeId]);
+    // Bridge the native callback API. The hook surfaces the player as soon
+    // as it exists, so consumers can attach PiP handlers from `onReady`.
+    useEffect(() => {
+        if (options.onReady) {
+            try {
+                options.onReady(player);
+            }
+            catch (error) {
+                // eslint-disable-next-line no-console
+                console.warn('[extended-vlc-player] onReady handler threw:', error);
+            }
+        }
+    }, [player, options]);
+    // Bump the native id once on mount so the first source prop is committed
+    // to the native side. We use a ref-based "first" instead of an effect to
+    // avoid an extra render.
+    const firstRef = useRef(true);
+    useEffect(() => {
+        if (firstRef.current) {
+            firstRef.current = false;
+            setNativeId(1);
+        }
+    }, []);
+    // Mark unused variables to keep TypeScript happy with strict checks.
+    void useCallback;
+    void isMountedRef;
+    void undefined;
+    return player;
+}
+//# sourceMappingURL=useExtendedVlcPlayer.js.map

package/build/useExtendedVlcPlayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExtendedVlcPlayer.js","sourceRoot":"","sources":["../src/useExtendedVlcPlayer.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { requireNativeModule } from 'expo-modules-core';\n\nimport type {\n  ExtendedVlcLoadEvent,\n  ExtendedVlcPlayer,\n  ExtendedVlcProgressEvent,\n  ExtendedVlcSource,\n} from './types';\n\n// Native module is registered by the platform-specific module under the\n// JS module name \"ExtendedVlcPlayer\". The requireNativeModule helper resolves\n// it at runtime; if the native side is missing, accessing the module throws\n// — we surface a clear error so the consumer knows what failed instead of\n// silently producing a no-op player.\nlet nativeModule: any = null;\ntry {\n  nativeModule = requireNativeModule('ExtendedVlcPlayer');\n} catch (error) {\n  // Allow JS-side import of the module to succeed even when the native side\n  // is not yet built (e.g. in a Jest test environment). We throw a helpful\n  // error only when the consumer actually calls a method.\n  nativeModule = null;\n}\n\nfunction getModule() {\n  if (!nativeModule) {\n    throw new Error(\n      '[extended-vlc-player] Native module is not available. ' +\n        'Run `npx expo prebuild --clean` and rebuild the app, ' +\n        'or check that the plugin ran successfully.'\n    );\n  }\n  return nativeModule;\n}\n\nfunction normalizeSource(source: ExtendedVlcSource) {\n  if (typeof source === 'string') return { uri: source };\n  const { uri } = source;\n  if (!uri) {\n    throw new Error('[extended-vlc-player] source.uri is required');\n  }\n  return { uri, headers: source.headers ?? null, drm: source.drm ?? null };\n}\n\nexport interface UseExtendedVlcPlayerOptions {\n  /** Called once after the player is constructed. Useful for attaching PiP handlers. */\n  onReady?: (player: ExtendedVlcPlayer) => void;\n}\n\n/**\n * Returns a stable player object for the given source. The native player\n * is created once (lazy on first method call) and replaced in place when\n * `source` changes via the same `replace` API used by `expo-video`.\n */\nexport function useExtendedVlcPlayer(\n  source: ExtendedVlcSource,\n  options: UseExtendedVlcPlayerOptions = {}\n): ExtendedVlcPlayer {\n  const normalized = useMemo(() => normalizeSource(source), [source]);\n  // We hold a numeric id of the \"current native source\" so we can detect\n  // when the JS source prop has changed and tell the native module to swap.\n  const [nativeId, setNativeId] = useState(0);\n  const isMountedRef = useRef(true);\n\n  // Event subscription is wired through the Fabric view component, not the\n  // module — events flow back into the JS player object via the\n  // ExtendedVlcPlayerView's callbacks. We keep the module call surface\n  // (play/pause/seek/PiP) here.\n\n  useEffect(() => {\n    isMountedRef.current = true;\n    return () => {\n      isMountedRef.current = false;\n    };\n  }, []);\n\n  useEffect(() => {\n    // When the source prop changes, ask the native module to swap in place\n    // instead of remounting the view (which would reset audio session, PiP\n    // delegate wiring, etc.).\n    try {\n      getModule().replace(normalized);\n    } catch (error) {\n      // Surface as console error; the player view will also emit onError\n      // once the Fabric event dispatcher picks it up.\n      // eslint-disable-next-line no-console\n      console.warn('[extended-vlc-player] replace failed:', error);\n    }\n  }, [normalized]);\n\n  // The player object is intentionally stable across renders. Methods are\n  // closures over `nativeId` so the latest normalized source is always\n  // referenced, but the object identity does not change — consumers can\n  // safely put it in dependency arrays.\n  const player = useMemo<ExtendedVlcPlayer>(() => {\n    const p: ExtendedVlcPlayer & { _nativeId: number } = {\n      _nativeId: nativeId,\n      play: () => getModule().play(nativeId),\n      pause: () => getModule().pause(nativeId),\n      stop: () => getModule().stop(nativeId),\n      seek: (seconds: number) => getModule().seek(nativeId, seconds),\n      setRate: (rate: number) => getModule().setRate(nativeId, rate),\n      setVolume: (volume: number) => getModule().setVolume(nativeId, volume),\n      setAudioTrack: (index: number) => getModule().setAudioTrack(nativeId, index),\n      setSubtitleTrack: (index: number) => getModule().setSubtitleTrack(nativeId, index),\n      replace: (next: ExtendedVlcSource) => {\n        const nextNormalized = normalizeSource(next);\n        try {\n          getModule().replace({\n            ...nextNormalized,\n            // Tag the replace with the current nativeId so the existing\n            // instance is updated rather than a new one allocated.\n            instanceId: nativeId,\n          });\n        } catch (error) {\n          // eslint-disable-next-line no-console\n          console.warn('[extended-vlc-player] replace failed:', error);\n        }\n      },\n      startPictureInPicture: () => getModule().startPictureInPicture(nativeId),\n      stopPictureInPicture: () => getModule().stopPictureInPicture(nativeId),\n      isPictureInPictureActive: () => getModule().isPictureInPictureActive(nativeId),\n      isPictureInPictureSupported: () => getModule().isPictureInPictureSupported(),\n    };\n    return p;\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [nativeId]);\n\n  // Bridge the native callback API. The hook surfaces the player as soon\n  // as it exists, so consumers can attach PiP handlers from `onReady`.\n  useEffect(() => {\n    if (options.onReady) {\n      try {\n        options.onReady(player);\n      } catch (error) {\n        // eslint-disable-next-line no-console\n        console.warn('[extended-vlc-player] onReady handler threw:', error);\n      }\n    }\n  }, [player, options]);\n\n  // Bump the native id once on mount so the first source prop is committed\n  // to the native side. We use a ref-based \"first\" instead of an effect to\n  // avoid an extra render.\n  const firstRef = useRef(true);\n  useEffect(() => {\n    if (firstRef.current) {\n      firstRef.current = false;\n      setNativeId(1);\n    }\n  }, []);\n\n  // Mark unused variables to keep TypeScript happy with strict checks.\n  void useCallback;\n  void isMountedRef;\n  void (undefined as ExtendedVlcLoadEvent | ExtendedVlcProgressEvent | undefined);\n\n  return player;\n}\n"]}

package/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["apple", "android"],
+  "apple": {
+    "modules": ["ExtendedVlcPlayerModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.extendedvlcplayer.ExtendedVlcPlayerModule"]
+  }
+}

package/ios/AudioSessionConfigurator.swift

@@ -0,0 +1,25 @@
+import AVFoundation
+import Foundation
+
+/// Centralizes the AVAudioSession configuration the player needs in
+/// order to be eligible for background playback and Picture-in-Picture.
+enum AudioSessionConfigurator {
+  /// Idempotent: setting the same category twice is a no-op.
+  static func configureForPlayback() {
+    do {
+      let session = AVAudioSession.sharedInstance()
+      try session.setCategory(
+        .playback,
+        mode: .moviePlayback,
+        options: [.allowAirPlay, .allowBluetoothA2DP]
+      )
+      try session.setActive(true, options: [])
+    } catch {
+      // Audio session configuration failures are non-fatal: the player
+      // still works in the foreground, but PiP may be denied by the
+      // system. Surface as console error so the issue is visible in
+      // development logs.
+      NSLog("[extended-vlc-player] AVAudioSession configuration failed: \(error)")
+    }
+  }
+}

package/ios/ExtendedVlcPlayer.podspec

@@ -0,0 +1,32 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'ExtendedVlcPlayer'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.description    = package['description']
+  s.license        = 'MIT'
+  s.author         = 'bbStudio'
+  s.homepage       = 'https://github.com/berattufekli/iptv_expo'
+  s.platforms      = {
+    :ios => '16.4',
+    :tvos => '16.4'
+  }
+  s.swift_version  = '5.9'
+  s.source         = { git: 'https://github.com/berattufekli/iptv_expo' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+  s.dependency 'MobileVLCKit', '~> 3.7.0'
+
+  s.source_files = '**/*.{h,m,mm,swift}'
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+    'SWIFT_OBJC_INTERFACE_HEADER_NAME' => 'ExtendedVlcPlayer-Swift.h',
+    'OTHER_SWIFT_FLAGS' => '$(inherited) -D COCOAPODS -Xfrontend -module-name -Xfrontend ExtendedVlcPlayer',
+    # The host app's Podfile already enables use_frameworks! :linkage => :static
+    # so we keep this pod consistent with that mode.
+  }
+end

package/ios/ExtendedVlcPlayerModule.swift

@@ -0,0 +1,130 @@
+import AVFoundation
+import ExpoModulesCore
+import Foundation
+import MobileVLCKit
+
+/**
+ * TurboModule surface for `extended-vlc-player`.
+ *
+ * Owns the long-lived PlayerRegistry that maps JS player ids to
+ * PlayerSession instances. The Fabric view component creates sessions
+ * via the bridge (`PlayerRegistryBridge`) and the JS code interacts
+ * with a session through the imperative methods exposed here.
+ */
+public final class ExtendedVlcPlayerModule: Module {
+  public func definition() -> ModuleDefinition {
+    Name("ExtendedVlcPlayer")
+
+    OnCreate {
+      AudioSessionConfigurator.configureForPlayback()
+    }
+
+    AsyncFunction("isPictureInPictureSupported") { () -> Bool in
+      AVPictureInPictureController.isPictureInPictureSupported()
+    }
+
+    AsyncFunction("isPictureInPictureActive") { (_ instanceId: Int) -> Bool in
+      PlayerRegistry.shared.session(for: instanceId)?.isPictureInPictureActive() ?? false
+    }
+
+    AsyncFunction("play") { (instanceId: Int) in
+      PlayerRegistry.shared.session(for: instanceId)?.play()
+    }
+
+    AsyncFunction("pause") { (instanceId: Int) in
+      PlayerRegistry.shared.session(for: instanceId)?.pause()
+    }
+
+    AsyncFunction("stop") { (instanceId: Int) in
+      PlayerRegistry.shared.session(for: instanceId)?.stop()
+    }
+
+    AsyncFunction("seek") { (instanceId: Int, seconds: Double) in
+      PlayerRegistry.shared.session(for: instanceId)?.seek(to: seconds)
+    }
+
+    AsyncFunction("setRate") { (instanceId: Int, rate: Double) in
+      PlayerRegistry.shared.session(for: instanceId)?.setRate(rate)
+    }
+
+    AsyncFunction("setVolume") { (instanceId: Int, volume: Double) in
+      PlayerRegistry.shared.session(for: instanceId)?.setVolume(Float(max(0, min(1, volume))))
+    }
+
+    AsyncFunction("setAudioTrack") { (instanceId: Int, index: Int) in
+      PlayerRegistry.shared.session(for: instanceId)?.setAudioTrack(index: index)
+    }
+
+    AsyncFunction("setSubtitleTrack") { (instanceId: Int, index: Int) in
+      PlayerRegistry.shared.session(for: instanceId)?.setSubtitleTrack(index: index)
+    }
+
+    AsyncFunction("replace") { (instanceId: Int, source: ReplacePayload) in
+      let uri = source.uri
+      if uri.isEmpty {
+        throw InvalidSourceException()
+      }
+      let url: URL
+      if let parsed = URL(string: uri), parsed.scheme != nil {
+        url = parsed
+      } else {
+        // Some Xtream providers hand us a raw IP+path; default to https.
+        url = URL(string: "https://\(uri)") ?? URL(fileURLWithPath: uri)
+      }
+      let media = VLCMedia(url: url)
+      PlayerRegistry.shared.session(for: instanceId)?.replace(media: media)
+    }
+
+    AsyncFunction("startPictureInPicture") { (instanceId: Int) -> Bool in
+      PlayerRegistry.shared.session(for: instanceId)?.startPictureInPicture() ?? false
+    }
+
+    AsyncFunction("stopPictureInPicture") { (instanceId: Int) -> Bool in
+      PlayerRegistry.shared.session(for: instanceId)?.stopPictureInPicture() ?? false
+    }
+  }
+}
+
+struct ReplacePayload: Record {
+  @Field var uri: String = ""
+  @Field var headers: [String: String]?
+  @Field var drm: Any?
+  @Field var instanceId: Int = 0
+}
+
+struct InvalidSourceException: Exception {}
+
+/// Registry is shared between this module and the Obj-C++ Fabric view
+/// (via `PlayerRegistryBridge`). The lock is held briefly to keep the
+/// hot path fast.
+final class PlayerRegistry {
+  static let shared = PlayerRegistry()
+  private let lock = NSLock()
+  private var sessions: [Int: PlayerSession] = [:]
+  private var nextId: Int = 0
+
+  func next() -> (Int, PlayerSession) {
+    lock.lock()
+    defer { lock.unlock() }
+    nextId += 1
+    let id = nextId
+    let session = PlayerSession(id: id)
+    sessions[id] = session
+    return (id, session)
+  }
+
+  func session(for id: Int) -> PlayerSession? {
+    lock.lock()
+    defer { lock.unlock() }
+    return sessions[id]
+  }
+
+  func remove(id: Int) {
+    lock.lock()
+    defer { lock.unlock() }
+    if let session = sessions[id] {
+      session.stop()
+    }
+    sessions[id] = nil
+  }
+}

package/ios/ExtendedVlcPlayerViewComponentView.h

@@ -0,0 +1,19 @@
+#import <React/RCTViewComponentView.h>
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Fabric view component for `ExtendedVlcPlayerView`. This is the
+ * Obj-C++ entry point that React Native's New Architecture uses to mount
+ * a native UIView.
+ *
+ * The actual UIView is a vanilla UIView that we set as the
+ * `VLCMediaPlayer.drawable` so libVLC draws into it directly. We don't
+ * subclass any specific VLC class because libVLC's drawable protocol is
+ * `UIView` — any UIView works.
+ */
+@interface ExtendedVlcPlayerViewComponentView : RCTViewComponentView
+@end
+
+NS_ASSUME_NONNULL_END