crc32-rs 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Mahmoud Harmouch
+
+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,170 @@
+<div align="center">
+
+# CRC32
+
+[![CRC32-V2 Logo](assets/logo.png)](https://github.com/wiseaidotdev/crc32-v2)
+
+[![Crates.io](https://img.shields.io/crates/v/crc32-v2.svg)](https://crates.io/crates/crc32-v2)
+[![Docs.rs](https://docs.rs/crc32-v2/badge.svg)](https://docs.rs/crc32-v2)
+[![npm](https://img.shields.io/npm/v/crc32-rs.svg)](https://www.npmjs.com/package/crc32-rs)
+[![PyPI](https://img.shields.io/pypi/v/crc32-rs.svg)](https://pypi.org/project/crc32-rs)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+> `crc32-v2` is a multi-language toolkit providing the fastest port of the CRC-32 algorithm from zlib to Rust, with zero-dependency Python and Node.js native bindings 🗿.
+
+Resurrecting the [`crc32`](https://crates.io/crates/crc32) crate from the ashes.
+
+|                  🦀 Rust                  |                                   🐍 Python                                    |                                 🟩 Node.js                                 |
+| :---------------------------------------: | :----------------------------------------------------------------------------: | :------------------------------------------------------------------------: |
+|           `cargo add crc32-v2`            |                             `pip install crc32-rs`                             |                           `npm install crc32-rs`                           |
+| [Documentation](https://docs.rs/crc32-v2) | [Read PYTHON.md](https://github.com/wiseaidotdev/crc32-v2/blob/main/PYTHON.md) | [Read NODE.md](https://github.com/wiseaidotdev/crc32-v2/blob/main/NODE.md) |
+
+</div>
+
+### Features
+
+- **Standard byte-at-a-time `crc32`**: compatible with zlib, PKZIP, Ethernet, FDDI
+- **Four-bytes-at-a-time `crc32_little`**: slicing-by-4, ~2-4x higher throughput on large inputs
+- **Big-endian `crc32_big`**: interoperable with big-endian hardware CRC devices
+- **Streaming `Digest`**: incremental checksum without buffering the entire payload
+- **`crc32_combine`**: merge two independently computed CRCs in O(log n) time
+- **Python bindings**: via PyO3 / maturin (`pip install crc32-rs`)
+- **Node.js bindings**: via napi-rs (`npm install crc32-rs`)
+
+## Rust Usage
+
+Add to your `Cargo.toml`:
+
+```toml
+[dependencies]
+crc32-v2 = "0.1.0"
+```
+
+Or run:
+
+```sh
+cargo add crc32-v2
+```
+
+### One-shot checksum
+
+```rust
+use crc32_v2::crc32;
+
+fn main() {
+    let data = b"Hello, world!";
+    println!("CRC-32: {:#010X}", crc32(0, data));  // CRC-32: 0xEBE6C6E6
+}
+```
+
+### Four-bytes-at-a-time (higher throughput)
+
+```rust
+use crc32_v2::byfour::crc32_little;
+
+fn main() {
+    let data = b"Hello, world!";
+    println!("CRC-32 (little): {:#010X}", crc32_little(0, data));  // CRC-32 (little): 0xEBE6C6E6
+}
+```
+
+### Streaming checksum via `Digest`
+
+```rust
+use crc32_v2::Digest;
+
+fn main() {
+    let mut digest = Digest::new();
+    digest.update(b"Hello, ");
+    digest.update(b"world!");
+    println!("CRC-32: {:#010X}", digest.finalize());  // CRC-32: 0xEBE6C6E6
+}
+```
+
+### Combining two checksums
+
+```rust
+use crc32_v2::{crc32, crc32_combine};
+
+fn main() {
+    let crc1 = crc32(0, b"Hello, ");
+    let crc2 = crc32(0, b"world!");
+    let combined = crc32_combine(crc1, crc2, b"world!".len() as u64);
+    assert_eq!(combined, crc32(0, b"Hello, world!"));
+    println!("Combined: {:#010X}", combined); // Combined: 0xEBE6C6E6
+}
+```
+
+## Python Usage
+
+See [PYTHON.md](PYTHON.md) for full documentation.
+
+```sh
+pip install crc32-rs
+```
+
+```python
+from crc32_rs import crc32, crc32_little, Digest
+
+print(hex(crc32(b"Hello, world!")))           # 0xebe6c6e6
+print(hex(crc32_little(b"Hello, world!")))    # 0xebe6c6e6
+
+d = Digest()
+d.update(b"Hello, ")
+d.update(b"world!")
+print(hex(d.finalize()))                       # 0xebe6c6e6
+```
+
+## Node.js Usage
+
+See [NODE.md](NODE.md) for full documentation.
+
+```sh
+npm install crc32-rs
+```
+
+```javascript
+// If installed via npm: const { crc32, crc32Little, Digest } = require('crc32-rs');
+// For local development:
+const { crc32, crc32Little, Digest } = require(".");
+
+console.log(crc32(Buffer.from("Hello, world!")).toString(16)); // ebe6c6e6
+console.log(crc32Little(Buffer.from("Hello, world!")).toString(16)); // ebe6c6e6
+
+const d = new Digest();
+d.update(Buffer.from("Hello, "));
+d.update(Buffer.from("world!"));
+console.log(d.finalize().toString(16)); // ebe6c6e6
+```
+
+## Benchmark
+
+Running `cargo bench` measures throughput across five payload sizes. Results on a typical x86-64 machine:
+
+<details>
+<summary><code>cargo bench</code></summary>
+
+| **Method**               | **1 B**             | **64 B**             | **1 KiB**           | **64 KiB**           | **1 MiB**           |
+| ------------------------ | ------------------- | -------------------- | ------------------- | -------------------- | ------------------- |
+| `crc32_v2::crc32`        | ~2.3 ns (421 MiB/s) | ~154 ns (395 MiB/s)  | ~2.8 µs (350 MiB/s) | ~178 µs (352 MiB/s)  | ~2.8 ms (352 MiB/s) |
+| `crc32_v2::crc32_little` | ~7.3 ns (131 MiB/s) | ~90.6 ns (673 MiB/s) | ~1.2 µs (814 MiB/s) | ~74.7 µs (837 MiB/s) | ~1.3 ms (771 MiB/s) |
+| `crc32_v2::crc32_big`    | ~2.6 ns (371 MiB/s) | ~175 ns (350 MiB/s)  | ~3.2 µs (305 MiB/s) | ~193 µs (324 MiB/s)  | ~3.1 ms (324 MiB/s) |
+| `crc32_v2::Digest`       | ~2.2 ns (439 MiB/s) | ~155 ns (393 MiB/s)  | ~2.7 µs (357 MiB/s) | ~173 µs (361 MiB/s)  | ~2.7 ms (364 MiB/s) |
+| `crc32fast::hash`        | ~10 ns (96 MiB/s)   | ~20 ns (3.0 GiB/s)   | ~105 ns (9.3 GiB/s) | ~5.4 µs (11.6 GiB/s) | ~86 µs (11.6 GiB/s) |
+| `crc32fast::Hasher`      | ~15 ns (64 MiB/s)   | ~36 ns (1.7 GiB/s)   | ~108 ns (9.0 GiB/s) | ~5.5 µs (11.5 GiB/s) | ~87 µs (11.5 GiB/s) |
+
+</details>
+
+> **Key takeaways**
+>
+> - `crc32_little` achieves ~800 MiB/s throughput for large inputs, making it over 2x faster than the simple byte-at-a-time `crc32` (~350 MiB/s), thanks to the slicing-by-4 algorithm. For tiny inputs (< 16 B), `crc32` is marginally faster due to lower alignment overhead.
+> - `crc32_big` falls back to a byte-at-a-time loop and achieves similar throughput to `crc32` (~320 MiB/s).
+> - `crc32fast` achieves ~11.6 GiB/s on x86-64 because it uses runtime-detected SIMD hardware acceleration (`pclmulqdq`). For maximum raw throughput on known hardware, prefer `crc32fast`. For pure portability, full control, or embedding in a `no_std` context without CPU feature detection overhead, use `crc32-v2`.
+
+## See Also
+
+- [A Painless Guide to CRC Error Detection Algorithms](https://www.zlib.net/crc_v3.txt) - the canonical reference for this algorithm.
+- [zlib - crc32.c](https://github.com/madler/zlib/blob/master/crc32.c) - the C implementation this crate is ported from.
+- [`crc32fast`](https://docs.rs/crc32fast) - SIMD-accelerated CRC-32 for Rust.
+- [`crc`](https://docs.rs/crc) - generic CRC computation for many widths and polynomials.
+- [IEEE 802.3 CRC-32](https://en.wikipedia.org/wiki/Cyclic_redundancy_check) - Wikipedia overview.

package/index.d.ts

@@ -0,0 +1,89 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+/**
+ * A streaming CRC-32 digest.
+ *
+ * Computes a CRC-32 checksum incrementally over multiple ``Buffer`` slices.
+ * The result is identical to computing the CRC over the concatenation of all
+ * buffers in one shot.
+ *
+ * ```javascript
+ * const { Digest } = require('.');
+ * const d = new Digest();
+ * d.update(Buffer.from('Hello, '));
+ * d.update(Buffer.from('world!'));
+ * console.log(d.finalize().toString(16));  // ebe6c6e6
+ * ```
+ *
+ * See Also: ``crc32()``, ``crc32Combine()``.
+ */
+export declare class Digest {
+  /**
+   * Create a new ``Digest`` starting from CRC value ``0``.
+   *
+   * ``initialCrc``: Optional starting CRC value (default ``0``).
+   */
+  constructor(initialCrc?: number | undefined | null)
+  /**
+   * Feed more bytes into the running checksum.
+   *
+   * ``data``: A ``Buffer`` to incorporate into the running CRC.
+   */
+  update(data: Buffer): void
+  /**
+   * Return the current CRC-32 checksum as an unsigned 32-bit integer.
+   *
+   * Does **not** reset the digest; further ``update()`` calls continue
+   * from the current state.
+   */
+  finalize(): number
+  /** Reset the digest to CRC ``0``. */
+  reset(): void
+}
+export type NapiDigest = Digest
+
+/**
+ * Calculates the CRC-32 checksum of `data`.
+ *
+ * Compatible with zlib, PKZIP, Ethernet, and FDDI.
+ *
+ * ``data``       : `Buffer` to checksum.
+ * ``initialCrc`` : Optional starting CRC value (default ``0``). Pass a
+ *                   previous result to chain multiple buffers.
+ *
+ * Returns an unsigned 32-bit integer.
+ *
+ * See [A Painless Guide to CRC Error Detection Algorithms](https://www.zlib.net/crc_v3.txt).
+ */
+export declare function crc32(data: Buffer, initialCrc?: number | undefined | null): number
+
+/**
+ * Calculates the CRC-32 checksum using the big-endian variant.
+ *
+ * ``data``       : `Buffer` to checksum.
+ * ``initialCrc`` : Optional starting CRC value (default ``0``).
+ *
+ * Returns an unsigned 32-bit integer.
+ */
+export declare function crc32Big(data: Buffer, initialCrc?: number | undefined | null): number
+
+/**
+ * Combines two CRC-32 values computed over adjacent byte sequences.
+ *
+ * ``crc1``: CRC-32 of the first sequence.
+ * ``crc2``: CRC-32 of the second sequence.
+ * ``len2``: Byte length of the second sequence.
+ *
+ * Returns the CRC-32 of the concatenation as an unsigned 32-bit integer.
+ */
+export declare function crc32Combine(crc1: number, crc2: number, len2: number): number
+
+/**
+ * Calculates the CRC-32 checksum using the four-bytes-at-a-time little-endian variant.
+ *
+ * ``data``       : `Buffer` to checksum.
+ * ``initialCrc`` : Optional starting CRC value (default ``0``).
+ *
+ * Returns an unsigned 32-bit integer.
+ */
+export declare function crc32Little(data: Buffer, initialCrc?: number | undefined | null): number

package/index.js

@@ -0,0 +1,708 @@
+// prettier-ignore
+/* eslint-disable */
+// @ts-nocheck
+/* auto-generated by NAPI-RS */
+
+const { readFileSync } = require('fs')
+let nativeBinding = null
+const loadErrors = []
+
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
+
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
+
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  let report = null
+  if (process.report && typeof process.report.getReport === 'function') {
+    process.report.excludeNetwork = true
+    report = process.report.getReport()
+  }
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
+      return true
+    }
+  }
+  return false
+}
+
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
+  }
+}
+
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (err) {
+      loadErrors.push(err)
+    }
+  } else if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./crc32.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-android-arm64')
+        const bindingPackageVersion = require('crc32-rs-android-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./crc32.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-android-arm-eabi')
+        const bindingPackageVersion = require('crc32-rs-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      if ((process.config && process.config.variables && process.config.variables.shlib_suffix === 'dll.a') || (process.config && process.config.variables && process.config.variables.node_target_type === 'shared_library')) {
+        try {
+        return require('./crc32.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-win32-x64-gnu')
+        const bindingPackageVersion = require('crc32-rs-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./crc32.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-win32-x64-msvc')
+        const bindingPackageVersion = require('crc32-rs-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      }
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./crc32.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-win32-ia32-msvc')
+        const bindingPackageVersion = require('crc32-rs-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./crc32.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-win32-arm64-msvc')
+        const bindingPackageVersion = require('crc32-rs-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+      return require('./crc32.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('crc32-rs-darwin-universal')
+      const bindingPackageVersion = require('crc32-rs-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      }
+      return binding
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    if (process.arch === 'x64') {
+      try {
+        return require('./crc32.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-darwin-x64')
+        const bindingPackageVersion = require('crc32-rs-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./crc32.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-darwin-arm64')
+        const bindingPackageVersion = require('crc32-rs-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./crc32.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-freebsd-x64')
+        const bindingPackageVersion = require('crc32-rs-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./crc32.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-freebsd-arm64')
+        const bindingPackageVersion = require('crc32-rs-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
+        try {
+          return require('./crc32.linux-x64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('crc32-rs-linux-x64-musl')
+          const bindingPackageVersion = require('crc32-rs-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./crc32.linux-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('crc32-rs-linux-x64-gnu')
+          const bindingPackageVersion = require('crc32-rs-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
+        try {
+          return require('./crc32.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('crc32-rs-linux-arm64-musl')
+          const bindingPackageVersion = require('crc32-rs-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./crc32.linux-arm64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('crc32-rs-linux-arm64-gnu')
+          const bindingPackageVersion = require('crc32-rs-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./crc32.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('crc32-rs-linux-arm-musleabihf')
+          const bindingPackageVersion = require('crc32-rs-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./crc32.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('crc32-rs-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('crc32-rs-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./crc32.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('crc32-rs-linux-loong64-musl')
+          const bindingPackageVersion = require('crc32-rs-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./crc32.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('crc32-rs-linux-loong64-gnu')
+          const bindingPackageVersion = require('crc32-rs-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./crc32.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('crc32-rs-linux-riscv64-musl')
+          const bindingPackageVersion = require('crc32-rs-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./crc32.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('crc32-rs-linux-riscv64-gnu')
+          const bindingPackageVersion = require('crc32-rs-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./crc32.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-linux-ppc64-gnu')
+        const bindingPackageVersion = require('crc32-rs-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./crc32.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-linux-s390x-gnu')
+        const bindingPackageVersion = require('crc32-rs-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
+    }
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./crc32.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-openharmony-arm64')
+        const bindingPackageVersion = require('crc32-rs-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'x64') {
+      try {
+        return require('./crc32.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-openharmony-x64')
+        const bindingPackageVersion = require('crc32-rs-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./crc32.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('crc32-rs-openharmony-arm')
+        const bindingPackageVersion = require('crc32-rs-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
+    }
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+function createLoadErrorChain(errors) {
+  return errors.reduce((previous, current) => {
+    let message
+    try {
+      message =
+        current && typeof current.message === 'string'
+          ? current.message
+          : String(current)
+    } catch {
+      message = 'Unknown error'
+    }
+    const error = new Error(message)
+    error.cause = previous
+    return error
+  }, null)
+}
+
+// NAPI_RS_FORCE_WASI is a tri-state flag:
+//   unset / any other value → native binding preferred, WASI is only a fallback
+//   'true'                   → prefer WASI, but retain native as a lazy fallback
+//   'error'                  → require WASI without initializing a native fallback
+// Treating any non-empty string as truthy (the historical behavior) meant
+// NAPI_RS_FORCE_WASI=false, NAPI_RS_FORCE_WASI=0, etc. inadvertently triggered
+// the WASI path, causing ENOENT for packages shipped without a .wasi.cjs file.
+//
+// NAPI_RS_WASI_FLAVOR selects one exact generated flavor and implies strict
+// WASI loading. It never crosses into another flavor or falls back to native.
+const __napiWasiFlavors = ["wasm32-wasi"]
+const __napiWasiFlavor = process.env.NAPI_RS_WASI_FLAVOR
+const __napiWasiFlavorRequested =
+  typeof __napiWasiFlavor === 'string' && __napiWasiFlavor.length > 0
+if (
+  __napiWasiFlavorRequested &&
+  __napiWasiFlavors.indexOf(__napiWasiFlavor) === -1
+) {
+  throw new Error(
+    'Unsupported WASI flavor "' +
+      __napiWasiFlavor +
+      '". Available flavors: ' +
+      __napiWasiFlavors.join(', '),
+  )
+}
+const forceWasiError = process.env.NAPI_RS_FORCE_WASI === 'error'
+const forceWasi =
+  process.env.NAPI_RS_FORCE_WASI === 'true' ||
+  forceWasiError ||
+  __napiWasiFlavorRequested
+
+if (!forceWasi) {
+  nativeBinding = requireNative()
+}
+
+if (!nativeBinding || forceWasi) {
+  let wasiBinding = null
+  let wasiBindingLoaded = false
+  const wasiBindingErrors = []
+  const __napiWasiResolveCandidate = (specifier, isPackage, localArtifacts) => {
+    try {
+      require.resolve(specifier)
+    } catch (resolveError) {
+      if (!resolveError || resolveError.code !== 'MODULE_NOT_FOUND') {
+        throw resolveError
+      }
+      if (isPackage) {
+        try {
+          require.resolve(specifier + '/package.json')
+        } catch (packageError) {
+          if (packageError && packageError.code === 'MODULE_NOT_FOUND') {
+            return resolveError
+          }
+          // An exports restriction proves the package exists even when its
+          // package.json is not public. Preserve the root resolution failure.
+          throw resolveError
+        }
+        // The package exists but its main/export target is broken.
+        throw resolveError
+      }
+      return resolveError
+    }
+    if (localArtifacts) {
+      let artifactError = null
+      for (let i = 0; i < localArtifacts.length; i++) {
+        try {
+          require.resolve(localArtifacts[i])
+          return null
+        } catch (resolveError) {
+          if (!resolveError || resolveError.code !== 'MODULE_NOT_FOUND') {
+            throw resolveError
+          }
+          artifactError = resolveError
+        }
+      }
+      return artifactError
+    }
+    return null
+  }
+  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === "wasm32-wasi")) {
+    let candidateError = null
+    let candidateFailed = false
+    try {
+      candidateError = __napiWasiResolveCandidate('./crc32.wasi.cjs', false, ["./crc32.wasm32-wasi.debug.wasm","./crc32.wasm32-wasi.wasm"])
+      candidateFailed = candidateError !== null
+      if (!candidateFailed) {
+        wasiBinding = require('./crc32.wasi.cjs')
+        nativeBinding = wasiBinding
+        wasiBindingLoaded = true
+      }
+    } catch (err) {
+      candidateError = err
+      candidateFailed = true
+    }
+    if (candidateFailed) {
+      wasiBindingErrors.push(candidateError)
+      loadErrors.push(candidateError)
+    }
+  }
+  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === "wasm32-wasi")) {
+    let candidateError = null
+    let candidateFailed = false
+    try {
+      candidateError = __napiWasiResolveCandidate('crc32-rs-wasm32-wasi', true, undefined)
+      candidateFailed = candidateError !== null
+      if (!candidateFailed) {
+        if (process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          const bindingPackageVersion = require('crc32-rs-wasm32-wasi/package.json').version
+          if (bindingPackageVersion !== '0.1.0') {
+            throw new Error(`WASI binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+        }
+        wasiBinding = require('crc32-rs-wasm32-wasi')
+        nativeBinding = wasiBinding
+        wasiBindingLoaded = true
+      }
+    } catch (err) {
+      candidateError = err
+      candidateFailed = true
+    }
+    if (candidateFailed) {
+      wasiBindingErrors.push(candidateError)
+      loadErrors.push(candidateError)
+    }
+  }
+  if (
+    !wasiBindingLoaded &&
+    forceWasi &&
+    !forceWasiError &&
+    !__napiWasiFlavorRequested
+  ) {
+    nativeBinding = requireNative()
+  }
+  if ((forceWasiError || __napiWasiFlavorRequested) && !wasiBindingLoaded) {
+    const error = new Error(
+      __napiWasiFlavorRequested
+        ? 'WASI binding for flavor "' + __napiWasiFlavor + '" not found'
+        : 'WASI binding not found and NAPI_RS_FORCE_WASI is set to error',
+    )
+    error.cause = createLoadErrorChain(wasiBindingErrors)
+    throw error
+  }
+}
+
+if (!nativeBinding) {
+  if (loadErrors.length > 0) {
+    const error = new Error(
+      `Cannot find native binding. ` +
+        `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
+        'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
+    )
+    // assign instead of the `new Error(message, { cause })` options form,
+    // which Node < 16.9 silently ignores
+    error.cause = createLoadErrorChain(loadErrors)
+    throw error
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+module.exports = nativeBinding
+module.exports.Digest = nativeBinding.Digest
+module.exports.NapiDigest = nativeBinding.NapiDigest
+module.exports.crc32 = nativeBinding.crc32
+module.exports.crc32Big = nativeBinding.crc32Big
+module.exports.crc32Combine = nativeBinding.crc32Combine
+module.exports.crc32Little = nativeBinding.crc32Little

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "crc32-rs",
+  "version": "0.1.0",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wiseaidev/crc32-v2.git"
+  },
+  "homepage": "https://github.com/wiseaidev/crc32-v2",
+  "bugs": {
+    "url": "https://github.com/wiseaidev/crc32-v2/issues"
+  },
+  "author": "Mahmoud Harmouch <oss@wiseai.dev>",
+  "license": "MIT",
+  "description": "A fast CRC-32 library for Node.js, powered by Rust.",
+  "keywords": [
+    "crc32",
+    "checksum",
+    "hash",
+    "zlib",
+    "rust",
+    "napi"
+  ],
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "*.node",
+    "README.md",
+    "LICENSE"
+  ],
+  "napi": {
+    "binaryName": "crc32"
+  },
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "build": "napi build --platform --release --features node",
+    "build:debug": "napi build --platform --features node",
+    "version": "napi version"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^3.6.2"
+  },
+  "engines": {
+    "node": ">= 22"
+  }
+}