@clarionhq/recorder 0.0.1 → 0.1.0

package/nitrogen/generated/ios/swift/HybridClarionRecorderSpec_cxx.swift

@@ -0,0 +1,354 @@
+///
+/// HybridClarionRecorderSpec_cxx.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * A class implementation that bridges HybridClarionRecorderSpec over to C++.
+ * In C++, we cannot use Swift protocols - so we need to wrap it in a class to make it strongly defined.
+ *
+ * Also, some Swift types need to be bridged with special handling:
+ * - Enums need to be wrapped in Structs, otherwise they cannot be accessed bi-directionally (Swift bug: https://github.com/swiftlang/swift/issues/75330)
+ * - Other HybridObjects need to be wrapped/unwrapped from the Swift TCxx wrapper
+ * - Throwing methods need to be wrapped with a Result<T, Error> type, as exceptions cannot be propagated to C++
+ */
+open class HybridClarionRecorderSpec_cxx {
+  /**
+   * The Swift <> C++ bridge's namespace (`margelo::nitro::clarion::recorder::bridge::swift`)
+   * from `ClarionRecorder-Swift-Cxx-Bridge.hpp`.
+   * This contains specialized C++ templates, and C++ helper functions that can be accessed from Swift.
+   */
+  public typealias bridge = margelo.nitro.clarion.recorder.bridge.swift
+
+  /**
+   * Holds an instance of the `HybridClarionRecorderSpec` Swift protocol.
+   */
+  private var __implementation: any HybridClarionRecorderSpec
+
+  /**
+   * Holds a weak pointer to the C++ class that wraps the Swift class.
+   */
+  private var __cxxPart: bridge.std__weak_ptr_HybridClarionRecorderSpec_
+
+  /**
+   * Create a new `HybridClarionRecorderSpec_cxx` that wraps the given `HybridClarionRecorderSpec`.
+   * All properties and methods bridge to C++ types.
+   */
+  public init(_ implementation: any HybridClarionRecorderSpec) {
+    self.__implementation = implementation
+    self.__cxxPart = .init()
+    /* no base class */
+  }
+
+  /**
+   * Get the actual `HybridClarionRecorderSpec` instance this class wraps.
+   */
+  @inline(__always)
+  public func getHybridClarionRecorderSpec() -> any HybridClarionRecorderSpec {
+    return __implementation
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `HybridClarionRecorderSpec_cxx`.
+   * The pointer has to be a retained opaque `Unmanaged<HybridClarionRecorderSpec_cxx>`.
+   * This removes one strong reference from the object!
+   */
+  public class func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> HybridClarionRecorderSpec_cxx {
+    return Unmanaged<HybridClarionRecorderSpec_cxx>.fromOpaque(pointer).takeRetainedValue()
+  }
+
+  /**
+   * Gets (or creates) the C++ part of this Hybrid Object.
+   * The C++ part is a `std::shared_ptr<HybridClarionRecorderSpec>`.
+   */
+  public func getCxxPart() -> bridge.std__shared_ptr_HybridClarionRecorderSpec_ {
+    let cachedCxxPart = self.__cxxPart.lock()
+    if Bool(fromCxx: cachedCxxPart) {
+      return cachedCxxPart
+    } else {
+      let newCxxPart = bridge.create_std__shared_ptr_HybridClarionRecorderSpec_(self.toUnsafe())
+      __cxxPart = bridge.weakify_std__shared_ptr_HybridClarionRecorderSpec_(newCxxPart)
+      return newCxxPart
+    }
+  }
+
+  
+
+  /**
+   * Get the memory size of the Swift class (plus size of any other allocations)
+   * so the JS VM can properly track it and garbage-collect the JS object if needed.
+   */
+  @inline(__always)
+  public var memorySize: Int {
+    return MemoryHelper.getSizeOf(self.__implementation) + self.__implementation.memorySize
+  }
+
+  /**
+   * Compares this object with the given [other] object for reference equality.
+   */
+  @inline(__always)
+  public func equals(other: HybridClarionRecorderSpec_cxx) -> Bool {
+    return self.__implementation === other.__implementation
+  }
+
+  /**
+   * Call dispose() on the Swift class.
+   * This _may_ be called manually from JS.
+   */
+  @inline(__always)
+  public func dispose() {
+    self.__implementation.dispose()
+  }
+
+  /**
+   * Call toString() on the Swift class.
+   */
+  @inline(__always)
+  public func toString() -> String {
+    return self.__implementation.toString()
+  }
+
+  // Properties
+  public final var state: std.string {
+    @inline(__always)
+    get {
+      return std.string(self.__implementation.state)
+    }
+  }
+
+  // Methods
+  @inline(__always)
+  public final func prepare(config: NativeRecorderConfig) -> bridge.Result_std__shared_ptr_Promise_void___ {
+    do {
+      let __result = try self.__implementation.prepare(config: config)
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_void__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_void__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_void__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve() })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func start() -> bridge.Result_std__shared_ptr_Promise_void___ {
+    do {
+      let __result = try self.__implementation.start()
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_void__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_void__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_void__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve() })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func pause() -> bridge.Result_std__shared_ptr_Promise_void___ {
+    do {
+      let __result = try self.__implementation.pause()
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_void__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_void__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_void__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve() })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func resume() -> bridge.Result_std__shared_ptr_Promise_void___ {
+    do {
+      let __result = try self.__implementation.resume()
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_void__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_void__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_void__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve() })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func stop() -> bridge.Result_std__shared_ptr_Promise_NativeRecorderResult___ {
+    do {
+      let __result = try self.__implementation.stop()
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_NativeRecorderResult__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_NativeRecorderResult__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_NativeRecorderResult__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve(__result) })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_NativeRecorderResult___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_NativeRecorderResult___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func discard() -> bridge.Result_std__shared_ptr_Promise_void___ {
+    do {
+      let __result = try self.__implementation.discard()
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_void__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_void__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_void__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve() })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func release() -> bridge.Result_std__shared_ptr_Promise_void___ {
+    do {
+      let __result = try self.__implementation.release()
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_void__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_void__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_void__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve() })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_void___(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func addStateListener(listener: bridge.Func_void_std__string) -> bridge.Result_double_ {
+    do {
+      let __result = try self.__implementation.addStateListener(listener: { () -> (String) -> Void in
+        let __wrappedFunction = bridge.wrap_Func_void_std__string(listener)
+        return { (__state: String) -> Void in
+          __wrappedFunction.call(std.string(__state))
+        }
+      }())
+      let __resultCpp = __result
+      return bridge.create_Result_double_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_double_(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func addAudioLevelListener(listener: bridge.Func_void_double_double) -> bridge.Result_double_ {
+    do {
+      let __result = try self.__implementation.addAudioLevelListener(listener: { () -> (Double, Double) -> Void in
+        let __wrappedFunction = bridge.wrap_Func_void_double_double(listener)
+        return { (__rms: Double, __peak: Double) -> Void in
+          __wrappedFunction.call(__rms, __peak)
+        }
+      }())
+      let __resultCpp = __result
+      return bridge.create_Result_double_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_double_(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func addChunkListener(listener: bridge.Func_void_std__string_double_double_double) -> bridge.Result_double_ {
+    do {
+      let __result = try self.__implementation.addChunkListener(listener: { () -> (String, Double, Double, Double) -> Void in
+        let __wrappedFunction = bridge.wrap_Func_void_std__string_double_double_double(listener)
+        return { (__uri: String, __startMs: Double, __endMs: Double, __sizeBytes: Double) -> Void in
+          __wrappedFunction.call(std.string(__uri), __startMs, __endMs, __sizeBytes)
+        }
+      }())
+      let __resultCpp = __result
+      return bridge.create_Result_double_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_double_(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func addErrorListener(listener: bridge.Func_void_NativeRecorderError) -> bridge.Result_double_ {
+    do {
+      let __result = try self.__implementation.addErrorListener(listener: { () -> (NativeRecorderError) -> Void in
+        let __wrappedFunction = bridge.wrap_Func_void_NativeRecorderError(listener)
+        return { (__error: NativeRecorderError) -> Void in
+          __wrappedFunction.call(__error)
+        }
+      }())
+      let __resultCpp = __result
+      return bridge.create_Result_double_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_double_(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func removeListener(id: Double) -> bridge.Result_void_ {
+    do {
+      try self.__implementation.removeListener(id: id)
+      return bridge.create_Result_void_()
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_void_(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func removeAllListeners() -> bridge.Result_void_ {
+    do {
+      try self.__implementation.removeAllListeners()
+      return bridge.create_Result_void_()
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_void_(__exceptionPtr)
+    }
+  }
+}

package/nitrogen/generated/ios/swift/NativeRecorderConfig.swift

@@ -0,0 +1,108 @@
+///
+/// NativeRecorderConfig.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * Represents an instance of `NativeRecorderConfig`, backed by a C++ struct.
+ */
+public typealias NativeRecorderConfig = margelo.nitro.clarion.recorder.NativeRecorderConfig
+
+public extension NativeRecorderConfig {
+  private typealias bridge = margelo.nitro.clarion.recorder.bridge.swift
+
+  /**
+   * Create a new instance of `NativeRecorderConfig`.
+   */
+  init(sampleRate: Double, channels: Double, bitDepth: Double, outputDirectory: String?, filenamePrefix: String?, rotateAfterMs: Double?, emitAudioLevel: Bool, audioLevelIntervalMs: Double, aacBitrate: Double) {
+    self.init(sampleRate, channels, bitDepth, { () -> bridge.std__optional_std__string_ in
+      if let __unwrappedValue = outputDirectory {
+        return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+      } else {
+        return .init()
+      }
+    }(), { () -> bridge.std__optional_std__string_ in
+      if let __unwrappedValue = filenamePrefix {
+        return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+      } else {
+        return .init()
+      }
+    }(), { () -> bridge.std__optional_double_ in
+      if let __unwrappedValue = rotateAfterMs {
+        return bridge.create_std__optional_double_(__unwrappedValue)
+      } else {
+        return .init()
+      }
+    }(), emitAudioLevel, audioLevelIntervalMs, aacBitrate)
+  }
+
+  @inline(__always)
+  var sampleRate: Double {
+    return self.__sampleRate
+  }
+  
+  @inline(__always)
+  var channels: Double {
+    return self.__channels
+  }
+  
+  @inline(__always)
+  var bitDepth: Double {
+    return self.__bitDepth
+  }
+  
+  @inline(__always)
+  var outputDirectory: String? {
+    return { () -> String? in
+      if bridge.has_value_std__optional_std__string_(self.__outputDirectory) {
+        let __unwrapped = bridge.get_std__optional_std__string_(self.__outputDirectory)
+        return String(__unwrapped)
+      } else {
+        return nil
+      }
+    }()
+  }
+  
+  @inline(__always)
+  var filenamePrefix: String? {
+    return { () -> String? in
+      if bridge.has_value_std__optional_std__string_(self.__filenamePrefix) {
+        let __unwrapped = bridge.get_std__optional_std__string_(self.__filenamePrefix)
+        return String(__unwrapped)
+      } else {
+        return nil
+      }
+    }()
+  }
+  
+  @inline(__always)
+  var rotateAfterMs: Double? {
+    return { () -> Double? in
+      if bridge.has_value_std__optional_double_(self.__rotateAfterMs) {
+        let __unwrapped = bridge.get_std__optional_double_(self.__rotateAfterMs)
+        return __unwrapped
+      } else {
+        return nil
+      }
+    }()
+  }
+  
+  @inline(__always)
+  var emitAudioLevel: Bool {
+    return self.__emitAudioLevel
+  }
+  
+  @inline(__always)
+  var audioLevelIntervalMs: Double {
+    return self.__audioLevelIntervalMs
+  }
+  
+  @inline(__always)
+  var aacBitrate: Double {
+    return self.__aacBitrate
+  }
+}

package/nitrogen/generated/ios/swift/NativeRecorderError.swift

@@ -0,0 +1,39 @@
+///
+/// NativeRecorderError.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * Represents an instance of `NativeRecorderError`, backed by a C++ struct.
+ */
+public typealias NativeRecorderError = margelo.nitro.clarion.recorder.NativeRecorderError
+
+public extension NativeRecorderError {
+  private typealias bridge = margelo.nitro.clarion.recorder.bridge.swift
+
+  /**
+   * Create a new instance of `NativeRecorderError`.
+   */
+  init(code: String, message: String, recoverable: Bool) {
+    self.init(std.string(code), std.string(message), recoverable)
+  }
+
+  @inline(__always)
+  var code: String {
+    return String(self.__code)
+  }
+  
+  @inline(__always)
+  var message: String {
+    return String(self.__message)
+  }
+  
+  @inline(__always)
+  var recoverable: Bool {
+    return self.__recoverable
+  }
+}

package/nitrogen/generated/ios/swift/NativeRecorderResult.swift

@@ -0,0 +1,54 @@
+///
+/// NativeRecorderResult.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * Represents an instance of `NativeRecorderResult`, backed by a C++ struct.
+ */
+public typealias NativeRecorderResult = margelo.nitro.clarion.recorder.NativeRecorderResult
+
+public extension NativeRecorderResult {
+  private typealias bridge = margelo.nitro.clarion.recorder.bridge.swift
+
+  /**
+   * Create a new instance of `NativeRecorderResult`.
+   */
+  init(uri: String, durationMs: Double, sizeBytes: Double, sampleRate: Double, channels: Double, bitDepth: Double) {
+    self.init(std.string(uri), durationMs, sizeBytes, sampleRate, channels, bitDepth)
+  }
+
+  @inline(__always)
+  var uri: String {
+    return String(self.__uri)
+  }
+  
+  @inline(__always)
+  var durationMs: Double {
+    return self.__durationMs
+  }
+  
+  @inline(__always)
+  var sizeBytes: Double {
+    return self.__sizeBytes
+  }
+  
+  @inline(__always)
+  var sampleRate: Double {
+    return self.__sampleRate
+  }
+  
+  @inline(__always)
+  var channels: Double {
+    return self.__channels
+  }
+  
+  @inline(__always)
+  var bitDepth: Double {
+    return self.__bitDepth
+  }
+}

package/nitrogen/generated/shared/c++/HybridClarionRecorderSpec.cpp

@@ -0,0 +1,34 @@
+///
+/// HybridClarionRecorderSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#include "HybridClarionRecorderSpec.hpp"
+
+namespace margelo::nitro::clarion::recorder {
+
+  void HybridClarionRecorderSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridGetter("state", &HybridClarionRecorderSpec::getState);
+      prototype.registerHybridMethod("prepare", &HybridClarionRecorderSpec::prepare);
+      prototype.registerHybridMethod("start", &HybridClarionRecorderSpec::start);
+      prototype.registerHybridMethod("pause", &HybridClarionRecorderSpec::pause);
+      prototype.registerHybridMethod("resume", &HybridClarionRecorderSpec::resume);
+      prototype.registerHybridMethod("stop", &HybridClarionRecorderSpec::stop);
+      prototype.registerHybridMethod("discard", &HybridClarionRecorderSpec::discard);
+      prototype.registerHybridMethod("release", &HybridClarionRecorderSpec::release);
+      prototype.registerHybridMethod("addStateListener", &HybridClarionRecorderSpec::addStateListener);
+      prototype.registerHybridMethod("addAudioLevelListener", &HybridClarionRecorderSpec::addAudioLevelListener);
+      prototype.registerHybridMethod("addChunkListener", &HybridClarionRecorderSpec::addChunkListener);
+      prototype.registerHybridMethod("addErrorListener", &HybridClarionRecorderSpec::addErrorListener);
+      prototype.registerHybridMethod("removeListener", &HybridClarionRecorderSpec::removeListener);
+      prototype.registerHybridMethod("removeAllListeners", &HybridClarionRecorderSpec::removeAllListeners);
+    });
+  }
+
+} // namespace margelo::nitro::clarion::recorder

package/nitrogen/generated/shared/c++/HybridClarionRecorderSpec.hpp

@@ -0,0 +1,84 @@
+///
+/// HybridClarionRecorderSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/HybridObject.hpp>)
+#include <NitroModules/HybridObject.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+// Forward declaration of `NativeRecorderConfig` to properly resolve imports.
+namespace margelo::nitro::clarion::recorder { struct NativeRecorderConfig; }
+// Forward declaration of `NativeRecorderResult` to properly resolve imports.
+namespace margelo::nitro::clarion::recorder { struct NativeRecorderResult; }
+// Forward declaration of `NativeRecorderError` to properly resolve imports.
+namespace margelo::nitro::clarion::recorder { struct NativeRecorderError; }
+
+#include <string>
+#include <NitroModules/Promise.hpp>
+#include "NativeRecorderConfig.hpp"
+#include "NativeRecorderResult.hpp"
+#include <functional>
+#include "NativeRecorderError.hpp"
+
+namespace margelo::nitro::clarion::recorder {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `ClarionRecorder`
+   * Inherit this class to create instances of `HybridClarionRecorderSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridClarionRecorder: public HybridClarionRecorderSpec {
+   * public:
+   *   HybridClarionRecorder(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridClarionRecorderSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridClarionRecorderSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridClarionRecorderSpec() override = default;
+
+    public:
+      // Properties
+      virtual std::string getState() = 0;
+
+    public:
+      // Methods
+      virtual std::shared_ptr<Promise<void>> prepare(const NativeRecorderConfig& config) = 0;
+      virtual std::shared_ptr<Promise<void>> start() = 0;
+      virtual std::shared_ptr<Promise<void>> pause() = 0;
+      virtual std::shared_ptr<Promise<void>> resume() = 0;
+      virtual std::shared_ptr<Promise<NativeRecorderResult>> stop() = 0;
+      virtual std::shared_ptr<Promise<void>> discard() = 0;
+      virtual std::shared_ptr<Promise<void>> release() = 0;
+      virtual double addStateListener(const std::function<void(const std::string& /* state */)>& listener) = 0;
+      virtual double addAudioLevelListener(const std::function<void(double /* rms */, double /* peak */)>& listener) = 0;
+      virtual double addChunkListener(const std::function<void(const std::string& /* uri */, double /* startMs */, double /* endMs */, double /* sizeBytes */)>& listener) = 0;
+      virtual double addErrorListener(const std::function<void(const NativeRecorderError& /* error */)>& listener) = 0;
+      virtual void removeListener(double id) = 0;
+      virtual void removeAllListeners() = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "ClarionRecorder";
+  };
+
+} // namespace margelo::nitro::clarion::recorder