expo-video-metadata 1.4.0 → 3.1.1

package/.oxfmtrc.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "trailingComma": "es5",
+  "ignorePatterns": ["build/**", "ios/**", "android/**", "example/ios/**", "example/android/**"]
+}

package/.oxlintrc.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "env": {
+    "builtin": true
+  }
+}

package/.yarnrc.yml

@@ -1,3 +1,7 @@
+enableScripts: true
+
 nodeLinker: node-modules
 
-yarnPath: .yarn/releases/yarn-4.5.1.cjs
+npmMinimalAgeGate: 2d
+
+yarnPath: .yarn/releases/yarn-4.15.0.cjs

package/README.md

@@ -1,55 +1,285 @@
 # expo-video-metadata
 
-This React Native (Expo) library provides a versatile function designed to extract a wide range of metadata from video files, including duration, width, height, frame rate, codec, audio availability, orientation, audio channels, audio codec, and audio sample rate. For comprehensive details, please refer to the listed exported types. Although the library is equipped with web support, its performance is reliant on specific platform APIs, leading to potential variability in its effectiveness across different browsers.
+Video metadata for Expo apps, powered by [Mediabunny](https://mediabunny.dev) on iOS, Android, and web.
 
-<img src="https://raw.githubusercontent.com/hirbod/expo-video-metadata/assets/preview.png" width="500" />
+This package exposes Mediabunny-style metadata for Expo and React Native:
+format, MIME type, start/end timestamps, per-track codecs, dimensions, rotation,
+pixel aspect ratio, display dimensions, color space, packet statistics, audio
+properties, metadata tags, embedded images, file size, and GPS location when the
+file contains it.
 
-# Installation in bare React Native projects
+It is currently maintained against **Expo SDK 57**.
 
-This package needs **Expo SDK 50** or **higher**, as it uses FileSystem APIs that were added in that version. This package adds native code to your project and does not work with Expo Go. Please use a custom dev client or build a standalone app. Works with Fabric. Needs RN 0.73+ (Java JDK 17)
+<img src="https://raw.githubusercontent.com/hirbod/expo-video-metadata/assets/preview_2026_mediabunny.png" width="800" />
 
-For bare React Native projects, you must ensure that you have [installed and configured the `expo` package](https://docs.expo.dev/bare/installing-expo-modules/) before continuing (SDK 50+). This just adds ~150KB to your final app size and is the easiest way to get started and it works with and without Expo projects.
+## Install
 
-### Add the package to your npm dependencies
+```sh
+npx expo install expo-video-metadata
+```
+
+This package does not ship custom native code. It uses Mediabunny for parsing and `expo-file-system` for efficient local file reads on iOS and Android.
+
+For bare React Native apps, install and configure Expo modules first:
+
+https://docs.expo.dev/bare/installing-expo-modules/
+
+## Platform Notes
+
+### iOS and Android
 
+iOS and Android use Mediabunny through a small `expo-file-system` source adapter. Local `file://` and `content://` videos are read with byte-range file handle reads, so large videos do not need to be loaded fully into memory.
+
+Remote URLs are read through Mediabunny's URL source. Request headers can be passed through the `headers` option.
+
+On iOS, picking videos with `expo-image-picker` is fastest when you keep the original asset representation:
+
+```ts
+preferredAssetRepresentationMode: ImagePicker.UIImagePickerPreferredAssetRepresentationMode.Current;
 ```
-npx expo install expo-video-metadata
+
+That avoids unnecessary copying or transcoding before metadata is read.
+
+### Web
+
+Web uses the same Mediabunny parser. It parses the media file in the browser instead of relying on `<video>` metadata events, which keeps the result shape aligned with iOS and Android.
+
+Local web sources can be passed as `File`, `Blob`, `blob:` URLs, or `data:` URLs.
+
+Remote web sources are read with `fetch`, so browser rules apply:
+
+- The server must allow CORS, for example with `Access-Control-Allow-Origin`.
+- The server should support byte-range requests with `Accept-Ranges: bytes`.
+- If the video needs auth, pass headers through `VideoInfoOptions`.
+
+If a remote URL works on iOS or Android but fails on web, it is usually a CORS issue. Native networking is not subject to browser CORS.
+
+## Usage
+
+```ts
+import { getVideoInfoAsync } from "expo-video-metadata";
+
+const info = await getVideoInfoAsync(videoUri);
+```
+
+With headers for a remote file:
+
+```ts
+const info = await getVideoInfoAsync("https://example.com/video.mp4", {
+  headers: {
+    Authorization: "Bearer token",
+  },
+});
+```
+
+On web, you can also pass a `File` or `Blob`:
+
+```ts
+const info = await getVideoInfoAsync(file);
+```
+
+When using `expo-image-picker` on web, prefer the returned `asset.file` over
+`asset.uri`:
+
+```ts
+const asset = result.assets[0];
+const info = await getVideoInfoAsync(asset.file ?? asset.uri);
+```
+
+Passing the `File` lets Mediabunny read only the byte ranges it needs. Passing a
+`blob:` URL requires loading that URL back into a `Blob` first, which can be much
+slower for large videos.
+
+## API
+
+```ts
+getVideoInfoAsync(
+  source: string | File | Blob,
+  options?: {
+    headers?: Record<string, string>;
+    exactDuration?: boolean;
+    packetStatsSampleCount?: number | null;
+    includeMetadataTags?: boolean;
+    includeVideoTracks?: boolean;
+    includeAudioTracks?: boolean;
+  }
+): Promise<VideoInfoResult>
+```
+
+`source` can be:
+
+- a local `file://` or `content://` URI on iOS and Android
+- a remote URL
+- a `File` or `Blob` on web
+- a `blob:` or `data:` URL on web
+
+Base64/data URLs work on web, but they are not ideal for large videos.
+
+By default, durations are read from metadata when possible, video and audio
+tracks are included, packet statistics inspect the first 30 packets of each
+track, and metadata tags are skipped. Skipping tags avoids extra reads for title,
+artist, comments, embedded images, raw tags, and GPS location when you only need
+technical media metadata.
+
+Use `includeMetadataTags: true` when you need container tags or location data:
+
+```ts
+const info = await getVideoInfoAsync(source, {
+  includeMetadataTags: true,
+});
 ```
 
-### Configure for iOS
+If you only need one media kind, disable the other one:
+
+```ts
+const info = await getVideoInfoAsync(source, {
+  includeAudioTracks: false,
+});
+```
 
-Run `npx pod-install` after installing the npm package.
+To match Mediabunny's metadata extraction demo more closely, use:
 
-### Configure for Android
+```ts
+const info = await getVideoInfoAsync(source, {
+  exactDuration: true,
+  includeMetadataTags: true,
+  packetStatsSampleCount: null,
+});
+```
 
-No additional set up necessary.
+Those settings can scan much more of the file.
 
-# API
+## Result
 
 ```ts
-import { getVideoInfoAsync } from 'expo-video-metadata';
+type VideoInfoResult = {
+  format: string;
+  mimeType: string | null;
+  start: number;
+  end: number;
+  tracks: MediaTrackInfo[];
+  metadataTags?: MetadataTagsInfo | null;
+  fileSize: number;
 
-/**
- * Retrieves video metadata.
- *
- * @param sourceFilename An URI of the video, local or remote. On web, it can be a File or Blob object, too. base64 URIs are supported but not recommended, as they can be very large and cause performance issues.
- * @param options Pass `headers` object in case `sourceFilename` is a remote URI, e.g { headers: "Authorization": "Bearer some-token" } etc.
- *
- * @return Returns a promise which fulfils with [`VideoInfoResult`](#Videoinforesult).
- */
+  // Convenience fields derived from the primary video/audio tracks:
+  duration: number;
+  hasAudio: boolean;
+  isHDR: boolean | null;
+  width: number;
+  height: number;
+  fps: number;
+  bitRate: number;
+  codec: string;
+  orientation: "Portrait" | "PortraitUpsideDown" | "Landscape" | "LandscapeRight" | "LandscapeLeft";
+  naturalOrientation: "Portrait" | "Landscape";
+  aspectRatio: number;
+  is16_9: boolean;
+  audioSampleRate: number;
+  audioChannels: number;
+  audioCodec: string;
+  location: {
+    latitude: number;
+    longitude: number;
+    altitude?: number;
+  } | null;
+};
 
-const result = await getVideoInfoAsync(sourceFilename: string | File | Blob, options: VideoInfoOptions = {}): Promise<VideoInfoResult>
+type MediaTrackInfo = {
+  type: string;
+  codec: string | null;
+  codecParameterString: string | null;
+  start: number;
+  end: number;
+  languageCode: string;
+  packetStats: {
+    packetCount: number;
+    averagePacketRate: number;
+    averageBitrate: number;
+  } | null;
+} & (
+  | {
+      type: "video";
+      codedWidth: number;
+      codedHeight: number;
+      rotation: number;
+      pixelAspectRatio: { num: number; den: number };
+      displayWidth: number;
+      displayHeight: number;
+      transparency: boolean;
+      colorSpace: {
+        primaries: string | null;
+        transfer: string | null;
+        matrix: string | null;
+        fullRange: boolean | null;
+        hdr: boolean | null;
+      };
+    }
+  | {
+      type: "audio";
+      numberOfChannels: number;
+      sampleRate: number;
+    }
+  | {}
+);
+
+type MetadataTagsInfo = {
+  title?: string;
+  description?: string;
+  artist?: string;
+  album?: string;
+  albumArtist?: string;
+  trackNumber?: number;
+  tracksTotal?: number;
+  discNumber?: number;
+  discsTotal?: number;
+  genre?: string;
+  date?: string;
+  lyrics?: string;
+  comment?: string;
+  images?: {
+    mimeType: string;
+    data: Uint8Array;
+    size: number;
+  }[];
+  rawTagCount?: number;
+  raw?: Record<string, unknown>;
+};
 ```
 
-See [VideoInfoResult](https://github.com/hirbod/expo-video-metadata/blob/main/src/ExpoVideoMetadata.types.ts#L1) type for more information.
+Some fields depend on what the file actually exposes and what options you pass.
+For example, `metadataTags` and `location` are only read when
+`includeMetadataTags` is `true`, and location is only returned when the video
+contains a readable GPS tag.
 
-## Hints
+Codec values come directly from Mediabunny. Use `track.codec` for the short
+codec identifier, such as `avc` or `aac`, and `track.codecParameterString` for
+the full codec string, such as `avc1.640034` or `mp4a.40.2`. The legacy
+convenience fields `codec` and `audioCodec` mirror the primary video and audio
+track `codec` values.
 
-If you're using libraries like expo-image-picker, make sure to use [preferredAssetRepresentationMode](https://docs.expo.dev/versions/latest/sdk/imagepicker/#imagepickeroptions) option like this:
+## Example With Expo Image Picker
 
 ```ts
-preferredAssetRepresentationMode: ImagePicker
-  .UIImagePickerPreferredAssetRepresentationMode.Current;
+import * as ImagePicker from "expo-image-picker";
+import { getVideoInfoAsync } from "expo-video-metadata";
+
+const result = await ImagePicker.launchImageLibraryAsync({
+  mediaTypes: "videos",
+  base64: false,
+  exif: true,
+  legacy: false,
+  videoQuality: ImagePicker.UIImagePickerControllerQualityType.High,
+  preferredAssetRepresentationMode:
+    ImagePicker.UIImagePickerPreferredAssetRepresentationMode.Current,
+});
+
+if (!result.canceled) {
+  const asset = result.assets[0];
+  const info = await getVideoInfoAsync(asset.file ?? asset.uri, {
+    includeMetadataTags: true,
+  });
+  console.log(info);
+}
 ```
 
-when picking a video. This will avoid the need to copy or transcode the video file and thus be a lot faster on iOS. If you use a different library, make sure to use the equivalent option. Location data is not supported with expo-image-picker, unless you set `legacy` to `true`.
+`expo-image-picker` may not expose location data unless `legacy` is enabled, even when the original video contains it.

package/build/ExpoVideoMetadata.types.d.ts

@@ -1,66 +1,94 @@
+export type PacketStatsInfo = {
+    packetCount: number;
+    averagePacketRate: number;
+    averageBitrate: number;
+};
+export type RationalInfo = {
+    num: number;
+    den: number;
+};
+export type ColorSpaceInfo = {
+    primaries: string | null;
+    transfer: string | null;
+    matrix: string | null;
+    fullRange: boolean | null;
+    hdr: boolean | null;
+};
+export type MetadataImageInfo = {
+    mimeType: string;
+    data: Uint8Array;
+    size: number;
+};
+export type MetadataTagsInfo = {
+    title?: string;
+    description?: string;
+    artist?: string;
+    album?: string;
+    albumArtist?: string;
+    trackNumber?: number;
+    tracksTotal?: number;
+    discNumber?: number;
+    discsTotal?: number;
+    genre?: string;
+    date?: string;
+    lyrics?: string;
+    comment?: string;
+    images?: MetadataImageInfo[];
+    rawTagCount?: number;
+    raw?: Record<string, unknown>;
+};
+export type BaseTrackInfo = {
+    type: string;
+    codec: string | null;
+    codecParameterString: string | null;
+    start: number;
+    end: number;
+    languageCode: string;
+    packetStats: PacketStatsInfo | null;
+};
+export type VideoTrackInfo = BaseTrackInfo & {
+    type: "video";
+    codedWidth: number;
+    codedHeight: number;
+    rotation: number;
+    pixelAspectRatio: RationalInfo;
+    displayWidth: number;
+    displayHeight: number;
+    transparency: boolean;
+    colorSpace: ColorSpaceInfo;
+};
+export type AudioTrackInfo = BaseTrackInfo & {
+    type: "audio";
+    numberOfChannels: number;
+    sampleRate: number;
+};
+export type MediaTrackInfo = BaseTrackInfo | VideoTrackInfo | AudioTrackInfo;
 export type VideoInfoResult = {
+    format: string;
+    mimeType: string | null;
+    start: number;
+    end: number;
+    tracks: MediaTrackInfo[];
+    metadataTags?: MetadataTagsInfo | null;
+    fileSize: number;
     /**
-     * Duration of the video in seconds (float).
+     * Legacy convenience fields derived from the primary video and audio tracks.
      */
     duration: number;
-    /**
-     * Tells if the video has a audio track. If the video has no audio track, its considered a mute video.
-     */
     hasAudio: boolean;
-    /**
-     * Available only on iOS >= 14 and Android. Tells if the video is a HDR video.
-     * Will return null if it could not be determined. (e.g. on Web or on older iOS/Android versions)
-     */
     isHDR: boolean | null;
-    /**
-     * Width of the video in pixels.
-     */
     width: number;
-    /**
-     * Height of the video in pixels.
-     */
     height: number;
-    /**
-     * Frame rate of the video in frames per second.
-     * Works on iOS, Android and Web (except Safari).
-     */
     fps: number;
-    /**
-     * Bit rate of the video in bits per second.
-     * Supported on all platforms.
-     */
     bitRate: number;
-    /**
-     * File size of the video in bytes. Works only for local files, returns 0 for remote files.
-     * Supported on all platforms.
-     */
-    fileSize: number;
-    /**
-     * Video codec.
-     * Supported on all platforms, but on Web it may return an empty string.
-     */
     codec: string;
-    /**
-     * Video orientation.
-     * Supported on all platforms, but on Web it may return an empty string.
-     */
     orientation: "Portrait" | "PortraitUpsideDown" | "Landscape" | "LandscapeRight" | "LandscapeLeft";
-    /**
-     * Audio sample rate of the video in samples per second.
-     */
+    naturalOrientation: "Portrait" | "Landscape";
+    aspectRatio: number;
+    is16_9: boolean;
     audioSampleRate: number;
-    /**
-     * Audio channel count of the video.
-     */
     audioChannels: number;
-    /**
-     * Audio codec of the video.
-     */
     audioCodec: string;
-    /**
-     * Location where the video was recorded.
-     * Supported on iOS and Android (if the video contains location metadata)
-     */
     location: {
         latitude: number;
         longitude: number;
@@ -70,8 +98,44 @@ export type VideoInfoResult = {
 export type VideoSource = string | File | Blob;
 export type VideoInfoOptions = {
     /**
-     * In case `sourceFilename` is a remote URI, `headers` object is passed in a network request.
+     * In case `source` is a remote URI, `headers` object is passed in network requests.
      */
     headers?: Record<string, string>;
+    /**
+     * Set to `true` to compute exact durations by scanning packet timing when
+     * metadata duration is unavailable or approximate.
+     *
+     * Defaults to `false` for faster metadata resolution.
+     */
+    exactDuration?: boolean;
+    /**
+     * Number of packets to inspect for packet statistics. Use `null` to scan the
+     * full track, matching Mediabunny's metadata extraction demo exactly.
+     *
+     * Defaults to `30`.
+     */
+    packetStatsSampleCount?: number | null;
+    /**
+     * Include container metadata tags such as title, artist, comments, embedded
+     * images, raw tags, and GPS location.
+     *
+     * Defaults to `false` because tag parsing can require extra reads and is not
+     * needed for basic technical video metadata.
+     */
+    includeMetadataTags?: boolean;
+    /**
+     * Include video tracks in the returned `tracks` array and derived video
+     * convenience fields.
+     *
+     * Defaults to `true`.
+     */
+    includeVideoTracks?: boolean;
+    /**
+     * Include audio tracks in the returned `tracks` array and derived audio
+     * convenience fields.
+     *
+     * Defaults to `true`.
+     */
+    includeAudioTracks?: boolean;
 };
 //# sourceMappingURL=ExpoVideoMetadata.types.d.ts.map

package/build/ExpoVideoMetadata.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoVideoMetadata.types.d.ts","sourceRoot":"","sources":["../src/ExpoVideoMetadata.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,WAAW,EACP,UAAU,GACV,oBAAoB,GACpB,WAAW,GACX,gBAAgB,GAChB,eAAe,CAAC;IACpB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI,CAAC;CACV,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC"}
+{"version":3,"file":"ExpoVideoMetadata.types.d.ts","sourceRoot":"","sources":["../src/ExpoVideoMetadata.types.ts"],"names":[],"mappings":"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"}

package/build/ExpoVideoMetadata.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoVideoMetadata.types.js","sourceRoot":"","sources":["../src/ExpoVideoMetadata.types.ts"],"names":[],"mappings":"","sourcesContent":["export type VideoInfoResult = {\n  /**\n   * Duration of the video in seconds (float).\n   */\n  duration: number;\n  /**\n   * Tells if the video has a audio track. If the video has no audio track, its considered a mute video.\n   */\n  hasAudio: boolean;\n  /**\n   * Available only on iOS >= 14 and Android. Tells if the video is a HDR video.\n   * Will return null if it could not be determined. (e.g. on Web or on older iOS/Android versions)\n   */\n  isHDR: boolean | null;\n  /**\n   * Width of the video in pixels.\n   */\n  width: number;\n  /**\n   * Height of the video in pixels.\n   */\n  height: number;\n  /**\n   * Frame rate of the video in frames per second.\n   * Works on iOS, Android and Web (except Safari).\n   */\n  fps: number;\n  /**\n   * Bit rate of the video in bits per second.\n   * Supported on all platforms.\n   */\n  bitRate: number;\n  /**\n   * File size of the video in bytes. Works only for local files, returns 0 for remote files.\n   * Supported on all platforms.\n   */\n  fileSize: number;\n  /**\n   * Video codec.\n   * Supported on all platforms, but on Web it may return an empty string.\n   */\n  codec: string;\n  /**\n   * Video orientation.\n   * Supported on all platforms, but on Web it may return an empty string.\n   */\n  orientation:\n    | \"Portrait\"\n    | \"PortraitUpsideDown\"\n    | \"Landscape\"\n    | \"LandscapeRight\"\n    | \"LandscapeLeft\";\n  /**\n   * Audio sample rate of the video in samples per second.\n   */\n  audioSampleRate: number;\n  /**\n   * Audio channel count of the video.\n   */\n  audioChannels: number;\n  /**\n   * Audio codec of the video.\n   */\n  audioCodec: string;\n  /**\n   * Location where the video was recorded.\n   * Supported on iOS and Android (if the video contains location metadata)\n   */\n  location: {\n    latitude: number;\n    longitude: number;\n    altitude?: number;\n  } | null;\n};\n\nexport type VideoSource = string | File | Blob;\n\nexport type VideoInfoOptions = {\n  /**\n   * In case `sourceFilename` is a remote URI, `headers` object is passed in a network request.\n   */\n  headers?: Record<string, string>;\n};\n"]}
+{"version":3,"file":"ExpoVideoMetadata.types.js","sourceRoot":"","sources":["../src/ExpoVideoMetadata.types.ts"],"names":[],"mappings":"","sourcesContent":["export type PacketStatsInfo = {\n  packetCount: number;\n  averagePacketRate: number;\n  averageBitrate: number;\n};\n\nexport type RationalInfo = {\n  num: number;\n  den: number;\n};\n\nexport type ColorSpaceInfo = {\n  primaries: string | null;\n  transfer: string | null;\n  matrix: string | null;\n  fullRange: boolean | null;\n  hdr: boolean | null;\n};\n\nexport type MetadataImageInfo = {\n  mimeType: string;\n  data: Uint8Array;\n  size: number;\n};\n\nexport type MetadataTagsInfo = {\n  title?: string;\n  description?: string;\n  artist?: string;\n  album?: string;\n  albumArtist?: string;\n  trackNumber?: number;\n  tracksTotal?: number;\n  discNumber?: number;\n  discsTotal?: number;\n  genre?: string;\n  date?: string;\n  lyrics?: string;\n  comment?: string;\n  images?: MetadataImageInfo[];\n  rawTagCount?: number;\n  raw?: Record<string, unknown>;\n};\n\nexport type BaseTrackInfo = {\n  type: string;\n  codec: string | null;\n  codecParameterString: string | null;\n  start: number;\n  end: number;\n  languageCode: string;\n  packetStats: PacketStatsInfo | null;\n};\n\nexport type VideoTrackInfo = BaseTrackInfo & {\n  type: \"video\";\n  codedWidth: number;\n  codedHeight: number;\n  rotation: number;\n  pixelAspectRatio: RationalInfo;\n  displayWidth: number;\n  displayHeight: number;\n  transparency: boolean;\n  colorSpace: ColorSpaceInfo;\n};\n\nexport type AudioTrackInfo = BaseTrackInfo & {\n  type: \"audio\";\n  numberOfChannels: number;\n  sampleRate: number;\n};\n\nexport type MediaTrackInfo = BaseTrackInfo | VideoTrackInfo | AudioTrackInfo;\n\nexport type VideoInfoResult = {\n  format: string;\n  mimeType: string | null;\n  start: number;\n  end: number;\n  tracks: MediaTrackInfo[];\n  metadataTags?: MetadataTagsInfo | null;\n  fileSize: number;\n\n  /**\n   * Legacy convenience fields derived from the primary video and audio tracks.\n   */\n  duration: number;\n  hasAudio: boolean;\n  isHDR: boolean | null;\n  width: number;\n  height: number;\n  fps: number;\n  bitRate: number;\n  codec: string;\n  orientation: \"Portrait\" | \"PortraitUpsideDown\" | \"Landscape\" | \"LandscapeRight\" | \"LandscapeLeft\";\n  naturalOrientation: \"Portrait\" | \"Landscape\";\n  aspectRatio: number;\n  is16_9: boolean;\n  audioSampleRate: number;\n  audioChannels: number;\n  audioCodec: string;\n  location: {\n    latitude: number;\n    longitude: number;\n    altitude?: number;\n  } | null;\n};\n\nexport type VideoSource = string | File | Blob;\n\nexport type VideoInfoOptions = {\n  /**\n   * In case `source` is a remote URI, `headers` object is passed in network requests.\n   */\n  headers?: Record<string, string>;\n  /**\n   * Set to `true` to compute exact durations by scanning packet timing when\n   * metadata duration is unavailable or approximate.\n   *\n   * Defaults to `false` for faster metadata resolution.\n   */\n  exactDuration?: boolean;\n  /**\n   * Number of packets to inspect for packet statistics. Use `null` to scan the\n   * full track, matching Mediabunny's metadata extraction demo exactly.\n   *\n   * Defaults to `30`.\n   */\n  packetStatsSampleCount?: number | null;\n  /**\n   * Include container metadata tags such as title, artist, comments, embedded\n   * images, raw tags, and GPS location.\n   *\n   * Defaults to `false` because tag parsing can require extra reads and is not\n   * needed for basic technical video metadata.\n   */\n  includeMetadataTags?: boolean;\n  /**\n   * Include video tracks in the returned `tracks` array and derived video\n   * convenience fields.\n   *\n   * Defaults to `true`.\n   */\n  includeVideoTracks?: boolean;\n  /**\n   * Include audio tracks in the returned `tracks` array and derived audio\n   * convenience fields.\n   *\n   * Defaults to `true`.\n   */\n  includeAudioTracks?: boolean;\n};\n"]}

package/build/ExpoVideoMetadataModule.d.ts

@@ -1,3 +1,7 @@
-declare const _default: any;
+import { getVideoInfo } from "./getVideoInfo";
+declare const _default: {
+    name: string;
+    getVideoInfo: typeof getVideoInfo;
+};
 export default _default;
 //# sourceMappingURL=ExpoVideoMetadataModule.d.ts.map

package/build/ExpoVideoMetadataModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoVideoMetadataModule.d.ts","sourceRoot":"","sources":["../src/ExpoVideoMetadataModule.ts"],"names":[],"mappings":";AACA,wBAAwD"}
+{"version":3,"file":"ExpoVideoMetadataModule.d.ts","sourceRoot":"","sources":["../src/ExpoVideoMetadataModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;;;;;AAE9C,wBAIE"}

package/build/ExpoVideoMetadataModule.js

@@ -1,3 +1,6 @@
-import { requireNativeModule } from "expo";
-export default requireNativeModule("ExpoVideoMetadata");
+import { getVideoInfo } from "./getVideoInfo";
+export default {
+    name: "ExpoVideoMetadata",
+    getVideoInfo,
+};
 //# sourceMappingURL=ExpoVideoMetadataModule.js.map

package/build/ExpoVideoMetadataModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoVideoMetadataModule.js","sourceRoot":"","sources":["../src/ExpoVideoMetadataModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAC3C,eAAe,mBAAmB,CAAC,mBAAmB,CAAC,CAAC","sourcesContent":["import { requireNativeModule } from \"expo\";\nexport default requireNativeModule(\"ExpoVideoMetadata\");\n"]}
+{"version":3,"file":"ExpoVideoMetadataModule.js","sourceRoot":"","sources":["../src/ExpoVideoMetadataModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,eAAe;IACb,IAAI,EAAE,mBAAmB;IAEzB,YAAY;CACb,CAAC","sourcesContent":["import { getVideoInfo } from \"./getVideoInfo\";\n\nexport default {\n  name: \"ExpoVideoMetadata\",\n\n  getVideoInfo,\n};\n"]}

package/build/createSourceInfo.d.ts

@@ -0,0 +1,4 @@
+import type { VideoInfoOptions, VideoSource } from "./ExpoVideoMetadata.types";
+import { type SourceInfo } from "./sourceInfo";
+export declare function createSourceInfo(source: VideoSource, options: VideoInfoOptions): Promise<SourceInfo>;
+//# sourceMappingURL=createSourceInfo.d.ts.map

package/build/createSourceInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSourceInfo.d.ts","sourceRoot":"","sources":["../src/createSourceInfo.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAA6C,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AA8B1F,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAerB"}

package/build/createSourceInfo.js

@@ -0,0 +1,42 @@
+import { File, FileMode } from "expo-file-system";
+import { StreamSource } from "mediabunny";
+import { createBlobSourceInfo, createUrlSourceInfo } from "./sourceInfo";
+import { isLocalFileSource } from "./utils";
+function createFileSystemSourceInfo(file) {
+    let handle = null;
+    const fileSize = file.size;
+    const getHandle = () => {
+        handle ??= file.open(FileMode.ReadOnly);
+        return handle;
+    };
+    return {
+        source: new StreamSource({
+            getSize: () => fileSize,
+            read: (start, end) => {
+                const currentHandle = getHandle();
+                currentHandle.offset = start;
+                return currentHandle.readBytes(end - start);
+            },
+            dispose: () => {
+                handle?.close();
+                handle = null;
+            },
+            prefetchProfile: "fileSystem",
+        }),
+        fileSize,
+    };
+}
+export async function createSourceInfo(source, options) {
+    const blobSourceInfo = await createBlobSourceInfo(source);
+    if (blobSourceInfo) {
+        return blobSourceInfo;
+    }
+    if (typeof source === "string" && isLocalFileSource(source)) {
+        return createFileSystemSourceInfo(new File(source));
+    }
+    if (typeof source === "string") {
+        return await createUrlSourceInfo(source, options);
+    }
+    throw new TypeError("Unsupported video source.");
+}
+//# sourceMappingURL=createSourceInfo.js.map

package/build/createSourceInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSourceInfo.js","sourceRoot":"","sources":["../src/createSourceInfo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAmB,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAmB,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C,SAAS,0BAA0B,CAAC,IAAU;IAC5C,IAAI,MAAM,GAAsB,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;IAE3B,MAAM,SAAS,GAAG,GAAG,EAAE;QACrB,MAAM,KAAK,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,IAAI,YAAY,CAAC;YACvB,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ;YACvB,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACnB,MAAM,aAAa,GAAG,SAAS,EAAE,CAAC;gBAClC,aAAa,CAAC,MAAM,GAAG,KAAK,CAAC;gBAC7B,OAAO,aAAa,CAAC,SAAS,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;YAC9C,CAAC;YACD,OAAO,EAAE,GAAG,EAAE;gBACZ,MAAM,EAAE,KAAK,EAAE,CAAC;gBAChB,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;YACD,eAAe,EAAE,YAAY;SAC9B,CAAC;QACF,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAmB,EACnB,OAAyB;IAEzB,MAAM,cAAc,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC1D,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,OAAO,0BAA0B,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,MAAM,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,IAAI,SAAS,CAAC,2BAA2B,CAAC,CAAC;AACnD,CAAC","sourcesContent":["import { File, FileMode, type FileHandle } from \"expo-file-system\";\nimport { StreamSource } from \"mediabunny\";\n\nimport type { VideoInfoOptions, VideoSource } from \"./ExpoVideoMetadata.types\";\nimport { createBlobSourceInfo, createUrlSourceInfo, type SourceInfo } from \"./sourceInfo\";\nimport { isLocalFileSource } from \"./utils\";\n\nfunction createFileSystemSourceInfo(file: File): SourceInfo {\n  let handle: FileHandle | null = null;\n  const fileSize = file.size;\n\n  const getHandle = () => {\n    handle ??= file.open(FileMode.ReadOnly);\n    return handle;\n  };\n\n  return {\n    source: new StreamSource({\n      getSize: () => fileSize,\n      read: (start, end) => {\n        const currentHandle = getHandle();\n        currentHandle.offset = start;\n        return currentHandle.readBytes(end - start);\n      },\n      dispose: () => {\n        handle?.close();\n        handle = null;\n      },\n      prefetchProfile: \"fileSystem\",\n    }),\n    fileSize,\n  };\n}\n\nexport async function createSourceInfo(\n  source: VideoSource,\n  options: VideoInfoOptions\n): Promise<SourceInfo> {\n  const blobSourceInfo = await createBlobSourceInfo(source);\n  if (blobSourceInfo) {\n    return blobSourceInfo;\n  }\n\n  if (typeof source === \"string\" && isLocalFileSource(source)) {\n    return createFileSystemSourceInfo(new File(source));\n  }\n\n  if (typeof source === \"string\") {\n    return await createUrlSourceInfo(source, options);\n  }\n\n  throw new TypeError(\"Unsupported video source.\");\n}\n"]}

package/build/createSourceInfo.web.d.ts

@@ -0,0 +1,4 @@
+import type { VideoInfoOptions, VideoSource } from "./ExpoVideoMetadata.types";
+import { type SourceInfo } from "./sourceInfo";
+export declare function createSourceInfo(source: VideoSource, options: VideoInfoOptions): Promise<SourceInfo>;
+//# sourceMappingURL=createSourceInfo.web.d.ts.map