react-native-nitro-buffer 0.0.1

package/lib/index.js

@@ -0,0 +1,34 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlowBuffer = exports.constants = exports.kStringMaxLength = exports.kMaxLength = exports.INSPECT_MAX_BYTES = exports.Buffer = void 0;
+var Buffer_1 = require("./Buffer");
+Object.defineProperty(exports, "Buffer", { enumerable: true, get: function () { return Buffer_1.Buffer; } });
+__exportStar(require("./utils"), exports);
+exports.INSPECT_MAX_BYTES = 50;
+exports.kMaxLength = 2147483647;
+exports.kStringMaxLength = 536870888;
+exports.constants = {
+    MAX_LENGTH: exports.kMaxLength,
+    MAX_STRING_LENGTH: exports.kStringMaxLength
+};
+class SlowBuffer extends Uint8Array {
+    constructor(size) {
+        super(size);
+        Object.setPrototypeOf(this, require('./Buffer').Buffer.prototype);
+    }
+}
+exports.SlowBuffer = SlowBuffer;

package/lib/utils.d.ts

@@ -0,0 +1,7 @@
+import { Buffer } from './Buffer';
+export declare function atob(data: string): string;
+export declare function btoa(data: string): string;
+export declare function isAscii(input: Buffer | Uint8Array | ArrayBuffer): boolean;
+export declare function isUtf8(input: Buffer | Uint8Array | ArrayBuffer): boolean;
+export declare function transcode(source: Uint8Array, fromEnc: string, toEnc: string): Buffer;
+export declare function resolveObjectURL(id: string): string | undefined;

package/lib/utils.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.atob = atob;
+exports.btoa = btoa;
+exports.isAscii = isAscii;
+exports.isUtf8 = isUtf8;
+exports.transcode = transcode;
+exports.resolveObjectURL = resolveObjectURL;
+const Buffer_1 = require("./Buffer");
+function atob(data) {
+    return Buffer_1.Buffer.from(data, 'base64').toString('binary');
+}
+function btoa(data) {
+    return Buffer_1.Buffer.from(data, 'binary').toString('base64');
+}
+function isAscii(input) {
+    const arr = input instanceof Uint8Array ? input : new Uint8Array(input);
+    for (let i = 0; i < arr.length; i++) {
+        if (arr[i] > 127)
+            return false;
+    }
+    return true;
+}
+function isUtf8(input) {
+    const arr = input instanceof Uint8Array ? input : new Uint8Array(input);
+    try {
+        // Fast path: TextDecoder if available
+        if (typeof TextDecoder !== 'undefined') {
+            new TextDecoder('utf-8', { fatal: true }).decode(arr);
+            return true;
+        }
+    }
+    catch (e) {
+        return false;
+    }
+    // Fallback: JS implementation of UTF-8 validation
+    let i = 0;
+    const len = arr.length;
+    while (i < len) {
+        let descriptor = arr[i];
+        if (descriptor <= 127) {
+            i++;
+            continue;
+        }
+        else if ((descriptor & 0xE0) === 0xC0) {
+            // 2 bytes
+            if (i + 1 >= len || (arr[i + 1] & 0xC0) !== 0x80)
+                return false;
+            if ((descriptor & 0xFE) === 0xC0)
+                return false; // Overlong
+            i += 2;
+        }
+        else if ((descriptor & 0xF0) === 0xE0) {
+            // 3 bytes
+            if (i + 2 >= len || (arr[i + 1] & 0xC0) !== 0x80 || (arr[i + 2] & 0xC0) !== 0x80)
+                return false;
+            if (descriptor === 0xE0 && (arr[i + 1] < 0xA0))
+                return false; // Overlong
+            if (descriptor === 0xED && (arr[i + 1] >= 0xA0))
+                return false; // Surrogate
+            i += 3;
+        }
+        else if ((descriptor & 0xF8) === 0xF0) {
+            // 4 bytes
+            if (i + 3 >= len || (arr[i + 1] & 0xC0) !== 0x80 || (arr[i + 2] & 0xC0) !== 0x80 || (arr[i + 3] & 0xC0) !== 0x80)
+                return false;
+            if (descriptor === 0xF0 && (arr[i + 1] < 0x90))
+                return false; // Overlong
+            if (descriptor === 0xF4 && (arr[i + 1] >= 0x90))
+                return false; // Out of range
+            i += 4;
+        }
+        else {
+            return false;
+        }
+    }
+    return true;
+}
+function transcode(source, fromEnc, toEnc) {
+    if (!Buffer_1.Buffer.isEncoding(fromEnc) || !Buffer_1.Buffer.isEncoding(toEnc)) {
+        throw new TypeError('Invalid encoding');
+    }
+    const buf = source instanceof Buffer_1.Buffer ? source : Buffer_1.Buffer.from(source);
+    const str = buf.toString(fromEnc);
+    return Buffer_1.Buffer.from(str, toEnc);
+}
+function resolveObjectURL(id) {
+    // Not implemented in RN context usually, stub or return undefined
+    return undefined;
+}

package/nitrogen/generated/.gitattributes

@@ -0,0 +1 @@
+** linguist-generated=true

package/nitrogen/generated/android/NitroBuffer+autolinking.cmake

@@ -0,0 +1,81 @@
+#
+# NitroBuffer+autolinking.cmake
+# This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+# https://github.com/mrousavy/nitro
+# Copyright © 2025 Marc Rousavy @ Margelo
+#
+
+# This is a CMake file that adds all files generated by Nitrogen
+# to the current CMake project.
+#
+# To use it, add this to your CMakeLists.txt:
+# ```cmake
+# include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/NitroBuffer+autolinking.cmake)
+# ```
+
+# Define a flag to check if we are building properly
+add_definitions(-DBUILDING_NITROBUFFER_WITH_GENERATED_CMAKE_PROJECT)
+
+# Enable Raw Props parsing in react-native (for Nitro Views)
+add_definitions(-DRN_SERIALIZABLE_STATE)
+
+# Add all headers that were generated by Nitrogen
+include_directories(
+  "../nitrogen/generated/shared/c++"
+  "../nitrogen/generated/android/c++"
+  "../nitrogen/generated/android/"
+)
+
+# Add all .cpp sources that were generated by Nitrogen
+target_sources(
+  # CMake project name (Android C++ library name)
+  NitroBuffer PRIVATE
+  # Autolinking Setup
+  ../nitrogen/generated/android/NitroBufferOnLoad.cpp
+  # Shared Nitrogen C++ sources
+  ../nitrogen/generated/shared/c++/HybridNitroBufferSpec.cpp
+  # Android-specific Nitrogen C++ sources
+  
+)
+
+# From node_modules/react-native/ReactAndroid/cmake-utils/folly-flags.cmake
+# Used in node_modules/react-native/ReactAndroid/cmake-utils/ReactNative-application.cmake
+target_compile_definitions(
+  NitroBuffer PRIVATE
+  -DFOLLY_NO_CONFIG=1
+  -DFOLLY_HAVE_CLOCK_GETTIME=1
+  -DFOLLY_USE_LIBCPP=1
+  -DFOLLY_CFG_NO_COROUTINES=1
+  -DFOLLY_MOBILE=1
+  -DFOLLY_HAVE_RECVMMSG=1
+  -DFOLLY_HAVE_PTHREAD=1
+  # Once we target android-23 above, we can comment
+  # the following line. NDK uses GNU style stderror_r() after API 23.
+  -DFOLLY_HAVE_XSI_STRERROR_R=1
+)
+
+# Add all libraries required by the generated specs
+find_package(fbjni REQUIRED) # <-- Used for communication between Java <-> C++
+find_package(ReactAndroid REQUIRED) # <-- Used to set up React Native bindings (e.g. CallInvoker/TurboModule)
+find_package(react-native-nitro-modules REQUIRED) # <-- Used to create all HybridObjects and use the Nitro core library
+
+# Link all libraries together
+target_link_libraries(
+        NitroBuffer
+        fbjni::fbjni                              # <-- Facebook C++ JNI helpers
+        ReactAndroid::jsi                         # <-- RN: JSI
+        react-native-nitro-modules::NitroModules  # <-- NitroModules Core :)
+)
+
+# Link react-native (different prefab between RN 0.75 and RN 0.76)
+if(ReactAndroid_VERSION_MINOR GREATER_EQUAL 76)
+    target_link_libraries(
+        NitroBuffer
+        ReactAndroid::reactnative                 # <-- RN: Native Modules umbrella prefab
+    )
+else()
+    target_link_libraries(
+        NitroBuffer
+        ReactAndroid::react_nativemodule_core     # <-- RN: TurboModules Core
+    )
+endif()

package/nitrogen/generated/android/NitroBuffer+autolinking.gradle

@@ -0,0 +1,27 @@
+///
+/// NitroBuffer+autolinking.gradle
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+/// This is a Gradle file that adds all files generated by Nitrogen
+/// to the current Gradle project.
+///
+/// To use it, add this to your build.gradle:
+/// ```gradle
+/// apply from: '../nitrogen/generated/android/NitroBuffer+autolinking.gradle'
+/// ```
+
+logger.warn("[NitroModules] 🔥 NitroBuffer is boosted by nitro!")
+
+android {
+  sourceSets {
+    main {
+      java.srcDirs += [
+        // Nitrogen files
+        "${project.projectDir}/../nitrogen/generated/android/kotlin"
+      ]
+    }
+  }
+}

package/nitrogen/generated/android/NitroBufferOnLoad.cpp

@@ -0,0 +1,44 @@
+///
+/// NitroBufferOnLoad.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#ifndef BUILDING_NITROBUFFER_WITH_GENERATED_CMAKE_PROJECT
+#error NitroBufferOnLoad.cpp is not being built with the autogenerated CMakeLists.txt project. Is a different CMakeLists.txt building this?
+#endif
+
+#include "NitroBufferOnLoad.hpp"
+
+#include <jni.h>
+#include <fbjni/fbjni.h>
+#include <NitroModules/HybridObjectRegistry.hpp>
+
+#include "HybridNitroBuffer.hpp"
+
+namespace margelo::nitro::nitro_buffer {
+
+int initialize(JavaVM* vm) {
+  using namespace margelo::nitro;
+  using namespace margelo::nitro::nitro_buffer;
+  using namespace facebook;
+
+  return facebook::jni::initialize(vm, [] {
+    // Register native JNI methods
+    
+
+    // Register Nitro Hybrid Objects
+    HybridObjectRegistry::registerHybridObjectConstructor(
+      "NitroBuffer",
+      []() -> std::shared_ptr<HybridObject> {
+        static_assert(std::is_default_constructible_v<HybridNitroBuffer>,
+                      "The HybridObject \"HybridNitroBuffer\" is not default-constructible! "
+                      "Create a public constructor that takes zero arguments to be able to autolink this HybridObject.");
+        return std::make_shared<HybridNitroBuffer>();
+      }
+    );
+  });
+}
+
+} // namespace margelo::nitro::nitro_buffer

package/nitrogen/generated/android/NitroBufferOnLoad.hpp

@@ -0,0 +1,25 @@
+///
+/// NitroBufferOnLoad.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include <jni.h>
+#include <NitroModules/NitroDefines.hpp>
+
+namespace margelo::nitro::nitro_buffer {
+
+  /**
+   * Initializes the native (C++) part of NitroBuffer, and autolinks all Hybrid Objects.
+   * Call this in your `JNI_OnLoad` function (probably inside `cpp-adapter.cpp`).
+   * Example:
+   * ```cpp (cpp-adapter.cpp)
+   * JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+   *   return margelo::nitro::nitro_buffer::initialize(vm);
+   * }
+   * ```
+   */
+  int initialize(JavaVM* vm);
+
+} // namespace margelo::nitro::nitro_buffer

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitro_buffer/NitroBufferOnLoad.kt

@@ -0,0 +1,35 @@
+///
+/// NitroBufferOnLoad.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.nitro_buffer
+
+import android.util.Log
+
+internal class NitroBufferOnLoad {
+  companion object {
+    private const val TAG = "NitroBufferOnLoad"
+    private var didLoad = false
+    /**
+     * Initializes the native part of "NitroBuffer".
+     * This method is idempotent and can be called more than once.
+     */
+    @JvmStatic
+    fun initializeNative() {
+      if (didLoad) return
+      try {
+        Log.i(TAG, "Loading NitroBuffer C++ library...")
+        System.loadLibrary("NitroBuffer")
+        Log.i(TAG, "Successfully loaded NitroBuffer C++ library!")
+        didLoad = true
+      } catch (e: Error) {
+        Log.e(TAG, "Failed to load NitroBuffer C++ library! Is it properly installed and linked? " +
+                    "Is the name correct? (see `CMakeLists.txt`, at `add_library(...)`)", e)
+        throw e
+      }
+    }
+  }
+}

package/nitrogen/generated/ios/NitroBuffer+autolinking.rb

@@ -0,0 +1,60 @@
+#
+# NitroBuffer+autolinking.rb
+# This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+# https://github.com/mrousavy/nitro
+# Copyright © 2025 Marc Rousavy @ Margelo
+#
+
+# This is a Ruby script that adds all files generated by Nitrogen
+# to the given podspec.
+#
+# To use it, add this to your .podspec:
+# ```ruby
+# Pod::Spec.new do |spec|
+#   # ...
+#
+#   # Add all files generated by Nitrogen
+#   load 'nitrogen/generated/ios/NitroBuffer+autolinking.rb'
+#   add_nitrogen_files(spec)
+# end
+# ```
+
+def add_nitrogen_files(spec)
+  Pod::UI.puts "[NitroModules] 🔥 NitroBuffer is boosted by nitro!"
+
+  spec.dependency "NitroModules"
+
+  current_source_files = Array(spec.attributes_hash['source_files'])
+  spec.source_files = current_source_files + [
+    # Generated cross-platform specs
+    "nitrogen/generated/shared/**/*.{h,hpp,c,cpp,swift}",
+    # Generated bridges for the cross-platform specs
+    "nitrogen/generated/ios/**/*.{h,hpp,c,cpp,mm,swift}",
+  ]
+
+  current_public_header_files = Array(spec.attributes_hash['public_header_files'])
+  spec.public_header_files = current_public_header_files + [
+    # Generated specs
+    "nitrogen/generated/shared/**/*.{h,hpp}",
+    # Swift to C++ bridging helpers
+    "nitrogen/generated/ios/NitroBuffer-Swift-Cxx-Bridge.hpp"
+  ]
+
+  current_private_header_files = Array(spec.attributes_hash['private_header_files'])
+  spec.private_header_files = current_private_header_files + [
+    # iOS specific specs
+    "nitrogen/generated/ios/c++/**/*.{h,hpp}",
+    # Views are framework-specific and should be private
+    "nitrogen/generated/shared/**/views/**/*"
+  ]
+
+  current_pod_target_xcconfig = spec.attributes_hash['pod_target_xcconfig'] || {}
+  spec.pod_target_xcconfig = current_pod_target_xcconfig.merge({
+    # Use C++ 20
+    "CLANG_CXX_LANGUAGE_STANDARD" => "c++20",
+    # Enables C++ <-> Swift interop (by default it's only C)
+    "SWIFT_OBJC_INTEROP_MODE" => "objcxx",
+    # Enables stricter modular headers
+    "DEFINES_MODULE" => "YES",
+  })
+end

package/nitrogen/generated/ios/NitroBuffer-Swift-Cxx-Bridge.cpp

@@ -0,0 +1,17 @@
+///
+/// NitroBuffer-Swift-Cxx-Bridge.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include "NitroBuffer-Swift-Cxx-Bridge.hpp"
+
+// Include C++ implementation defined types
+
+
+namespace margelo::nitro::nitro_buffer::bridge::swift {
+
+  
+
+} // namespace margelo::nitro::nitro_buffer::bridge::swift

package/nitrogen/generated/ios/NitroBuffer-Swift-Cxx-Bridge.hpp

@@ -0,0 +1,27 @@
+///
+/// NitroBuffer-Swift-Cxx-Bridge.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+// Forward declarations of C++ defined types
+
+
+// Forward declarations of Swift defined types
+
+
+// Include C++ defined types
+
+
+/**
+ * Contains specialized versions of C++ templated types so they can be accessed from Swift,
+ * as well as helper functions to interact with those C++ types from Swift.
+ */
+namespace margelo::nitro::nitro_buffer::bridge::swift {
+
+  
+
+} // namespace margelo::nitro::nitro_buffer::bridge::swift

package/nitrogen/generated/ios/NitroBuffer-Swift-Cxx-Umbrella.hpp

@@ -0,0 +1,38 @@
+///
+/// NitroBuffer-Swift-Cxx-Umbrella.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+// Forward declarations of C++ defined types
+
+
+// Include C++ defined types
+
+
+// C++ helpers for Swift
+#include "NitroBuffer-Swift-Cxx-Bridge.hpp"
+
+// Common C++ types used in Swift
+#include <NitroModules/ArrayBufferHolder.hpp>
+#include <NitroModules/AnyMapUtils.hpp>
+#include <NitroModules/RuntimeError.hpp>
+#include <NitroModules/DateToChronoDate.hpp>
+
+// Forward declarations of Swift defined types
+
+
+// Include Swift defined types
+#if __has_include("NitroBuffer-Swift.h")
+// This header is generated by Xcode/Swift on every app build.
+// If it cannot be found, make sure the Swift module's name (= podspec name) is actually "NitroBuffer".
+#include "NitroBuffer-Swift.h"
+// Same as above, but used when building with frameworks (`use_frameworks`)
+#elif __has_include(<NitroBuffer/NitroBuffer-Swift.h>)
+#include <NitroBuffer/NitroBuffer-Swift.h>
+#else
+#error NitroBuffer's autogenerated Swift header cannot be found! Make sure the Swift module's name (= podspec name) is actually "NitroBuffer", and try building the app first.
+#endif

package/nitrogen/generated/ios/NitroBufferAutolinking.mm

@@ -0,0 +1,35 @@
+///
+/// NitroBufferAutolinking.mm
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#import <Foundation/Foundation.h>
+#import <NitroModules/HybridObjectRegistry.hpp>
+
+#import <type_traits>
+
+#include "HybridNitroBuffer.hpp"
+
+@interface NitroBufferAutolinking : NSObject
+@end
+
+@implementation NitroBufferAutolinking
+
++ (void) load {
+  using namespace margelo::nitro;
+  using namespace margelo::nitro::nitro_buffer;
+
+  HybridObjectRegistry::registerHybridObjectConstructor(
+    "NitroBuffer",
+    []() -> std::shared_ptr<HybridObject> {
+      static_assert(std::is_default_constructible_v<HybridNitroBuffer>,
+                    "The HybridObject \"HybridNitroBuffer\" is not default-constructible! "
+                    "Create a public constructor that takes zero arguments to be able to autolink this HybridObject.");
+      return std::make_shared<HybridNitroBuffer>();
+    }
+  );
+}
+
+@end

package/nitrogen/generated/ios/NitroBufferAutolinking.swift

@@ -0,0 +1,12 @@
+///
+/// NitroBufferAutolinking.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+public final class NitroBufferAutolinking {
+  public typealias bridge = margelo.nitro.nitro_buffer.bridge.swift
+
+  
+}

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

@@ -0,0 +1,32 @@
+///
+/// HybridNitroBufferSpec.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include "HybridNitroBufferSpec.hpp"
+
+namespace margelo::nitro::nitro_buffer {
+
+  void HybridNitroBufferSpec::loadHybridMethods() {
+    // load base methods/properties
+    HybridObject::loadHybridMethods();
+    // load custom methods/properties
+    registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridMethod("alloc", &HybridNitroBufferSpec::alloc);
+      prototype.registerHybridMethod("allocUnsafe", &HybridNitroBufferSpec::allocUnsafe);
+      prototype.registerHybridMethod("byteLength", &HybridNitroBufferSpec::byteLength);
+      prototype.registerHybridMethod("write", &HybridNitroBufferSpec::write);
+      prototype.registerHybridMethod("decode", &HybridNitroBufferSpec::decode);
+      prototype.registerHybridMethod("compare", &HybridNitroBufferSpec::compare);
+      prototype.registerHybridMethod("fill", &HybridNitroBufferSpec::fill);
+      prototype.registerHybridMethod("indexOf", &HybridNitroBufferSpec::indexOf);
+      prototype.registerHybridMethod("indexOfBuffer", &HybridNitroBufferSpec::indexOfBuffer);
+      prototype.registerHybridMethod("lastIndexOfByte", &HybridNitroBufferSpec::lastIndexOfByte);
+      prototype.registerHybridMethod("lastIndexOfBuffer", &HybridNitroBufferSpec::lastIndexOfBuffer);
+      prototype.registerHybridMethod("fillBuffer", &HybridNitroBufferSpec::fillBuffer);
+    });
+  }
+
+} // namespace margelo::nitro::nitro_buffer

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

@@ -0,0 +1,74 @@
+///
+/// HybridNitroBufferSpec.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 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
+
+
+
+#include <NitroModules/ArrayBuffer.hpp>
+#include <string>
+
+namespace margelo::nitro::nitro_buffer {
+
+  using namespace margelo::nitro;
+
+  /**
+   * An abstract base class for `NitroBuffer`
+   * Inherit this class to create instances of `HybridNitroBufferSpec` in C++.
+   * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
+   * @example
+   * ```cpp
+   * class HybridNitroBuffer: public HybridNitroBufferSpec {
+   * public:
+   *   HybridNitroBuffer(...): HybridObject(TAG) { ... }
+   *   // ...
+   * };
+   * ```
+   */
+  class HybridNitroBufferSpec: public virtual HybridObject {
+    public:
+      // Constructor
+      explicit HybridNitroBufferSpec(): HybridObject(TAG) { }
+
+      // Destructor
+      ~HybridNitroBufferSpec() override = default;
+
+    public:
+      // Properties
+      
+
+    public:
+      // Methods
+      virtual std::shared_ptr<ArrayBuffer> alloc(double size) = 0;
+      virtual std::shared_ptr<ArrayBuffer> allocUnsafe(double size) = 0;
+      virtual double byteLength(const std::string& string, const std::string& encoding) = 0;
+      virtual double write(const std::shared_ptr<ArrayBuffer>& buffer, const std::string& string, double offset, double length, const std::string& encoding) = 0;
+      virtual std::string decode(const std::shared_ptr<ArrayBuffer>& buffer, double offset, double length, const std::string& encoding) = 0;
+      virtual double compare(const std::shared_ptr<ArrayBuffer>& a, double aOffset, double aLength, const std::shared_ptr<ArrayBuffer>& b, double bOffset, double bLength) = 0;
+      virtual void fill(const std::shared_ptr<ArrayBuffer>& buffer, double value, double offset, double length) = 0;
+      virtual double indexOf(const std::shared_ptr<ArrayBuffer>& buffer, double value, double offset, double length) = 0;
+      virtual double indexOfBuffer(const std::shared_ptr<ArrayBuffer>& buffer, const std::shared_ptr<ArrayBuffer>& needle, double offset, double length) = 0;
+      virtual double lastIndexOfByte(const std::shared_ptr<ArrayBuffer>& buffer, double value, double offset, double length) = 0;
+      virtual double lastIndexOfBuffer(const std::shared_ptr<ArrayBuffer>& buffer, const std::shared_ptr<ArrayBuffer>& needle, double offset, double length) = 0;
+      virtual void fillBuffer(const std::shared_ptr<ArrayBuffer>& buffer, const std::shared_ptr<ArrayBuffer>& value, double offset, double length) = 0;
+
+    protected:
+      // Hybrid Setup
+      void loadHybridMethods() override;
+
+    protected:
+      // Tag for logging
+      static constexpr auto TAG = "NitroBuffer";
+  };
+
+} // namespace margelo::nitro::nitro_buffer