react-native-audio-api 0.7.0-nightly-4fc09d1-20250727 → 0.7.0-nightly-a914864-20250729

package/src/interfaces.ts

@@ -5,7 +5,6 @@ import {
   BiquadFilterType,
   ChannelCountMode,
   ChannelInterpretation,
-  ProcessorMode,
 } from './types';
 import { AudioEventName, AudioEventCallback } from './events/types';
 
@@ -15,8 +14,8 @@ export interface IBaseAudioContext {
   readonly sampleRate: number;
   readonly currentTime: number;
 
+  createRecorderAdapter(): IRecorderAdapterNode;
   createOscillator(): IOscillatorNode;
-  createCustomProcessor(identifier: string): ICustomProcessorNode;
   createGain(): IGainNode;
   createStereoPanner(): IStereoPannerNode;
   createBiquadFilter: () => IBiquadFilterNode;
@@ -65,11 +64,6 @@ export interface IAudioNode {
   disconnect: (destination?: IAudioNode | IAudioParam) => void;
 }
 
-export interface ICustomProcessorNode extends IAudioNode {
-  readonly customProcessor: IAudioParam;
-  processorMode: ProcessorMode;
-}
-
 export interface IGainNode extends IAudioNode {
   readonly gain: IAudioParam;
 }
@@ -195,9 +189,13 @@ export interface IAnalyserNode extends IAudioNode {
   getByteTimeDomainData: (array: Uint8Array) => void;
 }
 
+export interface IRecorderAdapterNode extends IAudioNode {}
+
 export interface IAudioRecorder {
   start: () => void;
   stop: () => void;
+  connect: (node: IRecorderAdapterNode) => void;
+  disconnect: () => void;
 
   // passing subscriptionId(uint_64 in cpp, string in js) to the cpp
   onAudioReady: string;

package/common/cpp/audioapi/HostObjects/CustomProcessorNodeHostObject.h

@@ -1,54 +0,0 @@
-#pragma once
-
-#include <audioapi/HostObjects/AudioNodeHostObject.h>
-#include <audioapi/HostObjects/AudioParamHostObject.h>
-#include <audioapi/core/effects/CustomProcessorNode.h>
-
-#include <memory>
-#include <string>
-#include <vector>
-
-namespace audioapi {
-using namespace facebook;
-
-class CustomProcessorNodeHostObject : public AudioNodeHostObject {
- public:
-  explicit CustomProcessorNodeHostObject(const std::shared_ptr<CustomProcessorNode> &node)
-      : AudioNodeHostObject(node) {
-    addGetters(
-        JSI_EXPORT_PROPERTY_GETTER(CustomProcessorNodeHostObject, customProcessor),
-        JSI_EXPORT_PROPERTY_GETTER(CustomProcessorNodeHostObject, processorMode));
-
-    addSetters(
-        JSI_EXPORT_PROPERTY_SETTER(CustomProcessorNodeHostObject, processorMode));
-  }
-
-  JSI_PROPERTY_GETTER(customProcessor) {
-    auto customProcessorNode = std::static_pointer_cast<CustomProcessorNode>(node_);
-    auto customProcessorParam =
-        std::make_shared<AudioParamHostObject>(customProcessorNode->getCustomProcessorParam());
-    return jsi::Object::createFromHostObject(runtime, customProcessorParam);
-  }
-
-  JSI_PROPERTY_GETTER(processorMode) {
-    auto customProcessorNode = std::static_pointer_cast<CustomProcessorNode>(node_);
-    auto mode = customProcessorNode->getProcessorMode();
-    std::string modeStr = (mode == CustomProcessorNode::ProcessorMode::ProcessThrough)
-                            ? "processThrough"
-                            : "processInPlace";
-    return jsi::String::createFromUtf8(runtime, modeStr);
-  }
-
-  JSI_PROPERTY_SETTER(processorMode) {
-    auto customProcessorNode = std::static_pointer_cast<CustomProcessorNode>(node_);
-    std::string modeStr = value.getString(runtime).utf8(runtime);
-
-    if (modeStr == "processThrough") {
-      customProcessorNode->setProcessorMode(CustomProcessorNode::ProcessorMode::ProcessThrough);
-    } else {
-      customProcessorNode->setProcessorMode(CustomProcessorNode::ProcessorMode::ProcessInPlace);
-    }
-  }
-};
-
-} // namespace audioapi

package/common/cpp/audioapi/core/effects/CustomProcessorNode.cpp

@@ -1,173 +0,0 @@
-#include <audioapi/core/BaseAudioContext.h>
-#include <audioapi/core/effects/CustomProcessorNode.h>
-#include <audioapi/utils/AudioArray.h>
-#include <audioapi/utils/AudioBus.h>
-
-#include <algorithm>
-#include <cstring>
-#include <iostream>
-
-namespace audioapi {
-
-// Static registries and active node tracking
-std::map<std::string, std::function<std::shared_ptr<CustomAudioProcessor>()>>
-    CustomProcessorNode::s_processorFactoriesByIdentifier;
-std::unordered_map<std::string, CustomProcessorNode::GenericControlHandler>
-    CustomProcessorNode::s_controlHandlersByIdentifier;
-std::unordered_map<std::string, std::vector<CustomProcessorNode *>>
-    CustomProcessorNode::s_activeNodes;
-
-// Constructor: initializes processor, tracking, and preallocated buffers
-CustomProcessorNode::CustomProcessorNode(
-    BaseAudioContext *context,
-    const std::string &identifier)
-    : AudioNode(context), processorMode_(ProcessorMode::ProcessInPlace) {
-  customProcessorParam_ = std::make_shared<AudioParam>(
-      1.0f, MOST_NEGATIVE_SINGLE_FLOAT, MOST_POSITIVE_SINGLE_FLOAT, context);
-  isInitialized_ = true;
-
-  auto it = s_processorFactoriesByIdentifier.find(identifier);
-  processor_ =
-      (it != s_processorFactoriesByIdentifier.end()) ? it->second() : nullptr;
-
-  s_activeNodes[identifier].push_back(this);
-}
-
-// Destructor: cleans up tracking for this instance
-CustomProcessorNode::~CustomProcessorNode() {
-  for (auto &pair : s_activeNodes) {
-    auto &vec = pair.second;
-    vec.erase(std::remove(vec.begin(), vec.end(), this), vec.end());
-  }
-}
-
-// Gets the modifiable parameter
-std::shared_ptr<AudioParam> CustomProcessorNode::getCustomProcessorParam()
-    const {
-  return customProcessorParam_;
-}
-
-// Returns the current processing mode
-CustomProcessorNode::ProcessorMode CustomProcessorNode::getProcessorMode()
-    const {
-  return processorMode_;
-}
-
-// Updates the processing mode
-void CustomProcessorNode::setProcessorMode(ProcessorMode mode) {
-  processorMode_ = mode;
-}
-
-// Registers a factory for dynamic processor instantiation
-void CustomProcessorNode::registerProcessorFactory(
-    const std::string &identifier,
-    std::function<std::shared_ptr<CustomAudioProcessor>()> factory) {
-  s_processorFactoriesByIdentifier[identifier] = std::move(factory);
-  notifyProcessorChanged(identifier);
-}
-
-// Removes a processor factory from registry
-void CustomProcessorNode::unregisterProcessorFactory(
-    const std::string &identifier) {
-  s_processorFactoriesByIdentifier.erase(identifier);
-  notifyProcessorChanged(identifier);
-}
-
-// Updates processor instances for all nodes using given identifier
-void CustomProcessorNode::notifyProcessorChanged(
-    const std::string &identifier) {
-  auto it = s_activeNodes.find(identifier);
-  if (it != s_activeNodes.end()) {
-    for (CustomProcessorNode *node : it->second) {
-      auto f = s_processorFactoriesByIdentifier.find(identifier);
-      node->processor_ =
-          (f != s_processorFactoriesByIdentifier.end()) ? f->second() : nullptr;
-    }
-  }
-}
-
-// Registers control handler for runtime automation
-void CustomProcessorNode::registerControlHandler(
-    const std::string &identifier,
-    GenericControlHandler handler) {
-  s_controlHandlersByIdentifier[identifier] = std::move(handler);
-}
-
-// Removes a control handler
-void CustomProcessorNode::unregisterControlHandler(
-    const std::string &identifier) {
-  s_controlHandlersByIdentifier.erase(identifier);
-}
-
-// Core processing method routed by selected mode
-void CustomProcessorNode::processNode(
-    const std::shared_ptr<AudioBus> &processingBus,
-    int framesToProcess) {
-  if (!processor_)
-    return;
-
-  int numChannels = processingBus->getNumberOfChannels();
-  if (preallocatedOutputBuffers_.size() != static_cast<size_t>(numChannels)) {
-    preallocatedOutputBuffers_.resize(numChannels);
-  }
-
-  for (int ch = 0; ch < numChannels; ++ch) {
-    if (preallocatedOutputBuffers_[ch].size() !=
-        static_cast<size_t>(framesToProcess)) {
-      preallocatedOutputBuffers_[ch].resize(framesToProcess);
-    }
-  }
-
-  switch (processorMode_) {
-    case ProcessorMode::ProcessThrough:
-      processThrough(processingBus, framesToProcess);
-      break;
-    case ProcessorMode::ProcessInPlace:
-    default:
-      processInPlace(processingBus, framesToProcess);
-      break;
-  }
-}
-
-// Executes in-place processing on the shared audio buffer
-void CustomProcessorNode::processInPlace(
-    const std::shared_ptr<AudioBus> &bus,
-    int frames) {
-  if (!processor_)
-    return;
-
-  int numChannels = bus->getNumberOfChannels();
-  std::vector<float *> channelData(numChannels);
-  for (int ch = 0; ch < numChannels; ++ch) {
-    channelData[ch] = bus->getChannel(ch)->getData();
-  }
-
-  processor_->processInPlace(channelData.data(), numChannels, frames);
-}
-
-// Executes processing using separate input and output buffers with
-// preallocation
-void CustomProcessorNode::processThrough(
-    const std::shared_ptr<AudioBus> &bus,
-    int frames) {
-  if (!processor_)
-    return;
-
-  int numChannels = bus->getNumberOfChannels();
-  std::vector<float *> input(numChannels);
-  std::vector<float *> output(numChannels);
-
-  for (int ch = 0; ch < numChannels; ++ch) {
-    input[ch] = bus->getChannel(ch)->getData();
-    output[ch] = preallocatedOutputBuffers_[ch].data();
-  }
-
-  processor_->processThrough(input.data(), output.data(), numChannels, frames);
-
-  for (int ch = 0; ch < numChannels; ++ch) {
-    std::memcpy(
-        bus->getChannel(ch)->getData(), output[ch], sizeof(float) * frames);
-  }
-}
-
-} // namespace audioapi

package/common/cpp/audioapi/core/effects/CustomProcessorNode.h

@@ -1,186 +0,0 @@
-#pragma once
-
-#include <audioapi/core/AudioNode.h>
-#include <audioapi/core/AudioParam.h>
-#include <memory>
-#include <string>
-#include <cstring>
-#include <functional>
-#include <map>
-#include <unordered_map>
-#include <vector>
-#include <any>
-#include <utility>
-
-namespace audioapi {
-
-class AudioBus;
-
-/**
- * @brief Interface for defining custom audio processors that can be attached to nodes.
- */
-class CustomAudioProcessor {
- public:
-  virtual ~CustomAudioProcessor() = default;
-
-  /**
-   * @brief Processes audio data in-place.
-   * @param channelData Array of float pointers for each channel.
-   * @param numChannels Number of audio channels.
-   * @param numFrames Number of frames per channel.
-   */
-  virtual void processInPlace(float** channelData, int numChannels, int numFrames) {
-    // Default: do nothing
-  }
-
-  /**
-   * @brief Processes audio data from input to output buffers.
-   * Default behavior copies input to output and then calls in-place processing.
-   * @param input Input audio buffers.
-   * @param output Output audio buffers.
-   * @param numChannels Number of channels.
-   * @param numFrames Number of frames per channel.
-   */
-  virtual void processThrough(float** input, float** output, int numChannels, int numFrames) {
-    for (int ch = 0; ch < numChannels; ++ch) {
-      std::memcpy(output[ch], input[ch], sizeof(float) * numFrames);
-    }
-    processInPlace(output, numChannels, numFrames);
-  }
-};
-
-/**
- * @brief Audio node that wraps a user-defined processor for custom audio processing.
- */
-class CustomProcessorNode : public AudioNode {
- public:
-  /**
-   * @brief Enumerates supported audio processing modes.
-   */
-  enum class ProcessorMode {
-    ProcessInPlace,
-    ProcessThrough
-  };
-
-  /**
-   * @brief Constructs a new CustomProcessorNode attached to a given context with a processor identifier.
-   * @param context Audio context this node belongs to.
-   * @param identifier The identifier of the processor to instantiate and bind.
-   */
-  CustomProcessorNode(BaseAudioContext* context, const std::string& identifier);
-
-  /**
-   * @brief Destroys the node and removes it from active tracking.
-   */
-  ~CustomProcessorNode();
-
-  /**
-   * @brief Gets the custom AudioParam associated with this node.
-   * @return Shared pointer to an AudioParam.
-   */
-  std::shared_ptr<AudioParam> getCustomProcessorParam() const;
-
-  /**
-   * @brief Gets the processor mode.
-   * @return The current processing mode as an enum.
-   */
-  ProcessorMode getProcessorMode() const;
-
-  /**
-   * @brief Sets the processor mode.
-   * @param processorMode Processing mode to apply.
-   */
-  void setProcessorMode(ProcessorMode processorMode);
-
-  /**
-   * @brief Registers a factory for creating processors for a given identifier.
-   * @param identifier Unique string key.
-   * @param factory Function that returns a shared CustomAudioProcessor.
-   */
-  static void registerProcessorFactory(
-      const std::string& identifier,
-      std::function<std::shared_ptr<CustomAudioProcessor>()> factory);
-
-  /**
-   * @brief Unregisters a processor factory.
-   * @param identifier Key to remove.
-   */
-  static void unregisterProcessorFactory(const std::string& identifier);
-
-  /**
-   * @brief Alias for control callbacks accepting arbitrary parameters.
-   */
-  using GenericControlHandler = std::function<void(const std::vector<std::any>&)>;
-
-  /**
-   * @brief Registers a control handler for automation (e.g., gain or filter changes).
-   * @param identifier Control name key.
-   * @param handler Function to handle dynamic updates.
-   */
-  static void registerControlHandler(const std::string& identifier, GenericControlHandler handler);
-
-  /**
-   * @brief Unregisters a control handler by identifier.
-   * @param identifier The key to remove.
-   */
-  static void unregisterControlHandler(const std::string& identifier);
-
-  /**
-   * @brief Invokes a control handler using variadic arguments.
-   * @tparam Args Parameter types.
-   * @param identifier Key associated with the control handler.
-   * @param args Arguments passed to the handler.
-   */
-  template <typename... Args>
-  static void applyControlToNode(const std::string& identifier, Args&&... args) {
-    auto it = s_controlHandlersByIdentifier.find(identifier);
-    if (it != s_controlHandlersByIdentifier.end()) {
-      std::vector<std::any> paramList = { std::forward<Args>(args)... };
-      it->second(paramList);
-    }
-  }
-
- protected:
-  /**
-   * @brief Core audio processing callback invoked each render cycle.
-   * @param processingBus The audio bus containing buffers.
-   * @param framesToProcess Number of frames to process.
-   */
-  void processNode(const std::shared_ptr<AudioBus>& processingBus, int framesToProcess) override;
-
- private:
-  /**
-   * @brief In-place audio processing.
-   * @param bus The shared audio bus buffer.
-   * @param frames Number of frames to process.
-   */
-  void processInPlace(const std::shared_ptr<AudioBus>& bus, int frames);
-
-  /**
-   * @brief Processes audio using separate input and output buffers.
-   * @param bus Audio bus used for both input and output access.
-   * @param frames Number of frames to process.
-   */
-  void processThrough(const std::shared_ptr<AudioBus>& bus, int frames);
-
-  /**
-   * @brief Ensures that preallocated output buffers match the required frame and channel dimensions.
-   * This avoids real-time heap allocations.
-   */
-  void ensurePreallocatedBuffers(int numChannels, int numFrames);
-
-  std::shared_ptr<AudioParam> customProcessorParam_; ///< Optional real-time modifiable parameter.
-  ProcessorMode processorMode_ = ProcessorMode::ProcessInPlace; ///< Determines processing style.
-  std::shared_ptr<CustomAudioProcessor> processor_; ///< Processor instance.
-
-  std::vector<std::vector<float>> preallocatedOutputBuffers_; ///< Storage for preallocated channel data.
-  std::vector<float*> preallocatedOutputPointers_; ///< Pointers to preallocatedOutputBuffers_ for processor API.
-
-  static void notifyProcessorChanged(const std::string& identifier); ///< Notify and update all nodes with given identifier.
-
-  static std::map<std::string, std::function<std::shared_ptr<CustomAudioProcessor>()>> s_processorFactoriesByIdentifier; ///< Global registry of processor factories.
-  static std::unordered_map<std::string, GenericControlHandler> s_controlHandlersByIdentifier; ///< Global registry of control handlers.
-  static std::unordered_map<std::string, std::vector<CustomProcessorNode*>> s_activeNodes; ///< Tracks active node instances by identifier.
-};
-
-} // namespace audioapi

package/lib/commonjs/core/CustomProcessorNode.js

@@ -1,23 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-var _AudioNode = _interopRequireDefault(require("./AudioNode"));
-var _AudioParam = _interopRequireDefault(require("./AudioParam"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-class CustomProcessorNode extends _AudioNode.default {
-  constructor(context, customProcessor) {
-    super(context, customProcessor);
-    this.customProcessor = new _AudioParam.default(customProcessor.customProcessor, context);
-  }
-  get processorMode() {
-    return this.node.processorMode;
-  }
-  set processorMode(value) {
-    this.node.processorMode = value;
-  }
-}
-exports.default = CustomProcessorNode;
-//# sourceMappingURL=CustomProcessorNode.js.map

package/lib/commonjs/core/CustomProcessorNode.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_AudioNode","_interopRequireDefault","require","_AudioParam","e","__esModule","default","CustomProcessorNode","AudioNode","constructor","context","customProcessor","AudioParam","processorMode","node","value","exports"],"sourceRoot":"../../../src","sources":["core/CustomProcessorNode.ts"],"mappings":";;;;;;AAEA,IAAAA,UAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,WAAA,GAAAF,sBAAA,CAAAC,OAAA;AAAsC,SAAAD,uBAAAG,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAGvB,MAAMG,mBAAmB,SAASC,kBAAS,CAAC;EAGzDC,WAAWA,CACTC,OAAyB,EACzBC,eAAqC,EACrC;IACA,KAAK,CAACD,OAAO,EAAEC,eAAe,CAAC;IAC/B,IAAI,CAACA,eAAe,GAAG,IAAIC,mBAAU,CACnCD,eAAe,CAACA,eAAe,EAC/BD,OACF,CAAC;EACH;EAEA,IAAWG,aAAaA,CAAA,EAAkB;IACxC,OAAQ,IAAI,CAACC,IAAI,CAA0BD,aAAa;EAC1D;EAEA,IAAWA,aAAaA,CAACE,KAAoB,EAAE;IAC5C,IAAI,CAACD,IAAI,CAA0BD,aAAa,GAAGE,KAAK;EAC3D;AACF;AAACC,OAAA,CAAAV,OAAA,GAAAC,mBAAA","ignoreList":[]}

package/lib/module/core/CustomProcessorNode.js

@@ -1,17 +0,0 @@
-"use strict";
-
-import AudioNode from "./AudioNode.js";
-import AudioParam from "./AudioParam.js";
-export default class CustomProcessorNode extends AudioNode {
-  constructor(context, customProcessor) {
-    super(context, customProcessor);
-    this.customProcessor = new AudioParam(customProcessor.customProcessor, context);
-  }
-  get processorMode() {
-    return this.node.processorMode;
-  }
-  set processorMode(value) {
-    this.node.processorMode = value;
-  }
-}
-//# sourceMappingURL=CustomProcessorNode.js.map

package/lib/module/core/CustomProcessorNode.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["AudioNode","AudioParam","CustomProcessorNode","constructor","context","customProcessor","processorMode","node","value"],"sourceRoot":"../../../src","sources":["core/CustomProcessorNode.ts"],"mappings":";;AAEA,OAAOA,SAAS,MAAM,gBAAa;AACnC,OAAOC,UAAU,MAAM,iBAAc;AAGrC,eAAe,MAAMC,mBAAmB,SAASF,SAAS,CAAC;EAGzDG,WAAWA,CACTC,OAAyB,EACzBC,eAAqC,EACrC;IACA,KAAK,CAACD,OAAO,EAAEC,eAAe,CAAC;IAC/B,IAAI,CAACA,eAAe,GAAG,IAAIJ,UAAU,CACnCI,eAAe,CAACA,eAAe,EAC/BD,OACF,CAAC;EACH;EAEA,IAAWE,aAAaA,CAAA,EAAkB;IACxC,OAAQ,IAAI,CAACC,IAAI,CAA0BD,aAAa;EAC1D;EAEA,IAAWA,aAAaA,CAACE,KAAoB,EAAE;IAC5C,IAAI,CAACD,IAAI,CAA0BD,aAAa,GAAGE,KAAK;EAC3D;AACF","ignoreList":[]}

package/lib/typescript/core/CustomProcessorNode.d.ts

@@ -1,12 +0,0 @@
-import { ICustomProcessorNode } from '../interfaces';
-import { ProcessorMode } from '../types';
-import AudioNode from './AudioNode';
-import AudioParam from './AudioParam';
-import BaseAudioContext from './BaseAudioContext';
-export default class CustomProcessorNode extends AudioNode {
-    readonly customProcessor: AudioParam;
-    constructor(context: BaseAudioContext, customProcessor: ICustomProcessorNode);
-    get processorMode(): ProcessorMode;
-    set processorMode(value: ProcessorMode);
-}
-//# sourceMappingURL=CustomProcessorNode.d.ts.map

package/lib/typescript/core/CustomProcessorNode.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CustomProcessorNode.d.ts","sourceRoot":"","sources":["../../../src/core/CustomProcessorNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,SAAS,MAAM,aAAa,CAAC;AACpC,OAAO,UAAU,MAAM,cAAc,CAAC;AACtC,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,SAAS;IACxD,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC;gBAGnC,OAAO,EAAE,gBAAgB,EACzB,eAAe,EAAE,oBAAoB;IASvC,IAAW,aAAa,IAAI,aAAa,CAExC;IAED,IAAW,aAAa,CAAC,KAAK,EAAE,aAAa,EAE5C;CACF"}

package/src/core/CustomProcessorNode.ts

@@ -1,28 +0,0 @@
-import { ICustomProcessorNode } from '../interfaces';
-import { ProcessorMode } from '../types';
-import AudioNode from './AudioNode';
-import AudioParam from './AudioParam';
-import BaseAudioContext from './BaseAudioContext';
-
-export default class CustomProcessorNode extends AudioNode {
-  readonly customProcessor: AudioParam;
-
-  constructor(
-    context: BaseAudioContext,
-    customProcessor: ICustomProcessorNode
-  ) {
-    super(context, customProcessor);
-    this.customProcessor = new AudioParam(
-      customProcessor.customProcessor,
-      context
-    );
-  }
-
-  public get processorMode(): ProcessorMode {
-    return (this.node as ICustomProcessorNode).processorMode;
-  }
-
-  public set processorMode(value: ProcessorMode) {
-    (this.node as ICustomProcessorNode).processorMode = value;
-  }
-}