@javascriptcommon/react-native-xxhash 0.1.9

package/ios/Xxhash.h

@@ -0,0 +1,9 @@
+#ifdef __cplusplus
+#import "react-native-xxhash.h"
+#endif
+
+#import <React/RCTBridgeModule.h>
+
+@interface Xxhash : NSObject <RCTBridgeModule>
+
+@end

package/ios/Xxhash.mm

@@ -0,0 +1,62 @@
+#import "Xxhash.h"
+#import <React/RCTBridge+Private.h>
+#import <ReactCommon/RCTTurboModule.h>
+#import <ReactCommon/RCTTurboModuleWithJSIBindings.h>
+#import <React/RCTBridge.h>
+#import <React/RCTUtils.h>
+#import <jsi/jsi.h>
+
+@interface Xxhash () <RCTTurboModule, RCTTurboModuleWithJSIBindings>
+@end
+
+@implementation Xxhash
+RCT_EXPORT_MODULE(xxhash)
+
+@synthesize bridge = _bridge;
+@synthesize methodQueue = _methodQueue;
+
++ (BOOL)requiresMainQueueSetup {
+  return YES;
+}
+
+// New Architecture / bridgeless: route through the TurboModule path so RN calls
+// installJSIBindingsWithRuntime: below. Without getTurboModule: this stays a
+// legacy bridge module and the JSI-install hook is never invoked (it only fires
+// inside the `respondsToSelector:@selector(getTurboModule:)` branch of
+// RCTTurboModuleManager). A generic ObjCTurboModule is enough — the only thing
+// we need is the install hook to receive the live runtime.
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params {
+	return std::make_shared<facebook::react::ObjCTurboModule>(params);
+}
+
+// Installs __xxhash128 / __xxhash64 with the live jsi::Runtime, WITHOUT depending
+// on [RCTBridge currentBridge] — which is nil under bridgeless (RN 0.85), leaving
+// the globals uninstalled and making hash128()/hash64() throw "undefined is not
+// a function".
+- (void)installJSIBindingsWithRuntime:(facebook::jsi::Runtime &)runtime
+                          callInvoker:(const std::shared_ptr<facebook::react::CallInvoker> &)callinvoker {
+	xxhash::install(&runtime);
+}
+
+RCT_EXPORT_BLOCKING_SYNCHRONOUS_METHOD(install){
+	NSLog(@"Installing JSI bindings for xxhash ...");
+	RCTBridge* bridge = [RCTBridge currentBridge];
+	RCTCxxBridge* cxxBridge = (RCTCxxBridge*)bridge;
+
+	if (cxxBridge == nil) {
+		return @false;
+	}
+
+	auto jsiRuntime = (jsi::Runtime*) cxxBridge.runtime;
+	if (jsiRuntime == nil) {
+		return @false;
+	}
+
+	xxhash::install(jsiRuntime);
+
+	return @true;
+}
+
+
+@end

package/lib/commonjs/index.js

@@ -0,0 +1,78 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.hash64 = exports.hash128 = void 0;
+var _reactNative = require("react-native");
+let xxhashModule = globalThis.__xxhash128;
+if (!xxhashModule) {
+  // Referencing NativeModules.xxhash instantiates the module. Under the New
+  // Architecture (RN 0.85 bridgeless) that triggers the native
+  // installJSIBindingsWithRuntime hook, which installs __xxhash128/__xxhash64 —
+  // so the legacy install() is gone (and calling it would throw "undefined is
+  // not a function"). Only call install() when it actually exists (old arch).
+  if (_reactNative.NativeModules.xxhash) {
+    if (typeof _reactNative.NativeModules.xxhash.install === 'function') {
+      _reactNative.NativeModules.xxhash.install();
+    }
+    xxhashModule = globalThis.__xxhash128;
+  }
+}
+
+/**
+ * Hashes the input string using the xxhash128 algorithm.
+ * This function provides a fast and deterministic 128-bit hash for a given string input.
+ * 
+ * @param {string} input - The string to hash.
+ * @returns {string} The hashed string as a hexadecimal representation of the 128-bit hash.
+ * @throws {Error} If the input is not provided.
+ * @throws {Error} If the input is not of type string.
+ * 
+ * @example
+ * const result = hash128("hello world");
+ * console.log(result); // Example output: "3a2b9e6a2b5e7e5a9e6a2b5e7e5a2a2"
+ * 
+ * @description
+ * This function uses the xxhash128 algorithm, which provides a larger hash size (128-bit) compared to xxhash64.
+ * It is ideal for scenarios where a reduced collision risk is critical, such as in distributed systems or when hashing larger datasets.
+ */
+const hash128 = input => {
+  if (!input) {
+    throw new Error('Input is required');
+  }
+  if (typeof input !== 'string') {
+    throw new Error('Input must be a string');
+  }
+  return globalThis.__xxhash128(input);
+};
+
+/**
+ * Hashes the input string using the xxhash64 algorithm.
+ * This function provides a fast and deterministic 64-bit hash for a given string input.
+ * 
+ * @param {string} input - The string to hash.
+ * @returns {string} The hashed string as a hexadecimal representation of the 64-bit hash.
+ * @throws {Error} If the input is not provided.
+ * @throws {Error} If the input is not of type string.
+ * 
+ * @example
+ * const result = hash64("hello world");
+ * console.log(result); // Example output: "9e6a2b5e7e5a2a2e"
+ * 
+ * @description
+ * This function uses the xxhash64 algorithm, known for its high performance and low collision rate.
+ * It is ideal for hashing small to medium-sized strings.
+ */
+exports.hash128 = hash128;
+const hash64 = input => {
+  if (!input) {
+    throw new Error('Input is required');
+  }
+  if (typeof input !== 'string') {
+    throw new Error('Input must be a string');
+  }
+  return globalThis.__xxhash64(input);
+};
+exports.hash64 = hash64;
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +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":[]}

package/lib/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/module/index.js

@@ -0,0 +1,71 @@
+"use strict";
+
+import { NativeModules } from 'react-native';
+let xxhashModule = globalThis.__xxhash128;
+if (!xxhashModule) {
+  // New Architecture (RN 0.85 bridgeless): the native installJSIBindingsWithRuntime
+  // hook installs __xxhash128/__xxhash64, and the legacy install() is gone
+  // (calling it throws "undefined is not a function"). Guard it.
+  if (NativeModules.xxhash) {
+    if (typeof NativeModules.xxhash.install === 'function') {
+      NativeModules.xxhash.install();
+    }
+    xxhashModule = globalThis.__xxhash128;
+  }
+}
+
+/**
+ * Hashes the input string using the xxhash128 algorithm.
+ * This function provides a fast and deterministic 128-bit hash for a given string input.
+ * 
+ * @param {string} input - The string to hash.
+ * @returns {string} The hashed string as a hexadecimal representation of the 128-bit hash.
+ * @throws {Error} If the input is not provided.
+ * @throws {Error} If the input is not of type string.
+ * 
+ * @example
+ * const result = hash128("hello world");
+ * console.log(result); // Example output: "3a2b9e6a2b5e7e5a9e6a2b5e7e5a2a2"
+ * 
+ * @description
+ * This function uses the xxhash128 algorithm, which provides a larger hash size (128-bit) compared to xxhash64.
+ * It is ideal for scenarios where a reduced collision risk is critical, such as in distributed systems or when hashing larger datasets.
+ */
+export const hash128 = input => {
+  if (!input) {
+    throw new Error('Input is required');
+  }
+  if (typeof input !== 'string') {
+    throw new Error('Input must be a string');
+  }
+  return globalThis.__xxhash128(input);
+};
+
+/**
+ * Hashes the input string using the xxhash64 algorithm.
+ * This function provides a fast and deterministic 64-bit hash for a given string input.
+ * 
+ * @param {string} input - The string to hash.
+ * @returns {string} The hashed string as a hexadecimal representation of the 64-bit hash.
+ * @throws {Error} If the input is not provided.
+ * @throws {Error} If the input is not of type string.
+ * 
+ * @example
+ * const result = hash64("hello world");
+ * console.log(result); // Example output: "9e6a2b5e7e5a2a2e"
+ * 
+ * @description
+ * This function uses the xxhash64 algorithm, known for its high performance and low collision rate.
+ * It is ideal for hashing small to medium-sized strings.
+ */
+
+export const hash64 = input => {
+  if (!input) {
+    throw new Error('Input is required');
+  }
+  if (typeof input !== 'string') {
+    throw new Error('Input must be a string');
+  }
+  return globalThis.__xxhash64(input);
+};
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +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":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/index.d.ts

@@ -0,0 +1,41 @@
+declare global {
+    var __xxhash128: (input: string) => string;
+    var __xxhash64: (input: string) => string;
+}
+/**
+ * Hashes the input string using the xxhash128 algorithm.
+ * This function provides a fast and deterministic 128-bit hash for a given string input.
+ *
+ * @param {string} input - The string to hash.
+ * @returns {string} The hashed string as a hexadecimal representation of the 128-bit hash.
+ * @throws {Error} If the input is not provided.
+ * @throws {Error} If the input is not of type string.
+ *
+ * @example
+ * const result = hash128("hello world");
+ * console.log(result); // Example output: "3a2b9e6a2b5e7e5a9e6a2b5e7e5a2a2"
+ *
+ * @description
+ * This function uses the xxhash128 algorithm, which provides a larger hash size (128-bit) compared to xxhash64.
+ * It is ideal for scenarios where a reduced collision risk is critical, such as in distributed systems or when hashing larger datasets.
+ */
+export declare const hash128: (input: string) => string;
+/**
+ * Hashes the input string using the xxhash64 algorithm.
+ * This function provides a fast and deterministic 64-bit hash for a given string input.
+ *
+ * @param {string} input - The string to hash.
+ * @returns {string} The hashed string as a hexadecimal representation of the 64-bit hash.
+ * @throws {Error} If the input is not provided.
+ * @throws {Error} If the input is not of type string.
+ *
+ * @example
+ * const result = hash64("hello world");
+ * console.log(result); // Example output: "9e6a2b5e7e5a2a2e"
+ *
+ * @description
+ * This function uses the xxhash64 algorithm, known for its high performance and low collision rate.
+ * It is ideal for hashing small to medium-sized strings.
+ */
+export declare const hash64: (input: string) => string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,192 @@
+{
+  "name": "@javascriptcommon/react-native-xxhash",
+  "version": "0.1.9",
+  "description": "💪 react-native-xxhash fork with New Architecture / bridgeless (RN 0.85+) JSI install fix (iOS + Android). 💪 A high-performance React Native library for generating xxHash hashes using C++ and JSI",
+  "main": "./lib/commonjs/index.js",
+  "module": "./lib/module/index.js",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "src/index",
+  "source": "./src/index",
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-xxhash-example",
+    "test": "jest",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "release": "release-it"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "xxhash",
+    "hash",
+    "fast",
+    "xxhash3",
+    "react-native-xxhash",
+    "react-native-xxhash3",
+    "xxhash3-react-native",
+    "react-native-hash",
+    "hash-react-native",
+    "hash-xxhash",
+    "jsi",
+    "cpp",
+    "react-native-jsi",
+    "fast-hash",
+    "quick-hash",
+    "react-native-quick-hash",
+    "react-native-fast-hash",
+    "react-native-xxhash-jsi",
+    "react-native-xxhash-cpp",
+    "react-native-xxhash3-jsi",
+    "react-native-xxhash3-cpp"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pioner92/react-native-xxhash"
+  },
+  "author": "pioner921227 <alex.shumihin921227@gmail.com> (https://github.com/pioner92/react-native-xxhash)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/pioner92/react-native-xxhash/issues"
+  },
+  "homepage": "https://github.com/pioner92/react-native-xxhash#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^17.0.2",
+    "@evilmartians/lefthook": "^1.5.0",
+    "@react-native-community/cli": "15.0.1",
+    "@react-native/eslint-config": "^0.73.1",
+    "@release-it/conventional-changelog": "^9.0.2",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/release-notes-generator": "^14.0.3",
+    "@types/jest": "^29.5.5",
+    "@types/react": "^18.2.44",
+    "@types/react-native": "^0.65.5",
+    "@typescript-eslint/eslint-plugin": "^4.33.0",
+    "commitlint": "^17.0.2",
+    "del-cli": "^5.1.0",
+    "eslint": "^8.51.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-prettier": "^5.0.1",
+    "jest": "^29.7.0",
+    "prettier": "^3.0.3",
+    "react": "18.3.1",
+    "react-native": "0.76.6",
+    "react-native-builder-bob": "^0.35.2",
+    "release-it": "^17.10.0",
+    "typescript": "5.0.4"
+  },
+  "resolutions": {
+    "@types/react": "^18.2.44"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@3.6.1",
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": "angular"
+      }
+    }
+  },
+  "eslintConfig": {
+    "root": true,
+    "extends": [
+      "@react-native",
+      "prettier"
+    ],
+    "rules": {
+      "react/react-in-jsx-scope": "off",
+      "prettier/prettier": [
+        "error",
+        {
+          "quoteProps": "consistent",
+          "singleQuote": true,
+          "tabWidth": 2,
+          "trailingComma": "es5",
+          "useTabs": false
+        }
+      ]
+    }
+  },
+  "eslintIgnore": [
+    "node_modules/",
+    "lib/"
+  ],
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "create-react-native-library": {
+    "type": "legacy-module",
+    "languages": "cpp",
+    "version": "0.45.5"
+  }
+}

package/react-native-xxhash.podspec

@@ -0,0 +1,41 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+folly_compiler_flags = '-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32'
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-xxhash"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://google.com.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm}", "cpp/**/*.{hpp,cpp,c,h}"
+
+  # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
+  # See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
+  if respond_to?(:install_modules_dependencies, true)
+    install_modules_dependencies(s)
+  else
+    s.dependency "React-Core"
+
+    # Don't install the dependencies when we run `pod install` in the old architecture.
+    if ENV['RCT_NEW_ARCH_ENABLED'] == '1' then
+      s.compiler_flags = folly_compiler_flags + " -DRCT_NEW_ARCH_ENABLED=1"
+      s.pod_target_xcconfig    = {
+          "HEADER_SEARCH_PATHS" => "\"$(PODS_ROOT)/boost\"",
+          "OTHER_CPLUSPLUSFLAGS" => "-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1",
+          "CLANG_CXX_LANGUAGE_STANDARD" => "c++17"
+      }
+      s.dependency "React-Codegen"
+      s.dependency "RCT-Folly"
+      s.dependency "RCTRequired"
+      s.dependency "RCTTypeSafety"
+      s.dependency "ReactCommon/turbomodule/core"
+    end
+  end
+end

package/src/index.tsx

@@ -0,0 +1,82 @@
+import {NativeModules} from 'react-native'
+declare global {
+  var __xxhash128: (input: string) => string;
+  var __xxhash64: (input: string) => string;
+}
+
+
+let xxhashModule = globalThis.__xxhash128;
+
+if(!xxhashModule){
+  // Referencing NativeModules.xxhash instantiates the module. Under the New
+  // Architecture (RN 0.85 bridgeless) that triggers the native
+  // installJSIBindingsWithRuntime hook, which installs __xxhash128/__xxhash64 —
+  // so the legacy install() no longer exists (calling it throws "undefined is
+  // not a function"). Only call install() when it actually exists (old arch).
+  if(NativeModules.xxhash){
+    if(typeof NativeModules.xxhash.install === 'function'){
+      NativeModules.xxhash.install();
+    }
+    xxhashModule = globalThis.__xxhash128;
+  }
+}
+
+
+/**
+ * Hashes the input string using the xxhash128 algorithm.
+ * This function provides a fast and deterministic 128-bit hash for a given string input.
+ * 
+ * @param {string} input - The string to hash.
+ * @returns {string} The hashed string as a hexadecimal representation of the 128-bit hash.
+ * @throws {Error} If the input is not provided.
+ * @throws {Error} If the input is not of type string.
+ * 
+ * @example
+ * const result = hash128("hello world");
+ * console.log(result); // Example output: "3a2b9e6a2b5e7e5a9e6a2b5e7e5a2a2"
+ * 
+ * @description
+ * This function uses the xxhash128 algorithm, which provides a larger hash size (128-bit) compared to xxhash64.
+ * It is ideal for scenarios where a reduced collision risk is critical, such as in distributed systems or when hashing larger datasets.
+ */
+ export const hash128 = (input: string): string => {
+  if(!input){
+    throw new Error('Input is required');
+  }
+
+  if(typeof input !== 'string'){
+    throw new Error('Input must be a string');
+  }
+
+  return globalThis.__xxhash128(input);
+ }   
+
+/**
+ * Hashes the input string using the xxhash64 algorithm.
+ * This function provides a fast and deterministic 64-bit hash for a given string input.
+ * 
+ * @param {string} input - The string to hash.
+ * @returns {string} The hashed string as a hexadecimal representation of the 64-bit hash.
+ * @throws {Error} If the input is not provided.
+ * @throws {Error} If the input is not of type string.
+ * 
+ * @example
+ * const result = hash64("hello world");
+ * console.log(result); // Example output: "9e6a2b5e7e5a2a2e"
+ * 
+ * @description
+ * This function uses the xxhash64 algorithm, known for its high performance and low collision rate.
+ * It is ideal for hashing small to medium-sized strings.
+ */
+
+ export const hash64 = (input: string): string => {
+  if(!input){
+    throw new Error('Input is required');
+  }
+
+  if(typeof input !== 'string'){
+    throw new Error('Input must be a string');
+  }
+
+  return globalThis.__xxhash64(input);
+ }