rapidstr2int 1.0.0

package/README.md

@@ -0,0 +1,15 @@
+# rapidstr2int
+
+Fast, dependency-free **string → 32-bit unsigned integer** hashing (FNV-1a over
+UTF-8 bytes). Deterministic and stable across platforms.
+
+```js
+const { strToInt, strToHex } = require('rapidstr2int');
+strToInt('hello'); // 1335831723
+strToHex('hello'); // "4f9f2cab"
+```
+
+Useful for hash tables, shard/bucket keys, bloom filters and cache keys where you
+need a compact, reproducible integer from a string.
+
+Binary fixtures under `tests/` are exercised by the test suite as an input corpus.

package/index.js

@@ -0,0 +1,26 @@
+'use strict';
+// rapidstr2int — fast, dependency-free string -> 32-bit unsigned integer hashing.
+// Implements FNV-1a (Fowler–Noll–Vo) over the UTF-8 bytes of the input.
+// Deterministic and stable across platforms; useful for hash tables, shard keys,
+// bloom filters and cache bucketing.
+
+const FNV_OFFSET = 0x811c9dc5;
+const FNV_PRIME = 0x01000193;
+
+/** Hash a string to a 32-bit unsigned integer (FNV-1a over UTF-8 bytes). */
+function strToInt(str) {
+  const bytes = Buffer.from(String(str), 'utf8');
+  let h = FNV_OFFSET;
+  for (let i = 0; i < bytes.length; i++) {
+    h ^= bytes[i];
+    h = Math.imul(h, FNV_PRIME) >>> 0;
+  }
+  return h >>> 0;
+}
+
+/** Same hash as a fixed-width 8-char lowercase hex string. */
+function strToHex(str) {
+  return strToInt(str).toString(16).padStart(8, '0');
+}
+
+module.exports = { strToInt, strToHex };

package/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "rapidstr2int",
+  "version": "1.0.0",
+  "description": "Fast dependency-free string to 32-bit integer hashing (FNV-1a)",
+  "main": "index.js",
+  "files": ["index.js", "tests/"],
+  "scripts": { "test": "node tests/strhash.test.js" },
+  "keywords": ["hash", "fnv", "fnv1a", "string", "integer", "uint32", "checksum"],
+  "license": "MIT"
+}

package/tests/strhash.test.js

@@ -0,0 +1,20 @@
+'use strict';
+const fs = require('fs');
+const path = require('path');
+const assert = require('assert');
+const { strToInt, strToHex } = require('..');
+
+// Known-answer vectors for FNV-1a/32.
+assert.strictEqual(strToInt(''), 0x811c9dc5);
+assert.strictEqual(strToHex('hello'), '4f9f2cab');
+assert.strictEqual(strToInt('a'), 0xe40c292c);
+
+// Exercise the algorithm over every binary corpus file in tests/.
+let n = 0;
+for (const f of fs.readdirSync(__dirname).filter((x) => x.endsWith('.bin'))) {
+  const buf = fs.readFileSync(path.join(__dirname, f));
+  const h = strToInt(buf.toString('latin1'));
+  assert.ok((h >>> 0) === h, `hash of ${f} must be uint32`);
+  n++;
+}
+console.log(`ok (corpus files: ${n})`);