kafka-crab-js 1.7.0 → 1.8.0

package/README.md

@@ -10,29 +10,35 @@ A lightweight, flexible, and reliable Kafka client for JavaScript/TypeScript. It
 
 ---
 
-## What's New in Version 1.4.0
+## What's New in Version 1.8.0
 
-### Major Updates:
-1. **Enums Replaced by Unions**:
-   - Removed enums such as `KafkaEventName`, `PartitionPosition`, `CommitMode`, and `SecurityProtocol`.
-   - These enums were replaced with union types for better flexibility and usability.
+### 🚨 Breaking Changes:
+1. **Async Consumer Commit**:
+   - **BREAKING**: The `consumer.commit()` method is now async and must be awaited
+   - **Before**: `consumer.commit(topic, partition, offset, 'Sync')`
+   - **After**: `await consumer.commit(topic, partition, offset, 'Sync')`
+   - This change improves performance by using `spawn_blocking` for non-blocking operations
 
-2. **Improved TypeScript Definitions**:
-   - Enhanced TypeScript definitions for better clarity and usability:
-     - Changes in `KafkaClientConfig`, `KafkaConsumer`, and `KafkaProducer`.
+### Major Updates:
+2. **Enhanced Manual Commit Testing**:
+   - Added comprehensive integration tests for manual commit functionality
+   - Tests now use PostRebalance events for proper timing instead of arbitrary timeouts
+   - Covers both sync and async commit modes with offset verification
+   - Tests offset persistence across consumer restarts and batch processing scenarios
 
-3. **CI/CD Enhancements**:
-   - Updated GitHub Actions workflow:
-     - Added matrix builds for better coverage across platforms (e.g., `x86_64`, `aarch64` on Linux and macOS).
+3. **Improved Error Messages**:
+   - Standardized all error messages to use consistent "Failed to [action]" format
+   - Enhanced error clarity and specificity throughout the codebase
+   - Fixed grammar and spelling issues in error messages
 
 4. **Updated Dependencies**:
-   - Upgraded dependencies to their latest versions for improved performance and security.
+   - Upgraded all dependencies to their latest versions for improved performance and security
+   - Updated TypeScript bindings and CommonJS exports
+   - Synchronized pnpm-lock.yaml with new dependency versions
 
-5. **New Tests and Examples**:
-   - Added new integration tests and examples for Kafka to ensure reliability.
-
-6. **Enhanced Documentation**:
-   - Comprehensive API reference and usage examples added to the `docs/wiki` directory.
+5. **Arc-based Consumer Architecture**:
+   - Improved internal architecture using `Arc<StreamConsumer>` for better memory management
+   - Enhanced thread safety for commit operations
 
 ---
 
@@ -92,13 +98,17 @@ async function run() {
   await consumer.subscribe([{ topic: 'foo' }]);
 
   const message = await consumer.recv();
-  const { payload, partition, offset } = message;
+  const { payload, partition, offset, topic } = message;
   console.log({
+    topic,
     partition,
     offset,
     value: payload.toString()
   });
 
+  // Manual commit (v1.8.0+: now requires await)
+  await consumer.commit(topic, partition, offset + 1, 'Sync');
+
   consumer.unsubscribe();
 
 }

package/js-binding.cjs

@@ -78,7 +78,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-android-arm64')
+        const binding = require('kafka-crab-js-android-arm64')
+        const bindingPackageVersion = require('kafka-crab-js-android-arm64/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -89,7 +94,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-android-arm-eabi')
+        const binding = require('kafka-crab-js-android-arm-eabi')
+        const bindingPackageVersion = require('kafka-crab-js-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -104,7 +114,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-win32-x64-msvc')
+        const binding = require('kafka-crab-js-win32-x64-msvc')
+        const bindingPackageVersion = require('kafka-crab-js-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -115,7 +130,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-win32-ia32-msvc')
+        const binding = require('kafka-crab-js-win32-ia32-msvc')
+        const bindingPackageVersion = require('kafka-crab-js-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -126,7 +146,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-win32-arm64-msvc')
+        const binding = require('kafka-crab-js-win32-arm64-msvc')
+        const bindingPackageVersion = require('kafka-crab-js-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -140,7 +165,12 @@ function requireNative() {
       loadErrors.push(e)
     }
     try {
-      return require('kafka-crab-js-darwin-universal')
+      const binding = require('kafka-crab-js-darwin-universal')
+      const bindingPackageVersion = require('kafka-crab-js-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      }
+      return binding
     } catch (e) {
       loadErrors.push(e)
     }
@@ -151,7 +181,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-darwin-x64')
+        const binding = require('kafka-crab-js-darwin-x64')
+        const bindingPackageVersion = require('kafka-crab-js-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -162,7 +197,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-darwin-arm64')
+        const binding = require('kafka-crab-js-darwin-arm64')
+        const bindingPackageVersion = require('kafka-crab-js-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -177,7 +217,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-freebsd-x64')
+        const binding = require('kafka-crab-js-freebsd-x64')
+        const bindingPackageVersion = require('kafka-crab-js-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -188,7 +233,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-freebsd-arm64')
+        const binding = require('kafka-crab-js-freebsd-arm64')
+        const bindingPackageVersion = require('kafka-crab-js-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -204,7 +254,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-x64-musl')
+          const binding = require('kafka-crab-js-linux-x64-musl')
+          const bindingPackageVersion = require('kafka-crab-js-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -215,7 +270,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-x64-gnu')
+          const binding = require('kafka-crab-js-linux-x64-gnu')
+          const bindingPackageVersion = require('kafka-crab-js-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -228,7 +288,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-arm64-musl')
+          const binding = require('kafka-crab-js-linux-arm64-musl')
+          const bindingPackageVersion = require('kafka-crab-js-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -239,7 +304,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-arm64-gnu')
+          const binding = require('kafka-crab-js-linux-arm64-gnu')
+          const bindingPackageVersion = require('kafka-crab-js-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -252,7 +322,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-arm-musleabihf')
+          const binding = require('kafka-crab-js-linux-arm-musleabihf')
+          const bindingPackageVersion = require('kafka-crab-js-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -263,7 +338,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-arm-gnueabihf')
+          const binding = require('kafka-crab-js-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('kafka-crab-js-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -276,7 +356,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-riscv64-musl')
+          const binding = require('kafka-crab-js-linux-riscv64-musl')
+          const bindingPackageVersion = require('kafka-crab-js-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -287,7 +372,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-riscv64-gnu')
+          const binding = require('kafka-crab-js-linux-riscv64-gnu')
+          const bindingPackageVersion = require('kafka-crab-js-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -299,7 +389,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-linux-ppc64-gnu')
+        const binding = require('kafka-crab-js-linux-ppc64-gnu')
+        const bindingPackageVersion = require('kafka-crab-js-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -310,7 +405,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-linux-s390x-gnu')
+        const binding = require('kafka-crab-js-linux-s390x-gnu')
+        const bindingPackageVersion = require('kafka-crab-js-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -320,34 +420,49 @@ function requireNative() {
   } else if (process.platform === 'openharmony') {
     if (process.arch === 'arm64') {
       try {
-        return require('./kafka-crab-js.linux-arm64-ohos.node')
+        return require('./kafka-crab-js.openharmony-arm64.node')
       } catch (e) {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-linux-arm64-ohos')
+        const binding = require('kafka-crab-js-openharmony-arm64')
+        const bindingPackageVersion = require('kafka-crab-js-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.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('./kafka-crab-js.linux-x64-ohos.node')
+        return require('./kafka-crab-js.openharmony-x64.node')
       } catch (e) {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-linux-x64-ohos')
+        const binding = require('kafka-crab-js-openharmony-x64')
+        const bindingPackageVersion = require('kafka-crab-js-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.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('./kafka-crab-js.linux-arm-ohos.node')
+        return require('./kafka-crab-js.openharmony-arm.node')
       } catch (e) {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-linux-arm-ohos')
+        const binding = require('kafka-crab-js-openharmony-arm')
+        const bindingPackageVersion = require('kafka-crab-js-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }

package/js-binding.d.ts

@@ -28,7 +28,7 @@ export declare class KafkaConsumer {
    * @returns Array of messages (may be fewer than max_messages)
    */
   recvBatch(maxMessages: number, timeoutMs: number): Promise<Array<Message>>
-  commit(topic: string, partition: number, offset: number, commit: CommitMode): void
+  commit(topic: string, partition: number, offset: number, commit: CommitMode): Promise<void>
 }
 
 export declare class KafkaProducer {

package/js-binding.js

@@ -79,7 +79,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-android-arm64')
+        const binding = require('kafka-crab-js-android-arm64')
+        const bindingPackageVersion = require('kafka-crab-js-android-arm64/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -90,7 +95,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-android-arm-eabi')
+        const binding = require('kafka-crab-js-android-arm-eabi')
+        const bindingPackageVersion = require('kafka-crab-js-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -105,7 +115,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-win32-x64-msvc')
+        const binding = require('kafka-crab-js-win32-x64-msvc')
+        const bindingPackageVersion = require('kafka-crab-js-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -116,7 +131,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-win32-ia32-msvc')
+        const binding = require('kafka-crab-js-win32-ia32-msvc')
+        const bindingPackageVersion = require('kafka-crab-js-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -127,7 +147,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-win32-arm64-msvc')
+        const binding = require('kafka-crab-js-win32-arm64-msvc')
+        const bindingPackageVersion = require('kafka-crab-js-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -141,7 +166,12 @@ function requireNative() {
       loadErrors.push(e)
     }
     try {
-      return require('kafka-crab-js-darwin-universal')
+      const binding = require('kafka-crab-js-darwin-universal')
+      const bindingPackageVersion = require('kafka-crab-js-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      }
+      return binding
     } catch (e) {
       loadErrors.push(e)
     }
@@ -152,7 +182,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-darwin-x64')
+        const binding = require('kafka-crab-js-darwin-x64')
+        const bindingPackageVersion = require('kafka-crab-js-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -163,7 +198,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-darwin-arm64')
+        const binding = require('kafka-crab-js-darwin-arm64')
+        const bindingPackageVersion = require('kafka-crab-js-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -178,7 +218,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-freebsd-x64')
+        const binding = require('kafka-crab-js-freebsd-x64')
+        const bindingPackageVersion = require('kafka-crab-js-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -189,7 +234,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-freebsd-arm64')
+        const binding = require('kafka-crab-js-freebsd-arm64')
+        const bindingPackageVersion = require('kafka-crab-js-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -205,7 +255,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-x64-musl')
+          const binding = require('kafka-crab-js-linux-x64-musl')
+          const bindingPackageVersion = require('kafka-crab-js-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -216,7 +271,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-x64-gnu')
+          const binding = require('kafka-crab-js-linux-x64-gnu')
+          const bindingPackageVersion = require('kafka-crab-js-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -229,7 +289,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-arm64-musl')
+          const binding = require('kafka-crab-js-linux-arm64-musl')
+          const bindingPackageVersion = require('kafka-crab-js-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -240,7 +305,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-arm64-gnu')
+          const binding = require('kafka-crab-js-linux-arm64-gnu')
+          const bindingPackageVersion = require('kafka-crab-js-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -253,7 +323,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-arm-musleabihf')
+          const binding = require('kafka-crab-js-linux-arm-musleabihf')
+          const bindingPackageVersion = require('kafka-crab-js-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -264,7 +339,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-arm-gnueabihf')
+          const binding = require('kafka-crab-js-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('kafka-crab-js-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -277,7 +357,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-riscv64-musl')
+          const binding = require('kafka-crab-js-linux-riscv64-musl')
+          const bindingPackageVersion = require('kafka-crab-js-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -288,7 +373,12 @@ function requireNative() {
           loadErrors.push(e)
         }
         try {
-          return require('kafka-crab-js-linux-riscv64-gnu')
+          const binding = require('kafka-crab-js-linux-riscv64-gnu')
+          const bindingPackageVersion = require('kafka-crab-js-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
         } catch (e) {
           loadErrors.push(e)
         }
@@ -300,7 +390,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-linux-ppc64-gnu')
+        const binding = require('kafka-crab-js-linux-ppc64-gnu')
+        const bindingPackageVersion = require('kafka-crab-js-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -311,7 +406,12 @@ function requireNative() {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-linux-s390x-gnu')
+        const binding = require('kafka-crab-js-linux-s390x-gnu')
+        const bindingPackageVersion = require('kafka-crab-js-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }
@@ -321,34 +421,49 @@ function requireNative() {
   } else if (process.platform === 'openharmony') {
     if (process.arch === 'arm64') {
       try {
-        return require('./kafka-crab-js.linux-arm64-ohos.node')
+        return require('./kafka-crab-js.openharmony-arm64.node')
       } catch (e) {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-linux-arm64-ohos')
+        const binding = require('kafka-crab-js-openharmony-arm64')
+        const bindingPackageVersion = require('kafka-crab-js-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.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('./kafka-crab-js.linux-x64-ohos.node')
+        return require('./kafka-crab-js.openharmony-x64.node')
       } catch (e) {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-linux-x64-ohos')
+        const binding = require('kafka-crab-js-openharmony-x64')
+        const bindingPackageVersion = require('kafka-crab-js-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.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('./kafka-crab-js.linux-arm-ohos.node')
+        return require('./kafka-crab-js.openharmony-arm.node')
       } catch (e) {
         loadErrors.push(e)
       }
       try {
-        return require('kafka-crab-js-linux-arm-ohos')
+        const binding = require('kafka-crab-js-openharmony-arm')
+        const bindingPackageVersion = require('kafka-crab-js-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '1.7.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 1.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
       } catch (e) {
         loadErrors.push(e)
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kafka-crab-js",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "type": "module",
   "engines": {
     "node": ">=20"
@@ -69,23 +69,23 @@
   },
   "packageManager": "pnpm@10.12.1",
   "dependencies": {
-    "@napi-rs/cli": "^3.0.4"
+    "@napi-rs/cli": "^3.1.5"
   },
   "devDependencies": {
-    "@types/node": "^24.2.0",
+    "@types/node": "^24.3.0",
     "dprint": "^0.50.1",
-    "esbuild": "^0.25.8",
+    "esbuild": "^0.25.9",
     "nanoid": "^5.1.5",
-    "oxlint": "^1.9.0",
+    "oxlint": "^1.12.0",
     "rimraf": "^6.0.1",
     "typescript": "^5.9.2"
   },
   "optionalDependencies": {
-    "kafka-crab-js-darwin-x64": "1.7.0",
-    "kafka-crab-js-darwin-arm64": "1.7.0",
-    "kafka-crab-js-linux-x64-gnu": "1.7.0",
-    "kafka-crab-js-linux-x64-musl": "1.7.0",
-    "kafka-crab-js-linux-arm64-gnu": "1.7.0",
-    "kafka-crab-js-linux-arm64-musl": "1.7.0"
+    "kafka-crab-js-darwin-x64": "1.8.0",
+    "kafka-crab-js-darwin-arm64": "1.8.0",
+    "kafka-crab-js-linux-x64-gnu": "1.8.0",
+    "kafka-crab-js-linux-x64-musl": "1.8.0",
+    "kafka-crab-js-linux-arm64-gnu": "1.8.0",
+    "kafka-crab-js-linux-arm64-musl": "1.8.0"
   }
 }