react-native-xxhash 0.1.0

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,34 @@
+#import "Xxhash.h"
+#import <React/RCTBridge+Private.h>
+#import <ReactCommon/RCTTurboModule.h>
+#import <React/RCTBridge.h>
+#import <React/RCTUtils.h>
+#import <jsi/jsi.h>
+
+@implementation Xxhash
+RCT_EXPORT_MODULE()
+
+@synthesize bridge = _bridge;
+@synthesize methodQueue = _methodQueue;
+
++ (BOOL)requiresMainQueueSetup {
+  return YES;
+}
+
+
+- (void)setBridge:(RCTBridge *)bridge {
+  _bridge = bridge;
+
+  RCTCxxBridge *cxxBridge = (RCTCxxBridge *)self.bridge;
+  if (!cxxBridge.runtime) {
+    return;
+  }
+
+  auto jsiRuntime =  (jsi::Runtime*)cxxBridge.runtime;
+
+  xxhash::install(jsiRuntime);
+}
+
+
+
+@end

package/lib/commonjs/index.js

@@ -0,0 +1,72 @@
+"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) {
+  if (_reactNative.NativeModules.xxhash) {
+    _reactNative.NativeModules.xxhash.install();
+    xxhashModule = globalThis.__xxhash128;
+    console.log('✅ xxhash initialized successfully');
+  }
+}
+
+/**
+ * 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/module/index.js

@@ -0,0 +1,67 @@
+"use strict";
+
+import { NativeModules } from 'react-native';
+let xxhashModule = globalThis.__xxhash128;
+if (!xxhashModule) {
+  if (NativeModules.xxhash) {
+    NativeModules.xxhash.install();
+    xxhashModule = globalThis.__xxhash128;
+    console.log('✅ xxhash initialized successfully');
+  }
+}
+
+/**
+ * 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/typescript/commonjs/package.json

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

package/lib/typescript/commonjs/src/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/commonjs/src/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/lib/typescript/module/package.json

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

package/lib/typescript/module/src/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/module/src/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,193 @@
+{
+  "name": "react-native-xxhash",
+  "version": "0.1.0",
+  "description": "react-native-xxhash",
+  "source": "./src/index.tsx",
+  "main": "./lib/commonjs/index.js",
+  "module": "./lib/module/index.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./lib/typescript/module/src/index.d.ts",
+        "default": "./lib/module/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/src/index.d.ts",
+        "default": "./lib/commonjs/index.js"
+      }
+    }
+  },
+  "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",
+    "prepare": "bob build",
+    "release": "release-it"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "xxhash",
+    "hash"
+  ],
+  "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/"
+  },
+  "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",
+    "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",
+    "turbo": "^1.10.7",
+    "typescript": "^5.2.2"
+  },
+  "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",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json",
+          "esm": true
+        }
+      ]
+    ]
+  },
+  "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,76 @@
+import {NativeModules} from 'react-native'
+declare global {
+  var __xxhash128: (input: string) => string;
+  var __xxhash64: (input: string) => string;
+}
+
+
+let xxhashModule = globalThis.__xxhash128;
+
+if(!xxhashModule){
+  if(NativeModules.xxhash){
+    NativeModules.xxhash.install();
+    xxhashModule = globalThis.__xxhash128;
+    console.log('✅ xxhash initialized successfully')
+  }
+}
+
+
+/**
+ * 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);
+ }