react-native-xxhash 0.1.8 → 0.1.10

package/README.md

@@ -2,7 +2,6 @@
 
 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.
@@ -10,6 +9,9 @@ A React Native library for hashing strings using the fast and deterministic xxHa
 - **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.
 
+# Benchmarks (https://xxhash.com)
+<img width="772" height="712" alt="Screenshot 2025-10-23 at 09 48 25" src="https://github.com/user-attachments/assets/792c220b-54cc-45d7-8e62-e26757d11e85" />
+
 ## Installation
 
 To install the library, use either `npm` or `yarn`:

package/cpp/react-native-xxhash.cpp

@@ -1,40 +1,45 @@
 #include "react-native-xxhash.h"
 
-void xxhash::install(jsi::Runtime* rt_ptr) {
-  jsi::Runtime& runtime = *rt_ptr;
+constexpr size_t XXH128_HEX_LEN = 32;
+constexpr size_t XXH64_HEX_LEN = 16;
+constexpr size_t XXH128_HEX_LEN_NT = XXH128_HEX_LEN + 1;
+constexpr size_t XXH64_HEX_LEN_NT = XXH64_HEX_LEN + 1;
+
+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,
+      [](jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
          size_t count) {
-        const jsi::Value& arg = args[0];
+        const jsi::Value &arg = args[0];
 
         if (!arg.isString()) [[unlikely]] {
           throw jsi::JSError(rt, "Argument is not a 'string'");
         }
 
-        char result[33];
+        char result[XXH128_HEX_LEN_NT];
 
         xxhash::make_hash_128(arg.asString(rt).utf8(rt), result);
 
-        return jsi::String::createFromUtf8(rt, result);
+        return jsi::String::createFromAscii(rt, result, XXH128_HEX_LEN);
       });
 
   jsi::Function hash64 = jsi::Function::createFromHostFunction(
       runtime, jsi::PropNameID::forAscii(runtime, "hash64"), 1,
-      [](jsi::Runtime& rt, const jsi::Value& thisVal, const jsi::Value* args,
+      [](jsi::Runtime &rt, const jsi::Value &thisVal, const jsi::Value *args,
          size_t count) {
-        const jsi::Value& arg = args[0];
+        const jsi::Value &arg = args[0];
 
         if (!arg.isString()) [[unlikely]] {
           throw jsi::JSError(rt, "Argument is not a 'string'");
         }
 
-        char result[17];
+        char result[XXH64_HEX_LEN_NT];
 
         xxhash::make_hash_64(arg.asString(rt).utf8(rt), result);
 
-        return jsi::String::createFromUtf8(rt, result);
+        return jsi::String::createFromAscii(rt, result, XXH64_HEX_LEN);
       });
 
   runtime.global().setProperty(runtime, "__xxhash128", std::move(hash128));

package/cpp/react-native-xxhash.h

@@ -1,10 +1,10 @@
 #pragma once
 #ifndef XXHASH_H
 #define XXHASH_H
-#include <jsi/jsi.h>
+#include "xxhash.h"
 #include <iomanip>
+#include <jsi/jsi.h>
 #include <sstream>
-#include "xxhash.h"
 
 using namespace facebook;
 
@@ -12,16 +12,38 @@ 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);
+  static constexpr char hex[] = "0123456789abcdef";
+
+  for (int i = 0; i < 16; ++i) {
+    const uint8_t nibble = (hash >> ((15 - i) * 4)) & 0xF;
+    result[i] = hex[nibble];
+  }
+
+  result[16] = '\0';
 };
 
-void install(jsi::Runtime* rt);
-}  // namespace xxhash
+inline void make_hash_128(std::string_view str, char result[33]) noexcept {
+  const XXH128_hash_t hash = XXH3_128bits(str.data(), str.size());
+
+  static constexpr char hex[] = "0123456789abcdef";
+
+  // high64 → first 16
+  for (int i = 0; i < 16; ++i) {
+    const uint8_t nibble = (hash.high64 >> ((15 - i) * 4)) & 0xF;
+    result[i] = hex[nibble];
+  }
+
+  // low64 → next 16
+  for (int i = 0; i < 16; ++i) {
+    const uint8_t nibble = (hash.low64 >> ((15 - i) * 4)) & 0xF;
+    result[16 + i] = hex[nibble];
+  }
+
+  result[32] = '\0';
+}
+
+void install(jsi::Runtime *rt);
+} // namespace xxhash
 
 #endif /* XXHASH_H */

package/ios/Xxhash.mm

@@ -5,6 +5,27 @@
 #import <React/RCTUtils.h>
 #import <jsi/jsi.h>
 
+#ifdef RCT_NEW_ARCH_ENABLED
+#import <ReactCommon/RCTTurboModuleWithJSIBindings.h>
+#import <ReactCommon/TurboModule.h>
+#import <ReactCommon/CallInvoker.h>
+#endif
+
+using namespace facebook;
+
+#ifdef RCT_NEW_ARCH_ENABLED
+namespace {
+class XxhashTurboModule : public facebook::react::TurboModule {
+ public:
+  XxhashTurboModule(std::shared_ptr<facebook::react::CallInvoker> jsInvoker)
+      : facebook::react::TurboModule("xxhash", std::move(jsInvoker)) {}
+};
+} // namespace
+
+@interface Xxhash () <RCTTurboModule, RCTTurboModuleWithJSIBindings>
+@end
+#endif
+
 @implementation Xxhash
 RCT_EXPORT_MODULE(xxhash)
 
@@ -12,12 +33,19 @@ RCT_EXPORT_MODULE(xxhash)
 @synthesize methodQueue = _methodQueue;
 
 + (BOOL)requiresMainQueueSetup {
-  return YES;
+  return NO;
 }
 
 RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(install){
 	NSLog(@"Installing JSI bindings for xxhash ...");
-	RCTBridge* bridge = [RCTBridge currentBridge];
+
+#ifdef RCT_NEW_ARCH_ENABLED
+  if (self.bridge == nil) {
+    return @true;
+  }
+#endif
+
+	RCTBridge* bridge = self.bridge ?: [RCTBridge currentBridge];
 	RCTCxxBridge* cxxBridge = (RCTCxxBridge*)bridge;
 
 	if (cxxBridge == nil) {
@@ -34,5 +62,19 @@ RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(install){
 	return @true;
 }
 
+#ifdef RCT_NEW_ARCH_ENABLED
+- (void)installJSIBindingsWithRuntime:(jsi::Runtime &)runtime
+                          callInvoker:(const std::shared_ptr<react::CallInvoker> &)callInvoker {
+  xxhash::install(&runtime);
+}
+
+- (void)installJSIBindingsWithRuntime:(jsi::Runtime &)runtime {
+  xxhash::install(&runtime);
+}
+
+- (std::shared_ptr<react::TurboModule>)getTurboModule:(const react::ObjCTurboModule::InitParams &)params {
+  return std::make_shared<XxhashTurboModule>(params.jsInvoker);
+}
+#endif
 
 @end

package/lib/commonjs/index.js

@@ -7,10 +7,13 @@ exports.hash64 = exports.hash128 = void 0;
 var _reactNative = require("react-native");
 let xxhashModule = globalThis.__xxhash128;
 if (!xxhashModule) {
-  if (_reactNative.NativeModules.xxhash) {
-    _reactNative.NativeModules.xxhash.install();
+  const XxhashModule = _reactNative.TurboModuleRegistry.get('xxhash') ?? _reactNative.NativeModules.xxhash;
+  if (XxhashModule) {
+    XxhashModule.install?.();
     xxhashModule = globalThis.__xxhash128;
-    console.log('✅ xxhash initialized successfully');
+    if (xxhashModule) {
+      console.log('✅ xxhash initialized successfully');
+    }
   }
 }
 

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","xxhashModule","globalThis","__xxhash128","NativeModules","xxhash","install","console","log","hash128","input","Error","exports","hash64","__xxhash64"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAOA,IAAIC,YAAY,GAAGC,UAAU,CAACC,WAAW;AAEzC,IAAG,CAACF,YAAY,EAAC;EACf,IAAGG,0BAAa,CAACC,MAAM,EAAC;IACtBD,0BAAa,CAACC,MAAM,CAACC,OAAO,CAAC,CAAC;IAC9BL,YAAY,GAAGC,UAAU,CAACC,WAAW;IACrCI,OAAO,CAACC,GAAG,CAAC,mCAAmC,CAAC;EAClD;AACF;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACQ,MAAMC,OAAO,GAAIC,KAAa,IAAa;EACjD,IAAG,CAACA,KAAK,EAAC;IACR,MAAM,IAAIC,KAAK,CAAC,mBAAmB,CAAC;EACtC;EAEA,IAAG,OAAOD,KAAK,KAAK,QAAQ,EAAC;IAC3B,MAAM,IAAIC,KAAK,CAAC,wBAAwB,CAAC;EAC3C;EAEA,OAAOT,UAAU,CAACC,WAAW,CAACO,KAAK,CAAC;AACrC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAhBAE,OAAA,CAAAH,OAAA,GAAAA,OAAA;AAkBQ,MAAMI,MAAM,GAAIH,KAAa,IAAa;EAChD,IAAG,CAACA,KAAK,EAAC;IACR,MAAM,IAAIC,KAAK,CAAC,mBAAmB,CAAC;EACtC;EAEA,IAAG,OAAOD,KAAK,KAAK,QAAQ,EAAC;IAC3B,MAAM,IAAIC,KAAK,CAAC,wBAAwB,CAAC;EAC3C;EAEA,OAAOT,UAAU,CAACY,UAAU,CAACJ,KAAK,CAAC;AACpC,CAAC;AAAAE,OAAA,CAAAC,MAAA,GAAAA,MAAA","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","xxhashModule","globalThis","__xxhash128","XxhashModule","TurboModuleRegistry","get","NativeModules","xxhash","install","console","log","hash128","input","Error","exports","hash64","__xxhash64"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAOA,IAAIC,YAAY,GAAIC,UAAU,CAASC,WAAwD;AAE/F,IAAG,CAACF,YAAY,EAAC;EACf,MAAMG,YAAiB,GAAGC,gCAAmB,CAACC,GAAG,CAAC,QAAQ,CAAC,IAAIC,0BAAa,CAACC,MAAM;EACnF,IAAGJ,YAAY,EAAC;IACdA,YAAY,CAACK,OAAO,GAAG,CAAC;IACxBR,YAAY,GAAIC,UAAU,CAASC,WAAW;IAC9C,IAAGF,YAAY,EAAC;MACdS,OAAO,CAACC,GAAG,CAAC,mCAAmC,CAAC;IAClD;EACF;AACF;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACQ,MAAMC,OAAO,GAAIC,KAAa,IAAa;EACjD,IAAG,CAACA,KAAK,EAAC;IACR,MAAM,IAAIC,KAAK,CAAC,mBAAmB,CAAC;EACtC;EAEA,IAAG,OAAOD,KAAK,KAAK,QAAQ,EAAC;IAC3B,MAAM,IAAIC,KAAK,CAAC,wBAAwB,CAAC;EAC3C;EAEA,OAAOZ,UAAU,CAACC,WAAW,CAACU,KAAK,CAAC;AACrC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAhBAE,OAAA,CAAAH,OAAA,GAAAA,OAAA;AAkBQ,MAAMI,MAAM,GAAIH,KAAa,IAAa;EAChD,IAAG,CAACA,KAAK,EAAC;IACR,MAAM,IAAIC,KAAK,CAAC,mBAAmB,CAAC;EACtC;EAEA,IAAG,OAAOD,KAAK,KAAK,QAAQ,EAAC;IAC3B,MAAM,IAAIC,KAAK,CAAC,wBAAwB,CAAC;EAC3C;EAEA,OAAOZ,UAAU,CAACe,UAAU,CAACJ,KAAK,CAAC;AACpC,CAAC;AAAAE,OAAA,CAAAC,MAAA,GAAAA,MAAA","ignoreList":[]}

package/lib/module/index.js

@@ -1,12 +1,15 @@
 "use strict";
 
-import { NativeModules } from 'react-native';
+import { NativeModules, TurboModuleRegistry } from 'react-native';
 let xxhashModule = globalThis.__xxhash128;
 if (!xxhashModule) {
-  if (NativeModules.xxhash) {
-    NativeModules.xxhash.install();
+  const XxhashModule = TurboModuleRegistry.get('xxhash') ?? NativeModules.xxhash;
+  if (XxhashModule) {
+    XxhashModule.install?.();
     xxhashModule = globalThis.__xxhash128;
-    console.log('✅ xxhash initialized successfully');
+    if (xxhashModule) {
+      console.log('✅ xxhash initialized successfully');
+    }
   }
 }
 

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","xxhashModule","globalThis","__xxhash128","xxhash","install","console","log","hash128","input","Error","hash64","__xxhash64"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAAQA,aAAa,QAAO,cAAc;AAO1C,IAAIC,YAAY,GAAGC,UAAU,CAACC,WAAW;AAEzC,IAAG,CAACF,YAAY,EAAC;EACf,IAAGD,aAAa,CAACI,MAAM,EAAC;IACtBJ,aAAa,CAACI,MAAM,CAACC,OAAO,CAAC,CAAC;IAC9BJ,YAAY,GAAGC,UAAU,CAACC,WAAW;IACrCG,OAAO,CAACC,GAAG,CAAC,mCAAmC,CAAC;EAClD;AACF;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACC,OAAO,MAAMC,OAAO,GAAIC,KAAa,IAAa;EACjD,IAAG,CAACA,KAAK,EAAC;IACR,MAAM,IAAIC,KAAK,CAAC,mBAAmB,CAAC;EACtC;EAEA,IAAG,OAAOD,KAAK,KAAK,QAAQ,EAAC;IAC3B,MAAM,IAAIC,KAAK,CAAC,wBAAwB,CAAC;EAC3C;EAEA,OAAOR,UAAU,CAACC,WAAW,CAACM,KAAK,CAAC;AACrC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEC,OAAO,MAAME,MAAM,GAAIF,KAAa,IAAa;EAChD,IAAG,CAACA,KAAK,EAAC;IACR,MAAM,IAAIC,KAAK,CAAC,mBAAmB,CAAC;EACtC;EAEA,IAAG,OAAOD,KAAK,KAAK,QAAQ,EAAC;IAC3B,MAAM,IAAIC,KAAK,CAAC,wBAAwB,CAAC;EAC3C;EAEA,OAAOR,UAAU,CAACU,UAAU,CAACH,KAAK,CAAC;AACpC,CAAC","ignoreList":[]}
+{"version":3,"names":["NativeModules","TurboModuleRegistry","xxhashModule","globalThis","__xxhash128","XxhashModule","get","xxhash","install","console","log","hash128","input","Error","hash64","__xxhash64"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAAQA,aAAa,EAAEC,mBAAmB,QAAO,cAAc;AAO/D,IAAIC,YAAY,GAAIC,UAAU,CAASC,WAAwD;AAE/F,IAAG,CAACF,YAAY,EAAC;EACf,MAAMG,YAAiB,GAAGJ,mBAAmB,CAACK,GAAG,CAAC,QAAQ,CAAC,IAAIN,aAAa,CAACO,MAAM;EACnF,IAAGF,YAAY,EAAC;IACdA,YAAY,CAACG,OAAO,GAAG,CAAC;IACxBN,YAAY,GAAIC,UAAU,CAASC,WAAW;IAC9C,IAAGF,YAAY,EAAC;MACdO,OAAO,CAACC,GAAG,CAAC,mCAAmC,CAAC;IAClD;EACF;AACF;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACC,OAAO,MAAMC,OAAO,GAAIC,KAAa,IAAa;EACjD,IAAG,CAACA,KAAK,EAAC;IACR,MAAM,IAAIC,KAAK,CAAC,mBAAmB,CAAC;EACtC;EAEA,IAAG,OAAOD,KAAK,KAAK,QAAQ,EAAC;IAC3B,MAAM,IAAIC,KAAK,CAAC,wBAAwB,CAAC;EAC3C;EAEA,OAAOV,UAAU,CAACC,WAAW,CAACQ,KAAK,CAAC;AACrC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEC,OAAO,MAAME,MAAM,GAAIF,KAAa,IAAa;EAChD,IAAG,CAACA,KAAK,EAAC;IACR,MAAM,IAAIC,KAAK,CAAC,mBAAmB,CAAC;EACtC;EAEA,IAAG,OAAOD,KAAK,KAAK,QAAQ,EAAC;IAC3B,MAAM,IAAIC,KAAK,CAAC,wBAAwB,CAAC;EAC3C;EAEA,OAAOV,UAAU,CAACY,UAAU,CAACH,KAAK,CAAC;AACpC,CAAC","ignoreList":[]}

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,IAAI,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAC3C;AAcD;;;;;;;;;;;;;;;;GAgBG;AACF,eAAO,MAAM,OAAO,UAAW,MAAM,KAAG,MAUvC,CAAA;AAEF;;;;;;;;;;;;;;;;GAgBG;AAEF,eAAO,MAAM,MAAM,UAAW,MAAM,KAAG,MAUtC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,IAAI,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAC3C;AAiBD;;;;;;;;;;;;;;;;GAgBG;AACF,eAAO,MAAM,OAAO,UAAW,MAAM,KAAG,MAUvC,CAAA;AAEF;;;;;;;;;;;;;;;;GAgBG;AAEF,eAAO,MAAM,MAAM,UAAW,MAAM,KAAG,MAUtC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-xxhash",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "💪 A high-performance React Native library for generating xxHash hashes using C++ and JSI",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",

package/src/index.tsx

@@ -1,17 +1,20 @@
-import {NativeModules} from 'react-native'
+import {NativeModules, TurboModuleRegistry} from 'react-native'
 declare global {
   var __xxhash128: (input: string) => string;
   var __xxhash64: (input: string) => string;
 }
 
 
-let xxhashModule = globalThis.__xxhash128;
+let xxhashModule = (globalThis as any).__xxhash128 as typeof globalThis.__xxhash128 | undefined;
 
 if(!xxhashModule){
-  if(NativeModules.xxhash){
-    NativeModules.xxhash.install();
-    xxhashModule = globalThis.__xxhash128;
-    console.log('✅ xxhash initialized successfully')
+  const XxhashModule: any = TurboModuleRegistry.get('xxhash') ?? NativeModules.xxhash;
+  if(XxhashModule){
+    XxhashModule.install?.();
+    xxhashModule = (globalThis as any).__xxhash128;
+    if(xxhashModule){
+      console.log('✅ xxhash initialized successfully')
+    }
   }
 }
 
@@ -43,7 +46,7 @@ if(!xxhashModule){
   }
 
   return globalThis.__xxhash128(input);
- }   
+ }
 
 /**
  * Hashes the input string using the xxhash64 algorithm.
@@ -73,4 +76,4 @@ if(!xxhashModule){
   }
 
   return globalThis.__xxhash64(input);
- }   
+ }