From 33ee5bef6ef741d259bf4568a65512d6a468fac7 Mon Sep 17 00:00:00 2001
From: michal <dydmichal@gmail.com>
Date: Mon, 18 May 2026 17:12:22 +0200
Subject: [PATCH] feat: first impl of MEASN

---
 .../src/examples/AudioTag/AudioTag.tsx        | 148 ++++++++++++++----
 apps/fabric-example/ios/Podfile.lock          |   2 +-
 .../audiodocs/docs/core/audio-context.mdx     |  10 ++
 .../docs/other/web-audio-api-coverage.mdx     |   2 +-
 .../media-element-audio-source-node.mdx       | 107 +++++++++++++
 .../HostObjects/AudioContextHostObject.cpp    |  20 ++-
 .../HostObjects/AudioContextHostObject.h      |   1 +
 .../BaseAudioContextHostObject.cpp            |   3 +-
 .../sources/AudioFileSourceNodeHostObject.h   |   5 +
 .../AudioScheduledSourceNodeHostObject.cpp    |   2 +-
 .../MediaElementAudioSourceNodeHostObject.cpp |  17 ++
 .../MediaElementAudioSourceNodeHostObject.h   |  17 ++
 .../common/cpp/audioapi/core/AudioNode.cpp    |   8 +-
 .../common/cpp/audioapi/core/AudioNode.h      |   6 +-
 .../cpp/audioapi/core/BaseAudioContext.cpp    |  21 +++
 .../cpp/audioapi/core/BaseAudioContext.h      |   5 +-
 .../core/sources/AudioFileSourceNode.cpp      |  63 ++++++++
 .../core/sources/AudioFileSourceNode.h        |  30 ++++
 .../sources/MediaElementAudioSourceNode.cpp   |  49 ++++++
 .../sources/MediaElementAudioSourceNode.h     |  32 ++++
 .../audioapi/core/utils/AudioGraphManager.cpp |  35 ++++-
 .../audioapi/core/utils/AudioGraphManager.h   |  81 +++++-----
 .../common/cpp/audioapi/types/NodeOptions.h   |   8 +
 .../common/cpp/test/CMakeLists.txt            |   1 -
 packages/react-native-audio-api/src/api.ts    |   2 +
 .../react-native-audio-api/src/api.web.ts     |   2 +
 .../src/core/AudioContext.ts                  |   8 +
 .../src/core/MediaElementAudioSourceNode.ts   |  31 ++++
 .../src/development/react/Audio/Audio.tsx     |  15 ++
 .../react/Audio/AudioFileSourceNode.ts        |  16 +-
 .../src/development/react/Audio/types.ts      |  10 ++
 .../react-native-audio-api/src/interfaces.ts  |   5 +
 .../react-native-audio-api/src/mock/index.ts  |  22 +++
 .../src/web-core/AudioContext.tsx             |  11 ++
 .../web-core/MediaElementAudioSourceNode.tsx  |  19 +++
 35 files changed, 708 insertions(+), 106 deletions(-)
 create mode 100644 packages/audiodocs/docs/sources/media-element-audio-source-node.mdx
 create mode 100644 packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/MediaElementAudioSourceNodeHostObject.cpp
 create mode 100644 packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/MediaElementAudioSourceNodeHostObject.h
 create mode 100644 packages/react-native-audio-api/common/cpp/audioapi/core/sources/MediaElementAudioSourceNode.cpp
 create mode 100644 packages/react-native-audio-api/common/cpp/audioapi/core/sources/MediaElementAudioSourceNode.h
 create mode 100644 packages/react-native-audio-api/src/core/MediaElementAudioSourceNode.ts
 create mode 100644 packages/react-native-audio-api/src/web-core/MediaElementAudioSourceNode.tsx

diff --git a/apps/common-app/src/examples/AudioTag/AudioTag.tsx b/apps/common-app/src/examples/AudioTag/AudioTag.tsx
index 7ff67d93c..ea8645f73 100644
--- a/apps/common-app/src/examples/AudioTag/AudioTag.tsx
+++ b/apps/common-app/src/examples/AudioTag/AudioTag.tsx
@@ -1,58 +1,140 @@
-import React, { useRef } from 'react';
-import { Button, View } from 'react-native';
+import React, { useCallback, useMemo, useRef, useState, useEffect } from 'react';
+import { Text, useWindowDimensions, View } from 'react-native';
 import {
   Audio,
   AudioTagHandle,
 } from 'react-native-audio-api/development/react';
+import { AudioContext, GainNode } from 'react-native-audio-api';
 
-import { Container } from '../../components';
+import { Button, Container, Slider, Spacer } from '../../components';
 
 // const DEMO_AUDIO_URL = 'https://filesamples.com/samples/audio/m4a/sample4.m4a';
 const DEMO_AUDIO_URL = 'https://filesamples.com/samples/audio/mp3/sample4.mp3';
 
 const AudioTag: React.FC = () => {
+  const { width: screenWidth } = useWindowDimensions();
   const audioRef = useRef<AudioTagHandle>(null);
+  const [sliderVolume, setSliderVolume] = useState(1);
+  const volumeRef = useRef(1);
+  const audioContextRef = useRef<AudioContext>(new AudioContext());
+  const gainNodeRef = useRef<GainNode | null>(null);
 
-  // const handlePlay = () => {
-  //   audioRef.current?.play();
-  // };
+  const ensureMediaElementRoute = useCallback(() => {
+    if (!audioRef.current) {
+      throw new Error('Audio tag handle is not ready yet.');
+    }
 
-  // const handlePause = () => {
-  //   audioRef.current?.pause();
-  // };
+    const ctx = audioContextRef.current;
+    const mediaElementSource = ctx.createMediaElementSource(audioRef.current);
+    gainNodeRef.current = ctx.createGain();
+    gainNodeRef.current.gain.value = volumeRef.current;
 
-  // const handleSeekToTime = (time: number) => {
-  //   console.log('handleSeekToTime', time);
-  //   audioRef.current?.seekToTime(time);
-  // };
+    const biquad = ctx.createBiquadFilter();
+    biquad.type = 'highpass';
+    biquad.frequency.value = 5000;
+    mediaElementSource.connect(biquad);
+    biquad.connect(gainNodeRef.current);
+    gainNodeRef.current.connect(ctx.destination);
+    audioRef.current?.play();
+  }, []);
 
-  // const handleSetVolume = (volume: number) => {
-  //   audioRef.current?.setVolume(volume);
-  // };
+  const handleVolumeChange = useCallback((nextVolume: number) => {
+    setSliderVolume(nextVolume);
+    volumeRef.current = nextVolume;
+    audioRef.current?.setVolume(nextVolume);
+    if (gainNodeRef.current) {
+      gainNodeRef.current.gain.value = nextVolume;
+    }
+  }, []);
 
-  // const handleSetMuted = (muted: boolean) => {
-  //   audioRef.current?.setMuted(muted);
-  // };
+  const handleLoadStart = useCallback(() => {
+    // console.log('onLoadStart');
+  }, []);
+  const handleLoad = useCallback(() => {
+    // console.log('onLoad');
+  }, []);
+  const handleError = useCallback((error: Error) => {
+    // console.log('onError', error);
+  }, []);
+  const handlePositionChange = useCallback(
+    (seconds: number) => {
+      // console.log('onPositionChange', seconds);
+    },
+    []
+  );
+  const handleEnded = useCallback(() => {
+    // console.log('onEnded');
+  }, []);
+  const handlePlay = useCallback(() => {
+    // console.log('onPlay');
+  }, []);
+  const handlePause = useCallback(() => {
+    // console.log('onPause');
+  }, []);
+  const handleVolumeEvent = useCallback(
+    (volume: number) => {
+      // console.log('onVolumeChange', volume);
+    },
+    []
+  );
+
+  const audioTagElement = useMemo(
+    () => (
+      <Audio
+        source={DEMO_AUDIO_URL}
+        ref={audioRef}
+        context={audioContextRef.current}
+        controls
+        onLoadStart={handleLoadStart}
+        onLoad={handleLoad}
+        onError={handleError}
+        onPositionChange={handlePositionChange}
+        onEnded={handleEnded}
+        onPlay={handlePlay}
+        onPause={handlePause}
+        onVolumeChange={handleVolumeEvent}
+      />
+    ),
+    [
+      handleEnded,
+      handleError,
+      handleLoad,
+      handleLoadStart,
+      handlePause,
+      handlePlay,
+      handlePositionChange,
+      handleVolumeEvent,
+    ]
+  );
 
   return (
     <Container disablePadding>
       <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
         <View style={{ width: '90%' }}>
-          <Audio
-            source={DEMO_AUDIO_URL}
-            ref={audioRef}
-            controls
-            onLoadStart={() => console.log('onLoadStart')}
-            onLoad={() => console.log('onLoad')}
-            onError={(error) => console.log('onError', error)}
-            onPositionChange={(seconds) =>
-              console.log('onPositionChange', seconds)
-            }
-            onEnded={() => console.log('onEnded')}
-            onPlay={() => console.log('onPlay')}
-            onPause={() => console.log('onPause')}
-            onVolumeChange={(volume) => console.log('onVolumeChange', volume)}
+          {audioTagElement}
+          <Spacer.Vertical size={20} />
+          <Slider
+            label="Volume"
+            value={sliderVolume}
+            onValueChange={handleVolumeChange}
+            min={0}
+            max={1}
+            step={0.01}
+            minLabelWidth={70}
           />
+          <Spacer.Vertical size={20} />
+        </View>
+        <Button
+          title="Route via MediaElement node"
+          onPress={ensureMediaElementRoute}
+          width={screenWidth * 0.8}
+        />
+        <Spacer.Vertical size={12} />
+        <View style={{ width: '90%' }}>
+          <Text style={{ color: 'white', textAlign: 'center' }}>
+            The button initializes MediaElementAudioSourceNode from the Audio tag
+            handle and routes it through GainNode to destination.
+          </Text>
         </View>
       </View>
     </Container>
diff --git a/apps/fabric-example/ios/Podfile.lock b/apps/fabric-example/ios/Podfile.lock
index 79db070cf..74a47ec25 100644
--- a/apps/fabric-example/ios/Podfile.lock
+++ b/apps/fabric-example/ios/Podfile.lock
@@ -2550,7 +2550,7 @@ SPEC CHECKSUMS:
   ReactCodegen: d07ee3c8db75b43d1cbe479ae6affebf9925c733
   ReactCommon: fe2a3af8975e63efa60f95fca8c34dc85deee360
   ReactNativeDependencies: 4d5ce2683b6d74f7c686bf90a88c7d381295cf3c
-  RNAudioAPI: 764858df27270ed9a55803bb4c9c0ccb5bb14e9a
+  RNAudioAPI: 6668f71bdd9850005984acf39a3daef4935cec02
   RNGestureHandler: 187c5c7936abf427bc4d22d6c3b1ac80ad1f63c0
   RNReanimated: 64f4b3b33b48b19e0ba76a352571b52b1e931981
   RNScreens: 01b065ded2dfe7987bcce770ff3a196be417ff41
diff --git a/packages/audiodocs/docs/core/audio-context.mdx b/packages/audiodocs/docs/core/audio-context.mdx
index 259c60a79..00d09361e 100644
--- a/packages/audiodocs/docs/core/audio-context.mdx
+++ b/packages/audiodocs/docs/core/audio-context.mdx
@@ -33,6 +33,16 @@ It inherits all properties from [`BaseAudioContext`](/docs/core/base-audio-conte
 
 It inherits all methods from [`BaseAudioContext`](/docs/core/base-audio-context#methods).
 
+### `createMediaElementSource`
+
+Creates [`MediaElementAudioSourceNode`](/docs/sources/media-element-audio-source-node), routing media playback into the audio graph.
+
+| Parameter | Type | Description |
+| :---: | :---: | :---- |
+| `mediaElement` | `HTMLMediaElement` (web) \| [`AudioTagHandle`](/docs/experimental/audio-tag#ref-handle-audiotaghandle-methods) (native) | Media element to route into the graph. On native, wait for [`onLoad`](/docs/experimental/audio-tag#props-audioprops) on `<Audio>` before calling. |
+
+#### Returns [`MediaElementAudioSourceNode`](/docs/sources/media-element-audio-source-node).
+
 ### `close`
 
 Closes the audio context, releasing any system audio resources that it uses.
diff --git a/packages/audiodocs/docs/other/web-audio-api-coverage.mdx b/packages/audiodocs/docs/other/web-audio-api-coverage.mdx
index d0e5b8a68..efa1f0a95 100644
--- a/packages/audiodocs/docs/other/web-audio-api-coverage.mdx
+++ b/packages/audiodocs/docs/other/web-audio-api-coverage.mdx
@@ -23,6 +23,7 @@ sidebar_position: 2
 | DelayNode | ✅ |
 | GainNode | ✅ |
 | IIRFilterNode | ✅  |
+| MediaElementAudioSourceNode | ✅ | Full <Audio /> spec is still in a development phase, however most important functionalities are implemented. |
 | OfflineAudioContext | ✅ |
 | OscillatorNode | ✅ |
 | PeriodicWave | ✅ |
@@ -39,7 +40,6 @@ sidebar_position: 2
 | ChannelMergerNode | ❌ |
 | ChannelSplitterNode | ❌ |
 | DynamicsCompressorNode | ❌ |
-| MediaElementAudioSourceNode | ❌ |
 | MediaStreamAudioDestinationNode | ❌ |
 | MediaStreamAudioSourceNode | ❌ |
 | PannerNode | ❌ |
diff --git a/packages/audiodocs/docs/sources/media-element-audio-source-node.mdx b/packages/audiodocs/docs/sources/media-element-audio-source-node.mdx
new file mode 100644
index 000000000..229483c7c
--- /dev/null
+++ b/packages/audiodocs/docs/sources/media-element-audio-source-node.mdx
@@ -0,0 +1,107 @@
+---
+sidebar_position: 6
+---
+
+import AudioNodePropsTable from "@site/src/components/AudioNodePropsTable"
+import { ReadOnly } from '@site/src/components/Badges';
+
+# MediaElementAudioSourceNode
+
+The `MediaElementAudioSourceNode` is an [`AudioNode`](/docs/core/audio-node) that routes media playback into the audio graph.
+On web it mirrors [`AudioContext.createMediaElementSource()`](https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createMediaElementSource) and accepts an `HTMLMediaElement`.
+On native it wraps a file-backed source created by the experimental [`<Audio>`](/docs/experimental/audio-tag) tag.
+
+## Constructor
+
+```tsx
+constructor(context: BaseAudioContext, options: MediaElementAudioSourceOptions)
+```
+
+### `MediaElementAudioSourceOptions`
+
+| Parameter | Type | Default | |
+| :---: | :---: | :----: | :---- |
+| `mediaElement` | `HTMLMediaElement` (web) \| [`AudioTagHandle`](/docs/experimental/audio-tag#ref-handle-audiotaghandle-methods) (native) | — | Media element whose audio is routed into the graph. On native, wait for [`onLoad`](/docs/experimental/audio-tag#props-audioprops) before constructing this node. |
+
+Or by using [`AudioContext`](/docs/core/audio-context) factory method:
+[`AudioContext.createMediaElementSource()`](/docs/core/audio-context#createmediaelementsource)
+
+## Example
+
+```tsx
+import React, { useRef } from 'react';
+import {
+  AudioContext,
+  GainNode,
+} from 'react-native-audio-api';
+import { Audio, AudioTagHandle } from 'react-native-audio-api/development/react';
+
+function WebExample() {
+  const audioContextRef = useRef<AudioContext | null>(null);
+  if (!audioContextRef.current) {
+    audioContextRef.current = new AudioContext();
+  }
+
+  const audioElement = document.querySelector('audio')!;
+  const sourceNode = audioContextRef.current.createMediaElementSource(audioElement);
+  sourceNode.connect(audioContextRef.current.destination);
+}
+
+function NativeExample() {
+  const audioContextRef = useRef<AudioContext | null>(null);
+  const audioRef = useRef<AudioTagHandle>(null);
+
+  if (!audioContextRef.current) {
+    audioContextRef.current = new AudioContext();
+  }
+
+  const routeThroughGraph = () => {
+    if (!audioRef.current || !audioContextRef.current) {
+      return;
+    }
+
+    const mediaElementSource = audioContextRef.current.createMediaElementSource(
+      audioRef.current
+    );
+    const gain = audioContextRef.current.createGain();
+    mediaElementSource.connect(gain);
+    gain.connect(audioContextRef.current.destination);
+    audioRef.current.play();
+  };
+
+  return (
+    <Audio
+      ref={audioRef}
+      source="https://example.com/audio.mp3"
+      context={audioContextRef.current}
+      onLoad={routeThroughGraph}
+    />
+  );
+}
+```
+
+## Properties
+
+It inherits all properties from [`AudioNode`](/docs/core/audio-node#properties).
+
+<AudioNodePropsTable numberOfInputs={0} numberOfOutputs={1} channelCount="defined by associated media element" channelCountMode="max" channelInterpretation="speakers" />
+
+| Name | Type | Default value | Description |
+| :----: | :----: | :-------- | :------- |
+| `mediaElement` <ReadOnly /> | `HTMLMediaElement` \| [`AudioTagHandle`](/docs/experimental/audio-tag#ref-handle-audiotaghandle-methods) | — | The media element routed into the audio graph. |
+
+## Methods
+
+It inherits all methods from [`AudioNode`](/docs/core/audio-node#methods).
+
+## Remarks
+
+#### Binding
+
+- A single media element can be bound only once per [`AudioContext`](/docs/core/audio-context).
+- Calling `createMediaElementSource` again for the same element throws an error.
+
+#### Native routing
+
+- On native, the underlying file source is disconnected from the destination when this node is created so audio is not processed twice.
+- Use the same [`AudioTagHandle`](/docs/experimental/audio-tag#ref-handle-audiotaghandle-methods) for transport controls (`play`, `pause`, `seekToTime`, volume).
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/AudioContextHostObject.cpp b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/AudioContextHostObject.cpp
index c76067bb7..8660be890 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/AudioContextHostObject.cpp
+++ b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/AudioContextHostObject.cpp
@@ -1,5 +1,7 @@
 #include <audioapi/HostObjects/AudioContextHostObject.h>
 
+#include <audioapi/HostObjects/sources/AudioFileSourceNodeHostObject.h>
+#include <audioapi/HostObjects/sources/MediaElementAudioSourceNodeHostObject.h>
 #include <audioapi/core/AudioContext.h>
 #include <memory>
 #include <utility>
@@ -19,7 +21,8 @@ AudioContextHostObject::AudioContextHostObject(
   addFunctions(
       JSI_EXPORT_FUNCTION(AudioContextHostObject, close),
       JSI_EXPORT_FUNCTION(AudioContextHostObject, resume),
-      JSI_EXPORT_FUNCTION(AudioContextHostObject, suspend));
+      JSI_EXPORT_FUNCTION(AudioContextHostObject, suspend),
+      JSI_EXPORT_FUNCTION(AudioContextHostObject, createMediaElementSource));
 }
 
 JSI_HOST_FUNCTION_IMPL(AudioContextHostObject, close) {
@@ -57,4 +60,19 @@ JSI_HOST_FUNCTION_IMPL(AudioContextHostObject, suspend) {
   return promise;
 }
 
+JSI_HOST_FUNCTION_IMPL(AudioContextHostObject, createMediaElementSource) {
+  auto sourceObject = args[0].asObject(runtime);
+  auto fileSourceHostObject = sourceObject.getHostObject<AudioFileSourceNodeHostObject>(runtime);
+  auto mediaElementSourceNode =
+      context_->createMediaElementSource(fileSourceHostObject->getAudioFileSourceNode());
+
+  if (mediaElementSourceNode == nullptr) {
+    throw jsi::JSError(runtime, "This media element is already connected to this AudioContext.");
+  }
+
+  auto mediaElementSourceHostObject =
+      std::make_shared<MediaElementAudioSourceNodeHostObject>(mediaElementSourceNode);
+  return jsi::Object::createFromHostObject(runtime, mediaElementSourceHostObject);
+}
+
 } // namespace audioapi
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/AudioContextHostObject.h b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/AudioContextHostObject.h
index b62712928..ce114618d 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/AudioContextHostObject.h
+++ b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/AudioContextHostObject.h
@@ -24,5 +24,6 @@ class AudioContextHostObject : public BaseAudioContextHostObject {
   JSI_HOST_FUNCTION_DECL(close);
   JSI_HOST_FUNCTION_DECL(resume);
   JSI_HOST_FUNCTION_DECL(suspend);
+  JSI_HOST_FUNCTION_DECL(createMediaElementSource);
 };
 } // namespace audioapi
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.cpp b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.cpp
index 14d999109..924b30187 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.cpp
+++ b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.cpp
@@ -23,6 +23,7 @@
 #include <audioapi/HostObjects/utils/JsEnumParser.h>
 #include <audioapi/HostObjects/utils/NodeOptionsParser.h>
 #include <audioapi/core/BaseAudioContext.h>
+#include <audioapi/core/OfflineAudioContext.h>
 #include <audioapi/core/utils/AudioDecoder.h>
 
 #include <memory>
@@ -254,7 +255,7 @@ JSI_HOST_FUNCTION_IMPL(BaseAudioContextHostObject, createBufferSource) {
 }
 
 JSI_HOST_FUNCTION_IMPL(BaseAudioContextHostObject, createFileSource) {
-  auto makeFileSourceHostObject = [&](AudioFileSourceOptions opts) -> jsi::Value {
+  auto makeFileSourceHostObject = [&](const AudioFileSourceOptions &opts) -> jsi::Value {
 #if RN_AUDIO_API_FFMPEG_DISABLED
     if (opts.requiresFFmpeg) {
       return jsi::Value::undefined();
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/AudioFileSourceNodeHostObject.h b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/AudioFileSourceNodeHostObject.h
index 7bdbb1405..6be812b19 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/AudioFileSourceNodeHostObject.h
+++ b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/AudioFileSourceNodeHostObject.h
@@ -1,6 +1,7 @@
 #pragma once
 
 #include <audioapi/HostObjects/sources/AudioScheduledSourceNodeHostObject.h>
+#include <audioapi/core/sources/AudioFileSourceNode.h>
 #include <memory>
 
 namespace audioapi {
@@ -30,6 +31,10 @@ class AudioFileSourceNodeHostObject : public AudioScheduledSourceNodeHostObject
   JSI_HOST_FUNCTION_DECL(seekToStart);
   JSI_HOST_FUNCTION_DECL(seekToTime);
 
+  [[nodiscard]] std::shared_ptr<AudioFileSourceNode> getAudioFileSourceNode() const {
+    return std::static_pointer_cast<AudioFileSourceNode>(node_);
+  }
+
  private:
   uint64_t onPositionChangedCallbackId_ = 0;
   uint64_t onEndedCallbackId_ = 0;
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/AudioScheduledSourceNodeHostObject.cpp b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/AudioScheduledSourceNodeHostObject.cpp
index 099be5b6f..1e7691371 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/AudioScheduledSourceNodeHostObject.cpp
+++ b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/AudioScheduledSourceNodeHostObject.cpp
@@ -10,7 +10,7 @@ namespace audioapi {
 AudioScheduledSourceNodeHostObject::AudioScheduledSourceNodeHostObject(
     const std::shared_ptr<AudioScheduledSourceNode> &node,
     const AudioScheduledSourceNodeOptions &options)
-    : AudioNodeHostObject(node) {
+    : AudioNodeHostObject(node, options) {
   addSetters(JSI_EXPORT_PROPERTY_SETTER(AudioScheduledSourceNodeHostObject, onEnded));
 
   addFunctions(
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/MediaElementAudioSourceNodeHostObject.cpp b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/MediaElementAudioSourceNodeHostObject.cpp
new file mode 100644
index 000000000..589560cf0
--- /dev/null
+++ b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/MediaElementAudioSourceNodeHostObject.cpp
@@ -0,0 +1,17 @@
+#include <audioapi/HostObjects/sources/MediaElementAudioSourceNodeHostObject.h>
+#include <audioapi/core/sources/MediaElementAudioSourceNode.h>
+#include <audioapi/types/NodeOptions.h>
+
+#include <memory>
+
+namespace audioapi {
+
+MediaElementAudioSourceNodeHostObject::MediaElementAudioSourceNodeHostObject(
+    const std::shared_ptr<MediaElementAudioSourceNode> &node)
+    : AudioNodeHostObject(
+          node,
+          MediaElementAudioSourceOptions(static_cast<int>(node->getChannelCount()))) {}
+
+MediaElementAudioSourceNodeHostObject::~MediaElementAudioSourceNodeHostObject() = default;
+
+} // namespace audioapi
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/MediaElementAudioSourceNodeHostObject.h b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/MediaElementAudioSourceNodeHostObject.h
new file mode 100644
index 000000000..aee60216a
--- /dev/null
+++ b/packages/react-native-audio-api/common/cpp/audioapi/HostObjects/sources/MediaElementAudioSourceNodeHostObject.h
@@ -0,0 +1,17 @@
+#pragma once
+
+#include <audioapi/HostObjects/AudioNodeHostObject.h>
+#include <memory>
+
+namespace audioapi {
+
+class MediaElementAudioSourceNode;
+
+class MediaElementAudioSourceNodeHostObject : public AudioNodeHostObject {
+ public:
+  explicit MediaElementAudioSourceNodeHostObject(
+      const std::shared_ptr<MediaElementAudioSourceNode> &node);
+  ~MediaElementAudioSourceNodeHostObject() override;
+};
+
+} // namespace audioapi
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/core/AudioNode.cpp b/packages/react-native-audio-api/common/cpp/audioapi/core/AudioNode.cpp
index 0436c6f53..45dafd6b1 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/core/AudioNode.cpp
+++ b/packages/react-native-audio-api/common/cpp/audioapi/core/AudioNode.cpp
@@ -107,8 +107,8 @@ void AudioNode::disable() {
 
   isEnabled_ = false;
 
-  for (auto it = outputNodes_.begin(), end = outputNodes_.end(); it != end; ++it) {
-    it->get()->onInputDisabled();
+  for (const auto &outputNode : outputNodes_) {
+    outputNode.get()->onInputDisabled();
   }
 }
 
@@ -297,8 +297,8 @@ void AudioNode::onInputDisconnected(AudioNode *node) {
 void AudioNode::cleanup() {
   isInitialized_.store(false, std::memory_order_release);
 
-  for (auto it = outputNodes_.begin(), end = outputNodes_.end(); it != end; ++it) {
-    it->get()->onInputDisconnected(this);
+  for (const auto &outputNode : outputNodes_) {
+    outputNode.get()->onInputDisconnected(this);
   }
 
   outputNodes_.clear();
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/core/AudioNode.h b/packages/react-native-audio-api/common/cpp/audioapi/core/AudioNode.h
index d887a92d0..aa81cb54a 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/core/AudioNode.h
+++ b/packages/react-native-audio-api/common/cpp/audioapi/core/AudioNode.h
@@ -29,10 +29,10 @@ class AudioNode : public std::enable_shared_from_this<AudioNode> {
   DELETE_COPY_AND_MOVE(AudioNode);
 
   [[nodiscard]] size_t getChannelCount() const;
-  void connect(const std::shared_ptr<AudioNode> &node);
+  virtual void connect(const std::shared_ptr<AudioNode> &node);
   void connect(const std::shared_ptr<AudioParam> &param);
-  void disconnect();
-  void disconnect(const std::shared_ptr<AudioNode> &node);
+  virtual void disconnect();
+  virtual void disconnect(const std::shared_ptr<AudioNode> &node);
   void disconnect(const std::shared_ptr<AudioParam> &param);
   virtual std::shared_ptr<DSPAudioBuffer> processAudio(
       const std::shared_ptr<DSPAudioBuffer> &outputBuffer,
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.cpp b/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.cpp
index 41e95a136..603add1d3 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.cpp
+++ b/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.cpp
@@ -14,6 +14,7 @@
 #include <audioapi/core/sources/AudioBufferSourceNode.h>
 #include <audioapi/core/sources/AudioFileSourceNode.h>
 #include <audioapi/core/sources/ConstantSourceNode.h>
+#include <audioapi/core/sources/MediaElementAudioSourceNode.h>
 #include <audioapi/core/sources/OscillatorNode.h>
 #include <audioapi/core/sources/RecorderAdapterNode.h>
 #include <audioapi/types/NodeOptions.h>
@@ -185,6 +186,26 @@ std::shared_ptr<AudioFileSourceNode> BaseAudioContext::createFileSource(
   graphManager_->addSourceNode(fileSource);
   return fileSource;
 }
+
+std::shared_ptr<MediaElementAudioSourceNode> BaseAudioContext::createMediaElementSource(
+    const std::shared_ptr<AudioFileSourceNode> &fileSource) {
+  if (fileSource == nullptr) {
+    return nullptr;
+  }
+
+  auto mediaElementSource = std::make_shared<MediaElementAudioSourceNode>(
+      shared_from_this(),
+      fileSource,
+      MediaElementAudioSourceOptions(static_cast<int>(fileSource->getChannelCount())));
+
+  if (!fileSource->tryBindMediaElementSource(mediaElementSource)) {
+    return nullptr;
+  }
+
+  fileSource->routeThroughMediaElement();
+  graphManager_->addMediaElementSourceNode(mediaElementSource);
+  return mediaElementSource;
+}
 #endif // RN_AUDIO_API_TEST
 
 std::shared_ptr<IIRFilterNode> BaseAudioContext::createIIRFilter(const IIRFilterOptions &options) {
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.h b/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.h
index 1cbf100b8..528c1095d 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.h
+++ b/packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.h
@@ -30,6 +30,7 @@ class AudioDestinationNode;
 class AudioBufferSourceNode;
 class AudioBufferQueueSourceNode;
 class AudioFileSourceNode;
+class MediaElementAudioSourceNode;
 class AnalyserNode;
 class AudioEventHandlerRegistry;
 class ConvolverNode;
@@ -50,6 +51,7 @@ struct OscillatorOptions;
 struct BaseAudioBufferSourceOptions;
 struct AudioBufferSourceOptions;
 struct AudioFileSourceOptions;
+struct MediaElementAudioSourceOptions;
 struct StreamerOptions;
 struct DelayOptions;
 struct IIRFilterOptions;
@@ -100,6 +102,8 @@ class BaseAudioContext : public std::enable_shared_from_this<BaseAudioContext> {
       const AudioBufferSourceOptions &options);
 #if !RN_AUDIO_API_TEST
   std::shared_ptr<AudioFileSourceNode> createFileSource(const AudioFileSourceOptions &options);
+  std::shared_ptr<MediaElementAudioSourceNode> createMediaElementSource(
+      const std::shared_ptr<AudioFileSourceNode> &fileSource);
 #endif // RN_AUDIO_API_TEST
   std::shared_ptr<AudioBufferQueueSourceNode> createBufferQueueSource(
       const BaseAudioBufferSourceOptions &options);
@@ -148,7 +152,6 @@ class BaseAudioContext : public std::enable_shared_from_this<BaseAudioContext> {
   std::shared_ptr<PeriodicWave> cachedSquareWave_ = nullptr;
   std::shared_ptr<PeriodicWave> cachedSawtoothWave_ = nullptr;
   std::shared_ptr<PeriodicWave> cachedTriangleWave_ = nullptr;
-
   static constexpr size_t AUDIO_SCHEDULER_CAPACITY = 1024;
   CrossThreadEventScheduler<BaseAudioContext> audioEventScheduler_;
 
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/core/sources/AudioFileSourceNode.cpp b/packages/react-native-audio-api/common/cpp/audioapi/core/sources/AudioFileSourceNode.cpp
index 6ae7b44e5..8b41af563 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/core/sources/AudioFileSourceNode.cpp
+++ b/packages/react-native-audio-api/common/cpp/audioapi/core/sources/AudioFileSourceNode.cpp
@@ -1,5 +1,7 @@
 #include <audioapi/core/BaseAudioContext.h>
+#include <audioapi/core/destinations/AudioDestinationNode.h>
 #include <audioapi/core/sources/AudioFileSourceNode.h>
+#include <audioapi/core/sources/MediaElementAudioSourceNode.h>
 #include <audioapi/core/utils/Constants.h>
 #include <audioapi/events/AudioEvent.h>
 #include <audioapi/events/IAudioEventHandlerRegistry.h>
@@ -114,11 +116,66 @@ void AudioFileSourceNode::initDecoders(
       static_cast<size_t>(RENDER_QUANTUM_SIZE), channelCount_, context->getSampleRate());
 }
 
+void AudioFileSourceNode::connect(const std::shared_ptr<AudioNode> &node) {
+  if (routedThroughMediaElement_) {
+    return;
+  }
+
+  AudioScheduledSourceNode::connect(node);
+
+  if (std::shared_ptr<BaseAudioContext> context = context_.lock()) {
+    if (node == context->getDestination()) {
+      connectedToDestination_ = true;
+    }
+  }
+}
+
+void AudioFileSourceNode::disconnect() {
+  connectedToDestination_ = false;
+  AudioScheduledSourceNode::disconnect();
+}
+
+void AudioFileSourceNode::disconnect(const std::shared_ptr<AudioNode> &node) {
+  if (std::shared_ptr<BaseAudioContext> context = context_.lock()) {
+    if (node == nullptr || node == context->getDestination()) {
+      connectedToDestination_ = false;
+    }
+  }
+  AudioScheduledSourceNode::disconnect(node);
+}
+
 void AudioFileSourceNode::start(double when) {
+  if (!routedThroughMediaElement_ && !connectedToDestination_) {
+    if (std::shared_ptr<BaseAudioContext> context = context_.lock()) {
+      connect(context->getDestination());
+    }
+  }
+
   AudioScheduledSourceNode::start(when);
   filePaused_ = false;
 }
 
+void AudioFileSourceNode::routeThroughMediaElement() {
+  disconnect();
+  routedThroughMediaElement_ = true;
+  connectedToDestination_ = false;
+}
+
+bool AudioFileSourceNode::tryBindMediaElementSource(
+    const std::shared_ptr<MediaElementAudioSourceNode> &mediaElement) {
+  if (mediaElementSource_.lock()) {
+    return false;
+  }
+  mediaElementSource_ = mediaElement;
+  return true;
+}
+
+void AudioFileSourceNode::onMediaElementSourceReleased() {
+  routedThroughMediaElement_ = false;
+  mediaElementSource_.reset();
+  playbackState_ = PlaybackState::FINISHED;
+}
+
 void AudioFileSourceNode::pause() {
   filePaused_ = true;
 }
@@ -216,6 +273,12 @@ size_t AudioFileSourceNode::handleEof(
 std::shared_ptr<DSPAudioBuffer> AudioFileSourceNode::processNode(
     const std::shared_ptr<DSPAudioBuffer> &processingBuffer,
     int framesToProcess) {
+  return processDecodedOutput(processingBuffer, framesToProcess);
+}
+
+std::shared_ptr<DSPAudioBuffer> AudioFileSourceNode::processDecodedOutput(
+    const std::shared_ptr<DSPAudioBuffer> &processingBuffer,
+    int framesToProcess) {
   if (decoderState_ == nullptr || decoder_ == nullptr || !decoder_->isOpen()) {
     processingBuffer->zero();
     return processingBuffer;
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/core/sources/AudioFileSourceNode.h b/packages/react-native-audio-api/common/cpp/audioapi/core/sources/AudioFileSourceNode.h
index 42db20ad7..8fb4ab504 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/core/sources/AudioFileSourceNode.h
+++ b/packages/react-native-audio-api/common/cpp/audioapi/core/sources/AudioFileSourceNode.h
@@ -19,6 +19,7 @@ using namespace audioapi::channels;
 namespace audioapi {
 
 struct AudioFileSourceOptions;
+class MediaElementAudioSourceNode;
 
 struct OffloadedSeekRequest {
   double seconds = 0;
@@ -35,6 +36,8 @@ struct AudioFileDecoderState {
 };
 
 class AudioFileSourceNode : public AudioScheduledSourceNode {
+  friend class MediaElementAudioSourceNode;
+
  public:
   explicit AudioFileSourceNode(
       const std::shared_ptr<BaseAudioContext> &context,
@@ -43,8 +46,24 @@ class AudioFileSourceNode : public AudioScheduledSourceNode {
 
   void disable() override;
 
+  void connect(const std::shared_ptr<AudioNode> &node) override;
+  void disconnect() override;
+  void disconnect(const std::shared_ptr<AudioNode> &node) override;
+
   void start(double when) override;
 
+  /// Detaches from the graph output path and feeds only via MediaElementAudioSourceNode.
+  void routeThroughMediaElement();
+
+  [[nodiscard]] bool isRoutedThroughMediaElement() const {
+    return routedThroughMediaElement_;
+  }
+
+  /// @returns false if this file source is already bound to a media element source.
+  bool tryBindMediaElementSource(const std::shared_ptr<MediaElementAudioSourceNode> &mediaElement);
+
+  void onMediaElementSourceReleased();
+
   void setVolume(float v) {
     volume_ = v;
   }
@@ -69,12 +88,20 @@ class AudioFileSourceNode : public AudioScheduledSourceNode {
 
   void seekToTime(double seconds);
 
+  bool filePaused() const {
+    return filePaused_;
+  }
+
  protected:
   std::shared_ptr<DSPAudioBuffer> processNode(
       const std::shared_ptr<DSPAudioBuffer> &processingBuffer,
       int framesToProcess) override;
 
  private:
+  std::shared_ptr<DSPAudioBuffer> processDecodedOutput(
+      const std::shared_ptr<DSPAudioBuffer> &processingBuffer,
+      int framesToProcess);
+
   void initDecoders(
       bool useFilePath,
       const std::shared_ptr<BaseAudioContext> &context,
@@ -86,6 +113,9 @@ class AudioFileSourceNode : public AudioScheduledSourceNode {
   bool requiresFFmpeg_;
   bool filePaused_{false};
   bool loop_{false};
+  bool routedThroughMediaElement_{false};
+  bool connectedToDestination_{false};
+  std::weak_ptr<MediaElementAudioSourceNode> mediaElementSource_;
   double duration_{0};
   std::atomic<double> currentTime_{0};
   double sampleRate_{0};
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/core/sources/MediaElementAudioSourceNode.cpp b/packages/react-native-audio-api/common/cpp/audioapi/core/sources/MediaElementAudioSourceNode.cpp
new file mode 100644
index 000000000..247dd28a6
--- /dev/null
+++ b/packages/react-native-audio-api/common/cpp/audioapi/core/sources/MediaElementAudioSourceNode.cpp
@@ -0,0 +1,49 @@
+#include <audioapi/core/BaseAudioContext.h>
+#include <audioapi/core/sources/AudioFileSourceNode.h>
+#include <audioapi/core/sources/MediaElementAudioSourceNode.h>
+#include <audioapi/types/NodeOptions.h>
+
+#include <memory>
+
+namespace audioapi {
+
+MediaElementAudioSourceNode::MediaElementAudioSourceNode(
+    const std::shared_ptr<BaseAudioContext> &context,
+    const std::shared_ptr<AudioFileSourceNode> &fileSource,
+    const MediaElementAudioSourceOptions &options)
+    : AudioNode(context, options), fileSource_(fileSource) {
+  isInitialized_.store(true, std::memory_order_release);
+}
+
+MediaElementAudioSourceNode::~MediaElementAudioSourceNode() {
+  if (fileSource_ != nullptr) {
+    fileSource_->onMediaElementSourceReleased();
+  }
+}
+
+std::shared_ptr<DSPAudioBuffer> MediaElementAudioSourceNode::processNode(
+    const std::shared_ptr<DSPAudioBuffer> &processingBuffer,
+    int framesToProcess) {
+  if (fileSource_ == nullptr) {
+    processingBuffer->zero();
+    return processingBuffer;
+  }
+
+  return fileSource_->processDecodedOutput(processingBuffer, framesToProcess);
+}
+
+size_t MediaElementAudioSourceNode::getFileSourceNodeUseCount() const {
+  if (fileSource_ == nullptr) {
+    return 0;
+  }
+  return fileSource_.use_count();
+}
+
+bool MediaElementAudioSourceNode::fileSourceNodePaused() const {
+  if (fileSource_ == nullptr) {
+    return false;
+  }
+  return fileSource_->filePaused();
+}
+
+} // namespace audioapi
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/core/sources/MediaElementAudioSourceNode.h b/packages/react-native-audio-api/common/cpp/audioapi/core/sources/MediaElementAudioSourceNode.h
new file mode 100644
index 000000000..d602a50c7
--- /dev/null
+++ b/packages/react-native-audio-api/common/cpp/audioapi/core/sources/MediaElementAudioSourceNode.h
@@ -0,0 +1,32 @@
+#pragma once
+
+#include <audioapi/core/AudioNode.h>
+#include <memory>
+
+namespace audioapi {
+
+class AudioFileSourceNode;
+struct MediaElementAudioSourceOptions;
+
+class MediaElementAudioSourceNode : public AudioNode {
+ public:
+  explicit MediaElementAudioSourceNode(
+      const std::shared_ptr<BaseAudioContext> &context,
+      const std::shared_ptr<AudioFileSourceNode> &fileSource,
+      const MediaElementAudioSourceOptions &options);
+
+  ~MediaElementAudioSourceNode() override;
+
+  size_t getFileSourceNodeUseCount() const;
+  bool fileSourceNodePaused() const;
+
+ protected:
+  std::shared_ptr<DSPAudioBuffer> processNode(
+      const std::shared_ptr<DSPAudioBuffer> &processingBuffer,
+      int framesToProcess) override;
+
+ private:
+  std::shared_ptr<AudioFileSourceNode> fileSource_;
+};
+
+} // namespace audioapi
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/core/utils/AudioGraphManager.cpp b/packages/react-native-audio-api/common/cpp/audioapi/core/utils/AudioGraphManager.cpp
index 1689fc6b6..18b3f34a6 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/core/utils/AudioGraphManager.cpp
+++ b/packages/react-native-audio-api/common/cpp/audioapi/core/utils/AudioGraphManager.cpp
@@ -3,6 +3,7 @@
 #include <audioapi/core/effects/ConvolverNode.h>
 #include <audioapi/core/effects/DelayNode.h>
 #include <audioapi/core/sources/AudioScheduledSourceNode.h>
+#include <audioapi/core/sources/MediaElementAudioSourceNode.h>
 #include <audioapi/core/utils/AudioGraphManager.h>
 #include <audioapi/core/utils/Locker.h>
 
@@ -36,6 +37,9 @@ AudioGraphManager::Event &AudioGraphManager::Event::operator=(Event &&other) noe
       case EventPayloadType::SOURCE_NODE:
         payload.sourceNode = std::move(other.payload.sourceNode);
         break;
+      case EventPayloadType::MEDIA_ELEMENT_SOURCE_NODE:
+        payload.mediaElementSourceNode = std::move(other.payload.mediaElementSourceNode);
+        break;
       case EventPayloadType::AUDIO_PARAM:
         payload.audioParam = std::move(other.payload.audioParam);
         break;
@@ -63,6 +67,9 @@ AudioGraphManager::Event::~Event() {
     case EventPayloadType::SOURCE_NODE:
       payload.sourceNode.~shared_ptr();
       break;
+    case EventPayloadType::MEDIA_ELEMENT_SOURCE_NODE:
+      payload.mediaElementSourceNode.~shared_ptr();
+      break;
     case EventPayloadType::AUDIO_PARAM:
       payload.audioParam.~shared_ptr();
       break;
@@ -74,6 +81,7 @@ AudioGraphManager::Event::~Event() {
 
 AudioGraphManager::AudioGraphManager() {
   sourceNodes_.reserve(kInitialCapacity);
+  mediaElementAudioSourceNodes_.reserve(kInitialCapacity);
   processingNodes_.reserve(kInitialCapacity);
   audioParams_.reserve(kInitialCapacity);
   audioBuffers_.reserve(kInitialCapacity);
@@ -120,6 +128,7 @@ void AudioGraphManager::addPendingParamConnection(
 void AudioGraphManager::preProcessGraph() {
   settlePendingConnections();
   AudioGraphManager::prepareForDestruction(sourceNodes_, nodeDestructor_);
+  AudioGraphManager::prepareForDestruction(mediaElementAudioSourceNodes_, nodeDestructor_);
   AudioGraphManager::prepareForDestruction(processingNodes_, nodeDestructor_);
   AudioGraphManager::prepareForDestruction(audioBuffers_, bufferDestructor_);
 }
@@ -142,6 +151,16 @@ void AudioGraphManager::addSourceNode(const std::shared_ptr<AudioScheduledSource
   sender_.send(std::move(event));
 }
 
+void AudioGraphManager::addMediaElementSourceNode(
+    const std::shared_ptr<MediaElementAudioSourceNode> &node) {
+  auto event = std::make_unique<Event>();
+  event->type = ConnectionType::ADD;
+  event->payloadType = EventPayloadType::MEDIA_ELEMENT_SOURCE_NODE;
+  event->payload.mediaElementSourceNode = node;
+
+  sender_.send(std::move(event));
+}
+
 void AudioGraphManager::addAudioParam(const std::shared_ptr<AudioParam> &param) {
   auto event = std::make_unique<Event>();
   event->type = ConnectionType::ADD;
@@ -214,6 +233,9 @@ void AudioGraphManager::handleAddToDeconstructionEvent(std::unique_ptr<Event> ev
     case EventPayloadType::SOURCE_NODE:
       sourceNodes_.push_back(event->payload.sourceNode);
       break;
+    case EventPayloadType::MEDIA_ELEMENT_SOURCE_NODE:
+      mediaElementAudioSourceNodes_.push_back(event->payload.mediaElementSourceNode);
+      break;
     case EventPayloadType::AUDIO_PARAM:
       audioParams_.push_back(event->payload.audioParam);
       break;
@@ -223,15 +245,20 @@ void AudioGraphManager::handleAddToDeconstructionEvent(std::unique_ptr<Event> ev
 }
 
 void AudioGraphManager::cleanup() {
-  for (auto it = sourceNodes_.begin(), end = sourceNodes_.end(); it != end; ++it) {
-    it->get()->cleanup();
+  for (auto &sourceNode : sourceNodes_) {
+    sourceNode->cleanup();
+  }
+
+  for (auto &mediaElementAudioSourceNode : mediaElementAudioSourceNodes_) {
+    mediaElementAudioSourceNode->cleanup();
   }
 
-  for (auto it = processingNodes_.begin(), end = processingNodes_.end(); it != end; ++it) {
-    it->get()->cleanup();
+  for (auto &processingNode : processingNodes_) {
+    processingNode->cleanup();
   }
 
   sourceNodes_.clear();
+  mediaElementAudioSourceNodes_.clear();
   processingNodes_.clear();
   audioParams_.clear();
   audioBuffers_.clear();
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/core/utils/AudioGraphManager.h b/packages/react-native-audio-api/common/cpp/audioapi/core/utils/AudioGraphManager.h
index 419860b89..b2890bc51 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/core/utils/AudioGraphManager.h
+++ b/packages/react-native-audio-api/common/cpp/audioapi/core/utils/AudioGraphManager.h
@@ -1,5 +1,6 @@
 #pragma once
 
+#include <audioapi/core/sources/AudioFileSourceNode.h>
 #include <audioapi/core/utils/AudioDestructor.hpp>
 #include <audioapi/utils/AudioBuffer.hpp>
 #include <audioapi/utils/Macros.h>
@@ -14,6 +15,7 @@ namespace audioapi {
 class AudioNode;
 class AudioScheduledSourceNode;
 class AudioParam;
+class MediaElementAudioSourceNode;
 
 #define AUDIO_GRAPH_MANAGER_SPSC_OPTIONS \
   std::unique_ptr<Event>, channels::spsc::OverflowStrategy::WAIT_ON_FULL, \
@@ -28,7 +30,14 @@ class AudioGraphManager {
  public:
   enum class ConnectionType : uint8_t { CONNECT, DISCONNECT, DISCONNECT_ALL, ADD };
   using EventType = ConnectionType; // for backwards compatibility
-  enum class EventPayloadType : uint8_t { NODES, PARAMS, SOURCE_NODE, AUDIO_PARAM, NODE };
+  enum class EventPayloadType : uint8_t {
+    NODES,
+    PARAMS,
+    SOURCE_NODE,
+    MEDIA_ELEMENT_SOURCE_NODE,
+    AUDIO_PARAM,
+    NODE
+  };
   union EventPayload {
     struct {
       std::shared_ptr<AudioNode> from;
@@ -39,6 +48,7 @@ class AudioGraphManager {
       std::shared_ptr<AudioParam> to;
     } params;
     std::shared_ptr<AudioScheduledSourceNode> sourceNode;
+    std::shared_ptr<MediaElementAudioSourceNode> mediaElementSourceNode;
     std::shared_ptr<AudioParam> audioParam;
     std::shared_ptr<AudioNode> node;
 
@@ -95,6 +105,11 @@ class AudioGraphManager {
   /// @note Should be only used from JavaScript/HostObjects thread
   void addSourceNode(const std::shared_ptr<AudioScheduledSourceNode> &node);
 
+  /// @brief Adds a media element source node to the manager.
+  /// @param node The media element source node to add.
+  /// @note Should be only used from JavaScript/HostObjects thread
+  void addMediaElementSourceNode(const std::shared_ptr<MediaElementAudioSourceNode> &node);
+
   /// @brief Adds an audio parameter to the manager.
   /// @param param The audio parameter to add.
   /// @note Should be only used from JavaScript/HostObjects thread
@@ -119,6 +134,7 @@ class AudioGraphManager {
   static constexpr size_t kChannelCapacity = 1024;
 
   std::vector<std::shared_ptr<AudioScheduledSourceNode>> sourceNodes_;
+  std::vector<std::shared_ptr<MediaElementAudioSourceNode>> mediaElementAudioSourceNodes_;
   std::vector<std::shared_ptr<AudioNode>> processingNodes_;
   std::vector<std::shared_ptr<AudioParam>> audioParams_;
   std::vector<std::shared_ptr<AudioBuffer>> audioBuffers_;
@@ -147,6 +163,11 @@ class AudioGraphManager {
       return node.use_count() == 1 && (node->isUnscheduled() || node->isFinished());
     }
 
+    if constexpr (std::is_same_v<MediaElementAudioSourceNode, U>) {
+      return node.use_count() == 1 && node->getFileSourceNodeUseCount() == 2 &&
+          node->fileSourceNodePaused();
+    }
+
     if (node->requiresTailProcessing()) {
       // if the node requires tail processing, its own implementation handles disabling it at the right time
       return node.use_count() == 1 && !node->isEnabled();
@@ -163,54 +184,28 @@ class AudioGraphManager {
     if (vec.empty()) {
       return;
     }
-    /// An example of input-output
-    /// for simplicity we will be considering vector where each value represents
-    /// use_count() of an element vec = [1, 2, 1, 3, 1] our end result will be vec
-    /// = [2, 3, 1, 1, 1] After this operation all nodes with use_count() == 1
-    /// will be at the end and we will try to send them. After sending, we will
-    /// only keep audio objects with use_count() > 1 or which failed vec = [2, 3, failed,
-    /// sent, sent] failed will be always before sents vec = [2, 3, failed] and
-    /// we resize
-    /// @note if there are no nodes with use_count() == 1 `begin` will be equal to
-    /// vec.size()
-    /// @note if all audio objects have use_count() == 1 `begin` will be 0
-
-    int begin = 0;
-    int end = vec.size() - 1; // can be -1 (edge case)
-
-    // Moves all audio objects with use_count() == 1 to the end
-    // nodes in range [begin, vec.size()) should be deleted
-    // so new size of the vector will be `begin`
-    while (begin <= end) {
-      while (begin < end && AudioGraphManager::canBeDestructed(vec[end])) {
-        end--;
-      }
-      if (AudioGraphManager::canBeDestructed(vec[begin])) {
-        std::swap(vec[begin], vec[end]);
-        end--;
-      }
-      begin++;
-    }
+    // Compact in place: try to queue each destructible element; keep the rest.
+    size_t keepIndex = 0;
+    for (size_t i = 0; i < vec.size(); ++i) {
+      if (AudioGraphManager::canBeDestructed(vec[i])) {
+        if constexpr (HasCleanupMethod<T>) {
+          if (vec[i]) {
+            vec[i]->cleanup();
+          }
+        }
 
-    for (int i = begin; i < vec.size(); i++) {
-      if constexpr (HasCleanupMethod<T>) {
-        if (vec[i]) {
-          vec[i]->cleanup();
+        /// @note vec[i] does NOT get moved out if it is not successfully added.
+        if (audioDestructor.tryAddForDeconstruction(std::move(vec[i]))) {
+          continue;
         }
       }
 
-      /// If we fail to add we can't safely remove the node from the vector
-      /// so we swap it and advance begin cursor
-      /// @note vec[i] does NOT get moved out if it is not successfully added.
-      if (!audioDestructor.tryAddForDeconstruction(std::move(vec[i]))) {
-        std::swap(vec[i], vec[begin]);
-        begin++;
+      if (keepIndex != i) {
+        vec[keepIndex] = std::move(vec[i]);
       }
+      ++keepIndex;
     }
-    if (begin < vec.size()) {
-      // it does not reallocate if newer size is < current size
-      vec.resize(begin);
-    }
+    vec.resize(keepIndex);
   }
 };
 
diff --git a/packages/react-native-audio-api/common/cpp/audioapi/types/NodeOptions.h b/packages/react-native-audio-api/common/cpp/audioapi/types/NodeOptions.h
index 8acbbede4..df232abbe 100644
--- a/packages/react-native-audio-api/common/cpp/audioapi/types/NodeOptions.h
+++ b/packages/react-native-audio-api/common/cpp/audioapi/types/NodeOptions.h
@@ -126,6 +126,14 @@ struct AudioFileSourceOptions : AudioScheduledSourceNodeOptions {
   float volume = 1.0f;
 };
 
+struct MediaElementAudioSourceOptions : AudioNodeOptions {
+  explicit MediaElementAudioSourceOptions(int mediaChannelCount = 2) {
+    numberOfInputs = 0;
+    numberOfOutputs = 1;
+    channelCount = mediaChannelCount;
+  }
+};
+
 struct StreamerOptions : AudioScheduledSourceNodeOptions {
   std::string streamPath;
 };
diff --git a/packages/react-native-audio-api/common/cpp/test/CMakeLists.txt b/packages/react-native-audio-api/common/cpp/test/CMakeLists.txt
index 03daf8db6..074cfe12f 100644
--- a/packages/react-native-audio-api/common/cpp/test/CMakeLists.txt
+++ b/packages/react-native-audio-api/common/cpp/test/CMakeLists.txt
@@ -38,7 +38,6 @@ list(FILTER RNAUDIOAPI_SRC EXCLUDE REGEX ".*/Worklet.*Node\\.cpp$")
 list(REMOVE_ITEM RNAUDIOAPI_SRC
   "${REACT_NATIVE_AUDIO_API_DIR}/common/cpp/audioapi/core/AudioContext.cpp"
   "${REACT_NATIVE_AUDIO_API_DIR}/common/cpp/audioapi/libs/ffmpeg/FFmpegDecoding.cpp"
-  "${REACT_NATIVE_AUDIO_API_DIR}/common/cpp/audioapi/core/sources/AudioFileSourceNode.cpp"
 )
 
 file(GLOB_RECURSE RNAUDIOAPI_LIBS
diff --git a/packages/react-native-audio-api/src/api.ts b/packages/react-native-audio-api/src/api.ts
index cf101b869..54b2ab76b 100644
--- a/packages/react-native-audio-api/src/api.ts
+++ b/packages/react-native-audio-api/src/api.ts
@@ -19,6 +19,7 @@ export { default as ConstantSourceNode } from './core/ConstantSourceNode';
 export { default as ConvolverNode } from './core/ConvolverNode';
 export { default as DelayNode } from './core/DelayNode';
 export { default as GainNode } from './core/GainNode';
+export { default as MediaElementAudioSourceNode } from './core/MediaElementAudioSourceNode';
 export { default as OfflineAudioContext } from './core/OfflineAudioContext';
 export { default as OscillatorNode } from './core/OscillatorNode';
 export { default as PeriodicWave } from './core/PeriodicWave';
@@ -33,6 +34,7 @@ export { default as WorkletSourceNode } from './core/WorkletSourceNode';
 export * from './errors';
 export * from './system/types';
 export * from './types';
+export type { MediaElementAudioSourceOptions } from './core/MediaElementAudioSourceNode';
 export type { default as AudioEventSubscription } from './events/AudioEventSubscription';
 export { default as FilePreset } from './utils/filePresets';
 
diff --git a/packages/react-native-audio-api/src/api.web.ts b/packages/react-native-audio-api/src/api.web.ts
index 26baa31c2..eb3fe7cfa 100644
--- a/packages/react-native-audio-api/src/api.web.ts
+++ b/packages/react-native-audio-api/src/api.web.ts
@@ -11,6 +11,8 @@ export { default as BaseAudioContext } from './web-core/BaseAudioContext';
 export { default as BiquadFilterNode } from './web-core/BiquadFilterNode';
 export { default as DelayNode } from './web-core/DelayNode';
 export { default as GainNode } from './web-core/GainNode';
+export { default as MediaElementAudioSourceNode } from './web-core/MediaElementAudioSourceNode';
+export type { MediaElementAudioSourceOptions } from './web-core/MediaElementAudioSourceNode';
 export { default as OscillatorNode } from './web-core/OscillatorNode';
 export { default as StereoPannerNode } from './web-core/StereoPannerNode';
 export { default as ConstantSourceNode } from './web-core/ConstantSourceNode';
diff --git a/packages/react-native-audio-api/src/core/AudioContext.ts b/packages/react-native-audio-api/src/core/AudioContext.ts
index ffe927c65..c805e60fb 100644
--- a/packages/react-native-audio-api/src/core/AudioContext.ts
+++ b/packages/react-native-audio-api/src/core/AudioContext.ts
@@ -1,9 +1,11 @@
 import AudioAPIModule from '../AudioAPIModule';
 import { NotSupportedError } from '../errors';
+import { AudioTagHandle } from '../development/react/Audio/types';
 import { IAudioContext } from '../interfaces';
 import AudioManager from '../system';
 import { AudioContextOptions } from '../types';
 import BaseAudioContext from './BaseAudioContext';
+import MediaElementAudioSourceNode from './MediaElementAudioSourceNode';
 
 export default class AudioContext extends BaseAudioContext {
   constructor(options?: AudioContextOptions) {
@@ -38,4 +40,10 @@ export default class AudioContext extends BaseAudioContext {
   async suspend(): Promise<boolean> {
     return (this.context as IAudioContext).suspend();
   }
+
+  createMediaElementSource(
+    mediaElement: AudioTagHandle
+  ): MediaElementAudioSourceNode {
+    return new MediaElementAudioSourceNode(this, { mediaElement });
+  }
 }
diff --git a/packages/react-native-audio-api/src/core/MediaElementAudioSourceNode.ts b/packages/react-native-audio-api/src/core/MediaElementAudioSourceNode.ts
new file mode 100644
index 000000000..a764af487
--- /dev/null
+++ b/packages/react-native-audio-api/src/core/MediaElementAudioSourceNode.ts
@@ -0,0 +1,31 @@
+import AudioNode from './AudioNode';
+import type AudioContext from './AudioContext';
+import { IAudioContext } from '../interfaces';
+import type {
+  AudioTagHandle,
+  InternalAudioTagHandle,
+} from '../development/react/Audio/types';
+import { NotSupportedError } from '../errors';
+
+export interface MediaElementAudioSourceOptions {
+  mediaElement: AudioTagHandle;
+}
+
+export default class MediaElementAudioSourceNode extends AudioNode {
+  readonly mediaElement: AudioTagHandle;
+
+  constructor(context: AudioContext, options: MediaElementAudioSourceOptions) {
+    const internalHandle = options.mediaElement as InternalAudioTagHandle;
+    const fileSourceNode = internalHandle.getMediaElementSourceNode();
+    if (fileSourceNode === null) {
+      throw new NotSupportedError(
+        'Audio tag source is not ready yet. Wait for onLoad before creating MediaElementAudioSourceNode.'
+      );
+    }
+    const node = (context.context as IAudioContext).createMediaElementSource(
+      fileSourceNode
+    );
+    super(context, node);
+    this.mediaElement = options.mediaElement;
+  }
+}
diff --git a/packages/react-native-audio-api/src/development/react/Audio/Audio.tsx b/packages/react-native-audio-api/src/development/react/Audio/Audio.tsx
index f3a9a6cb7..c3afcbd89 100644
--- a/packages/react-native-audio-api/src/development/react/Audio/Audio.tsx
+++ b/packages/react-native-audio-api/src/development/react/Audio/Audio.tsx
@@ -74,6 +74,19 @@ const Audio = React.forwardRef<AudioTagHandle, AudioProps>((props, ref) => {
   const [currentTime, setCurrentTime] = useState(0);
   const [duration, setDuration] = useState(0);
 
+  useEffect(() => {
+    return () => {
+      if (!fileSourceRef.current) {
+        console.error('File source ref is not ready yet.');
+        return;
+      }
+      fileSourceRef.current.disconnect();
+      fileSourceRef.current.pause();
+      fileSourceRef.current.dispose();
+      fileSourceRef.current = null;
+    };
+  }, []);
+
   const effectiveMutedState = useMemo(() => {
     return mutedState ?? muted;
   }, [mutedState, muted]);
@@ -256,6 +269,8 @@ const Audio = React.forwardRef<AudioTagHandle, AudioProps>((props, ref) => {
       seekToTime,
       setVolume: setVolumeState,
       setMuted: setMutedState,
+      getMediaElementSourceNode: () =>
+        fileSourceRef.current?.getMediaElementSourceNode() ?? null,
     }),
     [pause, play, seekToTime, setMutedState, setVolumeState]
   );
diff --git a/packages/react-native-audio-api/src/development/react/Audio/AudioFileSourceNode.ts b/packages/react-native-audio-api/src/development/react/Audio/AudioFileSourceNode.ts
index 5bb939aed..499f04f24 100644
--- a/packages/react-native-audio-api/src/development/react/Audio/AudioFileSourceNode.ts
+++ b/packages/react-native-audio-api/src/development/react/Audio/AudioFileSourceNode.ts
@@ -14,7 +14,6 @@ type AttachFileSourceOptions = {
 export class AudioFileSourceNode extends AudioScheduledSourceNode {
   private readonly emitter = new AudioEventEmitter(global.AudioEventEmitter);
 
-  private didConnectToDestination = false;
   private positionSubscription?: AudioEventSubscription;
   private endedSubscription?: AudioEventSubscription;
 
@@ -39,17 +38,7 @@ export class AudioFileSourceNode extends AudioScheduledSourceNode {
     this.resetNodeAndSubscriptions();
   }
 
-  /**
-   * First call: connect to destination + start. Later calls on the same node
-   * (e.g. resume after pause): only start — avoids duplicate edges and matches
-   * native file-source resume (unpause) semantics.
-   */
   play(): void {
-    if (!this.didConnectToDestination) {
-      // @ts-expect-error destination.node is the underlying graph node
-      this.node.connect(this.context.destination.node);
-      this.didConnectToDestination = true;
-    }
     (this.node as IAudioScheduledSourceNode).start(this.context.currentTime);
   }
 
@@ -69,6 +58,10 @@ export class AudioFileSourceNode extends AudioScheduledSourceNode {
     (this.node as IAudioFileSourceNode).loop = value;
   }
 
+  getMediaElementSourceNode(): IAudioFileSourceNode {
+    return this.node as IAudioFileSourceNode;
+  }
+
   getDuration(): number {
     return (this.node as IAudioFileSourceNode).duration;
   }
@@ -111,6 +104,5 @@ export class AudioFileSourceNode extends AudioScheduledSourceNode {
       (this.node as IAudioFileSourceNode).onEnded = '0';
       this.node.disconnect(undefined);
     }
-    this.didConnectToDestination = false;
   }
 }
diff --git a/packages/react-native-audio-api/src/development/react/Audio/types.ts b/packages/react-native-audio-api/src/development/react/Audio/types.ts
index b7b7fd9a3..3cd49c1ce 100644
--- a/packages/react-native-audio-api/src/development/react/Audio/types.ts
+++ b/packages/react-native-audio-api/src/development/react/Audio/types.ts
@@ -1,5 +1,6 @@
 import { ReactNode } from 'react';
 import type BaseAudioContext from '../../../core/BaseAudioContext';
+import type { IAudioFileSourceNode } from '../../../interfaces';
 
 export interface AudioURISource {
   uri?: string | undefined;
@@ -32,6 +33,15 @@ export interface AudioTagHandle {
   setMuted: (muted: boolean) => void;
 }
 
+/**
+ * Internal handle surface used by MediaElementAudioSourceNode to obtain the
+ * underlying file source. Routing is applied in native
+ * createMediaElementSource. Not exported from the package public API.
+ */
+export interface InternalAudioTagHandle extends AudioTagHandle {
+  getMediaElementSourceNode: () => IAudioFileSourceNode | null;
+}
+
 interface AudioControlProps {
   autoPlay: boolean;
   controls: boolean; // TBD: should we support control display at all?
diff --git a/packages/react-native-audio-api/src/interfaces.ts b/packages/react-native-audio-api/src/interfaces.ts
index 6e86c66af..2367086a1 100644
--- a/packages/react-native-audio-api/src/interfaces.ts
+++ b/packages/react-native-audio-api/src/interfaces.ts
@@ -110,6 +110,9 @@ export interface IBaseAudioContext {
 }
 
 export interface IAudioContext extends IBaseAudioContext {
+  createMediaElementSource: (
+    mediaElement: IAudioFileSourceNode
+  ) => IMediaElementAudioSourceNode;
   close(): Promise<void>;
   resume(): Promise<boolean>;
   suspend(): Promise<boolean>;
@@ -244,6 +247,8 @@ export interface IAudioFileSourceNode extends IAudioScheduledSourceNode {
   onPositionChanged: string;
 }
 
+export interface IMediaElementAudioSourceNode extends IAudioNode {}
+
 export interface IConvolverNode extends IAudioNode {
   readonly buffer: IAudioBuffer | null;
   normalize: boolean;
diff --git a/packages/react-native-audio-api/src/mock/index.ts b/packages/react-native-audio-api/src/mock/index.ts
index 59c9f2087..7fedef3f6 100644
--- a/packages/react-native-audio-api/src/mock/index.ts
+++ b/packages/react-native-audio-api/src/mock/index.ts
@@ -469,6 +469,19 @@ class StreamerNodeMock extends AudioScheduledSourceNodeMock {
   resume(): void {}
 }
 
+class MediaElementAudioSourceNodeMock extends AudioNodeMock {
+  readonly mediaElement: HTMLMediaElement | AudioNodeMock;
+
+  constructor(
+    context: BaseAudioContextMock,
+    mediaElement: HTMLMediaElement | AudioNodeMock
+  ) {
+    super(context, {});
+    this.mediaElement = mediaElement;
+    this.numberOfInputs = 0;
+  }
+}
+
 class WorkletNodeMock extends AudioNodeMock {
   constructor(
     context: BaseAudioContextMock,
@@ -684,6 +697,12 @@ class AudioContextMock extends BaseAudioContextMock {
     this._state = 'suspended';
     return Promise.resolve();
   }
+
+  createMediaElementSource(
+    mediaElement: HTMLMediaElement | AudioNodeMock
+  ): MediaElementAudioSourceNodeMock {
+    return new MediaElementAudioSourceNodeMock(this, mediaElement);
+  }
 }
 
 class OfflineAudioContextMock extends BaseAudioContextMock {
@@ -1016,6 +1035,7 @@ export const ConstantSourceNode = ConstantSourceNodeMock;
 export const ConvolverNode = ConvolverNodeMock;
 export const DelayNode = DelayNodeMock;
 export const GainNode = GainNodeMock;
+export const MediaElementAudioSourceNode = MediaElementAudioSourceNodeMock;
 export const OfflineAudioContext = OfflineAudioContextMock;
 export const OscillatorNode = OscillatorNodeMock;
 export const RecorderAdapterNode = RecorderAdapterNodeMock;
@@ -1068,6 +1088,7 @@ export type ConstantSourceNode = ConstantSourceNodeMock;
 export type ConvolverNode = ConvolverNodeMock;
 export type DelayNode = DelayNodeMock;
 export type GainNode = GainNodeMock;
+export type MediaElementAudioSourceNode = MediaElementAudioSourceNodeMock;
 export type OfflineAudioContext = OfflineAudioContextMock;
 export type OscillatorNode = OscillatorNodeMock;
 export type RecorderAdapterNode = RecorderAdapterNodeMock;
@@ -1130,6 +1151,7 @@ export default {
   ConvolverNode: ConvolverNodeMock,
   DelayNode: DelayNodeMock,
   GainNode: GainNodeMock,
+  MediaElementAudioSourceNode: MediaElementAudioSourceNodeMock,
   OfflineAudioContext: OfflineAudioContextMock,
   OscillatorNode: OscillatorNodeMock,
   RecorderAdapterNode: RecorderAdapterNodeMock,
diff --git a/packages/react-native-audio-api/src/web-core/AudioContext.tsx b/packages/react-native-audio-api/src/web-core/AudioContext.tsx
index 9a9f01dc5..a6fae7a9c 100644
--- a/packages/react-native-audio-api/src/web-core/AudioContext.tsx
+++ b/packages/react-native-audio-api/src/web-core/AudioContext.tsx
@@ -10,6 +10,7 @@ import ConvolverNode from './ConvolverNode';
 import DelayNode from './DelayNode';
 import GainNode from './GainNode';
 import IIRFilterNode from './IIRFilterNode';
+import MediaElementAudioSourceNode from './MediaElementAudioSourceNode';
 import OscillatorNode from './OscillatorNode';
 import PeriodicWave from './PeriodicWave';
 import StereoPannerNode from './StereoPannerNode';
@@ -83,6 +84,16 @@ export default class AudioContext implements BaseAudioContext {
     return new AudioBufferSourceNode(this, { pitchCorrection });
   }
 
+  createMediaElementSource(
+    mediaElement: HTMLMediaElement
+  ): MediaElementAudioSourceNode {
+    return new MediaElementAudioSourceNode(
+      this,
+      this.context.createMediaElementSource(mediaElement),
+      mediaElement
+    );
+  }
+
   createBuffer(
     numberOfChannels: number,
     length: number,
diff --git a/packages/react-native-audio-api/src/web-core/MediaElementAudioSourceNode.tsx b/packages/react-native-audio-api/src/web-core/MediaElementAudioSourceNode.tsx
new file mode 100644
index 000000000..d1dc8b23c
--- /dev/null
+++ b/packages/react-native-audio-api/src/web-core/MediaElementAudioSourceNode.tsx
@@ -0,0 +1,19 @@
+import AudioNode from './AudioNode';
+import type BaseAudioContext from './BaseAudioContext';
+
+export interface MediaElementAudioSourceOptions {
+  mediaElement: HTMLMediaElement;
+}
+
+export default class MediaElementAudioSourceNode extends AudioNode {
+  readonly mediaElement: HTMLMediaElement;
+
+  constructor(
+    context: BaseAudioContext,
+    node: globalThis.MediaElementAudioSourceNode,
+    mediaElement: HTMLMediaElement
+  ) {
+    super(context, node);
+    this.mediaElement = mediaElement;
+  }
+}