@javascriptcommon/react-native-xxhash 0.1.9

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 pioner921227
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,104 @@
+# react-native-xxhash
+
+A React Native library for hashing strings using the fast and deterministic xxHash algorithm, written in C++ with JSI for high performance. This library provides support for both 64-bit and 128-bit hashing.
+
+
+## Features
+
+- **High Performance**: xxHash is one of the fastest non-cryptographic hash functions.
+- **Deterministic Hashing**: Ensures consistent results for the same input.
+- **128-bit and 64-bit Support**: Choose between 128-bit and 64-bit hash outputs based on your use case.
+- **Cross-Platform**: Supports both iOS and Android in React Native projects.
+
+## Installation
+
+To install the library, use either `npm` or `yarn`:
+
+```sh
+npm install react-native-xxhash
+```
+
+```sh
+yarn add react-native-xxhash
+```
+
+## iOS
+```sh
+pod install
+```
+
+---
+
+## Usage
+
+Here’s how to use the `react-native-xxhash` library in your React Native project:
+
+### Import the Functions
+```javascript
+import { hash128, hash64 } from 'react-native-xxhash';
+```
+
+### Hash a String (128-bit)
+This function generates a fast and deterministic 128-bit hash for a given string input.
+
+```javascript
+const resultHash128 = hash128("hello world");
+console.log('128-bit hash:', resultHash128);
+// Output: A 128-bit hash string
+```
+
+### Hash a String (64-bit)
+This function generates a fast and deterministic 64-bit hash for a given string input.
+
+```javascript
+const resultHash64 = hash64("hello world");
+console.log('64-bit hash:', resultHash64);
+// Output: A 64-bit hash string
+```
+
+### Example Usage in a Component
+```javascript
+import React, { useEffect } from 'react';
+import { Text, View } from 'react-native';
+import { hash128, hash64 } from 'react-native-xxhash';
+
+const App = () => {
+  useEffect(() => {
+    const hash128Result = hash128("react-native");
+    const hash64Result = hash64("react-native");
+
+    console.log("128-bit hash:", hash128Result);
+    console.log("64-bit hash:", hash64Result);
+  }, []);
+
+  return (
+    <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
+      <Text>Check your console for hash results!</Text>
+    </View>
+  );
+};
+
+export default App;
+```
+
+---
+
+## API Reference
+
+### `hash128(input: string): string`
+- **Description**: Generates a 128-bit hash for the given string input.
+- **Parameters**:
+  - `input` (string): The string to hash.
+- **Returns**: A 128-bit hash as a string.
+
+### `hash64(input: string): string`
+- **Description**: Generates a 64-bit hash for the given string input.
+- **Parameters**:
+  - `input` (string): The string to hash.
+- **Returns**: A 64-bit hash as a string.
+
+---
+
+## License
+
+`react-native-xxhash` is released under the MIT License. See the [LICENSE](LICENSE) file for details.

package/android/CMakeLists.txt

@@ -0,0 +1,48 @@
+cmake_minimum_required(VERSION 3.4.1)
+project(react-native-xxhash)
+
+set (CMAKE_VERBOSE_MAKEFILE ON)
+set (CMAKE_CXX_STANDARD 17)
+
+add_library(react-native-xxhash            SHARED
+            ../cpp/react-native-xxhash.cpp
+            ../cpp/xxhash.c
+            cpp-adapter.cpp
+)
+
+find_package(ReactAndroid REQUIRED CONFIG)
+
+find_package(fbjni REQUIRED CONFIG)
+
+target_include_directories(
+        react-native-xxhash PRIVATE
+        "${NODE_MODULES_DIR}/react-native/React"
+        "${NODE_MODULES_DIR}/react-native/React/Base"
+        "${NODE_MODULES_DIR}/react-native/ReactCommon"
+        "${NODE_MODULES_DIR}/react-native/ReactCommon/jsi"
+#        "${NODE_MODULES_DIR}/react-native/ReactAndroid/src/main/jni/react/turbomodule"
+#        "${NODE_MODULES_DIR}/react-native/ReactCommon/runtimeexecutor"
+)
+
+# Specifies a path to native header files.
+include_directories(
+            ../cpp
+)
+
+if (ReactAndroid_VERSION_MINOR GREATER_EQUAL 76)
+  target_link_libraries(
+    react-native-xxhash
+    ReactAndroid::jsi
+    log
+    ReactAndroid::reactnative
+    fbjni::fbjni
+  )
+else()
+    target_link_libraries(
+            react-native-xxhash
+            ReactAndroid::jsi
+            log
+            ReactAndroid::reactnativejni
+            fbjni::fbjni
+    )
+endif()

package/android/build.gradle

@@ -0,0 +1,154 @@
+import groovy.json.JsonSlurper
+import org.apache.tools.ant.filters.ReplaceTokens
+import java.nio.file.Paths
+
+buildscript {
+  // Buildscript is evaluated before everything else so we can't use getExtOrDefault
+  def kotlin_version = rootProject.ext.has("kotlinVersion") ? rootProject.ext.get("kotlinVersion") : project.properties["Xxhash_kotlinVersion"]
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:7.2.1"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+  }
+}
+
+static def findNodeModules(baseDir) {
+  def basePath = baseDir.toPath().normalize()
+  // Node's module resolution algorithm searches up to the root directory,
+  // after which the base path will be null
+  while (basePath) {
+    def nodeModulesPath = Paths.get(basePath.toString(), "node_modules")
+    def reactNativePath = Paths.get(nodeModulesPath.toString(), "react-native")
+    if (nodeModulesPath.toFile().exists() && reactNativePath.toFile().exists()) {
+      return nodeModulesPath.toString()
+    }
+    basePath = basePath.getParent()
+  }
+  throw new GradleException("react-native-xxhash: Failed to find node_modules/ path!")
+}
+
+def nodeModules = findNodeModules(projectDir)
+logger.warn("react-native-xxhash: node_modules/ found at: ${nodeModules}")
+
+def reactNativeArchitectures() {
+  def value = rootProject.getProperties().get("reactNativeArchitectures")
+  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+}
+
+def isNewArchitectureEnabled() {
+  return rootProject.hasProperty("newArchEnabled") && rootProject.getProperty("newArchEnabled") == "true"
+}
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+if (isNewArchitectureEnabled()) {
+  apply plugin: "com.facebook.react"
+}
+
+def getExtOrDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties["Xxhash_" + name]
+}
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["Xxhash_" + name]).toInteger()
+}
+
+def supportsNamespace() {
+  def parsed = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION.tokenize('.')
+  def major = parsed[0].toInteger()
+  def minor = parsed[1].toInteger()
+
+  // Namespace support was added in 7.3.0
+  return (major == 7 && minor >= 3) || major >= 8
+}
+
+android {
+  if (supportsNamespace()) {
+    namespace "com.xxhash"
+
+    sourceSets {
+      main {
+        manifest.srcFile "src/main/AndroidManifestNew.xml"
+      }
+    }
+  }
+
+  ndkVersion getExtOrDefault("ndkVersion")
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+
+    externalNativeBuild {
+      cmake {
+        cppFlags "-O2 -frtti -fexceptions -Wall -fstack-protector-all"
+        abiFilters (*reactNativeArchitectures())
+        arguments "-DANDROID_STL=c++_shared",
+                  "-DNODE_MODULES_DIR=${nodeModules}",
+                  "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
+      }
+    }
+  }
+
+  externalNativeBuild {
+    cmake {
+      path "CMakeLists.txt"
+    }
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  buildFeatures {
+    buildConfig true
+    prefab true
+  }
+
+    packagingOptions {
+      excludes = [
+            "**/libjsi.so",
+             "**/libreactnativejni.so",
+            "**/libreact_nativemodule_core.so",
+            "**/libturbomodulejsijni.so",
+            "**/libc++_shared.so",
+            "**/libfbjni.so",
+            "**/libreactnative.so",
+      ]
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  // For < 0.71, this will be from the local maven repo
+  // For > 0.71, this will be replaced by `com.facebook.react:react-android:$version` by react gradle plugin
+  //noinspection GradleDynamicVersion
+  implementation "com.facebook.react:react-native:+"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+}
+

package/android/cpp-adapter.cpp

@@ -0,0 +1,38 @@
+#include <jni.h>
+#include "react-native-xxhash.h"
+#include "jsi/jsi.h"
+#include <android/log.h>
+#include <fbjni/fbjni.h>
+#include <fbjni/detail/Registration.h>
+#include <typeinfo>
+
+//XXHashBridge
+
+
+using namespace facebook;
+
+struct XXHashBridge : jni::JavaClass<XXHashBridge> {
+public:
+    static constexpr auto kJavaDescriptor = "Lcom/xxhash/XxhashModule;";
+
+    static void registerNatives() {
+        javaClassStatic()->registerNatives({
+                                                   makeNativeMethod("nativeInstall", XXHashBridge::nativeInstall)
+                                           });
+    }
+private:
+    static void nativeInstall(
+            jni::alias_ref<jni::JObject> thiz,
+            jlong jsiRuntimePointer
+    ) {
+
+        // Реализация
+        auto jsiRuntime = reinterpret_cast<jsi::Runtime*>(jsiRuntimePointer);
+        // Установите JSI
+        xxhash::install(jsiRuntime);
+    }
+};
+
+JNIEXPORT jint JNI_OnLoad(JavaVM *vm, void *) {
+    return jni::initialize(vm, [] { XXHashBridge::registerNatives(); });
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+Xxhash_kotlinVersion=1.7.0
+Xxhash_minSdkVersion=21
+Xxhash_targetSdkVersion=31
+Xxhash_compileSdkVersion=31
+Xxhash_ndkversion=21.4.7075529

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,3 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          package="com.xxhash">
+</manifest>

package/android/src/main/AndroidManifestNew.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/xxhash/XxhashModule.kt

@@ -0,0 +1,55 @@
+package com.xxhash
+
+import android.util.Log
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.common.annotations.FrameworkAPI
+
+class XxhashModule internal constructor(val context: ReactApplicationContext) :
+  ReactContextBaseJavaModule(context) {
+
+    companion object {
+    const val NAME = "xxhash"
+
+    init {
+          System.loadLibrary("react-native-xxhash")
+    }
+
+    @OptIn(FrameworkAPI::class)
+    @JvmStatic
+    external fun nativeInstall(jsiRuntimePointer: Long)
+    }
+
+  private val reactContext = context
+
+  override fun getName(): String {
+    return NAME
+  }
+
+  // New Architecture / bridgeless: install eagerly when the context is ready so
+  // __xxhash128/__xxhash64 are available before the first hash() call, and we
+  // never depend on JS calling install(). Guarded so a null/zero
+  // javaScriptContextHolder (possible under bridgeless) can never NPE.
+  override fun initialize() {
+    super.initialize()
+    tryInstall()
+  }
+
+  @OptIn(FrameworkAPI::class)
+  @ReactMethod(isBlockingSynchronousMethod = true)
+  fun install(): Boolean {
+    return tryInstall()
+  }
+
+  @OptIn(FrameworkAPI::class)
+  private fun tryInstall(): Boolean {
+    val pointer = reactContext.javaScriptContextHolder?.get() ?: 0L
+    if (pointer == 0L) {
+      Log.w("xxhash", "install skipped: no JSI runtime pointer (bridgeless?)")
+      return false
+    }
+    nativeInstall(pointer)
+    return true
+  }
+}

package/android/src/main/java/com/xxhash/XxhashPackage.kt

@@ -0,0 +1,17 @@
+package com.xxhash
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+
+class XxhashPackage : ReactPackage {
+  override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+    return listOf(XxhashModule(reactContext))
+  }
+
+  override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+    return emptyList()
+  }
+}

package/cpp/react-native-xxhash.cpp

@@ -0,0 +1,43 @@
+#include "react-native-xxhash.h"
+
+void xxhash::install(jsi::Runtime* rt_ptr) {
+  jsi::Runtime& runtime = *rt_ptr;
+
+  jsi::Function hash128 = jsi::Function::createFromHostFunction(
+      runtime, jsi::PropNameID::forAscii(runtime, "hash128"), 1,
+      [](jsi::Runtime& rt, const jsi::Value& thisVal, const jsi::Value* args,
+         size_t count) {
+        const jsi::Value& arg = args[0];
+
+        if (!arg.isString()) [[unlikely]] {
+          throw jsi::JSError(rt, "Argument is not a 'string'");
+        }
+
+        char result[33];
+
+        xxhash::make_hash_128(arg.asString(rt).utf8(rt), result);
+
+        return jsi::String::createFromUtf8(rt, result);
+      });
+
+  jsi::Function hash64 = jsi::Function::createFromHostFunction(
+      runtime, jsi::PropNameID::forAscii(runtime, "hash64"), 1,
+      [](jsi::Runtime& rt, const jsi::Value& thisVal, const jsi::Value* args,
+         size_t count) {
+        const jsi::Value& arg = args[0];
+
+        if (!arg.isString()) [[unlikely]] {
+          throw jsi::JSError(rt, "Argument is not a 'string'");
+        }
+
+        char result[17];
+
+        xxhash::make_hash_64(arg.asString(rt).utf8(rt), result);
+
+        return jsi::String::createFromUtf8(rt, result);
+      });
+
+  runtime.global().setProperty(runtime, "__xxhash128", std::move(hash128));
+
+  runtime.global().setProperty(runtime, "__xxhash64", std::move(hash64));
+}

package/cpp/react-native-xxhash.h

@@ -0,0 +1,27 @@
+#pragma once
+#ifndef XXHASH_H
+#define XXHASH_H
+#include <jsi/jsi.h>
+#include <iomanip>
+#include <sstream>
+#include "xxhash.h"
+
+using namespace facebook;
+
+namespace xxhash {
+
+inline void make_hash_64(const std::string_view str, char result[17]) noexcept {
+  XXH64_hash_t hash = XXH3_64bits(str.data(), str.size());
+  std::snprintf(result, 17, "%016llx", hash);
+};
+
+inline void make_hash_128(const std::string_view str,
+                          char result[33]) noexcept {
+  XXH128_hash_t hash = XXH3_128bits(str.data(), str.size());
+  std::snprintf(result, 33, "%016llx%016llx", hash.high64, hash.low64);
+};
+
+void install(jsi::Runtime* rt);
+}  // namespace xxhash
+
+#endif /* XXHASH_H */

package/cpp/xxhash.c

@@ -0,0 +1,42 @@
+/*
+ * xxHash - Extremely Fast Hash algorithm
+ * Copyright (C) 2012-2023 Yann Collet
+ *
+ * BSD 2-Clause License (https://www.opensource.org/licenses/bsd-license.php)
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ *    * Redistributions of source code must retain the above copyright
+ *      notice, this list of conditions and the following disclaimer.
+ *    * Redistributions in binary form must reproduce the above
+ *      copyright notice, this list of conditions and the following disclaimer
+ *      in the documentation and/or other materials provided with the
+ *      distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * You can contact the author at:
+ *   - xxHash homepage: https://www.xxhash.com
+ *   - xxHash source repository: https://github.com/Cyan4973/xxHash
+ */
+
+/*
+ * xxhash.c instantiates functions defined in xxhash.h
+ */
+
+#define XXH_STATIC_LINKING_ONLY /* access advanced declarations */
+#define XXH_IMPLEMENTATION      /* access definitions */
+
+#include "xxhash.h"